Before going through documentation chapters, thanks for purchasing PrivateContent Mail Actions add-on and trusting LCweb!
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 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
Starting from v1.8, the add-on supports e-mail templates to be used. This means a fixed code will be used as base, while its contents will be replaced.
Let's make practical example: assume you created a basic template like this
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>My site</title> </head> <body> <div><h1>My Site Title</h1></div> <div>%CONTENT%</div> <footer>My site © %YEAR%</footer> </body> </html>
assume also to have attachedit to the "user verification" and "password recovery" systems.
It will be used as base and the %CONTENT% placeholder will be replaced each time with specific "user verification" and "password recovery" e-mail texts.
You can easily understand how powerful it can be, keeping all HTML and CSS codes in one place while only textual contents can be used for the add-on systems.
You can also use complex templates taken from external services like Mailchimp.
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!
Remember that users must be registered with pending status to trigger this system. Obviously an active user can't be validated again
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
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
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
Remember that sync is performed from PvtContent to Mailchimp, then any change performed in Mailchimp won't be reflected
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
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
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.
The add-on 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 and Polylang!
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 two folders called "languages" and "lang_admin".
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:
If you create new translations, please contact me at email@example.com sending your .PO and .MO files.
Otherwise they will be lost in next updates. Thanks!