[[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.