Come saltare le righe in un blocco di tabella dinamica

Cosa imparerai

Scopri come ignorare le righe (ad esempio gli articoli) in un blocco di tabella dinamica. Il caso d'uso più comune è nascondere gli articoli non pertinenti, come l'assicurazione sulla spedizione o gli articoli in omaggio, da un'e-mail di carrello abbandonato. Tuttavia, puoi seguire questi passaggi per qualsiasi e-mail che utilizza un blocco di tabella dinamica.

Prima di iniziare

Questo articolo spiega come nascondere elementi dai blocchi di tabelle dinamiche esistenti. Se non hai ancora creato un blocco di tabella dinamica funzionante (ad esempio, i prodotti in un’e-mail di carrello abbandonato o di conferma ordine), scopri come crearne uno da zero oppure inizia con un messaggio nella nostra libreria di flussi.

Scrivi le tue istruzioni if

Prima di apportare modifiche al modello, crea 2 snippet di codice usando un editor di testo o di codice (in un punto da cui potrai copiare e incollare gli snippet in un secondo momento). Ogni snippet di codice sarà composto da 3 parti:

1. Un tag if di apertura, {% if ... %}, che indica quali elementi devono comparire nel tuo blocco tabella.
2. Contenuto, come un tag immagine o del testo sul prodotto.
3. Un tag di chiusura, {% endif %}.

Crea il tag di apertura if

Ecco alcuni esempi di tag if di apertura:

Crea il contenuto per l’istruzione if

Per i contenuti, segui questi passaggi per usare i contenuti esistenti dal blocco della tabella dinamica. Scrivi questo snippet di codice in un editor di codice o di testo; lo aggiungerai al tuo modello nella prossima sezione.

1. In Contenuto cella per l’immagine del blocco tabella, fai clic su Sostituisci per visualizzare il segnaposto dell’immagine.
   

2. Copia l’intero codice dal campo Variabile dinamica o URL dinamico. Tieni presente che può trattarsi di una semplice variabile dinamica oppure di uno snippet di codice più lungo; copialo tutto, indipendentemente dalla lunghezza.
   

3. Sostituisci il segnaposto in questo snippet di codice con il codice che hai copiato dal campo Variabile dinamica o URL dinamico.
   

<img src="PLACEHOLDER" style="width: 200px; height: auto;" width="200">

Se il tuo blocco tabella esistente ha una semplice variabile dinamica per l’immagine, il contenuto risultante avrà un aspetto simile a questo:

<img src="{{item.product.variant.images.0.src}}" style="width: 200px; height: auto;" width="200">  

Se il tuo blocco tabella esistente contiene uno snippet di codice più lungo, il contenuto risultante potrebbe avere questo aspetto:

<img src="{% if item.product.variant.images.0.src %}{{item.product.variant.images.0.src}}{%else%}{{item.product.images.0.src|missing_product_image}}{%endif%}" style="width: 200px; height: auto;" width="200">

Aggiungi il tag di chiusura

Poi, unisci tutti i contenuti: la tua istruzione if di apertura, poi i tuoi contenuti e, infine, un tag di chiusura {% endif %}.

Ripeti per il contenuto del testo

Poi ripeti questa procedura con il contenuto sul lato destro del blocco tabella (ad es. il contenuto di testo). Fai clic su </> per aprire l’editor di codice e copiare tutto il contenuto HTML, quindi racchiudi questo contenuto nella stessa istruzione if (passaggi 1 e 3) che hai usato per il contenuto dell’immagine.

ecco come appare tutto insieme:

Ecco una panoramica di questi snippet di codice:

Dopo aver scritto entrambi gli snippet di codice, continua nell’editor del modello seguendo i passaggi riportati di seguito.

Salta le righe in un blocco tabella dinamica

1. Se la tua e-mail fa parte di un flusso, impostala su Bozza o Manuale in modo che i messaggi non vengano inviati mentre modifichi il messaggio del flusso.
2. Assicurati che l’ contenuto della cella di entrambe le colonne del nuovo blocco tabella sia impostato su testo.
   

3. Fai clic su </> per aprire l’editor HTML per il lato sinistro del blocco tabella.
4. Copia lo snippet di codice dell'immagine del prodotto che hai creato nella sezione precedente e incollalo nel campo HTML.
   

5. Clicca su Fine in alto a sinistra.
6. Vai all'editor per il lato destro del blocco tabella.
7. Fai clic su </> per aprire l'editor HTML per il lato destro del blocco tabella.
8. Copia lo snippet di codice dei dettagli del prodotto che hai creato nella sezione precedente e incollalo nel campo HTML, sostituendo tutti i contenuti precedenti.
9. Clicca su Fine.
10. Visualizza in anteprima l’e-mail per assicurarti che venga visualizzata come previsto: l’elemento saltato non deve comparire, ma tutti gli altri elementi verranno visualizzati normalmente. Assicurati di visualizzare l’anteprima con un evento che contenga l’elemento che stai cercando di nascondere, così puoi verificare che sia nascosto.

Istruzioni condizionali ed editor di testo in linea

Quando aggiungi alcune istruzioni condizionali a un blocco di testo, queste possono scomparire dall'editor di testo in linea. Il codice è ancora presente, ma è solo nascosto. Per visualizzare e modificare le istruzioni condizionali, utilizza il Django Tag Builder oppure sposta il contenuto in un blocco HTML dedicato per modificare direttamente il codice.

I seguenti tag non compaiono nell’editor di testo in linea, ma restano nel blocco di testo:

• {% for ... %}
• {% endfor %}
• {% if ... %}
• {% elif ... %}
• {% else %}
• {% endif %}
• {% with ... %}
• {% endwith %}

Risoluzione dei problemi

Nell'anteprima non viene visualizzato alcun elemento

1. Assicurati di visualizzare l’anteprima con un evento che corrisponda all’origine dati utilizzata (ad esempio Started checkout per un messaggio sul carrello abbandonato).
2. Assicurati che Repeat for e Row alias corrispondano esattamente a Row collection e Row alias del blocco originale.

L'elemento che dovrebbe essere ignorato è ancora visualizzato

Controlla l’ortografia e le maiuscole/minuscole dell’istruzione if. Se il prodotto continua a essere visualizzato, significa che soddisfa i criteri nella tua istruzione if, quindi la tua istruzione if non è configurata correttamente. Scopri di più sulla logica condizionale nei modelli.

Risultato

Dopo aver seguito questi passaggi, tutti gli elementi che non soddisfano i criteri nella tua istruzione if non verranno visualizzati in messaggi come le e-mail di carrello abbandonato o di conferma ordine. 

Risorse aggiuntive