Les 14: E-mails verzenden met plezier
Deze tutorial-les demonstreert verschillende mogelijkheden van Gato GraphQL om e-mails te verzenden.
E-mails verzenden
We verzenden e-mails via de mutatie _sendEmail die wordt geleverd door de Email Sender extensie.
- De e-mail wordt verzonden met het inhoudstype "text" of "HTML" afhankelijk van welke eigenschap van de
messageAs-invoer wordt gebruikt - De
from-invoer is optioneel; als die niet wordt opgegeven, worden de instellingen gebruikt die zijn opgeslagen in WordPress _sendEmailvoert de WordPress-functiewp_mailuit, dus het gebruikt de configuratie die in WordPress is gedefinieerd voor het verzenden van e-mails (zoals de te gebruiken SMTP-provider)
mutation {
sendTextEmail: _sendEmail(
input: {
from: {
email: "from@email.com"
name: "Me myself"
}
replyTo: "replyTo@email.com"
to: "target@email.com"
cc: ["cc1@email.com", "cc2@email.com"]
bcc: ["bcc1@email.com", "bcc2@email.com", "bcc3@email.com"]
subject: "Email with text content"
messageAs: {
text: "Hello world!"
}
}
) {
status
errors {
__typename
...on ErrorPayload {
message
}
}
}
sendHTMLEmail: _sendEmail(
input: {
to: "target@email.com"
subject: "Email with HTML content"
messageAs: {
html: "<p>Hello world!</p>"
}
}
) {
status
errors {
__typename
...on ErrorPayload {
message
}
}
}
}De e-mail samenstellen met Markdown
Het veld _strConvertMarkdownToHTML van de Helper Function Collection extensie converteert Markdown naar HTML.
We kunnen dit veld gebruiken om de e-mail samen te stellen met Markdown:
query GetEmailData {
emailMessage: _strConvertMarkdownToHTML(
text: """
We have great news: **Version 1.0 of our plugin will be released soon!**
If you'd like to help us beta test it, please complete [this form](https://forms.gle/FpXNromWAsZYC1zB8).
_Please reply by 30th June 🙏_
Thanks!
"""
)
@export(as: "emailMessage")
}
mutation SendEmail @depends(on: "GetEmailData") {
_sendEmail(
input: {
to: "target@email.com"
subject: "Great news!"
messageAs: {
html: $emailMessage
}
}
) {
status
errors {
__typename
...on ErrorPayload {
message
}
}
}
}Dynamische gegevens in de e-mail injecteren
Met de functievelden van PHP Functions via Schema kunnen we een berichtsjabloon maken met tijdelijke aanduidingen en deze vervangen door dynamische gegevens:
query GetPostData($postID: ID!) {
post(by: {id: $postID}) {
title @export(as: "postTitle")
excerpt @export(as: "postExcerpt")
url @export(as: "postLink")
author {
name @export(as: "postAuthorName")
url @export(as: "postAuthorLink")
}
}
}
query GetEmailData @depends(on: "GetPostData") {
emailMessageTemplate: _strConvertMarkdownToHTML(
text: """
There is a new post by [{$postAuthorName}]({$postAuthorLink}):
**{$postTitle}**: {$postExcerpt}
[Read online]({$postLink})
"""
)
emailMessage: _strReplaceMultiple(
search: ["{$postAuthorName}", "{$postAuthorLink}", "{$postTitle}", "{$postExcerpt}", "{$postLink}"],
replaceWith: [$postAuthorName, $postAuthorLink, $postTitle, $postExcerpt, $postLink],
in: $__emailMessageTemplate
)
@export(as: "emailMessage")
subject: _sprintf(string: "New post created by %s", values: [$postAuthorName])
@export(as: "emailSubject")
}
mutation SendEmail @depends(on: "GetEmailData") {
_sendEmail(
input: {
to: "target@email.com"
subject: $emailSubject
messageAs: {
html: $emailMessage
}
}
) {
status
}
}Een notificatie-e-mail naar de beheerder sturen
We kunnen het e-mailadres van de beheerder ophalen uit de WordPress wp_options-tabel en deze waarde injecteren in het to-veld:
query ExportData {
adminEmail: optionValue(name: "admin_email")
@export(as: "adminEmail")
}
mutation SendEmail @depends(on: "ExportData") {
_sendEmail(
input: {
to: $adminEmail
subject: "Admin notification"
messageAs: {
html: "There is a new post on the site, go check!"
}
}
) {
status
}
}Als alternatief, als Geneste mutaties zijn ingeschakeld in de Schema Configuration, kunnen we het e-mailadres van de beheerder al ophalen in de mutation-operatie (en het via Field to Input in de mutatie injecteren):
mutation SendEmail {
adminEmail: optionValue(name: "admin_email")
_sendEmail(
input: {
to: $__adminEmail
subject: "Admin notification"
messageAs: {
html: "There is a new post on the site, go check!"
}
}
) {
status
}
}Een gepersonaliseerde e-mail naar gebruikers sturen
Om deze GraphQL-query te laten werken, moet de Schema Configuration die op het endpoint is toegepast Geneste mutaties hebben ingeschakeld
Omdat _sendEmail een globaal veld is (of, preciezer gezegd, een globale mutatie), kan het worden uitgevoerd op elk type uit het GraphQL-schema, inclusief User.
Deze query haalt een lijst van gebruikers op, verzamelt hun gegevens (naam, e-mailadres en het aantal resterende credits, dat is opgeslagen als meta) en stuurt een gepersonaliseerde e-mail naar elk van hen:
mutation {
users {
email
displayName
credits: metaValue(key: "credits")
# If the user does not have meta entry "credits", use `0` credits
hasNoCreditsEntry: _isNull(value: $__credits)
remainingCredits: _if(condition: $__hasNoCreditsEntry, then: 0, else: $__credits)
emailMessageTemplate: _strConvertMarkdownToHTML(
text: """
Hello %s,
Your have **%s remaining credits** in your account.
Would you like to [buy more](%s)?
"""
)
emailMessage: _sprintf(
string: $__emailMessageTemplate,
values: [
$__displayName,
$__remainingCredits,
"https://mysite.com/buy-credits"
]
)
_sendEmail(
input: {
to: $__email
subject: "Remaining credits alert"
messageAs: {
html: $__emailMessage
}
}
) {
status
errors {
__typename
...on ErrorPayload {
message
}
}
}
}
}