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:
- mensaje a mostrar obligatorio.
- Estilo del mensaje: completed, critical, error, danger, info, spinner, notice, success, warning. por defecto usará info.
- Título del mensaje, opcional.
- 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.