Wasp Cli

Wasp CLI

Puedes usar WASP CLI para:

• Crear un nuevo child plugin basado en WASP.
• Generar clases (CPT, Taxonomy, Meta Box, Admin pages, etc.) con stubs.
• Registrar automáticamente esas clases en inc/classes.php.

Instalación y verificación

cd /path/to/your/wordpress-site/wp-content/plugins/wasp
composer install
php cli/wasp list

Si list funciona, ya puedes usar todos los comandos.

Flujo recomendado

1. Revisa comandos disponibles:

php cli/wasp list

2. Consulta ayuda de un comando específico:

php cli/wasp help create:post_type

3. Ejecuta en modo simulación (dry-run) antes de escribir archivos:

php cli/wasp create:post_type "Book" --dry-run

4. Ejecuta el comando real cuando el resultado te parezca correcto:

php cli/wasp create:post_type "Book"

Convenciones importantes

• Si no pasas <project>, los archivos se generan en el plugin actual (wasp).
• Si pasas <project>, ese valor debe ser el slug de un plugin hermano dentro de wp-content/plugins/.
• En child plugins, el namespace se deriva del slug:
  • wasp-child -> WaspChild
  • my-awesome-plugin -> MyAwesomePlugin

Lista de comandos

project:

• project:new
• project:rename

create:

• create:admin_page
• create:admin_subpage
• create:setting_fields
• create:post_type
• create:meta_box
• create:taxonomy
• create:term_meta
• create:user_meta
• create:shortcode
• create:custom_columns

Ejemplos rápidos

Crear un child plugin:

php cli/wasp project:new "WASP Child"

Crear un CPT y su Taxonomy en el plugin actual:

php cli/wasp create:post_type "Book"
php cli/wasp create:taxonomy "Genre" "wasp-book"

Crear elementos dentro de un child plugin (wasp-child):

php cli/wasp create:meta_box "Book Data" "wasp-book" "wasp-child"
php cli/wasp create:shortcode "Book Grid" "wasp-child"

Crear Setting Fields para una subpágina:

php cli/wasp create:setting_fields "Tracking Codes" "wasp-dashboard-setting" --subpage

wasp.sh y autocompletado

Este directorio incluye:

• cli/wasp.sh: wrapper para ejecutar wasp o php cli/wasp.
• cli/wasp-completion.sh: autocompletado para Bash/Zsh.

Ejemplo de instalación local (usuario actual):

chmod +x cli/wasp.sh
mkdir -p ~/.local/bin
cp cli/wasp.sh ~/.local/bin/wasp
chmod +x ~/.local/bin/wasp

Luego agrega ~/.local/bin al PATH y activa autocompletado:

echo 'source /path/to/your/wordpress-site/wp-content/plugins/wasp/cli/wasp-completion.sh' >> ~/.zshrc
source ~/.zshrc

Nota final

Los archivos generados son una base inicial. Debes editar las propiedades, métodos y lógica de negocio según las necesidades de tu plugin.