Add documentation for using custom email domain

[victorlin]

The custom domain documentation only provides instructions for the app service. It would be great if there was additional documentation on changing the email domain so that the sender address is [email protected] instead of the default which looks something like DoNotReply@a9ad25fe-cef3-43d3-bbe8-8b57eb2fce56.us1.azurecomm.net.

These were the steps I took to achieve that:

1. Go to the Email Communication Service resource > Settings > Provision domains
2. Select Add domain > Custom domain
3. Follow prompts to add the domain name
   • Note: This will create a new Email Communication Services Domain resource.
   • Note: For proper domain verification, I had to use @ instead of the domain for the TXT name.
4. Go to the Communication Service resource > Email > Domains
5. Disconnect the default domain: Options (3 dots) > Disconnect
6. Select Connect domain
7. Follow prompts to add the new Email Communication Services Domain resource
8. Go to the App Service resource > Settings > Environment variables
9. Edit the WP_EMAIL_CONNECTION_STRING
10. Replace [email protected] with [email protected]
11. Apply changes
12. Restart app service (?)

I can submit these steps as a PR if preferred.

[bmanjwani]

@victorlin
We have existing documentation for WordPress email integration. The steps for Azure managed domains are nearly identical to those for custom domains. You can find the specific steps for Azure managed domains here: WordPress Email Integration on GitHub.

For integrating custom domains with your ACS email addresses, please follow the instructions in these links:

Add Custom Verified Domains

[victorlin]

@bmanjwani thanks for those links. I was able to figure this out but those links aren't sufficient.

• The Wordpress Email Integration doc does not provide or link to instructions for setting up a custom domain, only noting that an Azure managed domain is provided by default.
• The Add Custom Verified Domains doc is only for steps 1-3 in the issue description.

My suggestion is to add a new section in the Wordpress Email Integration doc. Example:

Configuring a custom domain for sender address

1. Add a custom domain to the Email Communication Service resource by following instructions here: Add Custom Verified Domains
2. Go to the Communication Service resource > Email > Domains
3. Disconnect the default domain: Options (3 dots) > Disconnect
4. Select Connect domain
5. Follow prompts to add the new Email Communication Services Domain resource created from step 1.
6. Go to the App Service resource > Settings > Environment variables
7. Edit the WP_EMAIL_CONNECTION_STRING
8. Replace [email protected] with [email protected]
9. Apply changes
10. Restart app service (?)

[inclusiviteasy]

Oh man thanks for this, the missing piece for me was changing the environment variable... thanks for highlighting this @victorlin!