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ás incontables horas de desarrollo.
Para instalar solamente necesitas 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 zip
Para crear un plugin con fsmaker simplemente abre un terminal en la carpeta Plugins de FacturaScripts y ejecuta:
fsmaker plugin
fsmaker te pedirá el nombre del plugin (MiPlugin) y creará automáticamente la carpeta dentro de Plugins, con toda la estructura de directorios típica de un plugin de FacturaScripts, junto a los archivos facturascripts.ini, Init.php y Cron.php.
Para crear un controlador ejecuta fsmaker con la opción controller.
fsmaker controller
fsmaker te pedirá que elijas 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.
Para crear un modelo con fsmaker solamente debes usar la opción model:
fsmaker model
fsmaker te pedirá el nombre del modelo, el nombre de la tabla y las columnas de la tabla. Por último te preguntará si quieres crear los controladores de listado y edición.
Si lo que buscas es crear una extensión a un modelo existente, ejecuta fsmaker con la opción extensión y selecciona modelo.
fsmaker extension
Con este comando podrás crear una extensión de modelo que te permitirá ampliar la funcionalidad de modelos existentes sin necesidad de modificar el código original del sistema.
Los workers en FacturaScripts te permiten ejecutar tareas en segundo plano de forma asíncrona. En este vídeo aprenderás cómo crear y configurar un worker correctamente.
fsmaker worker
Los workers son ideales para realizar operaciones que requieren tiempo o recursos, sin bloquear la interfaz de usuario. Perfecto para procesamiento de datos, notificaciones y tareas programadas.
Los cronjobs te permiten ejecutar tareas automáticas en intervalos de tiempo específicos. Descubre en este vídeo cómo crear y gestionar cronjobs en FacturaScripts.
fsmaker cron
Los cronjobs son perfectos para automatizar tareas como copias de seguridad, limpieza de datos, sincronizaciones y cualquier otra operación que necesite ejecutarse periódicamente.
Composer es un gestor de dependencias de PHP. Si no tienes instalado Composer en tu equipo, puedes instalarlo fácilmente siguiendo estas guías que hemos preparado para Windows, Linux y Mac.
Para instalar Composer en Linux, puedes seguir la guía oficial de instalación en Linux/Unix/macOS. O si estás usando Ubuntu o derivados, simplemente abre un terminal e instala el paquete composer con apt:
sudo apt update
sudo apt install composer
Una vez instalado Composer ya puedes instalar fsmaker con estos comandos:
composer global require facturascripts/fsmaker
sudo ln -s ~/.config/composer/vendor/bin/fsmaker /usr/local/bin/fsmaker
Ahora ya puedes ejecutar fsmaker desde cualquier carpeta. Simplemente abre un terminal y ejecuta:
fsmaker
Para instalar en Windows puedes 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 puedes instalar fsmaker con este comando (usa PowerShell o CMD):
composer global require facturascripts/fsmaker
%APPDATA%\Composer\vendor\bin) está en el PATH del sistema.
Ahora ya puedes ejecutar fsmaker desde cualquier carpeta. Simplemente abre un terminal y ejecuta:
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, puedes seguir la misma guía oficial que para Linux. Normalmente implica ejecutar unos comandos en la Terminal.
Alternativamente, si usas Homebrew:
brew install composer
Una vez instalado Composer ya puedes instalar fsmaker con estos comandos (igual que en Linux):
composer global require facturascripts/fsmaker
Para poder ejecutar fsmaker directamente, crea un enlace simbólico (ajusta la ruta si tu home de Composer es diferente):
sudo ln -s ~/.composer/vendor/bin/fsmaker /usr/local/bin/fsmaker
Ahora ya puedes ejecutar fsmaker desde cualquier carpeta. Simplemente abre Terminal y ejecuta:
fsmaker
Al estar instalado fsmaker con Composer, basta con llamar a Composer para actualizar. Esto descargará siempre la última versión disponible:
composer global update
Consulta nuestra sección de noticias para estar al día o síguenos en X, Facebook o YouTube.
Noticias