Nuevas clases y funciones para FacturaScripts 2023

FacturaScripts 2023 va a ser una versión de transición donde reemplazaremos muchas clases y funciones para seguir con la evolución que necesita el proyecto. Necesitamos simplificar el desarrollo para atraer a más programadores, al tiempo que resolvemos viejos problemas de diseño.

Uno de los primeros cambios, como ya comentamos anteriormente, será elevar los requisitos a PHP 7.3, así como forzar los tipos de retorno de las funciones getPageData() y getModelClassName() de los controladores.

Otros cambios ya listos en la rama master y preparados para lanzar en la siguiente actualización son:

Nueva clase para administrar Plugins

La clase Core/Plugins es la nueva encargada de administrar los plugins: instalarlos, activarlos, desactivarlos y eliminarlos. Respecto a la versión anterior, esta nueva clase tiene la siguientes ventajas:

• Soluciona los problemas de prioridades de plugins de la versión anterior.
• Ejecuta el Init::update() de los plugins después de recargar, solucionando así los problemas que nos podemos encontrar si en el update() queremos usar clases que personaliza el propio plugin.
• Incluye su correspondiente test unitario.

También incluye funciones interesantes para el desarrollo de plugins como la de comprobar fácilmente si otro plugin está activado, incluso qué versión:

Plugins::isEnabled('Backup'); // devuelve true si el plugin Backup está activado

$plugin = Plugins::get('Backup'); // devuelve un objeto de tipo Core/Internal/Plugin con las propiedades del plugin
echo $plugin->version; // imprime la versión

Novedades para el archivo facturascripts.ini

Si tu plugin requiere para su funcionamiento de alguna extensión de PHP, con esta nueva clase puedes indicarlo en el archivo facturascripts.ini del plugin, usando el parámetro require_php.

name = 'MiPlugin'
description = 'Mi plugin'
version = 1
min_version = 2022
min_php = 7.4
require_php = 'mcrypt'

En este ejemplo hemos puesto como requisito PHP 7.4 o superior y con la extensión mcrypt activada. Si necesitas más de una extensión, puedes separarlas por comas:

require_php = 'mcrypt,soap'

Nuevo cliente Http para descargas y conectar con APIs

También en esta versión tenemos la nueva clase Core/Http, con la que podemos hacer consultas a webs en una sola línea:

$list = Http::get('https://facturascripts.com/PluginInfoList')->body(); // texto plano
$json = Http::get('https://facturascripts.com/PluginInfoList')->json(false); // en formato json
$array = Http::get('https://facturascripts.com/PluginInfoList')->json(); // json convertido en array

La misma clase se puede utilizar para conectar con una API, como por ejemplo la de FacturaScripts:

// obtenemos el listado de productos de la API
$products = Http::get('https://ruta-donde-este-facturascripts/api/3/productos')->setToken('clave-de-api')->json();

Cambios en Core/Base

Todas las clases de Core/Base serán reemplazadas poco a poco a lo largo del año por las nuevas versiones en Core o Core/Template. Puedes ver la lista prevista de cambios en el roadmap de 2023.

Cambios necesarios en los plugins

Como siempre la lista completa de cambios necesarios en los plugins se irá detallando en la sección de migración de plugins antiguos.