fsmaker es nuestra herramienta en línea de comandos para crear rápidamente plugins para FacturaScripts, además de modelos, controladores, etc. Es una herramienta muy sencilla con la que ahorrará incontables horas de desarrollo.
Para instalar solamente necesita PHP y Composer.
$ fsmaker
FacturaScripts Maker v1.8
crear:
$ fsmaker plugin
$ fsmaker api
$ fsmaker controller
$ fsmaker cron
$ fsmaker cronjob
$ fsmaker extension
$ fsmaker gitignore
$ fsmaker init
$ fsmaker model
$ fsmaker test
$ fsmaker upgrade
$ fsmaker upgrade-bs5
$ fsmaker worker
descargar:
$ fsmaker translations
ejecutar:
$ fsmaker run-tests
comprimir:
$ fsmaker zipA continuación vamos a crear un plugin sencillo con fsmaker. Para ello abrimos un terminal en la carpeta Plugins de FacturaScripts y ejecutamos:
fsmaker pluginfsmaker nos pedirá el nombre del plugin (MiPlugin) y creará automáticamente la carpeta en el directorio Plugins. Dentro tenemos la estructura de directorios típica de un plugin de FacturaScripts, junto a los archivos facturascripts.ini, Init.php y Cron.php.
Siguiendo con el ejemplo del plugin de notas, vamos a crear un modelo para las notas. Para ello nos colocamos en el directorio del plugin y ejecutamos:
fsmaker model
fsmaker nos pedirá el nombre del modelo (Embalaje), el nombre de la tabla (embalajes)
y las columnas de la tabla. Por último fsmaker nos preguntará si queremos crear los controladores.
Seleccionamos que sí y elegimos el menú y el título.
Ahora vamos a crear un controlador adicional para gestionar nuestras notas. Para ello ejecutamos el siguiente comando en el directorio del plugin:
fsmaker controllerfsmaker nos pedirá que elijamos el tipo de controlador (List o Edit), el título del controlador y el menú donde aparecerá. Una vez proporcionada esta información, se creará automáticamente el controlador con la estructura necesaria para funcionar correctamente en FacturaScripts.
Composer es un gestor de dependencias de PHP. Si no tiene instalado composer en su equipo, puede instalarlo fácilmente siguiendo estas guías que hemos preparado para Windows, Linux y Mac.
Para instalar composer en Linux, puede seguir la guía oficial de instalación en Linux/Unix/macOS. O si está usando Ubuntu o derivados, simplemente abra un terminal e instale el paquete composer con apt:
sudo apt update
sudo apt install composerUna vez instalado composer ya puede instalar fsmaker con estos comandos:
composer global require facturascripts/fsmaker
sudo ln -s ~/.config/composer/vendor/bin/fsmaker /usr/local/bin/fsmakerAhora ya puede ejecutar fsmaker desde cualquier carpeta. Simplemente abra un terminal y ejecute:
fsmakerPara instalar en windows puede seguir la guía oficial de instalación en windows, que normalmente implica descargar y ejecutar el Composer-Setup.exe.
Una vez instalado composer ya puede instalar fsmaker con este comando (use PowerShell o CMD):
composer global require facturascripts/fsmaker%APPDATA%\Composer\vendor\bin) está en el PATH del sistema.
Ahora ya puede ejecutar fsmaker desde cualquier carpeta. Simplemente abra un terminal y ejecute:
fsmaker Nota: En algunas configuraciones de Windows puede ser necesario ejecutar composer global exec fsmaker en lugar de solo fsmaker.
Para instalar composer en macOS, puede seguir la misma guía oficial que para Linux. Normalmente implica ejecutar unos comandos en la Terminal.
Alternativamente, si usa Homebrew:
brew install composerUna vez instalado composer ya puede instalar fsmaker con estos comandos (igual que en Linux):
composer global require facturascripts/fsmakerPara poder ejecutar fsmaker directamente, cree un enlace simbólico (ajuste la ruta si su home de composer es diferente):
sudo ln -s ~/.composer/vendor/bin/fsmaker /usr/local/bin/fsmakerAhora ya puede ejecutar fsmaker desde cualquier carpeta. Simplemente abra Terminal y ejecute:
fsmakerAl estar instalado fsmaker con composer, simplemente debemos llamar a composer para actualizar. Esto descargará siempre la última versión disponible:
composer global updateConsulte nuestra sección de noticias para estar informado o síganos en X, Facebook o YouTube.
Noticias