# 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'

# 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.

# Asset image

Retorna los tags de una imagen usando su uuid del Gestor de Archivos. e.g. {{ uuid | asset_image }}

# Asset link

Retorna el URL de una imagen usando su uuid del Gestor de Archivos. e.g. {{ uuid | asset_link: 'Este es una liga para el asset' }}

# 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 que pertenecen a un lenguaje seleccionado. e.g. {% assign entries = widget.entries | locale: 'es,en,pt' %} => entries

Parametros:

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

# 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.

# Filter By

Retorna una lista de Entradas que cumplen con un filtro. e.g. {% assign entries = widget.entries | filter_by: field: 'name', eq: 'entry3Cat3' %}

Parametros:

entries (ArrayEntry) — array con entradas
opts (Hash) (default: {}) — hash con el campo y eq como el valor

# 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.

# Base64 Decode

Devuelve el valor Base64-decoded de un string (ej. {% 'Hello world' | base64_encode %} # => 'SGVsbG8gd29ybGQ=').

# Base64 Encode

Devuelve el valor Base64-encoded de un string (ej. {% 'SGVsbG8gd29ybGQ=' | base64_decode %} # => 'Hello world').

# HMAC SHA1

Devuelve el hash SHA-1 usando un código de autenticación de mensajes (HMAC) de un string (ej. {% 'Hello world' | hmac_sha1: 'key' %} # => '2a73959742baf046e6e2e27e5ee94bcff0af31b1').

# HMAC SHA256

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

# MD5

Devuelve el hash MD5 de un string (ej. {% 'Hello world' | md5 %} # => '3e25960a79dbc69b674cd4ec67a72c62').

# SHA1

Devuelve el hash SHA-1 de un string (ej. {% 'Hello world' | sha1 %} # => '7b502c3a1f48c8609ae212cdfb639dee39673f5e').

# 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.

# 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').

# 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.

# Asset image Tag

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

# Asset Thumbnail Link Tag

Genera la etiqueta HTML del thumbnail de una imagen (ej. {{ asset | asset_thumbnail_link_tag: 'class', 'target' }}).

Parametros

asset (Asset) — Objeto de tipo Asset.
classes (String) (default: '') — Clases HTML adicionales (opcional).
target (String) (default: '') — Targets HTML adicionales (opcional).

# Asset URL

Genera la URL de un objeto tipo Asset (ej. {{ asset | asset_url: 'original' }}).

# Audio Player

Genera la URL de un objeto tipo Audio (ej. {{ audio1 | audio_player }}).

# Bar Code

Genera la URL de un código de barras (ej. {{ value | bar_code: 320, 320 }}).

Parametros

value (String) — Valor del código de barras.
width (Integer) (default: 100) — Ancho.
height (Integer) (default: 100) — Alto.

# 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 }}).

# Embedded Video

Devuelve la URL de un video integrado (ej. {{ movie2 | embedded_video }}).

# 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 }}).

# 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.

# QR Code

Genera un código QR (ej. {{ value | qr_code: 4, 320, 320 }}).

Parametros

value (String) (default: '') — Valor para el QR.
qr_size (Integer) (default: 4) — Tamaño del QR.
width (Integer) (default: 100) — Ancho del QR.
height (Integer) (default: 100) — Alto del QR.

# 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 }}).

# Video Player

Agrega un reproductor de video en código HTML usando un asset del Gestor de Archivos (ej. {{ movie1 | video_player: 320, 320 }}).

Parámetros

video (Asset) — Objeto de tipo Video del Gestor de Archivos.
width (Integer) — Ancho para el video.
height (Integer) — Alto para el video.

# 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 los Originations. Los valores soportados son 'pending', 'completed' y 'all'

# 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.

# Default Avatar Image

Muestra la imagen por defecto del avatar (ej. {{ user | avatar_for: 'C50x50' }}).

Parámetros

user (User) — Objeto User.
size (Integer) (default: 'C50x50') — Tamaño para la imagen.

# Image For

Muestra el código HTML para la imagen de un usuario (ej. {{ user | avatar_for: 'C50x50', true }}).

Parámetros

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

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 →