Saltar al contenido

Funciones

Tema

Personaliza el aspecto de tu blog con plantillas Liquid.

El editor de temas del blog, con los archivos del tema, el código y una vista previa en directo

Archivos del tema

Cada tema tiene 8 archivos:

ArchivoPara qué sirve
home.liquidPlantilla de la página de inicio
category.liquidPágina con la lista de una categoría
post.liquidPágina de un artículo
header.liquidParcial de cabecera compartido
footer.liquidParcial de pie de página compartido
shared.liquidComponentes reutilizables
styles.cssCSS personalizado
scripts.jsJavaScript personalizado

Plantillas Liquid

Los temas usan la sintaxis de plantillas de Liquid:

<h1>{{ workspace.blog_title }}</h1>

{% for post in posts %}
  <article>
    <h2>{{ post.title }}</h2>
    <p>{{ post.excerpt }}</p>
  </article>
{% endfor %}

Variables disponibles

Globales (todas las páginas)

{{ workspace.id }}
{{ workspace.name }}
{{ workspace.blog_title }}
{{ workspace.logo_url }}
{{ workspace.icon_url }}
{{ base_url }}
{{ current_year }}
{{ theme.version }}

Categorías

{% for category in categories %}
  {{ category.id }}
  {{ category.slug }}
  {{ category.name }}
  {{ category.description }}
{% endfor %}

Artículos (páginas de inicio y de categoría)

{% for post in posts %}
  {{ post.id }}
  {{ post.slug }}
  {{ post.category_slug }}
  {{ post.title }}
  {{ post.excerpt }}
  {{ post.featured_image_url }}
  {{ post.published_at }}
  {{ post.reading_time_minutes }}

  {% for author in post.authors %}
    {{ author.name }}
    {{ author.avatar_url }}
  {% endfor %}
{% endfor %}

Un artículo (página del artículo)

{{ post.title }}
{{ post.content }}
{{ post.excerpt }}
{{ post.featured_image_url }}
{{ post.published_at }}
{{ post.reading_time_minutes }}

{% for toc in post.table_of_contents %}
  {{ toc.id }}
  {{ toc.level }}
  {{ toc.text }}
{% endfor %}

{{ category.name }}
{{ category.slug }}

Paginación

{{ pagination.current_page }}
{{ pagination.total_pages }}
{{ pagination.has_next }}
{{ pagination.has_previous }}
{{ pagination.total_count }}
{{ pagination.per_page }}

Listas de la newsletter

{% for list in public_lists %}
  {{ list.id }}
  {{ list.name }}
  {{ list.description }}
{% endfor %}

Filtros útiles

FiltroDescripciónEjemplo
dateDa formato a las fechas{{ post.published_at | date: "%B %d, %Y" }}
truncateLimita la longitud del texto{{ post.excerpt | truncate: 150 }}
truncatewordsLimita el número de palabras{{ post.excerpt | truncatewords: 25 }}
upcase / downcaseCambia a mayúsculas o minúsculas{{ category.name | upcase }}
capitalizePone en mayúscula la primera letra{{ author.name | capitalize }}
strip_htmlQuita las etiquetas HTML{{ post.content | strip_html }}
escapeEscapa las entidades HTML{{ post.title | escape }}
url_encodeCodifica para URL{{ post.title | url_encode }}
defaultValor de respaldo{{ post.featured_image_url | default: "/images/placeholder.jpg" }}
sizeLongitud de un array o un texto{{ posts | size }}
first / lastPrimer o último elemento{{ categories | first }}
sortOrdena un array{{ posts | sort: "published_at" }}
reverseInvierte un array{{ posts | reverse }}
whereFiltra un array{{ posts | where: "category_id", "news" }}
mapExtrae una propiedad{{ posts | map: "title" }}
joinUne los elementos de un array{{ post.tags | join: ", " }}
splitDivide un texto{{ "a,b,c" | split: "," }}
replaceReemplaza texto{{ post.title | replace: "-", " " }}
append / prependAñade texto al final o al principio{{ post.slug | prepend: "/" }}
plus / minusOperaciones matemáticas{{ pagination.current_page | plus: 1 }}
times / divided_byOperaciones matemáticas{{ post.reading_time_minutes | times: 60 }}

Parciales

Include (comparte el ámbito del padre)

{% include 'header' %}
{% include 'footer' %}

Render (ámbito aislado)

{% render 'shared', widget: 'newsletter' %}
{% render 'shared', widget: 'categories' %}

El nombre de la plantilla debe ir entre comillas: como en Shopify Liquid 5.11, {% render variable %} y {% snippet %} no están soportados. Liquid funciona en los temas igual que en las plantillas de correo, con las mismas diferencias respecto a Shopify Liquid.

Versiones del tema

Los temas tienen versiones:

Versiones de un tema del blog: un borrador v2 creado a partir del tema predeterminado y la v1 publicada
  • Solo puede haber una versión publicada a la vez
  • Una versión publicada nunca cambia: al guardar tus cambios sobre ella se crea una nueva versión en borrador
  • Guardar un borrador actualiza ese borrador
  • Las versiones no publicadas son borradores

Modo de vista previa

Previsualiza temas no publicados añadiendo ?preview_theme_version=X a cualquier URL del blog:

https://blog.example.com/?preview_theme_version=5
https://blog.example.com/category/slug?preview_theme_version=5

La vista previa se salta la caché y exige iniciar sesión.