El archivo facturascripts.ini

Este archivo es imprescindible en cada plugin y contiene los siguientes campos:

• name, para el nombre del plugin. Debe ser el mismo nombre que el directorio del plugin.
• description, para la descripción del plugin.
• version, para la versión del plugin. Debe ser un número entero o decimal.
  • version = 1.0 -> Bien
  • version = 1.0.1 -> Mal, no es decimal
  • version = 1.0-beta -> Mal, no es decimal
• min_php (opcional), para indicar la versión mínima de PHP necesaria.
  • min_php = 7.2 -> Bien
  • min_php = 7.4.5 -> Mal, no es decimal
• min_version, para indicar la versión mínima de FacturaScripts necesaria.
  • 2021.04
• require (opcional), para indicar la lista de plugins (separadas por coma) de los que depende este plugin.
  • require = 'POS' -> Bien
  • require = 'POS, Servicios' -> Mal, hay un espacio
  • require = 'POS,Servicios' -> Bien

Ejemplo de facturascripts.ini

description = 'My fantastic new plugin for FacturaScritps'
min_version = 2022
name = 'MyNewPlugin'
version = 1

Esto indica que es el plugin MyNewPlugin, en su versión 1, que requiere para su funcionamiente FacturaScripts 2021

name

Indica el nombre del plugin y debe coincidir con el nombre de la carpeta. Este campo se añadío en FacturaScripts 2018 para resolver los problemas con los plugins cuyo zip contiene los archivos dentro de una carpeta que no se corresponde con la que debe tener el plugin. Ahora se utiliza este name para renombrar la carpeta.

Problemas frecuentes

El problema más frecuente es escribir mal facturascripts.ini, ya sea porque sobra o falta una s. Otro problema común es poner un name distinto al nombre de la carpeta del plugin:

• Carpeta Miplugin, name = 'Miplugin' -> Bien
• Carpeta Mi plugin, name = 'Miplugin' -> Mal, no uses espacios
• Carpeta Miplugin, name = 'MiPlugin' -> Mal, la p está en minúscula en la carpeta, pero en mayúsculas en el name