Herramienta oficial de línea de comandos

Crea plugins de FacturaScripts con fsmaker

Genera la estructura de un plugin, modelos, controladores, extensiones y pruebas desde el terminal. fsmaker automatiza el trabajo repetitivo para que puedas concentrarte en la funcionalidad.

Compatible con PHP 8.1 o superior

Ayuda integrada y comandos interactivos

Instalar fsmaker Ver código fuente

Software libre distribuido mediante Composer.

Terminal

$ fsmaker list

plugin       model
controller   extension
api          worker
cron         cronjob
test         run-tests
translations upgrade
upgrade-bs5  zip

$ fsmaker model --help

Genera las piezas habituales en segundos

Ejecuta cada comando desde la carpeta adecuada y responde a las preguntas del asistente interactivo.

Crear un plugin

fsmaker plugin

Genera la estructura inicial, incluido facturascripts.ini, Init.php y Cron.php.

Crear un modelo

fsmaker model

Define el modelo, su tabla y sus campos. También puedes generar los controladores de listado y edición.

Crear un controlador

fsmaker controller

Crea un controlador básico, de listado o de edición y elige el título y menú donde aparecerá.

Extender componentes

fsmaker extension

Amplía tablas, modelos, controladores, XMLViews o vistas HTML sin modificar el código original.

Crear un worker

fsmaker worker

Prepara tareas en segundo plano para procesos largos, notificaciones o trabajos que no deben bloquear la interfaz.

Crear un cronjob

fsmaker cronjob

Genera una tarea programada individual para automatizar sincronizaciones, mantenimiento y otros procesos periódicos.

Más automatización para el ciclo completo

API y CI

api genera una API REST y github-action prepara la integración continua.

Pruebas

test crea pruebas PHPUnit y run-tests las ejecuta.

Migraciones

upgrade moderniza el código y upgrade-bs5 adapta Bootstrap 4 a 5.

Entrega

translations actualiza idiomas y zip prepara el archivo distribuible.

Instala Composer y fsmaker

Necesitas PHP 8.1 o superior y Composer. Elige tu sistema operativo para completar la instalación.

Instala PHP y Composer

Sigue la guía oficial para Linux. En Ubuntu y derivados también puedes usar:

sudo apt update
sudo apt install php-cli composer

Instala fsmaker globalmente

composer global require facturascripts/fsmaker

Comprueba la ruta y ejecútalo

composer global config bin-dir --absolute
fsmaker list

Si el comando no se encuentra, añade el directorio que devuelve Composer al PATH.

Vídeo de instalación de Composer en Linux.

Instala Composer

Descarga y ejecuta Composer-Setup.exe. El instalador te ayudará a seleccionar PHP.

Instala fsmaker desde PowerShell o CMD

composer global require facturascripts/fsmaker

Comprueba la instalación

composer global config bin-dir --absolute
fsmaker list

Si Windows no encuentra fsmaker, añade al PATH la ruta indicada por Composer; normalmente está dentro de %APPDATA%\Composer\vendor\bin.

Vídeo de instalación de Composer en Windows.

Instala Composer

Sigue la guía oficial para macOS o usa Homebrew:

brew install composer

Instala fsmaker globalmente

composer global require facturascripts/fsmaker

Añade el ejecutable al PATH

composer global config bin-dir --absolute
fsmaker list

Añade al PATH el directorio mostrado por Composer si fsmaker todavía no se reconoce desde el terminal.

Mantén la herramienta al día y empieza a construir

Actualiza fsmaker con Composer y usa la ayuda integrada para descubrir cada opción.

Actualizar y consultar la ayuda

Actualiza únicamente fsmaker y consulta la lista o la ayuda específica de un comando.

composer global update facturascripts/fsmaker
fsmaker list
fsmaker model --help

Puedes añadir -v, -vv o -vvv para obtener más información durante la ejecución.

Siguiente paso

Crea tu primer plugin

Sigue el recorrido completo para generar la estructura, desarrollar la funcionalidad y publicar el resultado.

Cómo crear un plugin Informar de un problema Noticias de FacturaScripts