Easy Digital Downloads usa tags de modelo para permitir que você insira dados em seus e-mails. Estas são simplesmente funções que geram dados para renderização no e-mail. Estas são as tags de modelo padrão:
- {download_list} – Uma lista de downloads com links clicáveis para cada download comprado
Nota: O e-mail de Notificação de Venda não incluirá links clicáveis, pois estes são apenas para o recibo do cliente. - {file_urls} – Uma lista em texto simples de URLs de download para cada download comprado
- {name} – O primeiro nome do comprador
- {fullname} – O nome completo do comprador, primeiro e último
- {username} – O nome de usuário do comprador no site, se ele registrou uma conta
- {user_email} – O endereço de e-mail do comprador
- {billing_address} – O endereço de cobrança do comprador
- {date} – A data da compra
- {subtotal} – O preço da compra antes dos impostos
- {tax} – O valor taxado da compra
- {price} – O preço total da compra
- {payment_id} – O número de ID exclusivo desta compra
- {receipt_id} – O número de ID exclusivo deste recibo de compra
- {payment_method} – O método de pagamento usado para esta compra
- {sitename} – O nome do seu site
- {receipt_link} – Adiciona um link para que os usuários possam ver o recibo diretamente em seu site, caso não consigam visualizá-lo corretamente no navegador.
- {discount_codes} – Adiciona uma lista de quaisquer códigos de desconto aplicados a esta compra
- {ip_address} – O endereço IP do comprador
O EDD possui funções integradas para ajudá-lo a criar novas tags, remover tags existentes e testar se uma determinada tag existe.
Adicionando uma Nova Tag
Aqui está um trecho de exemplo que você pode usar e estender conforme necessário: https://library.wpcode.com/snippet/j578kp2g/
Removendo uma Tag
Se você estiver removendo uma tag que criou, simplesmente remova todo o código que escreveu para criá-la. Assim que o transient expirar, ela desaparecerá. Se você quiser remover uma tag principal, pode usar algo como o exemplo abaixo:
function edd_my_remove_tags() {
edd_remove_email_tag( 'name' );
}
add_action( 'edd_add_email_tags', 'edd_my_remove_tags', 99 );
No exemplo acima, ‘name’ é o nome da tag. Nós ainda nos conectamos a edd_add_email_tags mesmo que a estejamos removendo. Observe a prioridade de 99. A prioridade padrão do hook de ação do WordPress é 10. Ao substituir isso e defini-la como 99, estamos dizendo para executá-la após qualquer outra função conectada com prioridade menor que 99. Se a tag de e-mail que você está tentando remover for adicionada em uma função com prioridade superior a 99, você terá que aumentar a prioridade para garantir que ela seja maior que esse número – e, portanto, seja executada “depois” que a tag for adicionada. Essencialmente, você não pode remover uma tag que ainda não foi adicionada.
Procurando por uma Tag
Se você quiser ver se uma tag existe, pode fazer algo como isto:
if ( edd_email_tag_exists( 'name' ) ) {
echo "Yep!";
}
edd_email_tag_exists() retorna um booleano.
