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. Para consultar las clases disponibles, utiliza la referencia de clases.
Publica tus plugins en el catálogo
Empaqueta el plugin con fsmaker zip, crea su ficha y solicita la revisión. El plugin queda privado hasta que el personal lo aprueba: el catálogo solo admite plugins terminados, con capturas reales y que su autor se compromete a mantener.
Plugins gratuitos
Comparte el plugin, su documentación y todas sus actualizaciones sin coste, tras la revisión del personal.
Lo gratuito se queda gratuito: un plugin aprobado como gratuito ya no puede pasar a ser de pago, tampoco pasando antes por privado.
Plugins de pago
Asigna un precio y, tras la revisión del personal y la evaluación de usuarios del TOP, vende el plugin desde el catálogo oficial.
La comisión de venta es del 20 %. Consulta los requisitos para vender y cuántos plugins puedes tener a la venta.
Plugins privados
Distribuye a tus clientes nuevas versiones desde la web sin hacer público el plugin.
También cuentan para tu cupo de plugins.
Antes de publicar
-
Compromiso de mantenimiento
Quien instala un plugin lo usa en el programa con el que lleva su negocio. Publicarlo no es un compromiso de por vida, pero sí el de no abandonarlo a las pocas semanas: corregir sus fallos, atender las cuestiones de los usuarios y adaptarlo a las nuevas versiones de FacturaScripts mientras siga publicado. Si decides dejarlo, retíralo con tiempo y avisando a sus usuarios.
-
Revisión del personal
Todos los plugins, también los gratuitos, se revisan antes de entrar en el catálogo: que funcionen, que la ficha muestre capturas reales y que aporten algo propio. No se aprueban copias de plugins de otros autores. Se solicita desde la pestaña editar del plugin, con una sola solicitud abierta a la vez; si se rechaza, podrás volver a pedirla pasados 15 días.
-
Cupo según el uso real
Empiezas con un máximo de 5 plugins, sean gratuitos, de pago o privados. El cupo crece con las instalaciones activas de todos tus plugins, así que publicar más no da más visibilidad: lo que cuenta es que la gente use los que ya tienes.
-
Colabora antes de multiplicar
Si tu idea mejora un plugin que ya existe, manda un pull request a su repositorio. Y para integrar tu plugin con otro, usa los controladores condicionales en lugar de publicar un plugin puente.
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. El caso más habitual es no seguir al core: un plugin que lleva doce meses sin soportar una versión estable más reciente baja a salud 0 y deja de mostrarse. Te avisamos por correo antes de que ocurra.
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.
Aprovecha el potencial de la IA correctamente
Además de fsmaker tambien dispones de un plugin para instalar en Claude Code y/o ChatGPT Codex.
Repositorio GitHub