WS.WebTV: Consideraciones generales para editar las plantillas de WS.WebTV (Personalización Avanzada).
soporte, ws.webtv, personalización, avanzada, crear, plantilla, canal
WS.WebTV utiliza el framework Javascript "jQuery".
Si va a utilizar script basados en jQuery , tenga presente que no es necesario que lo agregue la sección <head> de las plantillas puesto que ya está incluido.
Versión de jQuery:
WS.WebTV soporta, y ha sido verificado, hasta la versión 1.9.1 de jQuery y 1.10.3 de jQueryUI; no obstante lo anterior, se continúa utilizando la versión 1.7.2 debido a que es más rápida que la 1.9.1, en varios casos, especialmente con Internet Explorer.
jQuery 2.0: No se ha verificado el soporte de jQuery 2.0 debido a que no es compatible con Internet Explorer 7 y 8 y WS.WebTV ha hecho un especial énfasis en conseguir una buena compatibilidad con navegadores Web antiguos.
¿Cómo cambiar de la versión 1.7.2 a la versión 1.9.1 de jQuery?
Debe editar el archivo de configuración de la WebTV ( config/Config.inc.php ) y añadir las siguientes líneas:
$JQUERY_URL = '//ajax.googleapis.com/ajax/libs/jquery/1.9.1/jquery.min.js';
$JQUERY_UI_URL = '//ajax.googleapis.com/ajax/libs/jqueryui/1.10.3/jquery-ui.min.js';
Ud. siempre debe utilizar URLs absolutas para referenciar imágenes, CSS y Scripts.
1. Referenciando un archivo localizado en una carpeta del tema actual:
{k.dir_public_frontend}/{k.theme}/carpeta/nombre_archivo.ext
Ejemplo. Referenciando una imagen localizada en la carpeta images del tema actual:
<img src="{k.dir_public_frontend}/{k.theme}/images/mi_imagen.jpg" alt="" >
2. Referenciando un archivo localizado en una carpeta del estilo del tema actual:
{k.dir_public_frontend}/{k.theme}/carpeta_{k.style}/nombre_archivo.ext
Ejemplo. Referenciando una imagen localizada en la carpeta images del estilo actual (del tema actual):
<img src="{k.dir_public_frontend}/{k.theme}/images_{k.style}/mi_imagen.jpg" alt="" >
Inclusión de archivo: {k.incl.archivo.tpl}
Si desea incluir una plantilla, dentro de otra plantilla, utilice esta etiqueta. Ejemplo:
{k.incl.inc_header.tpl}
Lo anterior incluirá el contenido del archivo "inc_header.tpl" dentro de la plantilla que contiene la etiqueta.
NOTA: Sólo es posible un nivel de "anidado".
Volcado de datos del usuario: {k.user.índice_dato}
Para volcar datos del la sesión del usuario. Ejemplo:
{k.user.alias}
Lo anterior devolverá el Alias del usuario. Ejemplos de posibles etiquetas:
{k.user.id}, {k.user.login}, {k.user.alias}, {k.user.name}, {k.user.surname}, {k.user.email}, {k.user.country}, {k.user.telephone}, {k.user.web}
NOTA: Estas etiquetas se utilizan normalmente dentro de bloques condicionales de sesión (ver más abajo).
Bloque condicional de sesión (Sesión Activa): <kuser:loggedin> ... </kuser:loggedin>
Cualquier código HTML que se encuentre dentro de estos tags será eliminado si el usuario no ha iniciado sesión. Ejemplo:
<kuser:loggedin>
<a href="#">Cerrar Sesión</a>
</kuser:loggedin>
El enlace "Cerrar Sesión", del ejemplo anterior, sólo aparecería si el usuario tiene una sesión activa.
Bloque condicional de sesión (Sin Iniciar Sesión): <kuser:loggedout> ... </kuser:loggedout>
Cualquier código HTML que se encuentre dentro de estos tags será eliminado si el usuario tiene una sesión activa. Ejemplo:
<kuser:loggedout>
<a href="#">Iniciar Sesión</a>
</kuser:loggedout>
El enlace "Iniciar Sesión", del ejemplo anterior, sólo aparecería si el usuario no ha iniciado sesión.
Bloque condicional de sesión (Nivel de Acceso): <kaccesslevel:n> ... </kaccesslevel:n>
Estos tags se utilizan principalmente en las plantillas del Back-End. Cuando el Nivel de Acceso del usuario actual es inferior al especificado en estos tags, el código HTML que se encuentre encerrado por éstos será eliminado.
La condición es: El "número" del Nivel de Acceso del usuario debe ser igual o inferior que "n" (un número menor significa un mayor Nivel de Acceso)
Ejemplo:
<kaccesslevel:1>
<a href="#">Configuración</a>
</kaccesslevel:1>
El enlace "Configuración", del ejemplo anterior, sólo aparecerá si el usuario actual es Admin o Webmaster.
Niveles de Acceso: 0 = Webmaster | 1 = Admin | 2 = Autor | 3 = Colaborador | 4 = Suscriptor de Pago | 5 = Suscriptor Gratuito. Más info.
Volcado de datos del CMS: {k.html.índice_dato}
Esta etiqueta se utiliza para volcar data del CMS; estas etiquetas pueden variar entre páginas. Ejemplo:
{k.html.channel_title}
El ejemplo anterior devolverá el título del Canal, cuando se utiliza en la plantilla de Canal.
NOTAS:
-
Estas etiquetas no pueden ser renombradas porque reflejan índices de estructuras de datos internas. Sin embargo, Ud. puede eliminarlas (o reposicionarlas/duplicarlas) libremente, si lo require.
- (Desde WS.WebTV V3.1 R50) En caso de que necesite incluir una de estas etiquetas en un campo de datos del Back-End (por ejemplo, en los campos de "Código HTML Adicional" / secciones <head> y </body>) entonces debe incluirlas como {html.índice_dato} , de lo contrario es posible que se pierdan o reemplacen al guardar.
Bloque de bucle: <kloop:loop_name> ... </kloop:loop_name>
All the HTML code inside these tags will be processed by the CMS, in a loop. Inside the loop there can be any of the CMS labels detailed in this document as well as loop-specific labels like {k.loop.value.data_index}
NOTA: Estas etiquetas no pueden ser renombradas porque reflejan índices de estructuras de datos internas. Sin embargo, Ud. puede modificar libremente el código HTML que se encuentre dentro del bloque del bucle; o incluso eliminar (o reposicionar) el bloque entero, si lo require.
Etiquetas especiales del Front-End: {k.html.fe_tpl_file}, {k.html.fe_action} (Desde WS.WebTV V3.1 R50)
Si necesita imprimir el nombre del archivo de plantilla actual, del Front-End, puede utilizar las etiquetas {k.html.fe_tpl_file} o {html.fe_tpl_file} .
Si necesita imprimir la acción/sección actual, del Front-End, puede utilizar las etiquetas {k.html.fe_action} o {html.fe_action} .
Volcado de texto de un pack de idioma (Front-End): {k.lang.fe.índice_texto_pack_idioma}
Esta etiqueta se utiliza para volcar texto del pack de idioma del Front-End. Ejemplo:
{k.lang.fe.published_by}
Lo anterior devolverá del texto "Published By", si el idioma inglés está seleccionado para el Front-End.
NOTA: El índice debe existir en el pack de idioma para poder obtener el valor asociado.
Volcado de texto de un pack de idioma (Back-End): {k.lang.be.índice_texto_pack_idioma}
Esta etiqueta se utiliza para volcar texto del pack de idioma del Back-End. Ejemplo:
{k.lang.be.channels}
Lo anterior devolverá del texto "Channels", si el idioma inglés está seleccionado para el Back-End.
NOTA: El índice debe existir en el pack de idioma para poder obtener el valor asociado.