Easy Digital Downloads utilise des balises de modèle pour vous permettre d’insérer des données dans vos e-mails. Ce sont simplement des fonctions qui génèrent des données à afficher dans l’e-mail. Voici les balises de modèle par défaut :
- {download_list} – Une liste des téléchargements avec des liens cliquables pour chaque téléchargement acheté
Remarque : L’e-mail de notification de vente n’inclura pas de liens cliquables, car ceux-ci sont uniquement destinés au reçu client par e-mail. - {file_urls} – Une liste en texte brut des URL de téléchargement pour chaque téléchargement acheté
- {name} – Le prénom de l’acheteur
- {fullname} – Le nom complet de l’acheteur, prénom et nom
- {username} – Le nom d’utilisateur de l’acheteur sur le site, s’il a créé un compte
- {user_email} – L’adresse e-mail de l’acheteur
- {billing_address} – L’adresse de facturation de l’acheteur
- {date} – La date de l’achat
- {subtotal} – Le prix de l’achat avant taxes
- {tax} – Le montant taxé de l’achat
- {price} – Le prix total de l’achat
- {payment_id} – Le numéro d’identification unique de cet achat
- {receipt_id} – Le numéro d’identification unique de ce reçu d’achat
- {payment_method} – La méthode de paiement utilisée pour cet achat
- {sitename} – Le nom de votre site
- {receipt_link} – Ajoute un lien pour que les utilisateurs puissent consulter leur reçu directement sur votre site Web s’ils ne peuvent pas l’afficher correctement dans le navigateur.
- {discount_codes} – Ajoute une liste des codes de réduction appliqués à cet achat
- {ip_address} – L’adresse IP de l’acheteur
EDD dispose de fonctions intégrées pour vous aider à créer de nouvelles balises, supprimer des balises existantes et tester si une balise donnée existe.
Ajouter une nouvelle balise
Voici un exemple d’extrait que vous pouvez utiliser et étendre selon vos besoins : https://library.wpcode.com/snippet/j578kp2g/
Supprimer une balise
Si vous supprimez une balise que vous avez créée, supprimez simplement tout le code que vous avez écrit pour la créer. Une fois le transient expiré, elle aura disparu. Si vous souhaitez supprimer une balise principale, vous pouvez utiliser quelque chose comme l’exemple ci-dessous :
function edd_my_remove_tags() {
edd_remove_email_tag( 'name' );
}
add_action( 'edd_add_email_tags', 'edd_my_remove_tags', 99 );
Dans l’exemple ci-dessus, « name » est le nom de la balise. Nous nous accrochons toujours à edd_add_email_tags même si nous la supprimons. Notez la priorité de 99. La priorité par défaut des crochets d’action WordPress est 10. En la remplaçant et en la définissant sur 99, nous lui disons de s’exécuter après toute autre fonction accrochée avec une priorité inférieure à 99. Si la balise d’e-mail que vous essayez de supprimer est ajoutée dans une fonction avec une priorité supérieure à 99, vous devrez augmenter la priorité pour vous assurer qu’elle est supérieure à ce nombre – et s’exécute donc « après » l’ajout de la balise. Essentiellement, vous ne pouvez pas supprimer une balise qui n’a pas encore été ajoutée.
Rechercher une balise
Si vous souhaitez voir si une balise existe, vous pouvez faire ceci :
if ( edd_email_tag_exists( 'name' ) ) {
echo "Yep!";
}
edd_email_tag_exists() renvoie un booléen.
