ZoomBlog Logo

Etiquetas en las plantillas de ZoomBlog

Esta es una página de referencia rápida de la mayoría de las etiquetas que se pueden utilizar en las plantillas de blogs alojados en ZoomBlog. No pretende ser un manual que explique en detalle cómo crear plantillas, su estructura, etc. Más adelante, conforme el tiempo nos lo permita y vayamos recogiendo comentarios al respecto, prepararemos un documento más explicativo.

  • Definiendo etiquetas exclusivas de ZoomBlog

    Todas las etiquetas de ZoomBlog, al igual que las etiquetas HTML o XML van entre los signos < y >

    Para diferenciarlas de cualquier otro tipo de etiquetas, las etiquetas de ZoomBlog empiezan con las letras zb, seguidas de dos puntos : y el nombre de la etiqueta correspondiente, por ejemplo:

    <zb:blogName>

    No suele importar la capitalización de las etiquetas, es decir, es lo mismo poner <zb:blogName> que <zb:BlogName> o <zb:BLOGname>, etc.

  • Tres tipos de etiquetas

    Existen tres tipos de etiquetas en ZoomBlog:

    1. Variables:
      Son aquellas que luego son sencillamente sustituídas por algún valor en concreto. Por ejemplo, la etiqueta <zb:blogName> luego es sustituida por... el nombre del blog, claro :-)

    2. Definidoras de Bloques:
      Estas no son etiquetas que luego sean sustituidas por un valor, sino que definen un bloque de HTML que, dependiendo del significado de la etiqueta, será mostrado o no. Dado que definen un bloque, estas etiquetas se deben emplear dos veces - una para definir el principio del bloque, y otra para definir el final del mismo.

      Por ejemplo, la etiqueta <zb:IfCommentsLeft> ... </zb:IfCommentsLeft> se utiliza para definir un bloque que será mostrado solamente si un artículo en concreto ha recibido ya comentarios. Observa la sintaxis para definir el final del bloque, con el símbolo / al principio, al estilo HTML/XML.

    3. Funciones:
      Las funciones pueden actuar como variables, como definidoras de bloques o para tomar decisiones según el caso, entre otras cosas.

      La sintáxis de las funciones es un poquito diferente:

      <zb:nombreFuncion(parámetros)>

      En esta página solo se documenta por ahora una función, ifSec(), que realmente actúa como una definidora de bloques y es muy sencilla de usar, por lo que no debes de preocuparte demasiado si te parece que la cosa empieza a complicarse más de lo deseable.

  • Etiquetas generales

    Son las que generalmente pueden ser utilizadas en cualquier parte.

    <zb:BlogTitle> El título del blog.
    <zb:BlogSubtitle> El subtítulo del blog.
    <zb:BlogName> El nombre del blog (lo que precede a zoomblog.com en la URL de tu blog)
    <zb:cbBUrl> zoomblog.com, o dicho de otra manera, lo que sigue al nombre del blog en la URL de tu blog.
    <zb:BlogURL> Equivalente a http://<zb:BlogName>.<zb:cbBUrl>
    <zb:BlogDescription> La descripción del blog.
    <zb:BlogHost> La URL del sitio que aloja tu blog, en este caso www.zoomblog.com
    <zb:BlogEntryCount> Número total de mensajes publicados en el blog.
    <zb:BlogCommentCount> Número total de comentarios publicados en el blog.
    <zb:BlogOwnerLink> Enlace al perfíl del creador del blog, generalmente http://www.egrupos.net/userProfile/XXX donde XXX es el identificador numérico del creador del blog.
    <zb:blogTZ> El valor interno que identifica la zona horaria del blog.

  • Etiquetas sobre artículos

    Son etiquetas que hacen referencia a un artículo en concreto. Para que funcionen, todas deberán ser utilizadas dentro de la etiqueta de bloque <zb:Entries> ... </zb:Entries>

    <zb:Entries>..</zb:Entries> Marcan el bloque que corresponderá a la presentación de un artículo. Información incluida en este bloque suele ser el título del artículo, su enlace permanente, el contenido del artículo por supuesto, enlaces a comentarios, referencias, etiquetas (tags), etc.

    Cuando se deba presentar más de un artículo - por ejemplo en la página principal - este bloque se repetirá por cada artículo que necesite ser mostrado.

    <zb:EntryDate>La fecha del artículo. Por el momento, no se puede definir el formato de fecha
    <zb:EntryID>Cada artículo tienen un ID numérico asociado. Esta etiqueta presenta el ID numérico del artículo
    <zb:EntryTitle>El título del artículo
    <zb:EntryPermalink>La URL (incluyendo el http://) al enlace permanente del artículo
    <zb:EntryAuthor>El nombre del autor del artículo
    <zb:EntryBody>El artículo en sí, en toda su hermosura
    <zb:EntryTags>Todas las etiquetas (tags) del artículo, enlazadas ya adecuadamente según la configuración en las preferencias del blog
    <zb:EntryAuthorEmail>La dirección de correo (sin trucos anti-spam) del autor del artículo
    <zb:EntryAuthorLink>Enlace al perfíl del autor del artículo, generalmente http://www.egrupos.net/userProfile/XXX donde XXX es el identificador numérico del autor del artículo.
    <zb:EntryCategory>El nombre de la categoría a la que pertenece el artículo
    <zb:EntryCategoryLink>Enlace completo (con su <a href="..."> y todo) a la categoría a la que pertenece el artículo
    <zb:EntryCategoryID>El identificador numérico de la categoría a la que pertenece el artículo
    <zb:EntryCommentCount>El número total de comentarios dejados al artículo
    <zb:EntryTrackbackCount>El número total de referencias dejadas al artículo

  • Etiquetas sobre referencias (trackback)

    Estas etiquetas suelen utilizarse generalmente en la plantilla trackbackList.html - donde se muestran las referencias recibidas para un artículo en concreto, una tras otra. Todas estas etiquetas deberán ir en un bloque definido por <zb:Trackbacks>..</zb:Trackbacks>

    <zb:Trackbacks>..</zb:Trackbacks> Define el bloque que corresponde con la presentación de una referencia y sus datos asociados. Utilizado en la plantilla trackbackList.html, se procesará este bloque por cada referencia recibida. Dado que dependen de un artículo en concreto, fuera de esta plantilla, solo cobrará efecto si se incluye en un bloque <zb:Entries>..</zb:Entries>
    <zb:EntryTrackbackLink>Muestra la URL a la que se deben enviar las referencias del artículo en curso
    <zb:EntryTrackbackDate>La fecha en que se recibió la referencia
    <zb:EntryTrackbackTitle>El título dado por la referencia, si se recibió.
    <zb:EntryTrackbackBlogName>El nombre del blog dado por la referencia, si se recibió.
    <zb:EntryTrackbackExcerpt>El texto que acompañó a la referencia, si se recibió.

  • Etiquetas de las categorías

    Suelen incluirse en la columna de la izquierda/derecha de las páginas del blog, y sirven para listas las categorías activas (con artículos en ellas). Como siempre, se definen primero con una etiqueta de bloque que se repetirá por cada una de las categorías existentes.

    <zb:Categories>..</zb:Categories> Define el bloque a repetir por cada una de las categorías existentes
    <zb:CategoryID>El identificador numérico de la categoría
    <zb:CategoryName>El nombre/título de la categoría
    <zb:CategoryLink>La URL (empezando con http://) que apunta a la categoría en curso
    <zb:CategoryCount>El número de artículos publicados bajo la categoría en curso
    <zb:CategoryDescription>La descripción de la categoría, caso de haberse otorgado una.

  • Etiquetas de Archivos

    Al igual que con las etiquetas de las categorías, suelen incluirse en las columnas de las páginas del blog, listando mes tras mes, enlaces que apunten a los artículos publicados en esos meses. En este bloque solo se mostrarán aquellos meses que ya cuenten con al menos un artículo publicado.

    <zb:ArchiveList>..</zb:ArchiveList> Define el bloque que se repetirá por cada uno de los meses a mostrar.
    <zb:ArchiveLink>Muestra la URL (empezando por http://) que lleva al archivo en cusro
    <zb:Month>Muestra el nombre del mes en curso
    <zb:Mon>Muestra las tres primeras letras del nombre del mes en curso
    <zb:Year>Muestra el año en curso
    <zb:YearShort>Muestra los dos últimos números del año en curso (p.ej. 06 para indicar el 2006)
    <zb:nPosts>Muestra el número de artículos publicados en la fecha (mes) en curso

  • Etiquetas de Enlaces Favoritos

    Otro grupo de sencillas etiquetas a aplicar generalmente en las columnas laterales del blog.

    <zb:FavSections>..</zb:FavSections> Define el bloque donde se incluirán las diferentes secciones.
    <zb:FavLinks>..</zb:FavLinks> Define el bloque de una sección, que será repetido por cada uno de los enlaces pertenecientes a esa sección.

    Para entendernos, el bloque definido por FavSections engloba todas las posibles secciones creadas, mientras que el bloque definido por FavLinks se aplica a cada una de las secciones.

    <zb:FavTitle>El título o nombre de una sección. Deberá ir dentro del bloque FavSections pero fuera del bloque FavLinks.
    <zb:FavName>El nombre de un enlace. Este sí deberá de ir dentro del bloque FavLinks
    <zb:FavUrl>La URL (sin el http://) del enlace

  • Etiquetas de los comentarios

    Esta sección es un poco más complicada ya que existen hasta tres etiquetas de bloques, cada una con un propósito diferente.

    <zb:Comments>..</zb:Comments> Generalmente utilizada en la plantilla commentList.html, aunque también se puede usar en la plantilla index.html (o en una plantilla nueva) si deseamos que aparezcan los comentarios en la misma página que aparece el artículo, en cuyo caso deberá de incluirse en el bloque <zb:Entries>..</zb:Entries>
    <zb:IfCommentsLeft>..</zb:IfCommentsLeft> Define un bloque que solo se mostrará si el artículo en curso ha recibido ya al menos un comentario. Es útil por ejemplo para insertar un enlace que nos lleve a leer esos comentarios, ya que ¿para qué invitar al lector a leer comentarios si no se ha recibido ninguno?
    <zb:CommentPost>..</zb:CommentPost>Define un bloque que solo se mostrará si el artículo en curso permite el envío de comentarios.
    <zb:CommentID>El ID numérico del comentario en curso
    <zb:CommentEntryID>El ID numérico del artículo al que pertenece el comentario
    <zb:CommentIP>La IP desde la cual se dejó el comentario
    <zb:CommentAuthor>El nombre de la persona que dejó el comentario, siempre que dejase un nombre
    <zb:CommentEmail>La dirección de correo electrónico de la persona que dejó el comentario, siempre que la indicase cuando dejó el comentario
    <zb:CommentURL>La página web de la persona que dejó el comentario, si la indicó
    <zb:CommentDate>La fecha en la que se dejó el comentario (según la zona horaria del blog)
    <zb:CommentAuthorLink>Si el usuario que dejó el comentario está registrado, se muestra el enlace completo (con su nombre para hacer clic) a su página desde donde se puede enviarle un mensaje. Si no es así, pero dejó una URL, se muestra el enlace (nuevamente con su nombre para hacer clic). De no cumplirse ninguna de estas condiciones, se muestra la palabra "Página" sin ningún enlace asociado.
    <zb:CommentEmailLink> Si el usuario que dejó el comentario está registrado, se muestra el enlace completo (con la palabra "Email" para hacer clic) a su página desde donde se puede enviarle un mensaje. En caso contrario se muestra la palabra "Email" sin ningún enlace asociado.
    <zb:CommentURLLink> Si el usuario que dejó el comentario dejó la URL de su página, se muestra el enlace completo (con la palabra "Página" para hacer clic) a dicha página. En caso contrario se muestra la palabra "Página" sin ningún enlace asociado.
    <zb:CommentBody>El texto completo - filtrado - del comentario.

  • Otras etiquetas

    <zb:RSSLink>Muestra la URL (empezando por http://) de agregación (feed) de los artículos del blog (formato RSS 2.0)
    <zb:RSSCommentLink> Muestra la URL (empezando por http://) de agregación (feed) de los comentarios a los artículos del blog (formato RSS 2.0)
    <zb:isBlogAdmin>..</zb:isBlogAdmin> Define un bloque que solo se mostrará si la persona que está viendo la página es identificada como un administrador del blog. Muy útil por ejemplo para que el dueño del blog incluya información al visitar su blog que solo él deba ver.
    <zb:AdminLink>URL completa que apunta a las páginas de administración del blog. Esta es por ejemplo una etiqueta que podría incluirse en el bloque isBlogAdmin definido anteriormente
    <zb:Calendar>Muestra el calendario. El formato del calendario depende de varios atributos CSS que generalmente se definirán en la hoja de estilo.

    • caltable: Atributos de la tabla
    • cal1row: Atributos de la primera fila, donde aparecen los días de la semana
    • cal1col: Atributos de las celdas en la primera fila
    • cal1txt: Atributos del texto que aparezca en la primera fila
    • caltxt: Atributos del texto de los días del mes
    • caltoday: Atributos del texto correspondiente al día actual

  • Funciones

    La única función documentada en este momento es ifSec() y actúa como definidora de bloque condicional. Su única razón de ser (al menos desde nuestro punto de vista) es para poder ofrecer al usuario la posibilidad de determinar desde la página de administración del blog en el apartado de Plantillas|Seleccionar Elementos si dichos elementos deben aparecer o no, sin tener que editar manualmente la plantilla.

    Aparte de eso, realmente tienes dos alternativas en cuanto a usar y entender como funciona esta función:

    1. Si deseas editar manualmente tus plantillas al 100% e ignorar la opción "Plantillas|Seleccionar Elementos", olvídate de esta función: puedes eliminarla de las plantillas existentes o, si creas tu plantilla por tu cuenta, no preocuparte ni de que existe.
    2. Si deseas usar la opción "Plantillas|Seleccionar Elementos", a la vez que editar tu plantilla, procura respetar las etiquetas que llamen a esta función allá donde las veas, y asegurarte que cada "elemento" empieza y termina con una llamada a esta función.

    Si tu caso es el segundo, aquí tienes los posibles parámetros y el "elemento" al que se refieren (correspondiendose con la opción correspondiente en "Plantillas|Seleccionar Elementos").

    <zb:ifSec(About)>El enlace que apunta al perfíl del autor del blog
    <zb:ifSec(Cat)>El bloque que muestra las categorías
    <zb:ifSec(Archive)>El que muestra los enlaces al archivo
    <zb:ifSec(Cal)>El que muestra el calendario
    <zb:ifSec(RSS)>El que muestra los enlaces de sindicación (artículos y comentarios)
    <zb:ifSec(Links)>El que muestra los enlaces favoritos
    <zb:ifSec(LCom)>El que muestra lus últimos comentarios publicados
    <zb:ifSec(Sub)>El que muestra el enlace que lleva al usuario a la página de información sobre cómo suscribirse

    Nuestra recomendación es la siguiente: Si has entendido cómo se usa esta función, perfecto. Si no lo has entendido y examinando cómo la usamos nosotros en las plantillas predefinidas no te lo aclara, remítete a los dos puntos que acabamos de indicarte.

    ¿Nos hemos dejado alguna etiqueta que haga algo que te interese? ¡Escribenos!

Apúntate | Blogs | Grupos | Bazar | Gente | Quienes somos | Privacidad | Novedades | Escribenos | Idioma

eGrupos es un servicio de eListas Networks
Copyright © 1999-2006 eListas Networks, Todos los derechos reservados
Términos del Servicio