Migrar los modelos de 2017

En FacturaScripts 2018 ahora utilizamos espacios de nombres, autoloader y notación CamelCase. Lo que significa que lo primero que debes hacer es renombrar tus modelos siguiendo esta nueva notación: La primera letra en mayúscula y sin guiones bajos en el nombre del modelo.

A continuación debes añadir el nuevo espacio de nombre y renombrar la clase con el mismo nombre que el archivo.

Antes

<?php

class my_model extends fs_model
{
    ...
}

Después

<?php
namespace FacturaScripts\Plugins\NOMBRE_PLUGIN\Model;

use FacturaScripts\Core\Model\Base;

class MyModel extends Base\ModelClass
{
    use Base\ModelTrait;
}

Nuevas funciones obligatorias

Los modelos ahora ya implementan las funciones más habituales, pero necesitan saber el nombre de la tabla y el de la clave primaria, por lo que es necesario implementar las funciones tableName() y primaryColumn().

public static function primaryColumn()
{
    /// sustituye id por el nombre de la columna que es la clave primaria
    return 'id';
}

public static function tableName()
{
    /// sustituye my_table por el nombre de la tabla
    return 'my_table';
}

Constructor innecesario

En los modelos de FacturaScripts 2015/2017 había un gran constructor con este estilo:

public function __construct($data = FALSE)
{
    parent::__construct('my_table');
    if ($data) {
        $this->id = $this->intval($data['id']);
        ....
    } else {
        $this->id = NULL;
        ...
    }
}

El primero bloque del if ha sido sustituido por la función loadFromdata(), que no necesitas implementar. La segunda parte del constructor, la del else, ha sido sustituida por la función clear(), que tampoco necesitas implementar, a menos que quieras establecer valores por defecto:

public function clear()
{
    parent::clear();
    $this->fecha = date('d-m-Y');
    $this->hora = date('H:i:s');
}

90% del código del modelo es ahora innecesario

Como ya hemos comentado, FacturaScripts 2018 permite desarrollar más rápido y con menos código, con lo que a partir de este punto debe eliminar la mayor parte de las funciones que ahora ya vienen implementadas de base:

• construct()
• get() y derivados.
• exists()
• save()
• delete()
• test()
• all() y derivados.
• url()

Puedes leer más sobre operaciones comunes con los modelos de 2018 en la documentación.

no_html() y random_string()

Estas funciones, que solían usarse en algunos modelos, ahora están en la clase Core\Base\Utils, con lo que simplemente debes añadir el use correspondiente y llamar a la función:

/// colocar debajo de namespace
use FacturaScripts\Core\Base\Utils;
...
public function test()
{
    $this->random = Utils::randomString(99);
    $this->observaciones = Utils::noHtml($this->observaciones);
}