• Antes de empezar a programar
  • ¿Qué versión de Symfony utiliza?
  • 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
    • ModelOnChangeClass
    • Modelos de Más de Una Tabla
    • Modelos Especiales
    • Cómo crear una factura, albarán, pedido o presupuesto
    • Herencia de Modelos
    • $modelo->install()
    • $modelo->all()
    • $modelo->clear()
    • $modelo->count()
    • $modelo->delete()
    • $modelo->exists()
    • $modelo->loadFromData()
    • $modelo->get()
    • $modelo->getModelFields()
    • $modelo->loadFromCode()
    • $modelo->primaryColumnValue()
    • $modelo->primaryColumn()
    • $modelo->newCode()
    • $modelo->tableName()
    • $modelo->save()
    • $modelo->primaryDescription()
    • $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 +
      • Widget Autocomplete
      • Widget Bytes
      • Widget Checkbox
      • Widget Color
      • Widget Datalist
      • Widget Date
      • Widget Datetime
      • Widget File
      • Widget Library
      • Widget Link
      • Widget Money
      • Widget Number
      • Widget Password
      • Widget Select
      • Widget Stars
      • Widget Text
      • Widget Textarea
      • Widget Time
      • Widget Radio
      • Widget 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
  • 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
  • Uso de la caché
  • La cola de trabajos
  • Descarga de Archivos desde MyFiles
  • 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
• Migración de plugins antiguos +
  • Row Business (Obsoleto)
  • Migrar los XML de las tablas de 2017
  • Migrar Modelos de 2017
  • addGridView() - (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
  • Obtener el PDF de una factura
  • Modificar registros
  • Eliminar registros

Sistema de Prioridades de Plugins en FacturaScripts

En FacturaScripts, es fundamental comprender el sistema de prioridades que rige el funcionamiento de los plugins. El último plugin activo tiene prioridad sobre los anteriores. Esto significa que, al consultar una página, se carga el modelo, la vista HTML, XML, un archivo JavaScript o una imagen del plugin con mayor prioridad que contenga el archivo solicitado.

Gracias a este mecanismo, podemos modificar el comportamiento de cualquier página. Simplemente copiamos (o extendemos, si se trata de una clase PHP o vista Twig) el archivo necesario a nuestro plugin, realizamos las modificaciones requeridas y al activar el plugin, que es el último en ser activado, tendrá preferencia sobre los demás.

Carpeta Dinamic

Para evitar la necesidad de consultar continuamente todos los plugins en busca de un archivo, estos se copian automáticamente a la carpeta Dinamic, siguiendo el sistema de prioridades mencionado anteriormente.

Los archivos en Dinamic se actualizan cada vez que instalas o actualizas un plugin, o cuando haces clic en el botón Reconstruir en el menú Administrador, Plugins.

Orden de Carga de los Plugins

Desde el listado de plugins (Menú Administrador -> Plugins), puedes observar el orden en que se cargan los plugins. Este orden determina la prioridad en el sistema de carga, asegurando que el último plugin activo tenga mayor prioridad, como se mencionó anteriormente.

Modificación de Archivos Específicos

Modificar Core/Controller/ListCliente.php

Crea el archivo ListCliente.php en la carpeta Controller de tu plugin. Hereda de la clase original y modifica el archivo según tus necesidades. Activa tu plugin y verás cómo se utiliza tu archivo en lugar del original.

<?php
namespace FacturaScripts\Plugins\MiNuevoPlugin\Controller;

class ListCliente extends \FacturaScripts\Core\Controller\ListCliente
{
    // Tu código aquí
}

Modificar Core/View/SendMail.html.twig

Copia el archivo SendMail.html.twig a la carpeta View de tu plugin y realízale las modificaciones necesarias. Activa tu plugin y verás cómo se utiliza tu archivo en lugar del original.

Cambiar el Logotipo del Login

Copia la imagen deseada al directorio Assets/images de tu plugin y renómbrala a horizontal-logo.png. Activa tu plugin y verás cómo se utiliza el nuevo archivo en lugar del original.

Herencia de Clases

Tanto en los modelos, controladores como en las vistas Twig, puedes heredar de las clases originales. De esta manera, no perderás ninguna de las mejoras que se implementen en el futuro.

Herencia en Twig

En particular, en una vista de Twig, es posible extender una plantilla externa a tu plugin, como podría ser de Core utilizando @Core, o de un plugin específico con @Plugin{NombrePlugin}, precediéndolo a la ruta de la vista. Este enfoque simplifica la aplicación de cambios específicos, evitando la necesidad de reescribir el archivo completo y garantizando la preservación de las modificaciones de la plantilla padre.