How Can We Help?
< Back
You are here:
Print

Basic Installation

  • Extract all files in the .zip file downloaded from griffinhosting.com.
  • Upload all files (retaining directory structure “modules/addons/email_plus”) to your WHMCS installation using FTP. NOTE : You must upload all files in “binary” mode, as they are encrypted. Not using binary mode could result in PHP errors and/or blank screens in WHMCS. See – http://docs.whmcs.com/Blank_or_Partially_Rendered_Pagesfor troubleshooting steps, before opening a support ticket with us.
  • Log in to your WHMCS installation as an administrator and select “setup”, “Addon Modules”.
  • Activate the Email Plus addon.
  • Click on “configure”, to bring up the configuration page.
  • Insert you license key from GriffinHosting.com and select how long to retain email logs. Note: This log is separate from you WHMCS logs. The Email Plus+ logs also keep track of deliver, opens and clicks from your selected provider.
  • Insert your API credentials provided by your selected email provider. Note : you may use more than one provider. (See instructions for each provider, on this site)
  • Select the users allowed to access the module and then select “save”.
  • Select your inbound processing settings (If using inbound parsing to support ticket integration).
  • Select a user that has API access.
  • Enter the number of days to store sent and received logs. Logs will be pruned as part of the nightly WHMCS cron job process.
  • Click on “addons”, “WHCMS Email Plus+”.
  • Verify license key and click on “Recheck License Now”.
  • Select from the menu on the left sidebar, “Template Configs”.
  • Using the drop-down list, select an external email provider for each template (or leave as internal to use the built-in smtp settings in WHMCS).
  • Input any tracking tags that will be passed to your provider for reporting and stats. Click on “Update” to save all settings.
  • Send a test email (using one of templates configured for an external provider).
  • For troubleshooting, you can enable module logging by going to “Utilities”, “Logs”, “Module logs” and enable debug logging. All email plus actions are logged, and API replies from providers are also logged.
  • Log in to your select provider, and configure Event webhooks and/or Inbound parsing (for support ticket integration). The URL’s to use will be displayed on the addon home page.
  • Insert the following lines (see sample below in yellow) to the “postSend” function right before the “try” command. OR upload and over-write with the files provided with email plus+ in the “vendor” folder to all “phpmailer” locations on your server.
  • Included in the software package file is a pre-configured (with the Email Plus+ settings) PHPMailer_5.2.26, which you can upload to your server (over-writing existing files in /vendor/phpmailer/phpmailer). This version is NEWER than the version provided by WHMCS. It includes several security updates, and vulnerability fixes. Use at your own risk!
  • Configure all other features and options as needed. (see additional Docs on this website for each provider).
  • For live updates to delivery, opens and click information, you will need to create webhooks back to your WHMCS installation. Please see your providers documentation on creating and using webhooks. The URL to use, is shown on the addon page in WHMCS (once installed).
Table of Contents