Changes between Initial Version and Version 1 of DocumentacionUsuario1.1.0/MenuPersonalizado

Timestamp:

Sep 26, 2017, 11:23:29 AM (7 years ago)

Author:

irina

Comment:

--

DocumentacionUsuario1.1.0/MenuPersonalizado

@@ +1 @@
+
+[[PageOutline(2-5,Índice)]]
+= Creación de menús de inicio personalizados para los ordenadores clientes =
+
+Los menús de inicio de los clientes OpenGnsys se gestionan desde la consola de administración.
+
+Según la forma de crearse y cómo trabajan sobre el cliente podemos distinguir dos tipos de menús:
+
+* '''automáticos''':
+        * Se generan utilizando acciones definidas en la consola de administración (comandos o tareas)
+        * Al pulsar un enlace informan al servidor de administración y este envía el comando al cliente.
+        * Se puede realizar un seguimiento del comando en la cola de acciones.
+* '''personalizados''':
+        * Se generan como una página html o php normal, incrustando en los enlaces llamadas a los script de opengnsys o cualquier comando bash de linux.
+        * Al pulsar el enlace se ejecuta el comando en local sin dar información a la consola de administración.
+
+Los menús pueden contener una zona pública que podrán usar todos los usuarios y otra privada que sólo podrán ver los operadores del aula y los administradores.
+
+Los menús personalizados se gestionan de forma análoga a los automáticos, en esta página sólo documentamos las diferencias existentes entre ambos. 
+
+== Creación de menús personalizados ==
+
+=== Características del menú personalizado ===
+
+Opengnsys nos permite crear menú personalizados. Normalmente se sitúan en el directorio /opt/opengngsys/www/menus aunque podrían estar incluso en otro servidor.
+
+Son páginas web estandar, la única diferencia es que podemos incluir enlaces que llamen a un comando que se ejecutará sobre el cliente. Estos enlaces pueden pedir confirmación para ejecutar el comando o no. 
+
+La url del enlace tiene que tener el siguiente formato. 
+
+ * Enlace sin confirmación:
+
+{{{
+<a href=”command:nombre_comando”>Texto</a>
+}}}
+
+ * Enlace con confirmación:
+
+{{{
+<a href="commandwithconfirmation:nombre_comando”>Texto</a>
+}}}
+
+Normalmente utilizaremos la confirmación en las acciones que sean destructivas, como por ejemplo restaurar una imagen.
+
+Se puede ejecutar cualquier comando o script de bash, entre ellos los específicos de opengnsys (situados en /opt/opengnsys/client/script). Las funciones incluidas en las librerías (ej: ogGetIpAddress) no se podrán ejecutar si no se llaman en un script.
+
+Tenemos un ejemplo de [source:branches/version1.1/admin/WebConsole/menus/menuejemplo.php menú personalizado], al instalar opengnsys se copia como ejemplo en la carpeta adecuada.
+
+=== Enlazando el menú personalizado con el menú creado en la consola ===
+
+En las propiedades del menú vacío definido en la consola tendremos que incluir la url completa de la página del menú personalizado. Observamos que existe una parte pública y otra privada, pudiendo definir un menú personalizado independiente para cada una de ellas.
+
+[[Image(formularioPropiedadesMenu.png)]]
+
+
+La configuración de menú personalizado se superpone a la automática, de forma que si existierán item automáticos no se mostrarían.
+
+== Zona privada del menú ==
+
+En la zona privada del menú pueden entrar los usuarios administradores y los operadores de aulas.
+
+El menú en la parte pública mostrará un enlace llamado "administración" y al pinchar sobre él nos pedirá usuario y clave, si los datos son correctos veremos las operaciones de la zona privada del menú.
+
+{{{
+<p><a href="../varios/acceso_operador.php?iph=<?php echo $_SERVERREMOTE_ADDR? ?>">Administración</a></p>
+}}}
+
+Para salir de la zona privada daremos al enlace "volver"
+
+{{{
+<p><a href="../varios/menucliente.php?iph=<?php echo $_SERVERREMOTE_ADDR? ?>">Volver</a></p>
+}}}
+
+Tenemos un ejemplo de [source:branches/version1.1/admin/WebConsole/menus/privatemenu.php menú privado] conteniendo el enlace necesario para volver a la zona pública.