Branding avanzado para páginas de entrada

Las plantillas de entrada usan 2 aplicaciones: login y resetpass Estas dos aplicaciones acceden una plantilla principal, que en cambio cargan subplantillas. login accede a la plantilla main.tmpl mientras que resetpass accede a resetpass.tmpl

Importante: Todas las variables y funciones mostradas en este documento son funciones y variables globales. Esto se debe a queTemplate::Toolkit no permite variables de alcance dinámico (scoping).

La aplicación `login`

En la aplicación de entrada, se llama la plantilla main.tmpl en cada página. Las subplantillas se incluyen en main.tmpl según el valor del parámetro page_to_show. Estas funciones solo están disponibles en plantillas que usan main.tmpl Usted no puede acceder estas funciones y variables por medio de resetpass.tmpl

Variable o función	Tipo	Descripción
logout	boolean	Indica si el usuario acaba de salir del sistema. `1` indica que el usuario acaba de salir.
login_messages	hash	Un hash de mensajes que el navegador puede mostrar dinámicamente por medio de JavaScript.
http_status_code	cadena	El código de estatus HTTP que el usuario encuentra.
app_name	cadena	El servicio de cPanel que se accede: `cpaneld` — La interfaz de cPanel. `whostmgrd` — La interfaz de WHM. `webmaild` — La interfaz de webmail.
reset_pass	boolean	Indica si la interfaz del usuario debe mostrar los controles para reiniciar la contraseña del usuario.
page_to_show	cadena	La página a mostrar, que corresponde con uno de los siguientes nombres de plantilla: `login` — La interfaz regular de entrada. `token_denied` — La interfaz que aparece cuando se niega el token del usuario. `passthrough` — La página de redirección que aparece cuando el usuario se autentica nuevamente, después de un token incorrecto. `access_denied` — La interfaz que aparece cuando el usuario escribe un nombre de usuario y contraseña incorrectos. `referrer_denied` — Aparece cuando se niega el enlace de referencia a una página. `fourohfour` — La página de error 404 HTTP.
display_locales()	función	Esta función busca una lista de locales disponibles al usuario, en una lista de hash. No acepta argumentos. Por ejemplo: `{ tag:"de", nombre:"Deutsch" }, { tag:"en", nombre:"English" }, { tag:"fr", nombre:"Français" }`

La aplicación `resetpass`

En la aplicación resetpass la plantilla resetpass.tmpl se carga para cada sesión de HTTP. Desde ese punto, el parámetropage_to_show carga la subplantilla que se va a usar.

Cuando la aplicación resetpass envía un correo de confirmación, se usan las plantillas resetpass-email.tmpl y resetpass-email-html.tmpl.

Variable	Tipo	Descripción
page_to_show	cadena	La página a mostrarse corresponde con uno de estos nombres de plantilla: `resetpass_no_user` — Esta plantilla se usa cuando un usuario pulsa el enlace Reset Password sin escribir su nombre de usuario. (`resetpass_no_user.tmpl`). `resetpass_confirmation` — Esta plantilla se usa cuando un usuario trata de reiniciar la contraseña. El usuario debe escribir el código de confirmación que recibe en su correo electrónico. Debe usar el código para reiniciar la contraseña (`resetpass_confirmation.tmpl`). `resetpass_success` — Se usa cuando un usuario reinicia exitosamente su contraseña (`resetpass_success.tmpl`).
notice_text	cadena	El aviso a mostrarse en la página, si alguno existe.
notice_class	cadena	La clase de HTML para el aviso en `notice_text`.

Globales

Global	Tipo	Descripción
locale	instancia de objeto hash Cpanel::Locale	Este objeto corresponde al local que resulta de la lógica descrita en la sección ¿Cómo se determina el local del navegador del usuario? Sus métodos y propiedades dan valores apropiados para el local determinado. Por ejemplo, en inglés, `locale.numf('1000')` mostrará`1,000`. Mientras tanto, en alemán `locale.numf('1000')` mostrará `1.000`.
MagicRevision()	función	La función `MagicRevision()` es un sistema de caché. Un URL de MagicRevision tiene el horario de modificación de un archivo incrustado en la ruta del URL. `cpsrvd` reconoce esta ruta y la elimina. Seguido, sirve el archivo como fue guardado por el navegador, en vez de recargar la imagen del disco, mientras no se haya modificado el archivo. Usar esta función mejorará los tiempos de carga para los usuarios y disminuirá la E/S de disco del sistema.
get_theme_url()	función	Esta función busca los archivos pedidos en `/usr/local/cpanel/base/unprotected/` y en`/usr/local/cpanel/base/unprotected/$themename/` y sirve el primer archivo correspondiente. Buscará un archivo que corresponda al nombre de archivo solicitado, con o sin el nombre de la aplicación. Por ejemplo, si se solicita `logo.png`, la función tratará también de encontrar`logo_whostmgr.png`. ¡Ojo!: Esta función no pasa valores por `MagicRevision()`. Usted debe pasar los URL para recursos de página por la función `MagicRevision()` antes de que se impriman en la página. Por ejemplo: `<img src="[% MagicRevision( get_theme_url('logo.png') ) %]" alt="logo">`

Cómo se determina el local del navegador del usuario

cPanel & WHM 11.32 presentó una pantalla de entrada localizada. Esta pantalla les permite a los usuarios seleccionar un local para su sesión al entrar al sistema. Hay varios factores que determinan el local que usuario puede ver al entrar al sistema.

Esta sección describe cómo el local se determina cuando el usuario trata de entrar a cPanel, WHM o webmail.

El parámetro de cadena de búsqueda locale, ubicado dentro del URL, recibe la prioridad más alta cuando se determina el local que el usuario debe ver.
- Por ejemplo, https://ejemplo.com:2083/login?locale=ru configuraría el local para ruso en la pantalla de entrada. Este valor también configurará la cookie session_locale para la sesión entera. Esto sobrescribe el local de la cuenta configurado.
- ¡Ojo!: Las cookies session_locale son válidas por 1 año.
Si el navegador del usuario ya ha configurado la cookie session_locale, la pantalla de entrada usará el local especificado en la pantalla de entrada y durante la sesión de la aplicación.
Si ninguno de los valores mostrados anteriormente se han configurado y el navegador envía el encabezado Accept-Language el sistema de login usará el local principal válido que corresponde con el valor del encabezado Accept-Language.
- ¡Ojo!: No todos los navegadores permiten esta variable.
Si ninguno de los parámetros anteriores se han configurado, el sistema login usará el local configurado por la variableserver_locale en /var/cpanel/cpanel.config. Usted puede configurar server_locale en la interfaz Tweak Settings de WHM bajo la pestaña System.
Si ninguna de las condiciones indicadas anteriormente se cumplen, el sistema de entrada usará el local para inglés de EEUU por predeterminación.