wp-advads Scaffolding Tool

📃 Introduction

CLI tools to streamline development tasks for the Advanced Ads WordPress plugin. Created by Shakeeb Ahmed

📦 Installation

Use via npx:

npx wp-advads

🚀 Usage

Run the CLI using:

npx wp-advads <command> [options]

🔧 Commands

init

Initializes a new project configuration file.

npx wp-advads init

release

Creates a new release for the plugin.

npx wp-advads release

class <classname> [options]

Creates a new PHP class file with optional templates.

npx wp-advads class MyClass -h "Class Heading" -d "Description" -s

Required Argument:

• <classname> – The name of the class.

Optional Argument:

• -h <heading> – File heading
• -d <description> – File description
• -i – Initializer interface
• -g – Integration interface
• -r – REST interface
• -s – Singleton class

view <viewname> [heading]

Creates a new view file (e.g. template partial).

npx wp-advads view sidebar "Sidebar View"

Required Argument:

• <viewname> – Name of the view file.

Optional Argument:

• [heading] – A heading comment added to the view file.

updates <version>

Creates update logic for the given plugin version.

npx wp-advads updates 1.2.3

Required Argument:

• <version> – Target version number (e.g. 1.2.0)

js <filename> [options]

Creates a new JavaScript file.

npx wp-advads js script -h "Main JS" -d "Handles the frontend logic"

Required Argument:

• <filename> – Name of the JavaScript file (without extension).

Optional Argument:

• -h <heading> – Heading comment for the file.
• -d <description> – Description comment for the file.

css <filename> [options]

Creates a new CSS file.

npx wp-advads css styles -h "Main CSS" -d "Plugin styles"

Required Argument:

• <filename> – Name of the CSS file (without extension).

Optional Argument:

• -h <heading> – Heading comment for the file.
• -d <description> – Description comment for the file.

pot

Generates .po and .mo translation files.

npx wp-advads pot

translations

Downloads translation files from GlotPress.

npx wp-advads translations

⚠️ Notes

A config file is required for all commands except init.

If one is missing, you'll be prompted to create it with wp-advads init.

👤 Author

Shakeeb Ahmed GitHub: @meshakeeb

📖 Changelog

See the changelog file