# Filtros

Un filtro es un método Ruby que toma uno o más parámetros y devuelve un valor. Los parámetros se pasan a los filtros por posición: el primer parámetro es la expresión que precede al carácter de barra vertical, y se pueden pasar parámetros adicionales usando la sintaxis name: arg1, arg2.

El marcado Output puede aceptar filtros, que modifican el resultado de la sentencia Output. Puede invocar filtros siguiendo la expresión principal de la sentencia Output con:

Un caracter de barra vertical (|)
El nombre del filtro
Opcionalmente, dos puntos (:) y una lista separada por comas de parámetros adicionales al filtro. Cada parámetro adicional debe ser una expresión válida, y cada filtro predefine los parámetros que acepta y el orden en que deben ser pasados.

Los filtros también se pueden unir entre sí añadiendo sentencias de filtro adicionales (comenzando con otro carácter de barra vertical). El Output del filtro anterior será el Input para el siguiente.

Hello {{ 'tobi' | upcase }}
Hello tobi has {{ 'tobi' | size }} letters!
Hello {{ '*tobi*' | textilize | upcase }}
Hello {{ 'now' | date: "%Y %h" }}

# Básicos

# Append

Añade un string e.g. {{ 'foo' | append:'bar' }} #=> 'foobar'

# Base64 decode

Decodifica un string codificado en Base64 e.g. {{ 'SGVsbG8gd29ybGQ=' | base64_decode }} #=> 'Hello world'

# Base64 encode

Codifica un string en Base64 e.g. {{ 'Hello world' | base64_encode }} #=> 'SGVsbG8gd29ybGQ='

# Capitalize

Poner palabra en mayúscula en la frase de entrada.

# Ceiling

Redondea hacia arriba un número decimal al próximo entero, e.g. {{ 4.6 | ceil }} #=> 5

# Date

Da formato a una fecha (syntax reference (opens new window))

# Default

Devuelve la variable dada a menos que sea nula o string vacío, entonces devuelve el valor dado, e.g. {{ undefined_variable | default: "Default value" }} #=> "Default value"

# Divided by

División de enteros e.g. {{ 10 | divided_by:3 }} #=> 3

# Downcase

Convierte un string de entrada en minúsculas.

# Escape

Escape HTML a un string.

# Escape once

Devuelve una versión escape de html sin afectar a las entidades escape existentes.

# First

Obtener el primer elemento del array pasado.

# Floor

Redondea un número decimal hacia abajo al entero más cercano, e.g. {{ 4.6 | floor }} #=> 4

# Format date

Da formato a una fecha con la localización del sitio, usa la misma sintaxis que date.

# Join

Une elementos del array con cierto caracter entre ellos.

# Last

Obtener el último elemento del array pasado.

# Lstrip

Elimina todos los espacios en blanco del principio de un string.

# Map

Mapear/coleccionar un array en una propiedad dada.

# Minus

Resta e.g. {{ 4 | minus:2 }} #=> 2

# Modulo

Modulo e.g. {{ 3 | modulo:2 }} #=> 1

# Newline to br

Reemplaza cada linea nueva (\n) con espacio HTML.

# Plus

Suma e.g. {{ '1' | plus:'1' }} #=> 2, {{ 1 | plus:1 }} #=> 2

# Prepend

Precede un string e.g. {{ 'bar' | prepend:'foo' }} #=> 'foobar'

# Remove

Elimina todas las incidencias e.g. {{ 'foobarfoobar' | remove:'foo' }} #=> 'barbar'

# Remove first

Elimina la primera incidencia e.g. {{ 'barbar' | remove_first:'bar' }} #=> 'bar'

# Replace

Reemplaza todas las incidencias e.g. {{ 'foofoo' | replace:'foo','bar' }} #=> 'barbar'

# Replace first

Reemplaza la primera incidencia e.g. {{ 'barbar' | replace_first:'bar','foo' }} #=> 'foobar'

# Reverse

Invierte el array dado.

# Round

Redondea al número entero más cercano o al número especificado de decimales e.g. {{ 4.5612 | round: 2 }} #=> 4.56

# Rstrip

Elimina todos los espacios en blanco del final de un string

# Script tag

Genera el tag HTML <script> para un template JavaScript, tomando como parámetros la URL y atributos de la forma attr: 'value', e.g. {{ 'my-js-url' | script_tag: async: 'async', defer: 'defer' }} => <script src='my-js-url' type='text/javascript' async='async' defer='defer'></script>

# Size

Devolver el tamaño de un array o string

# Slice

Divide un string. Toma un desplazamiento y una longitud, e.g. {{ "hello" | slice: -3, 3 }} #=> llo

# Sort

Ordena elementos del array

# Split

Dividir un string en un patrón coincidente e.g. {{ "a~b" | split:"~" }} #=> ['a','b']

# Times

Multiplica e.g {{ 5 | times:4 }} #=> 20

# Truncate

Restringe un string a x caracteres. También acepta un segundo parámetro que se añadirá al string e.g. {{ 'foobarfoobar' | truncate: 5, '.' }} #=> 'foob.'

# Truncatewords

Restringe una string a x palabras

# Uniq

Elimina elementos duplicados de un array, utilizando opcionalmente una propiedad determinada para comprobar su unicidad.

# Upcase

Convierte un string de entrada a mayúsculas

# URL encode

Codifica un string a URL

# Commerce

Estos son los filtros liquid que alteran valores relacionados con Comercio.

# Format currency

Agrega formato de divisa a un valor. e.g. {{ 4 | format_currency }} => $4

{{ 1890.5123 | format_currency: unit: '¥', separator: ',', delimiter: '.', precision: 3 }} = ¥1.890,512

Importante

Este filtro determina el formato de la moneda y tiene prioridad sobre cualquier otra configuración de divisa.

Si no especificas parámetros de divisa con el filtro de currency, Modyo utiliza la configuración de payment del reino.

En caso de que el sitio no tenga un reino asociado y no especifiques parámetros, se aplicará el formato predefinido del idioma del sitio.

Parámetros:

unit - símbolo de la moneda.
separator - separador de decimales.
delimiter - separador de miles.
precision - cantidad de dígitos decimales.

# Content

Estos son los filtros liquid que alteran valores relacionados al módulo de Content en Modyo Platform.

# Búsqueda de assets por UUID

Los filtros asset_image, asset_link, asset_url_by_uuid y asset_video buscan el archivo por su UUID en el ámbito de la cuenta, no del sitio.

Atención

Si el UUID no corresponde a ningún archivo de la cuenta, ninguno de los cuatro falla ni devuelve vacío: imprimen el mensaje Error de liquid: No existe el archivo con UUID 'el-uuid-pedido', que queda publicado en la página. Revisa los UUID cuando muevas plantillas o contenido entre cuentas.

# Asset image

Retorna los tags de una imagen usando su uuid del Gestor de Archivos. Al usar Cloudflare para la optimización de imágenes, puedes usar estos parámetros adicionales: width, height, blur, quality, format y fit e.g. {{ uuid | asset_image: width: 40, format: 'auto', fit: 'cover' }}

# Asset link

Emite una etiqueta de enlace HTML que apunta al archivo del Gestor de Archivos identificado por su UUID. El argumento es el texto visible del enlace y, si lo omites, se usa el nombre de archivo del asset. e.g. {{ uuid | asset_link: 'Descarga el instructivo' }} => <a href='https://midominio.com/uploads/instructivo.pdf'>Descarga el instructivo</a>

Parámetros:

uuid (String) — asset uuid
label (String) (default: nombre de archivo del asset) — texto visible del enlace

Tip

Si lo que necesitas es solo la dirección del archivo, para armar tu propio markup, usa asset_url_by_uuid.

# Asset URL by UUID

Retorna el URL de una imagen usando su uuid del Gestor de Archivos. e.g. {{ uuid | asset_url_by_uuid }}

# Asset video

Retorna los tags de un video usando su uuid del Gestor de Archivos. e.g. {{ uuid | asset_video: 350, 300 }}

Parametros:

uuid (String) — asset uuid
width (Integer) (default: 300) — ancho
height (Integer) (default: 200) — largo

# By category

Retorna una lista de Entradas que pertenecen a la Categoría seleccionada. e.g. {% assign filtered_entries = entries | by_category: 'category2,category1,category3' %}

Parametros:

entries (ArrayEntry) — array con entradas
list (String) (default: '') — String con categorías separadas por coma.

# By lang

Retorna una lista de Entradas en el idioma indicado. El filtro se llama by_lang: locale es el nombre del parámetro, no el del filtro. e.g. {% assign entries = widget.entries | by_lang: 'es' %} => entries

Parametros:

entries (ArrayEntry) — array con entradas
locale (String) (default: '') — un único código de idioma

by_lang reemplaza la condición de idioma que la colección ya tuviera, no la acumula: el último by_lang de la cadena es el que manda.

Atención

No acepta una lista separada por comas. Un valor como 'es,en,pt' se compara tal cual contra el idioma de cada entrada, así que el resultado es una colección vacía en lugar de la unión de los tres idiomas. Si necesitas varios idiomas, resuelve una colección por idioma y recórrelas por separado.

Aplicado sobre algo que no sea una colección de entradas, el filtro aborta y en el HTML publicado queda el comentario  en lugar del bloque.

# By slug

Retorna una lista de Entradas que pertenecen a un slug seleccionado. e.g. {% assign filtered_entries = entries | by_slug: 'slug2,slug1,slug' %}

Parametros:

entries (ArrayEntry) — array con entradas
slug (String) (default: '') — Slug separadas por coma.

# By tag

Retorna una lista de Entradas que pertenecen a un tag seleccionado. e.g. {% assign entries = widget.entries | by_tag: 'tag2,tag1,tag3' %} => entries

Parametros:

entries (ArrayEntry) — array con entradas
locale (String) (default: '') — String con tags separadas por coma.

# By type

Retorna una lista de Entradas que pertenecen a un Tipo de Contenido seleccionado. e.g. {% assign filtered_entries = entries | by_type: 'type2,type1,type3' %}

Parametros:

entries (ArrayEntry) — array con entradas
locale (String) (default: '') — String con tipos de contenido separados por coma.

# By UUID

Filtra un arreglo de entradas por uno o más UUIDs.

Parámetros:

entries (ArrayEntry) — colección (objeto antes de la barra)
uuid_list (String) — lista de UUIDs separada por comas

Predeterminado: Si uuid_list está en blanco retorna la colección original.

ej. {% assign filtradas = entries | by_uuid: 'uuid2,uuid1,uuid3' %}

# Filtro de Entrada Compuesto (`by`)

Aplica múltiples filtros de entradas en una sola llamada. Claves soportadas (todas opcionales):

types: slugs de tipos separados por comas (aplica by_type)
categories: slugs de categorías separados por comas (aplica by_category)
tags: tags separados por comas (aplica by_tag)
slugs: slugs de entradas separados por comas (aplica by_slug)
uuids: UUIDs separados por comas (aplica by_uuid)
locale: un único código de idioma (aplica by_lang; no acepta lista separada por comas)
from_published_date: fecha límite inicial (>= published_at)
to_published_date: fecha límite final (<= published_at)
sort_by: nombre de campo (name, slug, created_at, updated_at, published_at u otro path de campo)
order: asc | desc (default: desc)
per_page: cantidad de resultados por página (habilita paginación; default: 10)
page: número de página (default: 1)

ej. {% assign entries = spaces['testing'].entries | by: types: 'promo,basic', locale: 'es', categories: 'destacadas,favoritas', tags: 'test,test2', slugs: 'slug2,slug1', uuids: 'uuid2,uuid1', sort_by: 'name', order: 'asc', per_page: 10, page: 2 %}

# Filter By (Operadores Extendidos)

Retorna una lista de Entradas que cumplen con un filtro.

Parámetros:

entries (ArrayEntry) — array con entradas
opts (Hash) (default: {}) — hash con campo y pares operador/valor

El valor de field se escribe siempre con su prefijo:

fields.<nombre> para los campos del tipo de contenido.
meta.<atributo> para los metadatos, con estos atributos disponibles: meta.uuid, meta.name, meta.slug, meta.category, meta.category_slug, meta.category_name, meta.created_at, meta.updated_at, meta.published_at y meta.unpublished_at. Para filtrar por tags usa by_tag.

Atención

Un nombre de campo sin prefijo se descarta en silencio: el filtro no lanza error y devuelve la colección completa, sin filtrar. Si un listado te muestra todas las entradas, revisa primero que el valor de field empiece por fields. o por meta..

Operadores soportados (usar como llaves dentro de opts):

eq — igual a (implícito cuando solo se provee field y valor)
not — distinto de. Con nil como valor devuelve las entradas que tienen algún valor en el campo
gt, lt — mayor que / menor que
in — el valor del campo debe estar dentro de los valores separados por comas
nin — el valor del campo NO debe estar dentro de los valores separados por comas
has — el campo (tipo array) debe contener todos los valores separados por comas
search — busca el texto en los atributos de las ubicaciones de la entrada; necesita un campo de tipo ubicación
geohash — busca por proximidad con un geohash en base 32; necesita un campo de tipo ubicación

Solo in, nin y has aceptan un string separado por comas; el resto toma un valor único. search y geohash se comportan igual que en la API pública de Content. El operador all, que aparece en la lista de Filter By Query String, no está disponible en filter_by.

Ejemplos:

Filtrar entradas donde el campo status sea 'published' o 'featured': {% assign entries = entries | filter_by: field: 'fields.status', in: 'published,featured' %}

Filtrar entradas donde author_id no sea 1 ni 5: {% assign entries = entries | filter_by: field: 'fields.author_id', nin: '1,5' %}

Filtrar entradas que tengan ambos 'tech' y 'news' en su campo array categories: {% assign entries = entries | filter_by: field: 'fields.categories', has: 'tech,news' %}

Filtrar entradas cuyo campo subtitle tenga algún valor: {% assign entries = entries | filter_by: field: 'fields.subtitle', not: nil %}

Filtrar entradas publicadas después de una fecha: {% assign entries = entries | filter_by: field: 'meta.published_at', gt: '2026-01-01' %}

Atención

En dos casos filter_by aborta y en el HTML publicado queda el comentario  en lugar del bloque: cuando lo llamas sin field y cuando lo aplicas sobre una colección de la que no se puede resolver el tipo de contenido, como spaces['blog'].entries. Parte siempre de una colección acotada a un tipo, como spaces['blog'].types['post'].entries o widget.entries.

# Filter By Query String

Retorna una lista de Entradas que cumplen con un query. Se pueden usar operadores lógicos, varios campos meta, URLs, o tags de Liquid.

Operators:

gt, lt, in, all, nin

Fields:

meta.category meta.category_slug meta.category_name meta.uuid meta.name meta.created_at meta.updated_at meta.published_at meta.unpublished_at meta.slug meta.tag

Url examples:

https://company.site.com/testsite?meta.category_slug=category3
https://company.site.com/testsite?meta.tag=tag_name
https://company.site.com/testsite?meta.tag[in][]=tag1_name&meta.tag[in][]=tag2_name
https://company.site.com/testsite?meta.created_at=1987-11-19T13:13:13

e.g. {% assign entries = widget.entries | filter_by_query_string %}

Parametros:

entries (ArrayEntry) — array con entradas

# From Published Date

Retorna una lista de Entradas que tengan una fecha de publicación más reciente que el límite. e.g. {% assign entries = widgets.entries | from_published_date: date %}

Parametros:

entries (ArrayEntry) — array con entradas
date (Datetime)(default: Time.zone.now) — fecha límite

# Limit

Límita el número de resultados. e.g. {{ entries | limit: 1 }}

Parametros:

objeto(Array) — array
limit (Integer)(default: 1) — límite de resultados

# Paginated

Separa los resultados en páginas. e.g. {{ objects | paginated: 10, 2 }}

Parametros:

objeto(Array) — array
per_page (Integer) (default: 10) — objetos por página
page (Integer) (default: 1) — número de página a mostrar

# Sort By

Retorna un array con las entradas ordenadas por un campo e.g. {% assign entries = widgets.entries | sort_by: 'name', 'asc' %}

Parametros:

entries (ArrayEntry) — array con entradas
atributo (String) — campo por el cual se quiere ordenar
orden (String) - asc (asecendente) o desc (desciendiente)

# To Published Date

Retorna una lista de Entradas que tengan una fecha de publicación más vieja que el límite. e.g. {% assign entries = widgets.entries | to_published_date: date %}

Parametros:

entries (ArrayEntry) — array con entradas
date (Datetime)(default: Time.zone.now) — fecha límite

# Crypto

Estos filtros Liquid alteran valores relacionados con la Criptografía.

Atención

Los únicos filtros de hash de Modyo Platform son hmac_sha256 y sha256. md5, sha1 y hmac_sha1 no existen y, como un filtro desconocido no interrumpe el renderizado, Liquid devuelve el valor de entrada sin transformar: la página publica el dato en claro donde esperabas un hash. Revisa tus plantillas antes de firmar una integración con ellos.

# HMAC SHA256

Devuelve el hash SHA-256 de un string usando un código de autenticación de mensajes (HMAC), con la clave como argumento (ej. {{ 'Hello world' | hmac_sha256: 'key' }} #=> 'a82b2e160edaf92a6589dc11160d2a10c04449840a58717db308c1ee3512b039').

# SHA 256

Devuelve el hash SHA-256 de un string (ej. {{ 'Hello world' | sha256 }} #=> '64ec88ca00b268e5ba1a35678a1b5316d212f4f366b2477232534a8aeca37f3c').

# CSS

Estos filtros Liquid alteran valores relacionados con CSS en Modyo Platform.

Atención

Todos los filtros de color abortan si el valor de entrada no es un color válido, por ejemplo una variable que no existe en el contexto. Cuando eso pasa, en el HTML publicado queda el comentario  en lugar del color y la regla CSS que lo usaba se pierde.

# Brighten

Agrega brillo a un color (ej. {{ '#00ff00' | brighten: 15 }} #=> '#26ff26').

# Darken

Reduce el brillo de un color (ej. {{ '#00ff00' | darken: 15 }} #=> '#00b300').

# Desaturate

Desatura un color (ej. {{ '#00ff00' | desaturate: 15 }} #=> '#13ec13').

# Grayscale

Convierte un color a escala de grises (ej. {{ '#00ff00' | grayscale }} #=> '#808080'). Acepta un segundo argumento, pero no altera el resultado porque la conversión a escala de grises no lo usa.

# Greyscale

Convierte un color a escala de grises, con el mismo resultado que grayscale, pero recibe solo el color (ej. {{ '#00ff00' | greyscale }} #=> '#808080').

Atención

greyscale y grayscale no son intercambiables: greyscale no admite un segundo argumento. Una plantilla que pase intensidad, como {{ color | greyscale: 15 }}, aborta por el número de argumentos y en el HTML publicado queda el comentario . La misma plantilla con grayscale funciona.

# Lighten

Aligera un color (ej. {{ '#00ff00' | lighten: 15 }} #=> '#4dff4d').

# Opacity

Modifica la opacidad de un color (ej. {{ '#00ff00' | opacity: 0.5 }} #=> 'rgba(0, 255, 0, 0.5)').

# RGB

Transforma un color a su equivalente RGB (ej. {{ '#00ff00' | rgb }} #=> 'rgb(0, 255, 0)').

# Saturate

Satura un color (ej. {{ '#00ff00' | saturate: 15 }} #=> '#00ff00').

# Spin

Gira un color en grados a favor de las manecillas del reloj (ej. {{ '#00ff00' | spin: 15 }} #=> 'rgba(0, 255, 0, 0.5)').

# Location

Estos filtros Liquid alteran valores relacionados con la Geolocalización en Modyo Platform.

# Dynamic Map

Devuelve un mapa dinámico de Google Maps (ej. {{ locations | dynamic_map: '600x300', 'true', 'roadmap', true}}).

Parametros

locations (ArrayHash) — Array de hashes con los puntos de latitud y longitud.
size (String) (default: '600x300') — Tamaño en píxeles del mapa.
zoom (String) (default: 10) — Nivel de zoom para el mapa.
type (String) (default: 'roadmap') — Tipo de mapa.
icon (String) (default: '') — Icono para el mapa.
controls (String) (default: true) — Controles de navegación para el mapa.

# Static Map

Devuelve un mapa estático de Google Maps (ej. {{ locations | static_map: '600x300', 'true', 'roadmap'}}).

Parametros

locations (ArrayHash) — Array de hashes con los puntos de latitud y longitud.
size (String) (default: '600x300') — Tamaño en píxeles del mapa.
zoom (String) (default: 10) — Nivel de zoom para el mapa.
type (String) (default: 'roadmap') — Tipo de mapa.
icon (String) (default: '') — Icono para el mapa.

Estos filtros Liquid alteran valores relacionados con los ítems de menús en Modyo Platform.

# Active Page

Determina si un ítem URL está activo. Devuelve 'active' cuando está activo (ej. {{ 'company.modyo.com/jobs' | active_page: 'company.modyo.com/jobs' }} #=> 'active').

# Item Rel

Devuelve 'noopener noreferrer' si un enlace es "_blank" (ej. {{ '_blank' | item_rel }} #=> 'noopener noreferrer').

# Resolve URL

Resuelve la URL de un path y URL base (ej. {{ 'dynamic_bank' | resolve_url: 'company.modyo.com' }} #=> 'company.modyo.com/dynamic_bank').

# Visible Items

Devuelve una lista de ítems visibles en una lista de ítems (ej. {{ items | visible_items }}).

# Origination

Estos son los filtros liquid que alteran valores relacionados con originations en Modyo Platform.

# By UID

Devuelve el Origination con el UID seleccionado. ej. {% assign my_origination = site.originations | by_uid: 'my-origination' %}

Parámetros:

originations (ArrayOrigination) - array con originations
uid (String) - UID del Origination

# Site

Estos filtros Liquid alteran valores relacionados con los Sitios en Modyo Platform.

# Filtros retirados

Desde la versión 10.2 los filtros video_player, audio_player, embedded_video y asset_thumbnail_link_tag ya no existen. Los filtros bar_code y qr_code nunca existieron en Modyo Platform.

Atención

Un filtro desconocido no interrumpe el renderizado: Liquid devuelve el valor de entrada sin transformar. Una plantilla que todavía invoque estos filtros sobre un asset ya no muestra el reproductor ni el enlace y publica en su lugar el nombre interno del objeto que recibió, por ejemplo Liquid::Drops::Assets::VideoAssetDrop. No hay mensaje de error ni pista visible de la causa en la página, así que revisa tus plantillas antes de actualizar.

Para reemplazar video_player y audio_player, arma el markup con la dirección del archivo, disponible en url:

{% assign video = assets['uuid-del-video'] %}
<video src="{{ video.url }}" width="320" height="320" controls="controls"></video>

{% assign audio = assets['uuid-del-audio'] %}
<audio src="{{ audio.url }}" controls="controls"></audio>

Para reemplazar asset_thumbnail_link_tag, envuelve la miniatura, disponible en thumbnail_url, en un enlace al archivo:

{% assign image = assets['uuid-de-la-imagen'] %}
<a href="{{ image.url }}" class="thumbnail"><img src="{{ image.thumbnail_url }}" alt="{{ image.alt_text }}"></a>

embedded_video, bar_code y qr_code no tienen reemplazo: la plataforma no ofrece hoy un filtro equivalente.

# Asset image Tag

Genera la etiqueta HTML de una imagen (ej. {{ asset | asset_image_tag: 'original' }}).

# Asset URL

Genera la URL de un objeto Asset o una ruta de activo de plantilla. Para los objetos Asset que utilizan Cloudflare para la optimización de imágenes, puedes usar los siguientes parámetros adicionales: width, height, blur, quality, format y fit. (ej. {{ assets['asset_uuid'] | asset_url: blur: 40, format: 'auto', fit: 'cover' }}). Para las rutas de assets de plantilla (template asset paths) desde el template builder, especifica el tipo de asset como el segundo argumento (ej. {{ 'base' | asset_url: 'js' }}). También puedes usar los filtros script_tag o stylesheet_tag para generar automáticamente la etiqueta HTML <script> o <link> completa (ej. {{ 'base' | asset_url: 'css' | stylesheet_tag: media: 'screen' }}).

# Button To

Genera un botón (ej. {{ 'Hello World' | button_to: 'http://www.google.com' }}).

Devuelve el valor de una cookie (ej. {{ 32 | cookie_value }}).

# Escape JS

Evita interpretar código JavaScript (ej. {{ '<script>alert("hello world");</script>' | escape_js }}).

# Format Date

Traduce una fecha a otro formato (ej. {{ time | format_date: '%e %b, %Y' }}).

Parametros

time (DateTime) — Fecha.
format_date (String) (default: '') — El nuevo formato para la fecha.

# Format DateTime

Traduce una fecha a formato DateTime (ej. {{ time | format_datetime }}).

# Format Short Date

Traduce una fecha a un formato reducido (dd-mm-yyyy) (ej. {{ time | format_short_date }}).

# Get Session ID

Devuelve el identificador de la sesión actual.

ej. {{ '' | get_session_id }}

# Image Tag (URL Genérica)

Genera una etiqueta <img> simple para una URL cruda de imagen (no un objeto Asset).

ej. {{ 'https://cdn.example.com/logo.png' | image_tag }}

# Link To

Agrega una etiqueta de enlace (anchor link) (ej. {{ 'Hello World' | link_to: 'http://www.google.com', 'this is my alt', 'small', '_blank' }}).

Parametros

text (String) (default: '') — Texto para el enlace.
link (String) (default: '/') — URL para el enlace.
alt (String) (default: '') — Texto alternativo para el enlace.
class (String) (default: '') — Clase CSS para el enlace.
target (String) (default: '') — Target para el enlace.

# Notifications

Muestra la variable de mensaje flash (ej. {{ 'alert-error' | notifications }}).

# Primary button to

Genera un botón de tipo primario (ej. {{ 'Hello World' | primary_button_to: 'http://www.google.com', 'large' }}).

Parametros

text (String) (default: '') — Texto para el enlace.
link (String) (default: '/') — URL para el enlace.
size (String) (default: 'large') — Tamaño para el enlace.

# Sanitize HTML

Sanitiza las etiquetas HTML de un String (ej. {{ '<script>Hello World</script>' | sanitize }} #=> 'Hello World').

# Script tag

Agrega una etiqueta de script (ej. {{ 'test-script' | script_tag }}).

Agrega un campo de búsqueda (ej. {{ 'testsite' | search_box }}).

# Strftime

Convierte un datetime a formato String (ej. {{ time | strftime: '%m/%d/%y' }}).

# Strip tag

Elimina todas las etiquetas HTML y su contenido de un String (ej. {{ '<script>Hello World</script>' | strip_tags }} #=> "").

# Stylesheet Tag

Genera la etiqueta HTML <link> para un template CSS, tomando como parámetros la URL y atributos (ej. attr: 'value', {{ 'my-css-url' | stylesheet_tag: media: 'screen', title: 'color style' }} => <link href='my-css-url' rel='stylesheet' type='text/css' media='screen' title='color style' />).

# Theme Javascript

Agrega una etiqueta de tema en Javascript (ej. {{ 'home-page-javascript' | theme_javascript }}).

# Theme Stylesheet

Agrega una etiqueta de tema en CSS (ej. {{ 'home-page-stylesheet' | theme_stylesheet }}).

# Time Ago in Words

Convierte una fecha en String a palabras (ej. {{ '01-02-2019' | time_ago_in_words }} #=> 'over 3 years').

# Translate

Resuelve el texto de traducción para claves de Sitios. Se devolverán valores personalizados si existen (ej. {{ 'admin.logs.errors.no_logs_yet' | translate }}).

# Truncate HTML

Devuelve un String después de truncarlo (ej. {{ html | truncate_html: 10 }}).

# Step

Estos son los filtros liquid que alteran valores relacionados con steps en Modyo Platform.

# By UID

Devuelve el Step con el UID seleccionado. ej. {% assign my_step = origination.steps | by_uid: 'step-01' %}

Parámetros:

steps (ArrayStep) - array con steps
uid (String) - UID del Step

# Submission

Estos son los filtros liquid que alteran valores relacionados con submissions en Modyo Platform.

# By Origination

Devuelve los Submissions filtrados por UID de Origination. ej. {% assign filtered_submissions = user.submissions | by_origination: 'my-origination' %}

Parámetros:

submissions (ArraySubmission) - array con submissions del usuario
uid (String) - UID del Origination

# By Status

Devuelve los Submissions con el estado seleccionado. ej. {% assign filtered_submissions = user.submissions | by_status: 'completed' %}

Parámetros:

submissions (ArraySubmission) - array con submissions del usuario
status (String) - Estado de la respuesta. Los valores soportados son 'pending', 'completed' y 'all'

En Modyo 10.2 una respuesta puede estar en cuatro estados: No Iniciada, Pendiente, Completada y Cancelada. El filtro reconoce solo tres valores y no hay correspondencia directa con esos estados:

'pending' devuelve las respuestas Pendiente.
'completed' devuelve las respuestas Completada.
'all' no devuelve todas: entrega las Pendiente más las Completada, y deja fuera las No Iniciada y las Cancelada.
'not_started' y 'canceled' no están soportados. El filtro no falla ni deja rastro en la página: devuelve una colección vacía, así que el listado que los use se ve en blanco.

Atención

Una respuesta nace No Iniciada y pasa a Pendiente recién cuando se guarda la primera respuesta a una de sus tareas, así que las recién creadas no aparecen en los listados construidos con este filtro. Además, user.submissions ya viene acotado a las respuestas Pendiente y Completada, de modo que ninguna combinación de by_status alcanza a las No Iniciada ni a las Cancelada de esa colección.

Para listar los estados que el filtro no cubre, recorre una colección sin acotar, como user.invited_submissions, sin pasar por by_status, y compara submission.status dentro del ciclo:

{% assign invited = user.invited_submissions | by_origination: 'my-origination' %}
{% for invited_submission in invited %}
  {% if invited_submission.status == 'not_started' %}
    <a href="{{ invited_submission.resume_url }}">{{ invited_submission.origination.name }}</a>
  {% endif %}
{% endfor %}

# Completed

Verifica si un elemento (wrapper de step/task) está completado para un submission dado.

ej. {{ submission | completed: step }}

Parámetros:

submission (Submission) — submission actual (objeto antes de la barra)
element (Step|TaskResponse wrapper) — elemento a evaluar

Retorna: Boolean (true/false)

Desde Modyo 10.2 el filtro resuelve el estado contra el usuario presente en el contexto de render y no contra el titular de la respuesta: un step cuenta como completado solo si ese usuario tiene una respuesta completada en cada una de las tareas que ve. En un flujo con usuarios invitados, la misma plantilla entrega resultados distintos según quién la mire, y un step que en 10.1 aparecía completado puede aparecer incompleto.

Atención

El filtro necesita el objeto user en el contexto de la plantilla. Si no está, la evaluación aborta apenas la respuesta tiene al menos una tarea completada, y en el HTML publicado queda el comentario  en lugar del bloque, sin ningún aviso para quien navega. Protege el bloque con {% if user %} y asegúrate de que la plantilla reciba el usuario.

# URL (URL del Step para Submission)

Genera una URL navegable para un step dentro de un submission (primer task visible). Solo retorna valor si el submission está pendiente y el step está completado o el orden de steps permite navegación.

ej. {{ step | url: submission }}

Igual que completed, resuelve el step completado y la primera task visible contra el usuario del contexto de render, con las mismas consecuencias en flujos con usuarios invitados y el mismo comportamiento si falta user en el contexto.

Atención

Una respuesta recién creada está No Iniciada, no Pendiente, así que el filtro no devuelve valor justo en el caso más frecuente de una plantilla para retomar una respuesta. La respuesta pasa a Pendiente cuando se guarda la primera respuesta a una de sus tareas; hasta entonces, lleva al usuario al inicio del flujo con submission.resume_url, que no depende del estado.

# Resume Link

Retorna un tag HTML de enlace para retomar un step pendiente dentro de un submission, o el nombre del step si no hay URL disponible.

ej. {{ step | resume_link: submission }}

El enlace lo arma url, así que hereda todas sus condiciones: cuando url no devuelve valor, resume_link imprime el nombre del step como texto plano.

Atención

Sobre una respuesta No Iniciada el filtro imprime el nombre del step como texto plano y la página no muestra ningún error: la plantilla se ve completa, pero el usuario no tiene por dónde entrar. Lo mismo pasa cuando url no entrega enlace para ese step con el usuario del contexto. Revisa el estado de la respuesta antes de renderizar el listado y ofrece submission.resume_url mientras no esté Pendiente.

# Submissions Selector

Renderiza un fragmento HTML (dropdown) para seleccionar entre múltiples submissions pendientes (excluye el actual). No retorna nada si hay menos de 2 submissions pendientes.

ej. {{ pending_submissions | submissions_selector }}

# Task

Estos son los filtros liquid que alteran valores relacionados con tasks en Modyo Platform.

# By UID

Devuelve el Task con el UID seleccionado. ej. {% assign my_task = step.tasks | by_uid: 'task-01' %}

Parámetros:

tasks (ArrayTask) - array con tasks
uid (String) - UID del Task

# User

Estos filtros Liquid alteran valores relacionados con los Usuarios.

# Avatar For

Muestra el código HTML de la imagen de un usuario. Si el usuario no tiene avatar propio, entrega el avatar por defecto (ej. {{ user | avatar_for: 'C50x50', true }}).

Parámetros

user (User) — Objeto User.
size (String) (default: 'C50x50') — Tamaño para la imagen.
link (Boolean) (default: true) — true agrega un enlace hacia el perfil del usuario.

# Default Avatar Image

Muestra el código HTML del avatar por defecto. La firma es al revés de lo que sugiere el nombre: el valor que va antes de la barra es el tamaño, y el usuario es el primer argumento, opcional (ej. {{ 'C50x50' | default_avatar_image: user }}).

Parámetros

size (String) — Tamaño para la imagen, con el formato de las versiones de avatar: C25x25, C50x50, C75x75, C100x100, C125x125, C160x160, C200x200 o C250x250.
user (User) (default: nulo) — Objeto User del contexto Liquid. Tiene que ser el objeto, no un id ni un correo.

Devuelve una de tres imágenes, según lo que reciba:

Con un usuario cuyo reino tiene configurada la Imagen de avatar por defecto en Configuración de reino, la imagen del reino en el tamaño pedido.
Con un usuario cuyo reino no la tiene configurada, la imagen de marcador de posición en el tamaño pedido.
Sin usuario, la imagen de marcador de posición en el tamaño pedido.

Tip

Para el caso habitual no necesitas llamarlo: avatar_for ya recurre a default_avatar_image cuando el usuario no tiene avatar propio. Llámalo directo solo cuando quieras el avatar por defecto sin consultar el del usuario.

# By Form Slug

Retorna respuestas de formulario del usuario filtradas por un slug específico.

ej. {% assign responses = user.responses | by_form_slug: 'onboarding-form' %}

Parámetros:

responses (Array<FormResponse>) — user.responses
form_slug (String) — slug del formulario a coincidir

# By Response Date Range

Retorna respuestas de formulario creadas dentro de un rango de fechas (inclusivo).

ej. {% assign responses = user.responses | by_response_date_range: '2025-03-10', '2025-03-20' %}

Parámetros:

responses (Array<FormResponse>) — user.responses
date_from (String/Date) — fecha inicial (recomendado YYYY-MM-DD)
date_to (String/Date) — fecha final (recomendado YYYY-MM-DD)

# By Answer Text

Retorna respuestas de formulario que contienen una respuesta cuyo answers.text_field coincide exactamente con el texto provisto.

ej. {% assign responses = user.responses | by_answer_text: 'Blue' %}

Parámetros:

responses (Array<FormResponse>) — user.responses
answer_text (String) — texto exacto a coincidir

Estos filtros Liquid alteran valores relacionados con los Widgets.

# Entry Limit

Determina el límite de entradas para un widget (ej. {{ widget1 | entry_limit }}).

Devuelve una lista de todos los widgets que pertenecen a un Sitio (ej. {{ site | resolve_home_widget_list }}).

Devuelve una lista de todos los widgets que pertenecen a una página "me" (ej. {{ site | resolve_me_widget_list }}).

Devuelve una lista de todos los widgets que pertenecen a una página (ej. {{ site | resolve_widget_list: page }}).

Parámetros

site (Site) — Objeto de tipo Sitio.
page (Page) — Objeto de tipo Página.

← Objetos Tags →

# Filtros

# Básicos

# Append

# Base64 decode

# Base64 encode

# Capitalize

# Ceiling

# Date

# Default

# Divided by

# Downcase

# Escape

# Escape once

# First

# Floor

# Format date

# Join

# Last

# Lstrip

# Map

# Minus

# Modulo

# Newline to br

# Plus

# Prepend

# Remove

# Remove first

# Replace

# Replace first

# Reverse

# Round

# Rstrip

# Script tag

# Size

# Slice

# Sort

# Split

# Times

# Truncate

# Truncatewords

# Uniq

# Upcase

# URL encode

# Commerce

# Format currency

# Content

# Búsqueda de assets por UUID

# Asset image

# Asset link

# Asset URL by UUID

# Asset video

# By category

# By lang

# By slug

# By tag

# By type

# By UUID

# Filtro de Entrada Compuesto (by)

# Filter By (Operadores Extendidos)

# Filter By Query String

# From Published Date

# Limit

# Paginated

# Sort By

# To Published Date

# Crypto

# HMAC SHA256

# SHA 256

# CSS

# Brighten

# Darken

# Desaturate

# Grayscale

# Greyscale

# Lighten

# Opacity

# RGB

# Saturate

# Spin

# Location

# Filtro de Entrada Compuesto (`by`)