Padroneggiare il nuovo linguaggio di personalizzazione

Per realizzare i casi d'uso di personalizzazione semplici che avanzati, puoi e dovresti utilizzare il nuovo linguaggio di personalizzazione disponibile nella tua interfaccia. Questo linguaggio è stato progettato per semplificare la maggior parte dei casi d’uso comuni o ricorrenti.

Si basa su Liquid, un linguaggio open source sviluppato da Shopify. È pensato per essere semplice e intuitivo, permettendoti di personalizzare email e altri contenuti in modo dinamico senza dover possedere conoscenze avanzate di programmazione.

Il linguaggio include variabili, condizioni, loop e altre funzioni che ti consentono di adattare i contenuti, formattare testi o applicare calcoli matematici, tra le molte possibilità offerte.

Uno dei suoi principali punti di forza è la facilità d’uso. Chi inizia può apprendere rapidamente i concetti di base, mentre gli utenti più esperti possono sfruttarne la flessibilità per implementare personalizzazioni più avanzate e dinamiche. Essendo integrato in numerose piattaforme note, è una scelta comune tra sviluppatori e integratori.

-----

Esempio

Puoi inserire una variabile utilizzando la sintassi: {{ contact.firstname }} oppure puoi mostrare una parte dell’email in base alla lingua del contatto: {% if contact.language == "IT" %} Ciao {% else %} Hello {% endif %}

----

Esempi di casi d'uso

Nuova variabile Liquid

Contatto

Per aggiungere la variabile del nome (in precedenza $firstname$)

{{contact.firstname}}

Contatto

Per aggiungere la variabile mirror link

{{mirror_page_url}}

Contatto

Per aggiungere il link di disiscrizione (in precedenza $unsub_url$)

{{unsubscription_form_url}}

Contatto

Per mostrare una variabile in base alla lingua (in precedenza con
{% SPLIO IF language == "IT" %}

{% if contact.language == "IT" %} Ciao {% else %} Ciao {% endif %}

Contatto e prodotto
Creare un loop di prodotti basato su un campo della tabella dei contatti.

{% create_products_list list_of_products = contact.custom_fields['custom_field_name'] %}

{% for product in list_of_products %}

{{ product.name }}

{% endfor %}

Ordine
Per evidenziare ogni prodotto di un ordine utilizzando blocchi condizionali e campi personalizzati per riga d’ordine.

{% for orderline in order.orderlines %}

{% if orderline.custom_fields['custom_field_name'] == 'toto' %}

{{ orderline.product.name }}

{% endif %}

{% endfor %}

Prodotti

Per mostrare prodotti a partire da determinati ID prodotto.

{% create_products_list list_of_products = ['product_id_1','product_id_2'] %}

{% for product in list_of_products %}

{{ product.name }}

{% endfor %}

Contatto

Esempio che combina una condizione con un campo personalizzato.

{% if contact.custom_fields['gender'] == 'M' %}
Buongiorno Sig.
{% elsif contact.custom_fields['gender'] == 'F' %}
Buongiorno S.ra
{% else %}
Buongiorno
{% endif %}

Ordine
Per iterare su uno scontrino di acquisto
{{ order.external_id }} e mostrare la quantità e il nome del prodotto per ogni riga dell’ordine:

{% for orderline in order.orderlines %}
{{orderline.quantity}} x {{orderline.product.name}}
{% endfor %}

Prodotti

Per mostrare i prodotti la cui lista è salvata in un campo personalizzato del contatto, ad esempio una wishlist:

{% create_products_list list_of_products = contact.custom_fields['wishlist'] %}
{% for product in list_of_product %}
{{product.name}}
{% endfor %}

Prodotti

Per mostrare i prodotti in un formato visuale (ad esempio, una tabella a due colonne).

{% for orderline in order.orderlines %}

{{orderline.product.name}}

{{orderline.product.img_url}}

{% endfor %}