$modelo->install()
El método install() del modelo permite añadir registros por defecto a la tabla al momento de crearla.
En ocasiones hay tablas, como paises, que es necesario o muy recomendable inicializar con registros. Para estos casos existe el método install() en los modelos. Este método es llamado cuando se crea la tabla en la base de datos, únicamente en ese instante. Y debe devolver una sentencia SQL para insertar los valores necesarios en la tabla.
Ejemplo
En este ejemplo de modelo MiPais añadimos varios registros cuando se crea la tabla. Para ello devolvemos el SQL necesario.
<?php
namespace FacturaScripts\Plugins\TuPlugin\Model;
use FacturaScripts\Core\Model\Base\ModelClass;
use FacturaScripts\Core\Model\Base\ModelTrait;
class MiPais extends ModelClass
{
use ModelTrait;
public $id;
public $name;
public function install(): string
{
// devolvemos el SQL para insertar los registros predeterminados
return 'INSERT into mis_paises ('id','name') VALUES ('1','España'),('2','Portugal');';
}
public static function primaryColumn(): string
{
return 'id';
}
public static function tableName(): string
{
return 'mis_paises';
}
}Carpeta Data
En ocasiones queremos añadir tantos registros que es mejor cargarlos desde un archivo CSV. Por defecto, el método install() buscará en la carpeta Data un archivo CSV con el mismo nombre que la tabla. El orden de búsqueda es el siguiente:
- Busca en la carpeta Data/Codpais/ + nombre del país predeterminado en el panel de control.
- Busca en la carpeta Data/Lang/ + código del idioma predeterminado en el config.php
- Busca en la carpeta Data/Lang/ES.
El primer archivo que encuentre con el nombre de la tabla es el que carga. No es necesario ningún cambio en el modelo.