Diferencia entre revisiones de «SIU-Arai/usuarios/templates-login»
(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 | + | == 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
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:
Luego, tenemos que inicializar las dependencias del mismo:
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:
-
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 escomposer-package
-
class
el namespace y clase del template -
dir
el directorio donde se descargó el template
-
-
default
El template que se utiliza por defecto. Para nombrarlo se utilizan los identificadores creados en la sección anterior -
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