Diferencia entre revisiones de «SIU-Arai/usuarios/templates-login»

De SIU
Saltar a: navegación, buscar
(se agrega ejemplo de configuración del template)
 
Línea 5: Línea 5:
 
Luego hay que descargarlos en un directorio accesible para Araí-Usuarios y por último hay que configurar Araí-Usuarios para que lo utilice.
 
Luego hay que descargarlos en un directorio accesible para Araí-Usuarios y por último hay que configurar Araí-Usuarios para que lo utilice.
  
== Configuración de Araí-Usuarios ==
+
== Instalación del template ==
 +
 
 +
Lo primero es descargarse el template en el servidor donde tengamos corriendo Araí-Usuarios. Para este ejemplo, utilizamos el template base que se proporciona por el SIU:
 +
<syntaxhighlight lang="bash" enclose="div">
 +
git clone https://github.com/SIU-Toba/inline-template.git unx-template
 +
</syntaxhighlight>
 +
 
 +
Luego, tenemos que inicializar las dependencias del mismo:
 +
<syntaxhighlight lang="bash" enclose="div">
 +
cd unx-template
 +
composer install
 +
</syntaxhighlight>
 +
 
 +
== Configuración en Araí-Usuarios ==
 
La configuración de los templates de login se hace desde el archivo <code>config/idp.yml</code>, este archivo tiene una sección <code>templates_login</code>, se puede ver un ejemplo en el [https://hub.siu.edu.ar/siu-arai/arai-usuarios/blob/develop/templates/config/idp.yml.dist#L25 archivo de template].
 
La configuración de los templates de login se hace desde el archivo <code>config/idp.yml</code>, este archivo tiene una sección <code>templates_login</code>, se puede ver un ejemplo en el [https://hub.siu.edu.ar/siu-arai/arai-usuarios/blob/develop/templates/config/idp.yml.dist#L25 archivo de template].
  
Línea 15: Línea 28:
 
# <code>default</code><br /> El template que se utiliza por defecto. Para nombrarlo se utilizan los identificadores creados en la sección anterior
 
# <code>default</code><br /> El template que se utiliza por defecto. Para nombrarlo se utilizan los identificadores creados en la sección anterior
 
# <code>usage</code><br /> Se especifica por aplicación cuál template se quiere utilizar. Las aplicaciones se nombran por su ID. Este se puede ver desde la UI de Araí-Usuarios
 
# <code>usage</code><br /> Se especifica por aplicación cuál template se quiere utilizar. Las aplicaciones se nombran por su ID. Este se puede ver desde la UI de Araí-Usuarios
 +
 +
Tomando como ejemplo, para cambiar el template de login de forma genérica para todas las aplicaciones, se configura de la siguiente forma:
 +
 +
<syntaxhighlight lang="bash" enclose="div">
 +
    ...
 +
    templates_login:
 +
        definition:
 +
            unx:
 +
                type: composer-package
 +
                class: \SIU\InlineTemplate\Builder
 +
                dir: /ruta/a/unx-template
 +
        default: unx
 +
 +
</syntaxhighlight>

Revisión actual del 15:08 19 oct 2017

Siu-arai iso.png

Cambiando el template de página de login

Los templates se construyen así.

Luego hay que descargarlos en un directorio accesible para Araí-Usuarios y por último hay que configurar Araí-Usuarios para que lo utilice.

Instalación del template

Lo primero es descargarse el template en el servidor donde tengamos corriendo Araí-Usuarios. Para este ejemplo, utilizamos el template base que se proporciona por el SIU:

git clone https://github.com/SIU-Toba/inline-template.git unx-template

Luego, tenemos que inicializar las dependencias del mismo:

cd unx-template
composer install

Configuración en Araí-Usuarios

La configuración de los templates de login se hace desde el archivo config/idp.yml, este archivo tiene una sección templates_login, se puede ver un ejemplo en el archivo de template.

La configuración está dividida en tres partes:

  1. definition
    En esta sección se definen los templates que se pueden utilizar.
    A cada template hay que asignarle un identificador, puede ser cualquier identificador válido de PHP.
    Para cada definición hay que setear tres valores
    • type tipo de paquete del template, por ahora el único valor válido es composer-package
    • class el namespace y clase del template
    • dir el directorio donde se descargó el template
  2. default
    El template que se utiliza por defecto. Para nombrarlo se utilizan los identificadores creados en la sección anterior
  3. usage
    Se especifica por aplicación cuál template se quiere utilizar. Las aplicaciones se nombran por su ID. Este se puede ver desde la UI de Araí-Usuarios

Tomando como ejemplo, para cambiar el template de login de forma genérica para todas las aplicaciones, se configura de la siguiente forma:

    ...
    templates_login:
        definition:
            unx:
                type: composer-package
                class: \SIU\InlineTemplate\Builder
                dir: /ruta/a/unx-template
        default: unx