Sintaxis de Liquid compatible con las plantillas de teléfono

Obtén información sobre las etiquetas, los filtros y las variables comunes de Liquid compatibles con las plantillas de teléfono.

Para obtener una visión general de la sintaxis de Liquid, consulta la introducción a LiquidJS. Incluye un breve resumen de los dos tipos de marcado de Liquid:

• Salidas, que generan HTML.

  La sintaxis de las salidas consiste en una variable o un valor y una lista opcional de filtros delimitados por {{ y }}. Por ejemplo, {{ user.name }}.

• Etiquetas, que controlan el renderizado de la plantilla e implementan lógica.

  La sintaxis de las etiquetas consiste en un nombre de etiqueta y argumentos opcionales delimitados por {% y %}. Por ejemplo, {% if user_metadata.lang == 'it' %} Ciao! {% endif %}.

Esta página enumera las etiquetas, los filtros y las variables compatibles con las plantillas de teléfono.

​

Etiquetas

Todas las plantillas de teléfono admiten las siguientes etiquetas de Liquid:

Categoría	Etiquetas
Iteración	for, cycle, tablerow
Flujo de control	if, unless, elsif, else, case
Variable	assign, increment, decrement
Archivo	include, layout
Lenguaje	raw, comment

Puede consultar descripciones y ejemplos de etiquetas de Liquid en la página de etiquetas de LiquidJS.

​

Filtros

Todas las plantillas de teléfono admiten los siguientes filtros de Liquid:

Categoría	Filtros
Matemáticas	plus, minus, modulo, times, floor, ceil, round, divided_by, abs, at_least, at_most
Cadena	append, prepend, capitalize, upcase, downcase, strip, lstrip, rstrip, strip_newlines, split, replace, replace_first, remove, remove_first, truncate, truncatewords
HTML/URI	escape, escape_once, url_encode, url_decode, strip_html, newline_to_br
Arreglo	slice, map, sort, sort_natural, first, last, join, reverse, size
Fecha	date
Varios	default

Puede consultar descripciones y ejemplos de los filtros de Liquid en la página de filtros de LiquidJS.

​

Variables generales

Las siguientes variables están disponibles en el campo Plantilla de mensajes de texto de cada plantilla de teléfono, salvo que se indique lo contrario.

Las propiedades basadas en URL, como logo_url, se codifican automáticamente para URL a fin de reducir los riesgos de seguridad. Los números de teléfono se almacenan con su prefijo de país (+<country_code>), excepto los números de teléfono de EE. UU., que pueden omitirlo.

• Información relacionada con el inquilino definida en Configuración del Tenant:

  • tenant, que es el nombre original del inquilino
  • friendly_name
  • support_email
  • support_url
  • logo_url
  • home_url
  • region

• locale, que se basa en el parámetro de consulta ui_local de las solicitudes a /authorize

• code (no disponible en las plantillas blocked_account)

• connection, el nombre de la conexión de base de datos

• Las siguientes variables de user:

  • user.name
  • user.nickname
  • user.given_name
  • user.family_name
  • user.picture
  • user.login_count
  • user.user_metadata, atributos del usuario que no afectan la funcionalidad principal del usuario, incluidas sus preferencias
  • user.app_metadata, atributos del usuario que pueden afectar la funcionalidad principal del usuario, como el funcionamiento de una aplicación o a qué puede acceder, incluido su plan de soporte, sus roles de seguridad y sus grupos de control de acceso
  • user.email_verified
  • user.email
  • user.phone_number
  • user.phone_verified
  • user.multifactor
  • user.source_ip
  • user.country
  • user.city

• Las siguientes variables de client:

  • name
  • clientID
  • metadata

• El objeto application, con acceso a las propiedades estándar del cliente, como application.name y application.client_metadata

• Cuando un usuario inicia sesión a través de una Organización, están disponibles las siguientes variables adicionales:

  • organization.id
  • organization.name
  • organization.display_name
  • organization.metadata
  • organization.branding.logo_url
  • organization.branding.colors.primary
  • organization.branding.colors.page_background

• Varias variables de dominios personalizados:

  • custom_domain.domain, el nombre de dominio del inquilino
  • custom_domain.domain_metadata, los campos de metadatos del dominio personalizado (pares clave-valor)