Settings: opciones del panel de control

En ocasiones queremos leer y escribir información referente a la configuración general o de nuestro plugin en concreto. Para estos casos FacturaScripts ofrece un modelo Settings con una serie de funciones de acceso rápido para leer y escribir, además de una forma sencilla de añadir secciones al panel de control mediante archivos en la carpeta XMLView.

Leer datos de Settings

La información de settings se organiza en grupos y propiedades. Cada una de las secciones que ve en el panel de control es un grupo, y cada campo es una propiedad. Si queremos consultar una propiedad podemos usar la función Tools::settings().

Use FacturaScripts\Core\Tools;

$coddivisa = Tools::settings('default', 'coddivisa');

En este ejemplo estamos consultando la divisa predeterminada, que se encuentra en el campo coddivisa del grupo default. En otros casos puede que no tengamos un valor almacenado, por lo que podemos establecer un valor predeterminado en el tercer parámetro de la función.

$coddivisa = Tools::settings('default', 'coddivisa', 'EUR');
// si por algún motivo no estuviese guardado un valor de 'coddivisa', se devuelve 'EUR'

Leer desde twig

También podemos consultar esto desde las plantillas html usando la función settings().

{{ settings('default', 'coddivisa') }}

Escribir datos en Settings

Para asignar datos en Settings podemos usar la función Tools::settingsSet() y para guardarlos en la base de datos, la función Tools::settingsSave().

Tools::settingsSet('default', 'coddivisa', 'USD');
Tools::settingsSave();

Leer datos del config.php

Algunos datos como el nombre de la base de datos se almacenan en el archivo config.php y no pueden ser modificados desde el programa. Pero pueden ser consultados con la función Tools::config().

$db_name = Tools::config('db_name');