allegedwizard / wpgen

dev-dev 2026-08-30 15:54 UTC

Requires

• php: ^8.1
• symfony/console: ^v6.4.22
• symfony/process: ^8.0

MIT

• Marty Eason

Published on Packagist.org on 2026-08-30 16:48 UTC

README

Requirements

• php
• nodejs
• composer

Installation

Windows

1. Clone the repo
2. Run 'composer install' in the repo root directory
3. Add the repo directory to your system's PATH

Mac

Ensure composer is installed via:

brew install composer

Clone the repo, run composer install, and chmod the wpgen file so that it is executable.

git clone [e-mail]:allegedwizard/wpgen.git
cd wpgen
composer install
chmod 755 wpgen

Create an alias for the wpgen executable by editing or creating ~/.bashrc and adding the following:

alias wpgen='/absolute/path/to/wpgen/wpgen' 

Then restart your terminal and run wpgen to verify successful installation.

Create Plugin

In order to use wpgen, first create a plugin.

Navigate to your WordPress plugins directory, then run:

wpgen create:plugin

This creates a basic plugin architecture with a namespace of your choice.

A wpgen.config.json file is created in the plugin root directory. This file is required for all component functionality. Do not delete it.

Once your base plugin is generated, go to the new plugin directory and run:

composer install

Then, run wpgen to get a list of commands.

** create: prefixed commands must run from the plugin root directory.

** component: prefixed commands must be run from the specific component directory.

Gravity Forms Add-On

From the plugin root:

wpgen create:gravity-forms

Generates src/GravityForms/ with a GFFeedAddOn subclass (feed list, feed settings with a generic field map and conditional logic, process_feed() writing entry notes), an entry-note avatar filter, and optionally a Forms > Settings tab backed by a Settings helper (API URL + key, with a {PREFIX}API_KEY constant override). Requires Gravity Forms 2.5+ on the site.