Códigos de información de "Diseños"

Como se indica en el artículo Códigos de widgets de Diseños, existen diversos tipos de código que puedes utilizar para incluir información específica en tu plantilla. Todos presentarán el formato <data:name/> o <data:name1.name2/>, donde name es el nombre de la información concreta que deseas utilizar. En el ejemplo name1.name2, name2 es un elemento concreto dentro de un conjunto de datos denominado name1, por ej., photo.url.

A continuación, te ofrecemos una lista maestra de todos los datos disponibles. Se encuentra dividida en secciones según el elemento de página, dado que los distintos tipos de widgets utilizan información diferente.

Información disponible globalmente

Esta información se aplica a toda la página, de modo que puedes utilizarla donde lo desees, al contrario que otro tipo de información, que sólo se puede utilizar en un widget específico. Se hará referencia a ella como parte de la información global del "blog", por ej. como <data:blog.title/>, etc.

• title: el título del blog.
• pageType: el tipo de la página actual; de entre estos tres tipos: "element", "archive" o "index".
• url: la URL de la página actual.
• homepageUrl: la página principal del blog.
• pageTitle: el título de la página actual. Generalmente se trata del título del blog, pero también puede contener información adicional sobre páginas de archivo o de entradas.
• encoding: la codificación que se utilizará para el blog, por ejemplo, UTF-8.
• feedLinks: los vínculos de detección automática de feeds de la cabecera de la página.

Cabecera de página

Se trata de un widget sencillo que ofrece dos tipos de información. Se puede hacer referencia a ellos simplemente como<data:title/> and <data:description/>.

• title: el título del blog.
• description: la descripción del blog.

Entradas del blog

Esta es la parte principal de cualquier blog y, por ello, también la más compleja. Te recomendamos que hagas modificaciones en una de las plantillas predefinidas antes de escribir un widget de entradas del blog desde cero. No obstante, si deseas hacerlo, a continuación te ofrecemos toda la información disponible en este widget.

• feedLinks: una lista de los feeds de esta página. En la página principal, contiene los feeds más importantes del blog; en las páginas de elementos, también contendrá feeds de comentarios. Cada uno de los elementos de esta lista contiene:
  • url: la URL del feed.
  • name: el nombre del feed, es decir "Entradas" o "Comentarios".
  • feedType: el tipo de feed (Atom o RSS).
  • mimeType: el tipo de mime del feed.
• olderPageUrl: si hay entradas anteriores a las que se ven en la página actual, esta es la URL que dirige hasta ellas. En lo que al tipo de página se refiere, tiene en cuenta el contexto. (No todas las páginas constarán de este vínculo.)
• olderPageTitle: título del vínculo a la página de entradas más antigua.
• newerPageUrl: el equivalente más reciente a olderPageUrl.
• newerPageTitle: el equivalente más reciente a olderPageTitle.
• commentLabel: la frase utilizada para mostrar el número de comentarios, por ejemplo, "comentarios".
• authorLabel: la frase que se utiliza para indicar el autor de la entrada, por ejemplo, "entrada de".
• timestampLabel: la frase que se utiliza para indicar cuándo se ha escrito una entrada, por ejemplo, "publicada el".
• postLabelsLabel: frase que presenta la lista de etiquetas de entrada, por ej. "etiquetas de esta entrada".
• backlinksLabel: frase que describe los vínculos de retroceso de esta entrada, por ej. "vínculos a esta entrada".
• entradas: una lista de todas las entradas de esta página. Cada entrada contiene lo siguiente:
  • dateHeader: la fecha de esta entrada, presente únicamente si esta es la primera publicación de la lista que se ha publicado ese día.
  • id: el número de identificación de la entrada.
  • title: el título de la entrada.
  • body: el contenido de la entrada.
  • author: el nombre visible del autor de la entrada.
  • url: el vínculo perm. de esta entrada.
  • timestamp: la fecha y hora de la entrada. Al contrario que dateHeader, este dato figura en todas las entradas.
  • labels: la lista de etiquetas de la entrada. Cada etiqueta contiene las siguientes:
    • name: el texto de la etiqueta.
    • url: la URL de la página en la que figuran todas las entradas de este blog que tienen asignada la etiqueta.
    • isLast: "true" o "false". Indica si esta etiqueta es o no la última de la lista (útil para la utilización de comas).
  • allowComments: "Verdadero" si esta entrada permite comentarios.
  • numComments: el número de comentarios de esta entrada.
  • showBacklinks: indica si se muestran vínculos de retroceso para esta entrada.
  • numBacklinks: número de vínculos de retroceso para esta entrada.
  • addCommentUrl: la URL del formulario "añadir un comentario" de esta entrada.
  • emailPostUrl: la URL del formulario "enviar esta entrada por correo electrónico" de esta entrada.
  • editUrl: la URL del formulario de edición de esta entrada.
  • feedLinks: una lista de los feeds específicos de esta entrada. (Es diferente del feedLinks del blog, dado que contiene un feed para los comentarios de la entrada, por ejemplo). Cada uno consta de:
    • url: la URL del feed.
    • name: el nombre del feed, por ej., "Entradas" o "Comentarios".
    • feedType: el tipo de feed (Atom o RSS).
    • mimeType: el tipo de mime del feed.
  • comments: una lista de todos los comentarios de esta entrada (únicamente en páginas de elementos). Cada entrada contiene lo siguiente:
    • id: el número de identificación del comentario.
    • body: el cuerpo del comentario.
    • timestamp: la hora y la fecha a la que se creó el comentario.
    • author: el nombre mostrado del autor del comentario o bien "Anónimo".
    • authorUrl: URL del perfil del autor del comentario, si este no es anónimo.
    • deleteUrl: la URL para suprimir este comentario.
    • isDeleted: indica si este comentario se ha suprimido. (El texto de los comentarios suprimidos se sustituye con una variable.)

Archivos del blog

Los distintos estilos que se proporcionan aquí se corresponden con las distintas opciones predeterminadas de la pestaña "Elementos de página". Si estás diseñando una nueva versión, lo más fácil es utilizar el estilo "SIMPLE" y, a continuación, manipular el resto de la información como desees.

• title: el título del widget.
• style: uno de estos tres "MENÚ", "SIMPLE" o "JERÁRQUICO".
• data: una lista de todas las unidades de archivo, cada una de las cuales contiene:
  • name: el nombre de este intervalo de archivo, por ej., "agosto 2006".
  • url: el vínculo a la página que contiene las entradas correspondientes a este intervalo.
  • post-count: el número de entradas que hay en este intervalo.

Widget del perfil

Para un blog con un único autor, el widget del perfil contiene la información que se indica a continuación. Ten en cuenta que para acceder a las distintas partes de la información photo, deberás utilizar la notación <data:photo.url/>.

• title: el título del widget.
• userUrl: la URL del perfil del autor.
• location: la ubicación del perfil del autor.
• aboutme: la "Información personal" del perfil.
• displayname: el nombre visible del autor.
• photo: la fotografía del perfil del usuario, que consta de:
  • url: la URL de la foto.
  • width: el ancho de la foto, en píxeles.
  • height: la altura de la foto, en píxeles.
  • alt: el texto "alternativo" que acompaña a la foto.

En blogs de grupos, el widget del perfil contiene menos información sobre más autores, como se indica a continuación.

• title: el título del widget.
• authors: la lista de todos los autores, para cada uno de los cuales figura la siguiente información:
  • displayname: el nombre visible del autor.
  • userURL: la URL del perfil del autor.

Si deseas que tus plantillas se puedan utilizar con blogs tanto de un único autor como de varios, puedes utilizar la variabledata:team para distinguir entre ambos casos. Por ejemplo, <b:if cond='data:team=="true"'> (muestra varios autores) </b:if>

Widget de texto / HTML / JavaScript

El widget de texto y el widget de HTML/JavaScript funcionan de la misma forma y constan de los mismos dos datos.

• title: el título del widget.
• content: el contenido del widget.

Widget de feed

Un widget de feed contiene, además de su propia información, una lista denominada feedData, que incluye todos los elementos del feed. Cada uno de estos elementos, a su vez, consta de varios tipos de datos sobre sí mismo. Cuando hagas referencia a este tipo de datos, será preciso que establezcas, del modo que te indicamos, un bucle entre cada uno de los elementos de la lista: <b:loop var="i" values="feedData.items">. A continuación, utiliza la notación<data:i.title/> o <data:i.alternate.href/> para obtener la información de cada elemento.

• title: el título del widget.
• feedUrl: la URL del feed.
• feedData: los elementos del feed, cada uno de los cuales consta de:
  • title: el título del elemento.
  • str_published: cuándo se publicó el elemento (indicado en el formato de la zona horaria en la que se encuentra el blog).
  • published: cuándo se publicó el elemento (en segundos desde el momento en cuestión).
  • str_published: cuándo se realizó la última actualización del elemento (indicado en el formato de la zona horaria en la que se encuentra el blog).
  • updated: cuándo se realizó la última actualización del elemento (en segundos desde el momento en cuestión).
  • author: el autor del elemento.
  • summary: un fragmento del elemento, si está disponible.
  • alternate: dónde obtener más información acerca de este elemento, que contiene:
    • href: el vínculo perm. de este elemento.
    • type: el tipo de contenido de este elemento.

Widget de imagen

El widget de imagen contiene una única imagen y proporciona todos sus datos relevantes.

• title: el título del widget.
• sourceUrl: la URL de la imagen.
• width: el ancho de la imagen, en píxeles.
• height: la altura de la imagen, en píxeles.
• caption: el título de la imagen.

Widget de las etiquetas

El widget de las etiquetas incluye una lista de todas las etiquetas que se utilizan en el blog.

• title: el título del widget.
• labels: la lista de etiquetas, cada una de las cuales consta de la siguiente información:
  • name: el texto de la etiqueta.
  • count: número de entradas que tiene esta etiqueta.
  • url: vínculo a una página que muestra las entradas que tienen asignada esta etiqueta.

Widget de la lista

La versión más sencilla de una lista. Cada elemento consta de un único fragmento de texto, sin tipos de datos distintos en él.

• title: el título del widget.
• items: la lista de elementos.

Widget de la lista de vínculos

Una lista ligeramente más elaborada, en la que cada elemento consta de dos partes: el texto y el vínculo.

• title: el título del widget.
• links: la lista de vínculos, cada uno de los cuales contiene:
  • name: el texto del vínculo.
  • target: la URL del vínculo.

Widget del logotipo

Este es el nivel más sencillo de todos: sólo consta de un dato.

• fullButton: la URL del botón de Blogger que has seleccionado.