• Antes de empezar a programar +
  • Sistema de Prioridades de Plugins
  • Diagramas de tablas
  • Cómo hacer un pull-request
• Creación de Plugins
  • El archivo facturascripts.ini
  • El archivo Init.php
  • Los Controladores +
    • Controladores extendidos +
      • ListController en FacturaScripts +
        • addFilterAutocomplete()
        • addFilterCheckbox()
        • addFilterDatePicker()
        • addFilterNumber()
        • addFilterPeriod()
        • addFilterSelect()
        • addFilterSelectWhere()
      • EditController
      • PanelController +
        • addHtmlView()
        • addEditView()
        • addEditListView()
        • addListView()
      • Personalizando con Settings
      • Método disableColumn()
      • Interacción con las Vistas
    • Obtener Parámetros de la URL, Formularios o Cookies
    • Cómo guardar una cookie
    • Consultar el usuario y sus permisos
    • Formularios de edición de facturas, albaranes, etc
  • Añadir un Endpoint a la API
  • Los modelos +
    • Operaciones comunes con modelos
    • XML de la tabla
    • Modelos de Más de Una Tabla
    • Modelos Especiales
    • Cómo crear una factura, albarán, pedido o presupuesto
    • Herencia de Modelos
    • $modelo->getModelFields()
    • $modelo->all()
    • $modelo->clear()
    • $modelo->count()
    • $modelo->delete()
    • $modelo->loadFromData()
    • $modelo->install()
    • $modelo->exists()
    • $modelo->get()
    • $modelo->load() ...
    • $modelo->primaryColumnValue()
    • $modelo->primaryColumn()
    • $modelo->newCode()
    • $modelo->save()
    • $modelo->primaryDescription()
    • $modelo->tableName()
    • $modelo->primaryDescriptionColumn()
    • $modelo->url()
    • $modelo->test()
  • Las vistas HTML +
    • Iconos disponibles
    • Herencia de plantillas
  • Las vistas XML (XMLView) +
    • Columns
    • Rows +
      • Row status
      • Row statistics
      • Row actions
      • Row header y footer
    • Modals
    • Group
    • Column
    • Widgets +
      • Autocomplete
      • Bytes
      • Checkbox
      • Color
      • Datalist
      • Date
      • Datetime
      • File
      • Library
      • Link
      • Money
      • Number
      • Password
      • Select
      • Stars
      • Text
      • Textarea
      • Time
      • Subcuenta
      • Radio
      • Variante
  • Las traducciones en Plugins
  • Las extensiones +
    • Extensiones de controladores
    • Extensiones de modelos
    • Extensiones de tablas
    • Extensiones de XMLView
    • Extensiones de Vistas HTML
  • Mostrar mensajes, errores y alertas
  • Acceso a la Base de Datos +
    • DbQuery
    • Where
    • DataBaseWhere (obsoleta)
  • Settings: opciones del panel de control +
    • Cómo crear preferencias de aplicación para su plugin
  • Generación de PDF y Excel
  • AssetManager
  • El archivo Cron.php
  • Cómo publicar plugins
• Profundizando en el CORE +
  • Enrutado
  • Gestión de Errores
  • Gestión de Plugins
  • La cola de trabajos
  • La clase Request
  • La clase Response
  • Uso de la caché
  • Descarga archivos de MyFiles
  • La clase Tools
  • Cliente de API de OpenAI
  • Cliente HTTP +
    • Conectar con otro FacturaScripts mediante API
  • Validar Emails, Cadenas y URLs
  • Enviar emails con NewMail
• Test unitarios en plugins +
  • Añadir github action
• Migración de plugins antiguos +
  • Row Business (Obsoleto)
  • Migrar los XML de las tablas de 2017
  • Migrar Modelos de 2017
  • addGridView() - (obsoleto)
  • ¿Qué versión de Symfony utiliza?
  • ModelOnChange (obsoleto)
• La API REST +
  • Listado de recursos
  • Listar, filtrar y ordenar registros
  • Obtener un registro concreto
  • Crear o añadir registros
  • Cómo crear facturas, albaranes ...
  • Marcar factura como pagada
  • Hacer una factura rectificativa
  • Obtener el PDF de una factura, albarán ...
  • Subir archivos
  • Modificar registros
  • Eliminar registros
  • Obtener esquema modelo

Cómo publicar plugins en facturascripts.com

Si has creado un plugin y quieres publicarlo en facturascripts.com simplemente ve al menú Programadores → La forja y en la pestaña mis plugins pulsa el botón añadir. Debes haber iniciado sesión para que aparezca el botón añadir. No se pueden publicar plugins de forma anónima.

En la siguiente pantalla elige un nombre, una licencia y una descripción para tu plugin. ¿Tienes el código público en github, gitlab o similar? Si quieres puedes indicarlo en el campo git.

💾 Crea el zip de tu plugin

Para empaquetas un plugin, comprime la carpeta del plugin en formato zip. Comprime la carpeta, no el contenido, es decir, ve a la carpeta Plugins de FacturaScripts, y ahí selecciona la carpeta de tu plugin y comprímela en zip.

🚨 Problemas con el zip creado en Ubuntu y derivados

En las últimas versiones de Ubuntu y derivados, al comprimir mediante el asistente visual, lo hace empleando la versión 2 de zip, que todavía no está implementada en PHP. Por este motivo te va a indicar un error en todos los zips que comprimas así. Es mejor que en el caso de Linux lo comprimas en línea de comandos:

zip -r nombre-zip.zip carpeta-plugin

También puedes usar fsmaker:

fsmaker zip

🏷️ La versión es incorrecta

El campo version solamente acepta valores numéricos, enteros o decimales, para poder comparar fácilmente y saber si estamos usando una versión anterior. Evita versiones como:

• 0.1.2.3 (esto no es un número)
• A1234 (tampoco es un número)
• 1.2beta
• alpha

🗞️ Publica tu primera build

Ahora solamente falta subir el zip con los archivos del plugin.

• Haz clic en la pestaña editar de la página del plugin.
• En la sección de zips pulsa el botón añadir, aparecerá un formulario.
• Selecciona el archivo zip, indica la versión y pulsa guardar.

📚 Tipos de plugins

• Gratuitos: todo el mundo puede descargarlos, sin necesidad de registro.
• De pago: vende tus plugins directamente a través de esta web para llegar al mayor número de clientes. Define un precio, licencia y plazo de actualizaciones. Solamente aquellos que compren el plugin podrán descargarlo o actualizarlo.
• Privados: registra incluso plugins privados para utilizar el sistema de actualizaciones de FacturaScripts. Crea suscripciones para los usuarios que desee y solamente ellos podrán descargar o actualizar el plugin.