Archivos del tema
Cada tema tiene 8 archivos:
| Archivo | Para qué sirve |
|---|---|
home.liquid | Plantilla de la página de inicio |
category.liquid | Página con la lista de una categoría |
post.liquid | Página de un artículo |
header.liquid | Parcial de cabecera compartido |
footer.liquid | Parcial de pie de página compartido |
shared.liquid | Componentes reutilizables |
styles.css | CSS personalizado |
scripts.js | JavaScript 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
| Filtro | Descripción | Ejemplo |
|---|---|---|
date | Da formato a las fechas | {{ post.published_at | date: "%B %d, %Y" }} |
truncate | Limita la longitud del texto | {{ post.excerpt | truncate: 150 }} |
truncatewords | Limita el número de palabras | {{ post.excerpt | truncatewords: 25 }} |
upcase / downcase | Cambia a mayúsculas o minúsculas | {{ category.name | upcase }} |
capitalize | Pone en mayúscula la primera letra | {{ author.name | capitalize }} |
strip_html | Quita las etiquetas HTML | {{ post.content | strip_html }} |
escape | Escapa las entidades HTML | {{ post.title | escape }} |
url_encode | Codifica para URL | {{ post.title | url_encode }} |
default | Valor de respaldo | {{ post.featured_image_url | default: "/images/placeholder.jpg" }} |
size | Longitud de un array o un texto | {{ posts | size }} |
first / last | Primer o último elemento | {{ categories | first }} |
sort | Ordena un array | {{ posts | sort: "published_at" }} |
reverse | Invierte un array | {{ posts | reverse }} |
where | Filtra un array | {{ posts | where: "category_id", "news" }} |
map | Extrae una propiedad | {{ posts | map: "title" }} |
join | Une los elementos de un array | {{ post.tags | join: ", " }} |
split | Divide un texto | {{ "a,b,c" | split: "," }} |
replace | Reemplaza texto | {{ post.title | replace: "-", " " }} |
append / prepend | Añade texto al final o al principio | {{ post.slug | prepend: "/" }} |
plus / minus | Operaciones matemáticas | {{ pagination.current_page | plus: 1 }} |
times / divided_by | Operaciones 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:
- 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.
