La pantalla Menús (menú Administración › Apariencia e idiomas › Menús) configura el menú de navegación de Portail ZAPP: sus entradas, su orden, su icono, sus etiquetas en cada idioma y los grupos que las ven. Está reservada a los Administradores.
La lista de menús
Cada menú tiene un Nombre, un Tipo y una fecha de creación. Botones de cada línea: Editar, Asignaciones, Exportar y Eliminar (tras confirmación).
+ Nuevo menú pide un Nombre y un Tipo: Principal, Contextual o Barra lateral. La navegación de Portail ZAPP muestra un menú de tipo Principal: el asignado a la persona o a uno de sus grupos (consulta «Asignaciones»), y si no, el menú principal predeterminado, señalado con la insignia Predeterminado en la lista. El menú predeterminado es el menú Main; si no existe o no es de tipo Principal, es el menú de tipo Principal más antiguo. Otro menú de tipo Principal solo se muestra, por tanto, a las personas a las que está asignado.
El menú suministrado con Portail ZAPP se llama Main. Las actualizaciones le añaden las entradas de las nuevas funciones encontrándolo por ese nombre: no le cambies el nombre.
Editar un menú
Editar abre el menú:
- Propiedades: su Nombre y su Tipo, y luego Guardar;
- Elementos: sus entradas, presentadas en árbol.
Añadir un elemento
El formulario Añadir elemento pide:
- la Etiqueta, mostrada cuando ninguna traducción corresponde al idioma del lector;
- la ruta de la página (por ejemplo
/tickets); vacía, el elemento sirve de carpeta para otros elementos; - el icono (por ejemplo
bi-house): el botón junto al campo abre un selector de iconos con búsqueda; - el padre (Sin padre para una entrada de primer nivel);
- el orden (un número: los más pequeños primero).
La etiqueta, la ruta, el icono y el padre ya no se modifican después: para cambiarlos, elimina el elemento y vuelve a crearlo. En cambio, la etiqueta mostrada se corrige mediante las traducciones.
Ordenar los elementos
Arrastra un elemento por su asa ⠿: el nuevo orden se guarda en el acto (aparece Guardado). Arrastrar y soltar cambia el orden, no el padre.
En la navegación, las entradas de primer nivel siguen el orden elegido. Dentro de una carpeta, las subcarpetas van antes que los enlaces, y luego deciden el orden y la etiqueta.
Quién ve un elemento
Abre un elemento para configurar su sección Permisos:
- Grupos permitidos: marca los grupos afectados. Ningún grupo marcado: el elemento es visible para todos;
- Modo de visibilidad: Cualquier grupo (basta con pertenecer a uno de ellos) o Todos los grupos (hay que pertenecer a todos).
Esta visibilidad solo afecta a la presentación del menú, no a los permisos: ocultar una entrada no prohíbe la página, que sigue protegida por sus propios permisos (ver «Configurar los permisos»). A la inversa, algunas entradas se muestran a una persona que tiene derechos sobre la página aunque sus grupos no la muestren. Las entradas de un módulo que la licencia no incluye se ocultan. Un cambio de grupos de una persona llega a su menú en pocos minutos.
Traducir un elemento
La sección Traducciones lista las etiquetas e informaciones emergentes del elemento por idioma. Añadir / actualizar traducción: elige el Idioma (entre los idiomas activos), escribe la Etiqueta y, si hace falta, la Información emergente, y luego Guardar; una traducción existente para ese idioma se sustituye. Eliminar quita una traducción.
Cada uno ve la etiqueta de su idioma, si no la del idioma por defecto de la instancia, si no la etiqueta base.
Eliminar un elemento
Eliminar elemento (tras confirmación) quita el elemento y sus traducciones. Un elemento que contiene subelementos no se puede eliminar: aparece el mensaje «Este elemento tiene subelementos: muévelos o elimínalos primero.» y no se elimina nada. Elimina primero sus subelementos.
Exportar e importar
- Exportar descarga el menú en un archivo JSON: entradas, orden, iconos, traducciones y grupos permitidos (designados por su código).
- Importar carga un archivo así. Si existe un menú con el mismo nombre, todas sus entradas se sustituyen por las del archivo; si no, el menú se crea. El resultado indica si el menú se ha creado o actualizado, y el número de elementos importados.
Un grupo del archivo que no existe en la instancia se lista en Grupos desconocidos en esta instancia. Una entrada nunca se abre a todos por un grupo faltante: si no existe ninguno de sus grupos (o falta uno en modo Todos los grupos), queda reservada a los administradores y se lista en Entradas reservadas a los administradores. Crea los grupos faltantes antes de importar, o revisa después la visibilidad de las entradas afectadas. Sin grupo de administradores en la instancia, la importación se rechaza y no se modifica nada.
Asignaciones
Asignaciones asocia el menú a una cuenta o a un grupo, con una Prioridad (de 0 a 100, 50 por defecto): elige el Tipo de destino (Grupo o Usuario), luego el Destino —el grupo en la lista, o la cuenta buscando su nombre o su correo (dos caracteres como mínimo)— y Añadir. La lista de asignaciones muestra el nombre del destino; un destino eliminado desde entonces aparece como No encontrado.
Las asignaciones determinan la navegación de Portail ZAPP igual que la de las aplicaciones que leen el menú por la API:
- el menú de tipo Principal asignado a la propia persona, sea cual sea su prioridad;
- si no, el asignado a uno de sus grupos, primero la prioridad más alta (a igual prioridad, decide el nombre del menú);
- si no, el menú principal predeterminado.
Solo los menús de tipo Principal sustituyen la navegación: asignar un menú Contextual o Barra lateral no la cambia (la pantalla lo indica). En el menú elegido, cada entrada sigue sujeta a su visibilidad por grupos.
Ver también
- «Gestionar los grupos»: los grupos que determinan la visibilidad de las entradas.
- «Configurar los permisos»: lo que realmente autoriza el acceso a una página.