Plantillas
De BlogMail-Wiki, la enciclopedia libre.
Tabla de contenidos |
Guía Smarty
En Blogmail usamos Smarty como sistema de plantillas.
En la página oficial de Smarty hay un manual de lectura obligatoria para poder convertirse en una experta diseñadora de templates para blogmail: Smarty para diseñadoras
También hay versión en Inglés y Alemán
Esta es sólo una lista de los tags más frecuentes. La lista completa se puede encontrar en bm-includes/class-smarty.php
Si lo que quieres es utilizar una plantilla clásica de WordPress en BlogMail, utiliza el Conversor WordPress2Smarty
Referencia de tags Blogmail
Tags generales
Los podemos encontrar en la plantilla principal que es index.html
- {bloginfo show='variable'}: muestra un valor de la matriz de información del mailblog. Donde variable puede ser:
- name: nombre del mailblog
- rdf_url: url del feed rdf
- rss2_url: url del feed rss2
- pingback_url: url del pingback
- description: descripción del mailblog
- {$content}: muestra el contenido de post.html
- {the_postmails_counter}: muestra el número de postmails y el porcentaje de privacidad. Ej. Postmails: 58 (0% Privado)
- {posts_nav_link}: muestra los botones de página siguiente y página anterior cuando proceda
Tags específicos para index.html
- {bm_list_pages}: muestra las páginas ordenadas y la palabra páginas
Tags de campos del postmail
La plantilla de los postmails es post.html y en esta podemos incrustar diferentes tags que serán sustituidos dinámicamente por los valores de extraidos de la base de datos a los que hace referencia.
Campos de texto:
- {the_title}: título/asunto del postmail
- {the_content}: el contenido de texto de un postmail
Los campos de la cabecera son estos:
- {the_author_nickname}: alias del autor del postmail.
- {the_author_email}: el correo del autor.
- {the_to}: destinataria/s del postmail
- {the_cc}: campo cc del mailpost
- {the_bcc}: destinataria/s copia de carbon
Otros detalles:
- {the_ID}: el número identificador único que existe por cada postmail dentro de un mailblog.
- {permanent_link}: url de enlace permanente hacia este postmail
- {the_time}: fecha y hora del postmail
Tags de respuesta
En las plantillas de blogmail, podemos insertar ciertos tags que mostrarán un enlace a la interfaz privada para acciones como responder, responder a todos y reenviar el postmail que estamos navegando en la parte pública. Estos tags tienen sentido en la plantilla post.html que es la que usa blogmail para generar el bloque de html que representa un postmail.
Los tags y su definición:
- {reply_link} Muestra enlace a interfaz de escritura de respuesta.
- {replyall_link} Enlace de respuesta a todos los remitentes.
- {forward_link} Enlace a escritura de reenviado.
- {edit_post_link} Enlace a edición de mailpost.
Para evitar que se muestren estos enlaces para navegantes anónimos podemos encerrar los anteriores tags en una condición smarty de esta manera en nuestra plantilla post.html:
{if $islogged}
Acciones de administrador para este postmail: {reply_link} - {replyall_link} - {forward_link} - {edit_post_link}
{/if}
$islogged es una variable smarty que nos dice si la pagina que se genera es para que lo vea la usuaria habiendo hecho login.
Tags de comentario
Aunque estamos intentando prescindir de los comentarios, por ahora el tag smarty que nos muestra la cantidad de comentarios que tiene cada mailpost es {comments_popup_link}. El uso habitualmente en post.html es este:
{comments_popup_link zero='Si te das prisa, puedes ser el primero en comentar' one='Un comentario' more='% comentarios'}
Donde los argumentos que le pasamos son:
- zero: texto que muestra si no hay ningún comentario
- one: texto que muestra cuando sólo hay un comentario
- more: texto que muestra cuando hay más de un comentario. El símbolo % se reemplazará por el número de comentarios que tenga el mailpost.
Ver también
- CSS, hojas de estilo en cascada
