Zoho Mail plugin for CraftCMS

Craft is a content management platform that help content creators and businesses to create and manage their websites and e-commerce sites with the help of open source tools and versatile integrations.

The Zoho Mail plugin for CraftCMS will help you to configure Zoho Mail to send emails to the people who interact with your application or website automatically based on the templates you configure.

Table of Contents

Installing Zoho Mail plugin for CraftCMS

  1. Once you log in to the CraftCMS Admin Dashboard, navigate to the Plugin Store on the felt menu search for the Zoho Mail plugin using the Search option available at the top bar.
  2. Choose Zoho Mail from the Search results. Navigate to the Installation Instructions section and copy the installation command for the latest version.
  3. In your system, open the Command (Windows) or Terminal (Apple) and go to the CraftCMS root directory on your server and enter the installation command copied.
  4. Run the command to download and install the module.
  5. On successful installation of the package, navigate back to the Administrator Panel and you can find the Zoho Mail plugin available on the left pane.

Configuration of Zoho Mail plugin

On successful installation of the plugin you can proceed to the configuration of Zoho Mail plugin:

  1. Log in to the CraftCMS Admin Dashboard and locate the Zoho Mail plugin from the left menu.
  2. In the Account configuration window, choose the region in which your Zoho Account Data resides. (One of the valid domains hosted with Zoho)
    Account configuration
  3. Copy the Authorized Redirection URL from the configuration page.
  4. Log in to your Zoho Mail account, and access the Zoho Developer Console to create a new Client ID and Client Secret to access Zoho Mail API.
  5. Click on Get Started if you have no existing Client. If you have an existing client, click on Add Client in the top-right corner.
  6. Select Server-based Applications in the Client Type window.
  7. Provide the appropriate Client Name and your domain in Homepage URL along with the Authorized Redirect URL copied from your CraftCMS account.​​
  8. Click Create to generate the Client ID and Client Secret.
  9. Navigate to the Zoho Mail configuration page in CraftCMS Admin Account.
  10. Enter the Client ID and Client Secret obtained from the Zoho Developer Console on this page.
  11. Click Authorize.
  12. You will be taken to the Zoho Mail account authorization window. Enter your email account credentials and click Accept.
    Authorize CraftCMS to access Zoho Mail
  13. On successful authorization, you'll be taken to the Email Configuration window.
    Email configuration
  14. Provide a display name and choose the email address from the drop-down provided using the which the emails should be sent from your website or application hosted on CraftCMS.
    1. The email addresses shown here will be the alias/ external addresses in addition to the primary email address of the account used to authorize the use of Zoho Mail plugin.
  15. Click Save.
  16. The email configuration will be saved and you can also choose to modify the configuration any time, using the option given for the same.

You can also choose to send test email using the Test button given below the Email Configuration window.

Use Zoho Mail plugin to send emails from CraftCMS

Once successfully configured, you can use Zoho Mail plugin to send emails from your website or application hosted on CraftCMS.

To send emails using the Zoho Mail plugin:

  1. Log in to the CraftCMS Admin Dashboard and navigate to Settings from the left menu.
  2. Select Email from the System section.
  3. Navigate to the Transport Type section and choose Zoho Mail from the drop-down.
    Email module settings
  4. Provide the preferred values for the following options:
    1. System email address - The email address that will be used to send emails from CraftCMS.
    2. Reply-To address - To which the recipients of the email should respond to.
    3. Sender name - The display name to be shown on the outgoing emails.
    4. HTML email template - The email template to be sent to the audience interacting with your website.
  5. Click Save at the top-right corner.

Note:

Zoho Mail cannot be used for sending out emails in the following categories:

  1. Promotional emails, Bulk or Mass emails, Marketing emails, and Newsletters. You can use Zoho Campaigns which is designed and optimized to send bulk, promotional, marketing emails, and newsletters.
  2. Transactional emails. You can use Zoho ZeptoMail which is specifically designed and optimized to send transactional emails to your customers.

Troubleshooting

Invalid Client Secret

  1. While configuring your plugin, ensure you have entered the correct information in the Domain field. Select the region in which your Zoho account is hosted (.in, .com, etc).
  2. Verify if the Client ID and Client Secret used in the configuration page match with the Client created for the plugin in Zoho Developer Console.

If the above-given troubleshooting method does not resolve the issue, reach out to our Customer support (support@zohomail.com) with the screenshot of the configuration settings page for a solution.

Still can't find what you're looking for?

Write to us: support@zohomail.com