PrivateContent Mail Actions add-on

Documentation for v1.7 and later


Introduction

Before going through documentation chapters, thanks for purchasing PrivateContent Mail Actions add-on and trusting LCweb!

Need further help?

Open a ticket

Need a customization?

Ask for a quote

Installation

E-mail System Setup

Normally any server has got a limited number of e-mails per hour. Usually this number varies from few hundreds to a thousand.

If you are expecting a high e-mail activity, be sure your server can handle that or e-mails won't be sent without any warning.

E-mail builders

E-mail titles and texts caould contain placeholders to show dynamic data.
The allowed variables for each module are specified on top of each e-mail builder block.

Using Wordpress editor in "visual" mode, it will create the HTML code to be inserted in e-mail.
While using "text" mode you can send advanced e-mail templates (created by you or taken from external services like Mailchimp).

In any case an e-mail test is suggested before using a module.

You can also use PrivateContent User Data add-on shortcode to use custom users data in e-mails

Users Verification

Landing Page

If called directly, the landing page will redirect to the homepage. Then it MUST be a newly created page.
It should not be changed once the system is active or the links sent via mail won't work!

Users status

Remember that users must be registered with pending status to trigger this system. Obviously an active user can't be validated again

Manual e-mail sending

Is also posssible to manually send the verification e-mail. Directly from Mail Actions settings for user group or on "edit user" page for individuals.
Please note that user will be able to verify themselves only through the URL contained in last e-mail received

MailChimp Sync

Unsubscribed Users - Webhook

The add-on has got an endpoint URL to track mailchimp subscribed users.
The URL to use is in Mail Action settings, show once you set up the API key.

There you'll find a link guiding you on Mailchimp's page where to create webhooks.
Create a webhook with these exact options

Notes:

Bulk Actions

The sync uses Mailchimp batches to avoid excessive server usage. These actions (eg. manual sync) aren't immediate, then expect a little delay (around 5 minutes) to see changes in Mailchimp

Users Management

Remember that sync is performed from PvtContent to Mailchimp, then any change performed in Mailchimp won't be reflected

Users Unsubscription

The above note doesn't apply to useres deletion or subscription if you setup webhook. Unsubscribed/deleted useres will be marked as "no sync" in pvtContent

User Categories

Once you performed the first manual sync, a list will be created, containing user categories. this list MUST NOT be touched, to avoid sync troubles

Quick Mail

Mail Actions adds a system to quickly contact user groups even without MailChimp.
It's a very basic e-mail system: just insert an e-mail title, description and select one or more categories you want to reach.

Be careful in case of massive users database: each hosting has an outgoing e-mail limit per hour.
If you exceed the limit, e-mail commands will just be ignored and won't be possible to know how many e-mails have been successfully sent.

Multilanguage

The plugin is 100% multilanguage for both front and back ends. If a translation of your language has been created, WordPress will automatically switch between languages.
Plus it is compatible with WPML, Polylang and qTranslate!

How to create a translation

If you have WPML + String Translation add-on or Polylang, you can simply scan the plugin and translate strings via its UI.

Otherwise: go in the plugin folder, you'll find a folder called "languages".
Inside you'll find the default.pot file. It contains english strings to be translated.

If you want to create or customize your language translation, follow these steps:

  1. Open the default.pot file with POedit
  2. Edit the catalog by inserting your data and setting translation's language
  3. Save the file with your language's i18n identifier and "pcma_ml-" prefix (the italian example is pcma_ml-it_IT)
  4. Go to the plugin folder ".. wp-content/plugins/private-content-mail-actions/languages" and paste and paste resulting .PO and .MO files

If you create new translations, please contact me at support@lcweb.it sending your .PO and .MO files.
Otherwise they will be lost in next updates. Thanks!

LCweb - Copyright © 2019 - All Rights Reserved