Permisos

Si en el artículo de Grupos de Usuarios dijimos que cada grupo es un llavero, aquí está la fábrica de llaves. Cada permiso es una llave: una casilla que aparece en la pantalla de Grupos de Usuarios para que se pueda marcar o dejar vacía. Esta pantalla no le da acceso a nadie a nada por sí sola; lo que hace es definir qué llaves existen, cómo se llaman y en qué sección aparecen cuando se arma un grupo.

Es la tercera pieza del trío: en Usuarios se decide quién entra, en Grupos de Usuarios se decide qué llaves lleva cada grupo, y aquí se mantiene el catálogo de llaves. Igual que Grupos de Usuarios, esta pantalla es exclusiva del Admin Principal y no la vas a poder abrir desde tu cuenta, pero conviene conocerla: un cambio aquí afecta a todos los grupos a la vez, y saber cómo funciona te ayuda a entender por qué una pantalla o una extensión aparece, o no, en el menú de tu equipo.

Esta pantalla es solo para el Admin Principal

Igual que Grupos de Usuarios, Permisos solo se abre con la cuenta del Admin Principal. Si cualquier otra persona intenta entrar (aunque su grupo tuviera marcada la casilla "Permisos"), NexFlow le muestra la pantalla de "Sin acceso" con el mensaje "Esta seccion es exclusiva del Administrador Principal." y un enlace para volver al Dashboard.

La razón es la misma de siempre, pero aquí pesa todavía más: el catálogo de permisos define qué existe para todo el sistema, no solo para un grupo. Quien pudiera editarlo podría cambiar las reglas del juego para todos. Por eso la casilla "Permisos" que aparece en Grupos de Usuarios solo decide si el enlace se muestra en el menú lateral, y nunca es suficiente para entrar de verdad a la pantalla.

La lista de permisos

Al abrir la pantalla, el Admin Principal ve arriba el botón azul "Agregar permiso" y abajo una tabla con todos los permisos existentes, con cuatro columnas:

Columna	Qué te dice
Identificador	El nombre "técnico" del permiso, en letra tipo máquina de escribir (por ejemplo settings o extension_carrusel). Es el nombre que usa NexFlow por dentro para reconocer esa llave. Es lo más importante de cada renglón, y ahorita te explico por qué.
Nombres	El nombre "humano" del permiso, que es lo que se ve en las casillas de Grupos de Usuarios. Si tiene varios idiomas capturados, aparecen todos separados por una diagonal, como "Configuracion / Settings".
Tipo	Funcion principal, Modulo o Extension. Define en cuál de los tres bloques de la pantalla de Grupos aparece la casilla.
Acciones	Los enlaces "Editar" y "Borrar" de cada permiso.

La lista se muestra en el orden en que se fueron creando los permisos, no en orden alfabético; los más nuevos quedan hasta abajo.

La idea clave: el identificador es lo que NexFlow revisa

Este es el punto que más conviene entender. Cuando alguien intenta abrir una pantalla del panel, el código de esa pantalla le pregunta al sistema algo como "¿el grupo de esta persona tiene la llave users?". Lo que se compara es el identificador, letra por letra. El nombre bonito que aparece en la casilla es solo para que la persona que arma los grupos sepa qué está marcando; a NexFlow no le importa.

De ahí se desprenden tres cosas prácticas:

• Un permiso solo sirve si alguna pantalla del panel revisa exactamente ese identificador. La mayoría de las pantallas del panel ya tienen su permiso en la lista, así que ahí mismo se puede ver cuáles son. Si se inventa un permiso con un identificador que ninguna pantalla revisa, la casilla aparecerá en Grupos de Usuarios, pero marcarla no abrirá ni cerrará nada. Por eso, no conviene crear permisos "por si acaso".
• Y al revés: una pantalla cuyo permiso no exista en esta lista no se puede repartir entre grupos, porque no habría casilla que marcar. Esa pantalla queda disponible solo para el Admin Principal.
• Escribir mal un identificador (una letra de más, una mayúscula donde no va) equivale a crear una llave que no abre ninguna puerta.

Ya que estamos, hay un permiso en la lista llamado dashboard. Como vimos en el artículo de Grupos de Usuarios, el Dashboard aparece siempre para quien haya iniciado sesión, así que marcar o desmarcar esa casilla no cambia lo que la persona puede hacer.

El caso de las extensiones

Las extensiones siguen una regla especial y muy útil de conocer. Para cada extensión instalada, NexFlow busca un permiso cuyo identificador sea la palabra extension_ seguida del nombre de la carpeta de esa extensión. Por ejemplo, para la extensión cuya carpeta se llama carrusel, el permiso se llama extension_carrusel. Esa es la razón por la que en la lista se ven identificadores como extension_carrusel o extension_ultimos_articulos.

Esto tiene una consecuencia importante que te puede tocar de cerca: instalar una extensión nueva no crea su permiso automáticamente. En el código de NexFlow, la pantalla de Permisos es el único lugar del panel que da de alta permisos, y solo el Admin Principal puede usarla. Mientras esa extensión no tenga su permiso en el catálogo, y mientras ese permiso no esté marcado en el grupo de tu equipo desde Grupos de Usuarios, la extensión no aparecerá en el menú "Extensiones" de tu cuenta ni de las de tu equipo: solo la ve el Admin Principal. Así que, si instalaste una extensión y no la encuentras en tu menú, lo primero que hay que revisar es si falta alguno de esos dos pasos, y ambos los hace el Admin Principal.

Un permiso que no es una pantalla: ver todas las citas

No todos los permisos abren o cierran una pantalla. Un buen ejemplo es appointments_view_all, que en la lista aparece con el nombre "Citas — Ver todas (no solo las asignadas)". Trabaja junto con el permiso de Citas: quien tiene el permiso de Citas pero no tiene este, entra a la pantalla de Citas pero solo ve las citas que le fueron asignadas a él como agente. Quien sí lo tiene ve todas. Es la misma pantalla, pero con dos niveles de vista, y por eso se controla con una llave aparte.

Agregar un permiso

Con un clic en "Agregar permiso", el botón desaparece y en su lugar se despliega, en la misma pantalla, el formulario "Nuevo permiso".

Campo	Para qué sirve
Identificador tecnico (menu_key)	El identificador del que hablamos arriba. Es el único dato obligatorio. Debajo del campo, NexFlow deja este recordatorio: "Sin espacios ni acentos, ej. dashboard, comments, extension_carrusel. Es lo que usa el codigo para checar el permiso." Conviene hacerle caso: NexFlow solo verifica que no se deje vacío y que no esté repetido, no revisa que cumpla el formato, así que la disciplina de escribirlo bien es de quien lo captura.
Tipo	Un menú con tres opciones: Funcion principal, Modulo y Extension. Decide en cuál bloque de la pantalla de Grupos aparecerá la casilla: "Funciones principales", "Modulos" o "Extensiones". Si no se elige, se guarda como Funcion principal.
Nombre del permiso en cada idioma	Cinco cajitas: Espanol, English, Deutsch, Francais y Portugues. Ninguna es obligatoria. Se escribe el nombre en los idiomas que se quieran ver; los que se dejen vacíos simplemente no aparecen. Si se dejan los cinco vacíos, en las casillas se mostrará el identificador técnico en lugar de un nombre.

Al dar clic en "Guardar", la página se recarga, el formulario se cierra, aparece un aviso de confirmación con la palabra "OK" y el permiso queda al final de la lista. Si hay que arrepentirse antes de guardar, "Cancelar" recarga la pantalla sin guardar nada.

Los dos avisos de error

Si se deja el identificador vacío, aparece un recuadro rojo con el mismo recordatorio de formato que vimos arriba. Si se escribe un identificador que ya usa otro permiso, el recuadro rojo dice "Ese identificador ya esta en uso por otro permiso." En ambos casos no se guarda nada, y con corregirlo y volver a guardar basta.

Editar un permiso

Con un clic en "Editar" en el renglón del permiso, la página se recarga y el mismo formulario aparece ya abierto, con el título "Editar permiso" y los datos actuales. Aquí hay un detalle que conviene saber para no llevarse sorpresas: aunque el campo del identificador se puede escribir, al guardar NexFlow solo actualiza el tipo y los nombres; el identificador queda como estaba cuando se creó el permiso.

Piénsalo así: el identificador es el que reconocen las pantallas por dentro, así que lo prudente es tratarlo como algo fijo. Si hubo un error al escribirlo, la salida es crear un permiso nuevo con el identificador correcto, borrar el equivocado y, si ya estaba marcado en algún grupo, marcar la casilla nueva en ese grupo. Lo que sí se puede corregir en cualquier momento son los nombres (por ejemplo, para agregar la traducción a otro idioma) y el tipo (por ejemplo, para mover una casilla de "Modulos" a "Extensiones"). Cualquier cambio en esos dos datos se refleja de inmediato en la pantalla de Grupos de Usuarios.

Borrar un permiso

El enlace rojo "Borrar" no borra a la primera. Abre una ventanita de confirmación que dice "Deseas borrar este permiso? Cualquier grupo que lo tuviera activado lo perdera." con dos botones, "Si, borrar" y "No". A diferencia de los grupos, aquí no hay ningún permiso protegido: todos se pueden borrar, y por eso conviene pensarlo dos veces.

Esto es lo que se puede esperar al confirmar: el permiso desaparece del catálogo, su casilla ya no aparece en la pantalla de Grupos de Usuarios y no se puede volver a marcar en ningún grupo. Y, como el grupo Admin se calcula tomando todos los permisos que existan en el catálogo, deja de incluirlo también y baja su contador de "Permisos activos".

El borrado no elimina la pantalla a la que ese permiso se refería: la pantalla sigue existiendo, solo que ya no hay casilla para repartirla entre grupos. Si se borra un permiso por error, no pasa nada irreparable: se vuelve a crear con el mismo identificador (el mismo, letra por letra) y tipo, y la casilla regresa a Grupos de Usuarios. Después de recrearlo, conviene entrar a Grupos de Usuarios y revisar que las casillas estén como se necesitan.

Qué te toca a ti

Con esto tienes el cuadro completo del trío. Permisos mantiene el catálogo de llaves; en Grupos de Usuarios se arman los llaveros con esas llaves; y en Usuarios, que sí es tuya, le entregas a cada persona de tu equipo el llavero que le toca.

De este artículo llévate una idea práctica: si algo que esperas ver en tu menú no aparece (una extensión nueva, por ejemplo), hay dos lugares donde conviene revisar primero: que el permiso ya exista en el catálogo, y que el grupo de esa cuenta lo tenga marcado. En los dos casos, quien lo resuelve es el Admin Principal.