Le notifiche e-mail di StoreFront sono progettate per fornire informazioni importanti ai clienti e ai proprietari degli store. Queste notifiche vengono create con l'aiuto dei tag HTML e utilizzano variabili speciali per visualizzare le informazioni effettive sull'ordine nelle e-mail.
Di seguito ti forniamo un elenco delle variabili disponibili con la relativa descrizione.
Le notifiche e-mail personalizzabili sono disponibili per i piani Venture e di livello superiore.
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 Menu dello Store. |
| ${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 Menu di Store. |
| ${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 per le informazioni di 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} | Aggiunge l'URL https://my.e-shop.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. |
Nota
Se un elemento ne contiene un altro secondario, la richiesta sarà simile a $ {order.shippingAddress.city}
L'elenco degli elementi può essere specificato utilizzando la seguente costruzione:
<#list order.items as orderItem>
${orderItem.name}
</#list>Modificare l'e-mail di conferma dell'ordine
StoreFront consente di mantenere aggiornati i clienti tramite messaggi predefiniti per le conferme degli ordini, pagati e non pagati.
Gli ordini pagati generano il seguente messaggio:
Grazie per il tuo ordine presso lo store $ {store.name}!
Ti invieremo un'e-mail di notifica non appena il pacco verrà spedito.Gli ordini non pagati (ad esempio quelli acquistati tramite 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 posizionarla in qualsiasi punto del messaggio.
Rimuovere il numero di telefono aziendale dall'e-mail di conferma dell'ordine
Se fornito, il numero di telefono della tua azienda viene aggiunto ai messaggi di conferma dell'ordine per impostazione predefinita. Per rimuovere questo dato dalle tue e-mail, elimina la seguente riga di codice dai modelli di conferma d'ordine:
<#if (store.officeAddress.phone)?has_content>
or call <b>${store.officeAddress.phone}</b></#if>Dalla variabile ${store.officeAddress.phone} dipende la visualizzazione del numero di telefono nell'e-mail. Se rimuovi questa riga dal codice del modello, il numero di telefono non verrà visualizzato.
Usare campi aggiuntivi dell'ordine
I campi aggiuntivi ti consentono di salvare ulteriori informazioni sull'ordine. Possono essere visibili al cliente o meno.
Altri strumenti per gestire i campi aggiuntivi dell'ordine comprendono due funzioni e una serie di oggetti: getOrderExtraFieldValue("key"), getOrderExtraField("key"), order.extraFields.
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.
Stampare determinati campi di un campo aggiuntivo specifico dell'ordine, rimuovendo 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.