Actualización de plugins a 2022

En la versión 2022 de FacturaScripts introducimos algunos cambios internos. Esto hace que en algunos casos sea necesaria la actualización del código de plugins antiguos para hacerlos compatibles con la nueva versión del núcleo. Hemos condensado estos cambios en la sección de ayuda para programadores:

• Migración de plugins antiguos

El primer cambio a realizar es en el campo min_version del archivo facturascripts.ini del plugin. En este campo se debe reflejar la versión mínima de FacturaScripts donde el plugin funcionará. No es realista indicar que el mínimo es 2018, ya que ha habido muchos cambios desde entonces. ¿Seguro que has probado esta versión de tu plugin con esa versión del core? El valor mínimo razonable es 2020, por debajo de ahí se considera que el plugin no es compatible con la versión 2022.

El resto de cambios consisten en forzar los tipos de retorno de las funciones más usadas de modelos y algunas de controladores. Para forzar el tipo de retorno de una función en PHP se añade dos puntos y el tipo, justo después del nombre de la función:

public function getPageData(): array
{
    $pageData = parent::getPageData();
    $pageData['title'] = 'MyNewController';
    $pageData['menu'] = 'admin';
    $pageData['icon'] = 'fas fa-page';
    return $pageData;
}

Fíjate en la parte señalada:

Este cambio hace que si por despiste del programador hace un return de algo que no sea un array, la ejecución se detendrá con un error de tipado, señalando el error al programador y reduciendo el tiempo que se emplea en encontralo.

Futuras versiones

Como siempre, puedes ver el plan de desarrollo completo en la sección roadmap.