El sistema de prioridades de plugins

Lo primero que debe tener claro es el sistema de prioridades por el que se rige FacturaScripts. El último plugin activo tiene prioridad sobre el anterior, y así sucesivamente. Cuando se consulta una página, se carga un modelo, una vista HTML, XML, un archivo javascript o una imagen, se utiliza el archivo del plugin con mayor prioridad que tenga ese archivo.

Gracias a este sistema podemos modificar el comportamiento de cualquier página. Simplemente copiamos (o extendemos si se trata de una clase PHP o vista de Twig) el archivo necesario a nuestro plugin, hacemos ahí los cambios, y al activar el plugin, como ha sido el último en activar, tiene preferencia sobre el resto.

La carpeta Dinamic

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

Los archivos de Dinamic se actualizan cada vez que instalas o actualizas, o cuando pulsas el botón reconstruir el menú Administrador, Plugins.

Ver el orden de carga de los plugins

Desde el listado de plugins (menú Administrador, Plugins) se puede ver el orden en que se carga cada plugin. Este orden determina la prioridad en el sistema de carga, asegurando así que el último plugin activo tenga mayor prioridad, como se ha mencionado anteriormente.

¿Quiere modificar el archivo Core/Controller/ListCliente.php?

Cree el archivo ListCliente.php en la carpeta Controller de su plugin. Herede de la clase original y modifique el archivo de su plugin a su gusto. Active su plugin y verá como se usa su archivo en lugar del original.

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

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

¿Quiere modificar el archivo Core/View/SendMail.html.twig?

Copie el archivo SendMail.html.twig a la carpeta View de su plugin, modifique el archivo a su gusto. Active su plugin y verá como se usa su archivo en lugar del original.

¿Quiere cambiar el logotipo del login?

Copie la imagen que desee al directorio Assets/images de su plugin y renombrela como horizontal-logo.png. Active su plugin y verá como se usa el nuevo archivo en vez del original.

Herencia

Tanto en los modelos, controladores, como en las vistas Twig puede heredar de los originales. Así no perderá ninguna de las mejoras que estos sufran.

Herencia en twig

En el caso concreto de una vista de Twig, es posible extender a una plantilla concreta externa a nuestro plugin, como podría ser de Core con @Core o de un plugin concreto @Plugin{NombrePlugin}, precediendolo a la ruta de la vista. De este modo se simplifica aplicar cambios concretos, sin tener que re-escribir el archivo entero, y sin perder cambios de la plantilla padre.