eCommerce: Modifica dei modelli di notifiche e-mail

Le notifiche di Ecwid sono progettate per fornire importanti informazioni sull'ordine al cliente e al titolare dello store. Tali notifiche sono realizzate con l'aiuto dei tag HTML e utilizzano variabili speciali per visualizzare le informazioni effettive sull'ordine nelle e-mail.

In questo articolo viene descritto l'elenco delle variabili disponibili e vengono forniti degli esempi del loro utilizzo.

 

Guarda un video su come modificare i modelli delle notifiche tramite e-mail:

Variabili per le informazioni sui clienti

Nome Descrizione
${customer.name} Visualizza il nome del cliente.
${customer.email} Visualizza l'e-mail del cliente
${customer.membership_name} Visualizza il nome del gruppo di clienti
${customer.membership_id} Visualizza l'ID del gruppo di clienti

Variabili per le informazioni sugli ordini

Nome Descrizione
<#list order.items as orderItem> </#list> Visualizza l'elenco dei prodotti ordinati.
${orderItem.name} Visualizza il nome del prodotto.
${orderItem.sku} Visualizza lo SKU del prodotto.
<#noescape>${orderItem.description}</#noescape> Visualizza la descrizione del prodotto.
${orderItem.customerUrl} Richiama l'URL della pagina del prodotto.
${orderItem.imageUrl} Visualizza l'immagine del prodotto.
${orderItem.quantity} Visualizza la quantità di articoli ordinati.
${orderItem.price} Visualizza il prezzo del prodotto.
${orderItem.isShippingRequired}  
${orderItem.weight} Visualizza il peso dell'articolo ordinato.
${orderItem.subtotal} Visualizza il subtotale di articoli dell'ordine (prezzo articolo x quantità di articoli ordinati).
<#list orderItem.options as option> </#list> Visualizza l'elenco delle opzioni selezionate per il prodotto.
${option.name} Visualizza il nome dell'opzione.
${option.value} Visualizza l'importo del modificatore di prezzo.
<#list orderItem.attributes as attribute> </#list> Visualizza l'elenco degli attributi nascosti impostati per il prodotto.
${attribute.name} Visualizza il titolo dell'attributo nascosto.
${attribute.value} Visualizza il nome dell'attributo nascosto.
<#list orderItem.visibleAttributes as visibleAttribute> </#list> Visualizza l'elenco degli attributi impostati per il prodotto.
${visibleAttribute.name} Visualizza il titolo dell'attributo.
${visibleAttribute.value} Visualizza il nome dell'attributo.
<#list orderItem.files as file> </#list> Visualizza l'elenco dei file allegati al prodotto.
${file.description} Visualizza la descrizione del file.
${file.fileName}  
${file.name} Visualizza il nome del file.
${file.type} Visualizza il tipo di file.
${file.size} Visualizza la dimensione del file.
${file.url} Aggiunge un link per il download del file.
${order.number} Visualizza il numero dell'ordine.
${order.customerUrl} Aggiunge l'URL al profilo del cliente. Vuoto se l'ordine è stato effettuato in modo anonimo.
<@orderLink/> Aggiunge il numero dell'ordine. Se l'ordine è stato effettuato da un cliente registrato, contiene un URL della cronologia degli ordini del cliente. Se il cliente non è registrato, il numero dell'ordine sarà visualizzato come testo normale.
${order.adminUrl} Aggiunge un link all'ordine nel Pannello di controllo Ecwid.
${order.dateCreated} Visualizza la data in cui l'ordine è stato effettuato.
${order.paymentStatus} Visualizza lo stato corrente del pagamento dell'ordine.
<@paymentStatusColor/> Consente di modificare il colore dell'elemento ${order.paymentStatus} a seconda dello stato del pagamento.
${order.subtotal} Visualizza il subtotale dell'ordine.
${order.total} Visualizza il totale dell'ordine.
${order.shippingCost} Visualizza la tariffa di spedizione per l'ordine.
${order.weight} Visualizza il peso totale degli articoli ordinati.
<#list order.taxes as tax> </#list> Visualizza un elenco di tasse applicate all'ordine.
${tax.name} Visualizza il nome della tassa.
${tax.value} Visualizza il valore della tassa.
<#list order.discounts as discount> </#list> Visualizza un elenco dello sconto applicato all'ordine.
${discount.name} Visualizza il nome dello sconto.
${discount.value} Visualizza il valore dello sconto.
${order.couponPercent} Visualizza la percentuale del coupon di sconto applicata all'ordine.
${order.couponName} Visualizza il nome del coupon di sconto.
${order.couponCode} Visualizza il codice coupon di sconto.
${order.totalDiscount} Visualizza l'importo totale del valore dello sconto applicato all'ordine.
${order.isShippingRequired}  
${order.shippingAddress} Visualizza l'intero indirizzo di spedizione per l'ordine. È anche possibile visualizzare separatamente ciascun elemento dell'indirizzo di spedizione.
${order.shippingAddress.name} Visualizza il nome del cliente.
${order.shippingAddress.companyName} Visualizza il nome della società specificato nell'indirizzo di spedizione
${order.shippingAddress.street} Visualizza la via specificata nell'indirizzo di spedizione.
${order.shippingAddress.city} Visualizza la città specificata nell'indirizzo di spedizione.
${order.shippingAddress.country} Visualizza il paese specificato nell'indirizzo di spedizione.
${order.shippingAddress.countryCode} Visualizza il codice del paese specificato nell'indirizzo di spedizione del cliente
${order.shippingAddress.postalCode} Visualizza il codice postale specificato nell'indirizzo di spedizione.
${order.shippingAddress.state} Visualizza lo stato specificato nell'indirizzo di spedizione.
${order.shippingAddress.stateCode} Visualizza il codice dello stato specificato nell'indirizzo di spedizione del cliente
${order.shippingAddress.phone} Visualizza il numero di telefono del cliente.
${order.shippingAddress.province} Visualizza la provincia specificata nell'indirizzo di spedizione.
${order.shippingAddress.provinceCode} Visualizza il codice della provincia specificato nell'indirizzo di spedizione del cliente
${order.billingAddress} Visualizza l'intero indirizzo di spedizione per l'ordine. È anche possibile visualizzare separatamente ciascun elemento dell'indirizzo di spedizione.
${order.billingAddress.name} Visualizza il nome del cliente.
${order.billingAddress.companyName} Visualizza il nome della società specificato nell'indirizzo di spedizione.
${order.billingAddress.street} Visualizza la via specificata nell'indirizzo di fatturazione.
${order.billingAddress.city} Visualizza la città specificata nell'indirizzo di fatturazione.
${order.billingAddress.country} Visualizza il paese specificato nell'indirizzo di fatturazione.
${order.billingAddress.countryCode} Visualizza il codice del paese specificato nell'indirizzo di fatturazione del cliente
${order.billingAddress.postalCode} Visualizza il codice postale specificato nell'indirizzo di fatturazione.
${order.billingAddress.state} Visualizza lo stato specificato nell'indirizzo di fatturazione.
${order.billingAddress.stateCode} Visualizza il codice dello stato specificato nell'indirizzo di spedizione del cliente
${order.billingAddress.phone} Visualizza il numero di telefono specificato nell'indirizzo di fatturazione.
${order.billingAddress.province} Visualizza la provincia specificata nell'indirizzo di fatturazione.
${order.billingAddress.provinceCode} Visualizza il codice della provincia specificato nell'indirizzo di spedizione del cliente
${order.pickupTime} Visualizza l'orario di ritiro selezionato da un cliente
${order.isPaid}  
${order.paymentMethod} Visualizza il titolo "Metodo di pagamento": e il nome del metodo di pagamento.
${order.PaymentMethod.isOnline}  
${order.PaymentMethod.instructionsTitle} Visualizza il titolo delle istruzioni di pagamento.
${order.PaymentMethod.instructions} Visualizza il contenuto delle istruzioni di pagamento.
${order.PaymentMethod.name} Visualizza il nome del metodo di pagamento.
${order.orderComments} Visualizza i commenti all'ordine.
${order.privateAdminNotes} Visualizza le note all'ordine del personale aggiunte dal proprietario dello store.
${order.isPaymentStatusUpdated}  
${order.isFulfillmentStatusUpdated}  
${order.fulfillmentStatus} Visualizza lo stato di evasione corrente dell'ordine.
${order.trackingNumber} Visualizza il numero di tracciabilità dell'ordine, se abilitato.
${order.trackingUrl} Aggiunge l'URL della pagina di tracciabilità dell'ordine per le opzioni di spedizione calcolate dal corriere.
${order.affiliateID} Visualizza l'ID affiliato dell'ordine.
${order.extraFields}  
<#list order.extraFields as extraField> </#list> Visualizza l'elenco dei campi aggiuntivi dell'ordine.
${extraField.key} Visualizza la chiave del campo aggiuntivo.
${extraField.value} Visualizza il valore del campo aggiuntivo.
${extraField.title} Opzionale. Visualizza il titolo del campo aggiuntivo.
${extraField.orderDisplaySection} Opzionale. Visualizza il titolo del campo aggiuntivo.
${extraField.type} Visualizza il tipo di campo aggiuntivo. 

Variabili per le informazioni sui prodotti

Nome Descrizione
${product.name} Visualizza il nome del prodotto.
${product.sku} Visualizza lo SKU del prodotto.
${product.quantity} Visualizza la quantità del prodotto.
${product.adminUrl} Visualizza l'URL della pagina del prodotto nel Pannello di controllo Ecwid.
${product.customerUrl} Aggiunge l'URL della pagina del prodotto.
${product.imageUrl} Visualizza l'immagine del prodotto.
${product.warningLimit} Visualizza la quantità di articoli in magazzino che fa scattare la "Notifica per livello di scorte basso".
${product.options}  
<#list product.options as option> </#list> Visualizza l'elenco delle opzioni del prodotto.
${option.name} Visualizza il nome dell'opzione.
${option.value} Mostra il valore dell'opzione selezionata.
${product.attributes}  
<#list product.attributes as attribute> </#list> Visualizza l'elenco degli attributi nascosti impostati per il prodotto.
${attribute.name} Visualizza il titolo dell'attributo nascosto.
${attribute.value} Visualizza il nome dell'attributo nascosto.
<#list product.visibleAttributes as visibleAttribute> </#list> Visualizza l'elenco degli attributi impostati per il prodotto.
${visibleAttribute.name} Visualizza il titolo dell'attributo.
${visibleAttribute.value} Visualizza il nome dell'attributo.

Variabili disponibili per le informazioni sullo store

Nome Descrizione
${store.id} Visualizza l'ID dello store
${store.name} Visualizza il nome dello store.
${store.logoUrl} Richiama l'URL del logo dello store.
<@storeLogo/> Visualizza il logo dello store. Se il logo non è specificato, visualizza il nome dello store.
${store.storeUrl} Richiama il front URL dello store.
${store.companyEmail} Visualizza l'e-mail aziendale, che è specificata nelle impostazioni dello store.
${store.customerOrdersPageUrl} Richiama l'URL alla pagina della cronologia degli ordini del cliente.
<#list store.legalPages as page> </#list> Visualizza l'elenco delle pagine legali.
${page.name} Mostra il nome di alcune pagine legali.
${page.url} Richiama l'URL della specifica pagina legale.
<@legalPages/> Visualizza l'elenco delle pagine legali in una singola stringa.
${store.controlPanelUrl} Aggiungi l'URL https://my.ecwid.com/cp/ al messaggio.
${store.egoodsLinkLifetime} Visualizza la durata del link di merci elettroniche.
${store.egoodsMaxDownloadAttempts} Mostra la quantità massima di tentativi di download per i prodotti merci elettroniche.
${store.officeAddress} Visualizza l'indirizzo fisico dello store, che è specificato nelle impostazioni dello store.
${store.resetPasswordUrl} Aggiunge l'URL di reimpostazione della password di un cliente al messaggio.
${store.businessRegistrationID} Visualizza l'ID registrazione dello store (IVA).

Variabili per le informazioni sulla marca

Nome Descrizione
${brand.name} Visualizza il nome della marca "Ecwid".
${brand.logoUrl} Richiama l'URL del logo Ecwid.

Se un elemento contiene un elemento secondario, la richiesta sarà simile a questa: $ {order.shippingAddress.city}

L'elenco degli elementi può essere specificato utilizzando questa costruzione:

<#list order.items as orderItem>
${orderItem.name}
</#list>

 

Modificare l'e-mail di conferma dell'ordine

Ecwid fornisce messaggi predefiniti per le conferme degli ordini, pagati e non pagati, per mantenere aggiornati i clienti.

Gli ordini pagati generano il seguente messaggio:

Grazie per il tuo ordine presso lo store $ {store.name}! 
Ti invieremo un'email di notifica non appena il pacco verrà spedito.

Gli ordini non pagati (ad esempio i metodi di pagamento offline) generano il seguente messaggio:

Grazie per il tuo ordine presso lo store ${store.name}! 
Il tuo ordine del ${order.dateCreated} è stato inviato e sarà elaborato 
alla ricezione del pagamento.

Puoi personalizzare questi messaggi per sintonizzarli con lo stile del tuo store usando HTML.

La variabile ${store.name} visualizza il nome dello store nel messaggio. Puoi posizionarlo in qualsiasi parte del messaggio.

Rimuovere il numero telefonico aziendale dall'e-mail di conferma dell'ordine

Se fornito, aggiungiamo il numero di telefono della tua azienda ai messaggi di conferma dell'ordine per impostazione predefinita. Se desideri rimuovere questa linea dalle tue e-mail, elimina la seguente riga di codice dai modelli di conferma dell'ordine:

<#if (store.officeAddress.phone)?has_content> 
or call <b>${store.officeAddress.phone}</b></#if>

La variabile ${store.officeAddress.phone} è responsabile della visualizzazione del numero di telefono nell'e-mail. Se rimuovi questa linea dal codice del modello, il numero di telefono non verrà visualizzato.

Utilizzare i campi aggiuntivi dell'ordine

I campi aggiuntivi dell'ordine ti consentono di salvare alcune informazioni aggiuntive per l'ordine. Possono essere visibili o nascoste al cliente.

Ulteriori strumenti per lavorare con campi aggiuntivi dell'ordine includono due funzioni e una serie di oggetti: getOrderExtraFieldValue("key")getOrderExtraField("key"), order.extraFields.

Ecco alcuni esempi: 

Mostra tutti i campi aggiuntivi dell'ordine impostati per essere visibili nei dettagli dell'ordine (titolo e orderDisplaySection sono specificati)

<#list order.extraFields as extraField>
	<#if extraField.title?has_content && extraField.orderDisplaySection?has_content>
${extraField.title}: ${extraField.value}
	</#if>
</#list>

Stampa il valore di un campo aggiuntivo di un ordine specifico

<#assign myExtraFieldValue = getOrderExtraFieldValue("askHowYouFoundUsApp")>
<#if myExtraFieldValue?has_content>
	${myExtraFieldValue}
</#if>

In cui "askHowYouFoundUsApp" è la chiave del campo aggiuntivo dell'ordine.

Stampa campi specifici del un campo aggiuntivo di un ordine specifico (rimuovi i campi che non è necessario mostrare)

<#assign myExtraField = getOrderExtraField("askHowYouFoundUsApp")>
${myExtraField.key}
${myExtraField.value}
${myExtraField.type}
${myExtraField.orderDisplaySection}
${myExtraField.title}

In cui "askHowYouFoundUsApp" è la chiave del campo aggiuntivo dell'ordine.