Desarrollo de plugins
Cómo crear un plugin para FacturaScripts
Amplía FacturaScripts sin modificar el núcleo. Empieza con una estructura mínima, genera el código habitual con fsmaker y publica tu trabajo en el catálogo oficial.
Crea la base del plugin con fsmaker
La herramienta oficial de línea de comandos genera la estructura repetitiva para que puedas concentrarte en la funcionalidad.
$ fsmaker plugin
$ fsmaker model
$ fsmaker controller
$ fsmaker extension
$ fsmaker cron
$ fsmaker test
$ fsmaker run-tests
$ fsmaker translations
$ fsmaker upgrade
$ fsmaker zipDel primer archivo al ZIP listo para publicar
Un plugin puede empezar con un directorio dentro de Plugins y un archivo facturascripts.ini. Ahí defines su nombre, descripción, versión y requisitos. Después podrás activarlo desde Administrador → Plugins.
- Genera modelos, controladores y extensiones.
- Crea tareas programadas y trabajos en cola.
- Prepara y ejecuta pruebas unitarias.
- Actualiza código obsoleto y construye el ZIP.
Aprende las piezas fundamentales
Consulta la documentación por bloques y avanza desde los datos hasta las pantallas de tu plugin.
Datos
Define las tablas y los objetos con los que trabajará el plugin.
Controladores y pantallas
Añade lógica, listados y formularios de edición reutilizando los controladores genéricos.
Guías y cursos
Sigue la documentación para programadores o aprende con ejemplos guiados.
Publica tus plugins en el catálogo
Ejecuta fsmaker zip para empaquetar el plugin y súbelo al catálogo. Desde su ficha podrás añadir documentación, noticias y nuevas versiones.
Plugins gratuitos
Comparte el plugin, su documentación y todas sus actualizaciones sin coste.
Plugins de pago
Asigna un precio y, tras el proceso de revisión, vende el plugin desde el catálogo oficial.
La comisión de venta es del 20 %.
Plugins privados
Distribuye a tus clientes nuevas versiones desde la web sin hacer público el plugin.
Mantén cada instalación al día
Publica nuevas versiones desde la ficha del plugin y decide cómo deben llegar a los usuarios.
Canales estable y beta
Abre la ficha del plugin, entra en la pestaña ZIPs y añade la nueva versión.
- Publica versiones estables para todos los usuarios.
- Prueba cambios en beta antes de promoverlos.
- Centraliza la distribución sin enviar archivos por email.
Mejora el plugin con datos reales
El catálogo reúne las conversaciones y señales que te ayudan a mantener un plugin útil y confiable.
Feedback de los usuarios
Recibe avisos de fallos y sugerencias, responde desde la web y sigue cada conversación sin perder contexto. El sistema de puntos ayuda a evitar abusos.
Salud y valoraciones
Las valoraciones, cuestiones abiertas, versiones y descargas forman el indicador de salud. Los plugins mantenidos ganan visibilidad y los que acumulan problemas o quedan abandonados salen del catálogo.
No tienes que desarrollar en solitario
Comparte dudas con programadores de todo el mundo y participa en la reunión virtual de los martes a las 18:30, hora española.
Comunidad de desarrollo
Pregunta sobre programación, documentación, traducciones o cualquier problema que encuentres.
Crea tu primer plugin
Instala fsmaker, genera la estructura inicial y consulta la guía cuando necesites profundizar.