Documentation Home> AllDocumentation/Es/WHMDocsEsEditAttach

Branding avanzado para páginas de entrada

Para la versión 11.32 de cPanel & WHM

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

PICK Importante: Todas las variables y funciones mostradas en este documento son funciones y variables globales. Esto se debe a que Template::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ámetro page_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.
note ¡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?

Con cPanel & WHM 11.32 se presenta 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.

  1. 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.
    • note ¡Ojo!: Las cookies session_locale son válidas por 1 año.
  2. 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.
  3. 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.
    • note ¡Ojo!: No todos los navegadores permiten esta variable.
  4. Si ninguno de los parámetros anteriores se han configurado, el sistema login usará el local configurado por la variable server_locale en /var/cpanel/cpanel.config. Usted puede configurar server_locale en la interfaz Tweak Settings de WHM bajo la pestaña System.
  5. Si ninguna de las condiciones indicadas anteriormente se cumplen, el sistema de entrada usará el local para inglés de EEUU por predeterminación.

Edit | Attach | Print version | History: r3 < r2 < r1 | Backlinks | Raw View | More topic actions
Topic revision: r3 - 04 Apr 2012 - 15:33:06 - Main.RosieArcelay