Saltar al contenido principal
pdf?stylesheet=default
Blackboard Help

Variables comunes del diseño Express

Las variables del diseño Express se utilizan para agregar información de forma dinámica a los archivos de diseño Express, como header.html, footer.html y core.css. Cuando el tema Express sube un archivo de diseño Express, las variables se remplazan con los datos de Moodle que representan. Por ejemplo, %WWWROOT% se reemplaza con la URL base del sitio –, por lo general, http://<client name>.mrooms.net.

Esta página incluye un listado de todas las variables de diseño Express. Estas variables se pueden utilizar en una plantilla Express, pero sus valores no se remplazan hasta que el tema Express lee los archivos de diseño. La lista está agrupada según donde normalmente se usa la variable. Algunas variables solo se pueden usar en header.html o footer.html.

Variables de navegación

  • %BREADCRUMB%: Muestra la línea de la barra de navegación, que muestra al usuario dónde está en el sitio, junto con el botón Activar edición y el menú Cambiar rol a... , según los permisos del usuario.
  • %DOCLINK%: Muestra los enlaces centrales a documentos de ayuda de Moodle, que, por lo general, apuntan a docs.moodle.org.
  • %EXPRESSMENU%: Muestra el archivo menu.html y el JavaScript necesario para convertirlo en un menú YUI.
  • %HEADERID%: Se utiliza para agregar un atributo de ID dinámico para una etiqueta div. Los valores son “header,” “header-home,” o “header-none,” según dónde se encuentre el usuario en el sitio.
  • %HEADING%: Muestra un valor en la variable de encabezado (por lo general, este es el nombre completo del sitio).
  • %HOMELINK%: Muestra el botón Página principal, que dirige al usuario de vuelta a la página principal. La aplicación establece las páginas en las cuales se muestra este botón.
  • %LANGMENU%: Muestra el menú desplegable Elegir idioma, que le permite al usuario elegir el idioma en que se visualiza la interfaz. Esto exige que el archivo manifest.xml tenga la etiqueta de diseño para el diseño que mostrará el menú de idiomas:

    &lt;options&gt;langmenu=true&lt;/options&gt;

  • %LOGGEDINAS%: Muestra solo el área Usted se ha identificado como sin el selector del menú de idiomas.
  • %MENU%: Muestra el menú Elegir idioma , el texto Usted se ha identificado como y los enlaces para iniciar sesión en el sitio. Muestra menú Saltar a en una actividad. Esto exige que el archivo manifest.xml tenga la etiqueta de diseño para el diseño que mostrará el menú de idiomas:

    &lt;options&gt;langmenu=true&lt;/options&gt;

  • %MRHELPLINKS%: Enlaza al sitio de soporte.
  • %PERFORMANCEINFO%: Muestra la información de rendimiento sobre el tiempo de carga de la página y las consultas de la base de datos.
  • %SWITCHTHEME%: Imprime un cambio al tema Mobile o al sitio completo cuando un usuario ha accedido al sitio dese un navegador móvil.
  • %SWITCHROLE%: Imprime un regreso al rol o inicia sesión con el nombre de usuario cuando un usuario ha cambiado su rol o ha iniciado sesión como otro usuario, respectivamente.
  • %VALIDATORS%: Muestra los enlaces a las validaciones HTML de la aplicación.

Variables de región de bloque

Las variables de región muestran los bloques y el contenido que ha sido asignado a esa región. Para que las variables de región funcionen, la región debe agregarse al archivo manifest.xml del diseño Express en una etiqueta de región, que forma parte de la etiqueta de diseño. Si la región no está configurada para el diseño dentro del archivo manifest.xml, entonces la variable de región de bloque de diseño Express no mostrará los bloques de esa región.

  • %BLOCKREGION1%: Una región de bloque personalizado se puede colocar en cualquier parte dentro de la estructura del diseño. Esto permite a los clientes personalizar sus diseños de formas nuevas y exclusivas.
  • %BLOCKREGION2%: Una región de bloque personalizado se puede colocar en cualquier parte dentro de la estructura del diseño. Esto permite a los clientes personalizar sus diseños de formas nuevas y exclusivas.
  • %BLOCKREGION3%: Una región de bloque personalizado se puede colocar en cualquier parte dentro de la estructura del diseño. Esto permite a los clientes personalizar sus diseños de formas nuevas y exclusivas.
  • %BLOCKREGION4%: Una región de bloque personalizado se puede colocar en cualquier parte dentro de la estructura del diseño. Esto permite a los clientes personalizar sus diseños de formas nuevas y exclusivas.
  • %MAIN%: Se utiliza para la columna central del archivo de diseño de página Flexpage y se puede reutilizar en otros diseños, así como también en una región de bloque personalizado.
  • %MAINCONTENT%: El contenido principal de una página del curso; por lo general, la columna central, que contiene las actividades y los recursos.
  • %SIDEPOST%: La región derecha del bloque para la mayoría de los archivos de diseño. Esta es una región estándar.
  • %SIDEPRE%: La región izquierda del bloque para la mayoría de los archivos de diseño. Esta es una región estándar.
  • %SIDETOP%: La región superior del bloque en un diseño de página Flexpage. También se puede utilizar para agregar una región superior del bloque a cualquier otro archivo de diseño.

Variables del curso

  • %ACTIVITYNAVARROWS%: Muestra las flechas Anterior y Siguiente que están vinculadas a las actividades anteriores y siguientes en el curso, según la ubicación de las actividades en las secciones del curso. Estas solo se deberían utilizar en incourse.html. Es necesario que el filtro de flechas de navegación de la actividad esté activado por Moodlerooms y habilitado para el sitio.
  • %COURSEACTIVITIESYUI%: Crea un menú YUI para todas las secciones y las actividades dentro de cada sección. Es mejor utilizarlo en el menú Express, pero se puede utilizar por sí mismo si un desarrollador entiende cómo funciona el menú YUI. Habilitar el menú de personalización de las Actividades del curso debe estar configurado como “Sí” en los ajustes del sitio Express para que esta variable funcione.

    Esta función podría generar problemas de rendimiento con una gran cantidad de cursos.

  • %COURSEFULLNAME%: Muestra el nombre completo del curso en el que el usuario se encuentra actualmente.
  • %COURSEID%: Muestra el número de ID del curso. Se debe utilizar para crear enlaces dinámicos al curso, el módulo, el bloque o el perfil del usuario.
  • %COURSESHORTNAME%: Muestra el nombre corto del curso en el que el usuario se encuentra actualmente.
  • %COURSESUMMARY%: Muestra el resumen del curso.
  • %COURSEVISIBLE%: Muestra el valor 1 si el curso está configurado para estar a disposición de los estudiantes; de lo contrario, muestra el valor 0.
  • %COURSEHEADER%: Muestra el encabezado del curso para el formato del curso, si se lo ha configurado.
  • %COURSECONTENTFOOTER%: Muestra el pie de página del contenido del curso para el formato del curso, si se lo ha configurado.
  • %COURSECONTENTHEADER%: Muestra el encabezado del contenido del curso para el formato del curso, si se lo ha configurado.
  • %COURSEFOOTER%: Muestra el pie de página del curso para el formato del curso, si se lo ha configurado.
  • %CUSTOMIMAGE%: Muestra el logotipo que se ha subido al sitio, la categoría o el curso mediante la pestaña Crear un diseño del bloque Express.

  • %JOULEGRADERLINK%: Un enlace al calificador de Joule según dónde se encuentre el usuario en el curso (curso o actividad), junto con la cadena de idioma para el calificador de Joule.
  • %GRADELINKSLIST%: Todos los enlaces al informe del calificador que el usuario tiene permiso parar ver.

Variables Flexpage

  • %FPPREVIOUSBUTTON%: Imprime el botón anterior si la página Flexpage está configurada para mostrarlo y si tiene una página Flexpage después de la página Flexpage actual en la jerarquía de páginas Flexpage.
  • %FPNEXTBUTTON%: Imprime el botón siguiente si la página Flexpage está configurada para mostrarlo y si tiene una página Flexpage antes de la página Flexpage actual en la jerarquía de páginas Flexpage.
  • %FPTABS%: Muestra solo el menú Flexpage que está configurado para ser la pestaña superior.

Variables de mensajería

  • %ALERTBADGE%: Muestra el ícono de mensajes de la insignia de la alerta y una ventana expandible con las alertas dentro de ella.

Variables del sitio

  • %SITEFULLNAME%: Muestra el nombre completo del sitio.
  • %SITESHORTNAME%: Muestra el nombre corto del sitio.
  • %SITESUMMARY%: Muestra el resumen del sitio.

Variables del usuario

  • %ADDRESS%: Muestra la dirección del usuario tal como aparece en el perfil del usuario.
  • %CITY%: Muestra la ciudad del usuario tal como aparece en el perfil del usuario.
  • %COUNTRY%: Muestra el país del usuario tal como aparece en el perfil del usuario.
  • %DEPARTMENT%: Muestra el departamento del usuario tal como aparece en el perfil del usuario.
  • %EMAIL%: Muestra la dirección de correo electrónico del usuario tal como aparece en el perfil del usuario.
  • %FIRSTNAME%: Muestra el nombre del usuario tal como aparece en el perfil del usuario.
  • %IDNUMBER%: Muestra el número de ID del usuario tal como aparece en el perfil del usuario.
  • %INSTITUTION%: Muestra la institución del usuario tal como aparece en el perfil del usuario.
  • %LASTNAME%: Muestra el apellido del usuario tal como aparece en el perfil del usuario.
  • %MYCOURSES%: Muestra una lista de etiquetas HTML <li> para cada curso en el que el usuario está matriculado. Un diseño Express debería incluir una etiqueta HTML de lista ordenada o lista desordenada en torno a esta variable. Se utiliza a menudo en una lista desplegable de JavaScript, en el encabezado del diseño.
    Ejemplo: <ul id=”mycourses”>%MYCOURSES%</ul> Habilitar Mis cursos debe estar configurado como “Sí” en los ajustes del sitio Express para que esta variable funcione.

    Esta función podría generar problemas de rendimiento con una gran cantidad de cursos.

  • %MYCOURSESYUI%: Muestra un elemento de menú YUI apropiado que contiene los cursos que los que el usuario está matriculado. Es mejor utilizarlo en el menú Express, pero se puede utilizar por sí mismo si un desarrollador entiende cómo funciona el menú YUI. Habilitar Mis cursos debe estar configurado como “Sí” en los ajustes del sitio Express para que esta variable funcione.
  • %PHONE1%: Muestra el número de teléfono del usuario tal como aparece en el perfil del usuario.
  • %PHONE2%: Muestra el número de teléfono móvil del usuario tal como aparece en el perfil del usuario.
  • %PICBIG%: Muestra la etiqueta de imagen para mostrar la imagen de perfil del usuario, grande y con formato. Además, agrega una clase de CSS personalizado llamada “userpicbig” para permitir a un desarrollador personalizar la altura y el ancho de la imagen mediante un CSS.
  • %PICSML%: Muestra la etiqueta de imagen para mostrar la imagen de perfil del usuario, pequeña y con formato. Además, agrega una clase de CSS personalizado llamada “userpicsml” para permitir a un desarrollador personalizar la altura y el ancho de la imagen mediante un CSS.
  • %PICBIGURL%: Muestra la URL para mostrar la imagen de perfil del usuario, grande y con formato.
  • %PICSMLURL%: Muestra la URL para mostrar la imagen de perfil del usuario, pequeña y con formato.
  • %SESSIONKEY%: La clave de sesión actual del usuario, que se utilizará con enlaces que requieren la clave de sesión en la URL.
  • %USERID%: Muestra el número de ID del usuario. Se debe utilizar para crear enlaces dinámicos al perfil del usuario, o a bloques y actividades que usan la ID del usuario.
  • %USERNAME%: Muestra el nombre de usuario del usuario. Se puede utilizar para crear enlaces dinámicos o para mostrar al usuario que ha iniciado sesión con un nombre de usuario específico.

Variables de campos de perfil personalizado

Las variables de campos de perfil personalizado se nombran según el nombre corto asignado cuando se creó el campo de perfil personalizado. No se pueden mostrar los campos de perfil personalizado del tipo área de texto en un diseño.

Los nombres de las variables deben aparecer en letras mayúsculas con un símbolo de porcentaje (%) al comienzo y al final. Deberá habilitar los campos de perfil personalizado en los ajustes de Express (a través del bloque Administración del sitio) para usar variables de campo de perfil personalizado.

Esta función podría generar problemas de rendimiento con una gran cantidad de campos de perfil personalizado.

Ejemplo:

  • Nombre corto del campo de perfil personalizado: especialización
  • Variable del diseñador Express: %MAJOR%

Variables de la URL

  • %DESIGNDIR%: Muestra el comienzo de la URL para acceder a un archivo en el directorio de almacenamiento Express. Por lo general, se utiliza en etiquetas img y CSS para subir imágenes que se almacenan en el directorio de diseño. Remplaza a la variable mPower %SITETHEMEDIR%.
  • %WWWROOT%: Muestra el directorio raíz de la Web para su sitio.

Variables If Express

Las variables If Express ofrecen a Express una versión muy limitada de programación. Express busca un archivo de diseño para estas variables. Cuando encuentra una variable, establece si mostrar o no el código HTML entre la variable if de apertura y la variable if de cierre.

Ejemplo de uso de las variables If

IFNOTLOGGEDIN

<form action="%WWWROOT%/login/index.php" method="post" class="guestinfo">
Nombre de usuario: <input type="text" name="username" value="Username">
Contraseña: <input type="password" name="password" value="Contraseña">
<input type="submit" class="loginbutton" value="Login">
</form>

IFNOTLOGGEDIN

Express no mostrará el código HTML entre las variables IFNOTLOGGEDIN si el usuario ha iniciado sesión, pero sí lo mostrará si el usuario accede a la página como un invitado.

Opciones

  • IFHASFOOTER: Si la opción nofooter está configurada en verdadero, entonces el HTML dentro de estas variables no se imprimirá.
  • IFSHOWCOURSEHEADERFOOTER: Si la opción nocourseheaderfooter está configurada en verdadero, se mostrará el HTML de esta área. Se utiliza con las variables %COURSEHEADER%, %COURSECONTENTFOOTER%,%COURSECONTENTHEADER% y %COURSEFOOTER%.
  • IFSHOWLOGININFO: Si la opción notlogininfo está configurada en verdadero, no se mostrará el HTML de esta área.

Curso

  • IFINCOURSE: Mostrará el HTML si el usuario está en una página dentro de un curso.
  • IFSHOWCOURSEFOOTER: Si el pie de página del curso tiene contenido, entonces se muestra el HTML.

Sitio

  • IFATSITE: Mostrará el HTML si el usuario está en una página que está dentro del curso del sitio.

Flexpage

La variable if de página Flexpage muestra el HTML basado en los ajustes de página Flexpage y las regiones de bloque de página Flexpage.

  • IFHASNEXTORPREVIOUS: Si la página Flexpage está configurada para mostrar los botones siguiente o anterior, entonces se mostrará el HTML dentro de estas variables.

    Ejemplo de uso de IFHASBEXTPREVIOUS

    IFHASNEXTORPREVIOUS

    <div class="flexpage_prev_next">
    %FPPREVIOUSBUTTON%
    %FPNEXTBUTTON%
    </div>

    IFHASNEXTORPREVIOUS

  • IFHASMAIN: Si la región principal del bloque tiene bloques o si el usuario está moviendo bloques, se mostrará el HTML dentro de estas variables. Por lo general, contendrá la variable de diseño Express %MAIN% para mostrar los bloques asociados a esa región. En general, esta región solo se usa en páginas Flexpage.
  • IFHASSIDETOP: Si la región superior lateral del bloque tiene bloques o si el usuario está moviendo bloques, se mostrará el HTML dentro de estas variables. Por lo general, contendrá la variable de diseño Express %SIDETOP% para mostrar los bloques asociados a esa región. En general, esta región solo se usa en páginas Flexpage.

Regiones de bloque

Las variables if de región de bloque no mostrarán el HTML si se cumple alguna de las siguientes condiciones:

  1. La región del bloque no está en la etiqueta de regiones, en el archivo manifest.xml, para al archivo de diseño actual que se está visualizando.
  2. La opción noblocks está configurada en verdadero en el archivo manifest.xml para al archivo de diseño actual que se está visualizando.
  3. No hay bloques actualmente en la región de bloques y el usuario no está moviendo un bloque.
  4. IFHASBLOCKREGION1: Si la región personalizada blockregion1 tiene bloques o si el usuario está moviendo bloques, se mostrará el HTML dentro de estas variables. Por lo general, contendrá la variable de diseño Express %BLOCKREGION1% para mostrar los bloques asociados a esa región.
  5. IFHASBLOCKREGION2: Si la región personalizada blockregion2 tiene bloques o si el usuario está moviendo bloques, se mostrará el HTML dentro de estas variables. Por lo general, contendrá la variable de diseño Express %BLOCKREGION2% para mostrar los bloques asociados a esa región.
  6. IFHASBLOCKREGION3: Si la región personalizada blockregion3 tiene bloques o si el usuario está moviendo bloques, se mostrará el HTML dentro de estas variables. Por lo general, contendrá la variable de diseño Express %BLOCKREGION3% para mostrar los bloques asociados a esa región.
  7. IFHASBLOCKREGION4: Si la región personalizada blockregion4 tiene bloques o si el usuario está moviendo bloques, se mostrará el HTML dentro de estas variables. Por lo general, contendrá la variable de diseño Express %BLOCKREGION4% para mostrar los bloques asociados a esa región.
  8. IFHASSIDEPOST: Si la región side-post del bloque tiene bloques o si el usuario está moviendo bloques, se mostrará el HTML dentro de estas variables. Por lo general, contendrá la variable de diseño Express %SIDEPOST% para mostrar los bloques asociados a esa región. Se trata siempre del lateral derecho de una página de Joule. Por lo general, contiene el siguiente html:

    <div id="region-post" class="block-region">
    <div class="region-content">
    %SIDEPOST%
    </div>
    </div>

  9. IFHASSIDEPRE: Si la región side-pre del bloque tiene bloques o si el usuario está moviendo bloques, se mostrará el HTML dentro de estas variables. Se trata siempre del lateral izquierdo de una página de Joule. Por lo general, contiene el siguiente html:

    <div id="region-pre" class="block-region">
    <div class="region-content">
    %SIDEPRE%
    </div>
    </div>

Usuario

Las variables if de usuario muestran contenido HTML entre las variables según el estado del usuario.

  • IFSITEADMIN: Mostrará el HTML si el usuario ha sido asignado como administrador de un sitio.
  • IFLOGGEDIN: Mostrará el HTML dentro de estas variables si el usuario ha iniciado sesión.
  • IFNOTLOGGEDIN: Mostrará el HTML dentro de estas variables si el usuario no ha iniciado sesión y no se lo considera un invitado.