• Antes de empezar a programar +
  • Sistema de Prioridades de Plugins
  • Diagramas de tablas
  • Cómo hacer un pull-request
• Creación de Plugins
  • El archivo facturascripts.ini
  • El archivo Init.php
  • Los Controladores +
    • Controladores extendidos +
      • ListController en FacturaScripts +
        • addFilterAutocomplete()
        • addFilterCheckbox()
        • addFilterDatePicker()
        • addFilterNumber()
        • addFilterPeriod()
        • addFilterSelect()
        • addFilterSelectWhere()
      • EditController
      • PanelController +
        • addHtmlView()
        • addEditView()
        • addEditListView()
        • addListView()
      • Personalizando con Settings
      • Método disableColumn()
      • Interacción con las Vistas
    • Obtener Parámetros de la URL, Formularios o Cookies
    • Cómo guardar una cookie
    • Consultar el usuario y sus permisos
    • Formularios de edición de facturas, albaranes, etc
  • Añadir un Endpoint a la API
  • Los modelos +
    • Operaciones comunes con modelos
    • XML de la tabla
    • Modelos de Más de Una Tabla
    • Modelos Especiales
    • Cómo crear una factura, albarán, pedido o presupuesto
    • Herencia de Modelos
    • $modelo->getModelFields()
    • $modelo->all()
    • $modelo->clear()
    • $modelo->count()
    • $modelo->delete()
    • $modelo->loadFromData()
    • $modelo->install()
    • $modelo->exists()
    • $modelo->get()
    • $modelo->load() ...
    • $modelo->primaryColumnValue()
    • $modelo->primaryColumn()
    • $modelo->newCode()
    • $modelo->save()
    • $modelo->primaryDescription()
    • $modelo->tableName()
    • $modelo->primaryDescriptionColumn()
    • $modelo->url()
    • $modelo->test()
  • Las vistas HTML +
    • Iconos disponibles
    • Herencia de plantillas
  • Las vistas XML (XMLView) +
    • Columns
    • Rows +
      • Row status
      • Row statistics
      • Row actions
      • Row header y footer
    • Modals
    • Group
    • Column
    • Widgets +
      • Autocomplete
      • Bytes
      • Checkbox
      • Color
      • Datalist
      • Date
      • Datetime
      • File
      • Library
      • Link
      • Money
      • Number
      • Password
      • Select
      • Stars
      • Text
      • Textarea
      • Time
      • Subcuenta
      • Radio
      • Variante
  • Las traducciones en Plugins
  • Las extensiones +
    • Extensiones de controladores
    • Extensiones de modelos
    • Extensiones de tablas
    • Extensiones de XMLView
    • Extensiones de Vistas HTML
  • Mostrar mensajes, errores y alertas
  • Acceso a la Base de Datos +
    • DbQuery
    • Where
    • DataBaseWhere (obsoleta)
  • Settings: opciones del panel de control +
    • Cómo crear preferencias de aplicación para su plugin
  • Generación de PDF y Excel
  • AssetManager
  • El archivo Cron.php
  • Cómo publicar plugins
• Profundizando en el CORE +
  • Enrutado
  • Gestión de Errores
  • Gestión de Plugins
  • La cola de trabajos
  • La clase Request
  • La clase Response
  • Uso de la caché
  • Descarga archivos de MyFiles
  • La clase Tools
  • Cliente de API de OpenAI
  • Cliente HTTP +
    • Conectar con otro FacturaScripts mediante API
  • Validar Emails, Cadenas y URLs
  • Enviar emails con NewMail
• Test unitarios en plugins +
  • Añadir github action
• Migración de plugins antiguos +
  • Row Business (Obsoleto)
  • Migrar los XML de las tablas de 2017
  • Migrar Modelos de 2017
  • addGridView() - (obsoleto)
  • ¿Qué versión de Symfony utiliza?
  • ModelOnChange (obsoleto)
• La API REST +
  • Listado de recursos
  • Listar, filtrar y ordenar registros
  • Obtener un registro concreto
  • Crear o añadir registros
  • Cómo crear facturas, albaranes ...
  • Marcar factura como pagada
  • Hacer una factura rectificativa
  • Obtener el PDF de una factura, albarán ...
  • Subir archivos
  • Modificar registros
  • Eliminar registros
  • Obtener esquema modelo

Mostrar mensajes, errores y alertas

FacturaScripts permite mostrar mensajes, avisos, alertas y errores desde los controladores o modelos utilizando la clase Tools. Asegúrate de incluir la declaración correcta para usar la clase:

use FacturaScripts\Core\Tools;

Mostrar un mensaje

Utiliza el método notice() para mostrar mensajes informativos. Por ejemplo:

Tools::log()->notice('hola'); // Muestra el mensaje 'hola'

// Traduce la cadena 'record-updated-correctly' al idioma predeterminado.
Tools::log()->notice('record-updated-correctly');

Mostrar una alerta

Emplea el método warning() para mostrar alertas:

Tools::log()->warning('hola'); // Muestra 'hola'

// Traduce la cadena 'access-denied' al idioma predeterminado.
Tools::log()->warning('access-denied');

Mostrar un error

Para indicar errores, utiliza el método error():

Tools::log()->error('hola'); // Muestra 'hola'

// Traduce la cadena 'record-save-error' al idioma predeterminado.
Tools::log()->error('record-save-error');

Mostrar mensajes desde JavaScript

La función setToast() en JavaScript permite mostrar mensajes en la vista y acepta cuatro parámetros:

1. Mensaje: (obligatorio) Texto a mostrar.
2. Estilo: Define el estilo del mensaje. Las opciones incluyen: completed, critical, error, danger, info, spinner, notice, success, warning. Por defecto se utiliza info.
3. Título: (opcional) Título del mensaje.
4. Duración: Tiempo de visualización en milisegundos. Por defecto, 10000 (10 segundos).

Si deseas saber cómo integrar estos mensajes en tu vista HTML, consulta la documentación sobre Vistas HTML.

<script>
setToast('tu mensaje aquí', 'warning', 'tu título aquí', 10000);
</script>

Otros tipos de mensajes

Además de notice(), warning() y error(), la clase Tools ofrece otros métodos:

• debug(): Agrega mensajes que solo se muestran en la barra de depuración.
• info(): Para mensajes informativos adicionales.
• critical(): Para errores de mayor gravedad.

Uso de canales

Por defecto, todos los mensajes se asignan al canal master. Sin embargo, es posible especificar un canal diferente al llamar a la función log(). Por ejemplo:

Tools::log('otro-canal')->notice('hola canal'); // El mensaje se añade al canal 'otro-canal'

Visualización de logs antiguos

Puedes consultar los logs antiguos desde el menú Administrador > Logs. A modo de resumen:

• En el canal master se guardan únicamente errores y mensajes críticos.
• En otros canales se almacenan todos los mensajes, excepto los de debug(). La retención de estos mensajes se puede configurar desde el Panel de Control.

Traducciones

Las traducciones se almacenan en el directorio Translation del plugin en archivos JSON. Se pueden gestionar y actualizar desde la sección de traducciones en la Forja.

Uso de traducciones existentes

Si deseas utilizar traducciones ya existentes, visita el listado de traducciones en español y selecciona la que mejor se adapte a tus necesidades.