Introducción a la programación de plugins

FacturaScripts es prácticamente un framework MVC escrito en PHP 5.4 (compatible con versiones superiores, inluida PHP 7.X). Puede conectar tanto a MySQL como a PostgreSQL. La capa gráfica está construida sobre bootstrap para adaptarse a PC, tablet y móvil. Y su sistema de plugins permite modificar el comportamiento de cualquier clase.

Estructura de un plugin

Los plugins se encuentran en la carpeta plugins, uno por carpeta, y tienen esta estructura de archivos y carpetas:

controller/

Contiene los controladores del plugin, uno en cada archivo, con el mismo nombre que la clase del controlador que contienen. Es decir, si el archivo se llama ventas_imprimir.php, la clase que contiene debe ser ventas_imprimir.

model/

Contiene los modelos del plugin, uno en cada archivo, con el mismo nombre que la clase del modelo que contienen. Es decir, si el archivo se llama factura_cliente.php, la clase que contiene debe ser factura_cliente.

model/table/

Contiene las estructuras de las tablas de la base de datos que se deseen crear/modificar. Los archivos se llaman igual que las tablas, es decir, el archivo articulos.xml es para crear/modificar la tabla articulos.

view/

Contiene las vistas HTML del plugin, una en cada archivo.

view/js/

Contiene los archivos javascript del plugin.

cron.php (opcional)

Contiene el código que se ejecutará cada vez que se ejecute el cron, siempre que el plugin esté activo.

description (opcional)

Este archivo de texto plano, sin extensión, contiene la descripción del plugin (este plugin hace tal y tal...).

facturascripts.ini

Indica a FacturaScripts la versión del plugin, requisitos, etc...

functions.php (opcional)

Contiene funciones que pueden ser llamadas desde cualquier modelo, controlador o vista.

Personalizar un plugin

Si desea personalizar un plugin, cree una nueva carpeta en plugins y copie los archivos que desea modificar. Cuando active ese plugin, se usarán esos archivos en lugar de los originales.