Diferencia entre revisiones de «SIU-Arai/usuarios/templates-login»
(Página creada con «= Cambiando el template de página de login = Para manejar Creando templates para las páginas de login») |
(se agrega ejemplo de configuración del template) |
||
(No se muestran 2 ediciones intermedias de otro usuario) | |||
Línea 1: | Línea 1: | ||
+ | [[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]] | ||
= Cambiando el template de página de login = | = Cambiando el template de página de login = | ||
− | + | Los templates se construyen [[SIU-Arai/usuarios/templates|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: |
+ | <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 está dividida en tres partes: | ||
+ | # <code>definition</code><br />En esta sección se definen los templates que se pueden utilizar. <br/> A cada template hay que asignarle un identificador, puede ser cualquier identificador válido de PHP.<br/> Para cada definición hay que setear tres valores | ||
+ | #* <code>type</code> tipo de paquete del template, por ahora el único valor válido es <code>composer-package</code> | ||
+ | #* <code>class</code> el namespace y clase del template | ||
+ | #* <code>dir</code> el directorio donde se descargó el template | ||
+ | # <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 | ||
+ | |||
+ | 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