• Antes de empezar a programar +
  • ¿Qué versión de Symfony utiliza?
  • 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
    • ModelOnChangeClass
    • Modelos de Más de Una Tabla
    • Modelos Especiales
    • Cómo crear una factura, albarán, pedido o presupuesto
    • Herencia de Modelos
    • $modelo->install()
    • $modelo->all()
    • $modelo->clear()
    • $modelo->count()
    • $modelo->delete()
    • $modelo->exists()
    • $modelo->loadFromData()
    • $modelo->get()
    • $modelo->getModelFields()
    • $modelo->loadFromCode()
    • $modelo->primaryColumnValue()
    • $modelo->primaryColumn()
    • $modelo->newCode()
    • $modelo->tableName()
    • $modelo->save()
    • $modelo->primaryDescription()
    • $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 +
      • Widget Autocomplete
      • Widget Bytes
      • Widget Checkbox
      • Widget Color
      • Widget Datalist
      • Widget Date
      • Widget Datetime
      • Widget File
      • Widget Library
      • Widget Link
      • Widget Money
      • Widget Number
      • Widget Password
      • Widget Select
      • Widget Stars
      • Widget Text
      • Widget Textarea
      • Widget Time
      • Widget Radio
      • Widget 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
  • 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
  • Uso de la caché
  • La cola de trabajos
  • Descarga de Archivos desde MyFiles
  • 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
• Migración de plugins antiguos +
  • Row Business (Obsoleto)
  • Migrar los XML de las tablas de 2017
  • Migrar Modelos de 2017
  • addGridView() - (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
  • Obtener el PDF de una factura
  • Modificar registros
  • Eliminar registros

Mostrar mensajes, errores y alertas

Puede mostrar mensajes, avisos o alertas y errores desde controladores o modelos con la clase Tools. No olvide añadir el use de la clase.

use FacturaScripts\Core\Tools;

Mostrar un mensaje

Tools::log()->notice('hola'); // muestra un mensaje que dice hola

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

Mostrar una alerta

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

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

Mostrar un error

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

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

Mostrar un mensaje, alerta u error desde javaScripts

La función setToast() de javaScripts adminte 4 parámetros:

1. mensaje a mostrar obligatorio.
2. Estilo del mensaje: completed, critical, error, danger, info, spinner, notice, success, warning. por defecto usará info.
3. Título del mensaje, opcional.
4. Tiempo de visualización en milisegundos, por defecto 10000 (10 segundos).

Si quieressaber como añadir estos mensajes a tu vista html, visita la documentación sobre las vistas HTML.

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

Otros tipos

Además de notice(), warning() y error() también está disponible debug(), que añade mensajes que solamente aparecerán en la barra de debug, info() y critical() para errores graves.

Los canales

Por defecto todos los mensajes se añaden al canal master. Pero puede usar un canal distinto al enviar el mensaje. Simplemente indique el canal a utilizar como parámetro de la función log().

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

Dónde ver los logs antiguos

Puede ver los logs antiguos desde el menú Administrador, Logs.

¿Qué logs se guardan?

Del canal master solamente se guardan errores y críticos, pero del resto de canales se guardan todos los mensajes excepto los de debug(). Estos mensajes se almacenan durante unos días, que puede configurar desde el panel de control.

¿Dónde están las traducciones?

Las traducciones se almacenan en el directorio Translation del plugin, en archivos json. Estas traducciones las hacemos desde la sección traducciones de la forja.

¿Puedo usar traducciones existentes?

Si, simplemente ve al listado de traducciones en español y busca la que más se te adapte.