Migración de plugins antiguos

No existe el código perfecto y hacer un framework con nuevas funciones cada poco tiempo y que sea compatible hacia atrás por los siglos de los siglos es el santo grial de los informáticos. Nadie lo ha conseguido y cada poco tiempo hay que romper la compatibilidad con plugins antiguos: a veces poco, a veces mucho.

FacturaScripts ha mantenido la compatibilidad hacia atrás desde la versión 2013 hasta la 2017. También desde la versión 2018 a la 2023. En la versión 2022 se introdujeron algunos cambios que podían romper la compatibilidad y en la 2023 algunos más. A continuación puedes ver más detalles de cada una de las roturas de compatibilidad hacia atrás:

Cambios en la v2024

• El requisito mínimo es ahora PHP 7.4.
• La clase CronClass se encuentra ahora en Core/Template y ha sido rediseñada para que sea más sencillo crear tareas programadas.
• La clase InitClass se ha movido también a Core/Template.

Cambios en la v2023

• El requisito mínimo es ahora PHP 7.3.
• La clase Core/Base/Cache ha sido reemplazada por Core/Cache.
• La función getClientIp() de la clase IpFilter ha sido reemplazada por la misma función, pero en Core/Session.
• La clase Core/App/WebRender ha sido reemplazada por Core/Html.
• La clase Core/Base/PluginManager ha sido reemplazada por Core/Plugins.
• La clase Core/Base/DownloadTools ha sido reemplazada por Core/Http.
• La clase Core/App/AppSettings ha sido reemplazada por Core/Tools.
• La clase Core/Base/ToolBox ha sido reemplazada por Core/Tools.
• Las llamadas a i18n.trans() en las plantillas HTML han sido reemplazada por trans().
• Las llamadas a appSettings.get() en las plantillas HTML han sido reemplazada por settings().
• Las llamadas a fsc.toolBox().coins().format() en las plantillas HTML han sido reemplazada por money().
• Las llamadas a fsc.toolBox().numbers().format() en las plantillas HTML han sido reemplazada por number().

Cambios en la v2022

Para esta versión se requiere como mínimo PHP 7.2. Además, se puede requerir una versión superior de PHP desde el archivo facturascripts.ini del plugin. También se han abandonado los gidview y se han rediseñado los formularios de albaranes, facturas, pedidos, presupuestos y asientos.

Min version >= 2020

Todos los plugins que tengan en su archivo facturascripts.ini un min_version menor que 2020 se consideran incompatibles con la versión 2022.

Forzado el tipo de retorno en muchas funciones

Para reducir los errores de programación y facilitar las herramientas de análisis de código, se han forzado los tipos de retorno de muchas funciones. Por ejemplo, la función getPageData() de los controladores debe forzar el tipo retorno array:

La diferencia es ese getPageData(): array que indica a PHP que lo que devuelve la función debe ser un array o si no, debe detener la ejecución. Lo mismo sucede con la función getModelClassName() de los EditController, que debe forzar el retorno de string:

<?php
namespace FacturaScripts\Core\Controller;

class EditFabricante extends \FacturaScripts\Core\Lib\ExtendedController\EditController
{
    public function getModelClassName(): string
    {
        return 'Fabricante';
    }
}

En los modelos se debe forzar el tipo de retorno de las siguientes funciones (si las tiene el modelo):

• delete(): bool
• install(): string
• loadFromCode($code, array $where = [], array $order = []): bool
• primaryColumn(): string
• primaryDescriptionColumn(): string
• tableName(): string
• test(): bool
• save(): bool
• saveInsert(array $values = []): bool
• saveUpdate(array $values = []): bool
• url(string $type = 'auto', string $list = 'List'): string

Calculator sustituye a BusinessDocTool

Se ha reemplazado la clase BusinessDocTool para calcular los totales de facturas, albaranes, pedidos y presupuestos:

$tools = new BusinessDocumentTools();
$tools->recalculate($albaran);

Ahora se debe usar la nueva clase Calculator:

$lines = $albaran->getLines();
Calculator::calculate($albaran, $lines, true);

Cambios en la v2020

Los modelos de más de una tabla conocidos como ModelView se renombraron a JoinModel.

Cambios en la v2018

La versión 2018 es un rediseño completo y por tanto, sin ninguna compatibilidad con la versión 2017 o anteriores. Hemos renombrado las carpetas existente y añadido algunas nuevas. La nueva escructura queda así:

• Controller: anteriormente llamada controller. Contiene todos los controladores del plugin.
• Model: anteriormente llamada model. Contiene todos los modelos del plugin.
• Table: anteriormente llamada model/table. Contiene los archivos xml con la estructura de cada tabla usada por los modelos del plugin.
• View: anteriormente llamada view. Contiene las vistas HTML usadas por el plugin.