=== EELV Newsletter === Contributors: bastho, ecolosites Donate link: http://ba.stienho.fr#don Tags: newsletter, email, tracking, addressbook, mailing, contacts Requires at least: 5.1 Tested up to: 5.4 Stable tag: stable License: GPLv2 License URI: https://www.gnu.org/licenses/gpl-2.0.html Add a registration form on Front-office a newsletter adminer on BackOffice : manage skins, address book, archives, answers, tracking == Description == = Add a registration form on FrontOffice, a newsletter manager on BackOffice : = * manage skins * address book * archives * answers = Freely manage content = * shortcuts to add last posts or pages preview * the plugin allows to use shortcodes into the newsletters = Subscribe / unsubscribe form = - Create a new page and put the shortcode [eelv_news_form] in the content. - Go to the configuration page on the wordpress admin to manage defaults values for expeditor and fill the unsuscribe page (the page wich contains the shortcode [eelv_news_form] to allow visitors to suscribe/unsuscribe your newsletter) - available attributes : - **group**=1 *(Numeric, define in wich address book group to register e-mail addresses)* - **subscribe**=1 *(Boolean)* - **unsubscribe**=1 *(Boolean)* - **archives**=1 *(Boolean, displays or not the archives link)* - **archives_title**="Last newsletters" *(String)* - **title**="Your email:" *(String)* - **placeholder**="Your email:" *(String)* - **button_label**="ok" *(String)* = Answer functionnality = * Create a new page and put the shortcode [nl_reply_form] in the content. * Go to the configuration page on the wordpress admin to manage defaults values for expeditor and fill the answer page (the page wich contains the shortcode [nl_reply_form] to allow visitors to answer your newsletter) * add answer links in your newsletters by adding the shortcode [nl_reply_link], you can add as many links as you want. Attributes your anwser links are rep="the_answer_code" val="the link's text" example: **Do you like this plugin ?** >`[nl_reply_link val="Yes I do" rep="yes"]` > >`[nl_reply_link val="Not at all" rep="no"]` > >`[nl_reply_link val="Can you repeat the question ?" rep="misunderstand"]` > Links will be automaticly created with the e-mail address of the recipient. If the link is broken, with not enougth datas, a form will be displayed to complete it. = Reading tracking = * Check if your newsletters are readen or not * Clean your address book = Use skins = * You can create skins or use the default skin. * The default skin automaticly load the 3 latest posts into your newsletter. = Sending alert = * Network admins can also setup an email to receive each newsletter sent by the server, for preventing spam usage or support users = External address books with hooks = Use theses hooks to use any external address book To hook into the pre-sending form and and add your recipients selector, use : ` My recipients'; } ?> ` To parse the query and correctly add emails to the queue, use : ` ` Also usefull: `add_action('eelv_newsletter_addressbook_list')` = WP CLI Support = Sending to huge list of recipients can be done over wp-cli. `wp newsletter send` In a multisite use, --url parameter is mandatory. To avoid any conflict, set "send by" to "WP-CLI" in your configuration page.', == Installation == 1. Upload `eelv_newsletter` to the `/wp-content/plugins/` directory 2. Activate the plugin through the 'Plugins' menu in WordPress admin 3. Create a new page and insert the short code `[eelv_news_form]` 4. You can edit defaults settings in Newsletter > Configuration and help == Frequently asked questions == = Does the adress book has a blacklist ? = Yes, email registered in the black list, won't receive any newsletter from your site. = Can I create my own skins ? = Yes, skins are registered as post-type. 1. Site admins can create skins into newsletter > skins 2. To add skins on each blog on a multisite network, just add some items to the default themes variable in your functions.php ex: `$eelv_nl_default_themes['your skin name']='Your skin HTML here';` 3. To add a default content to this skin, add an item to the default content variable. ex : `$eelv_nl_content_themes['your skin name']='Your content here';` == Screenshots == 1. Template manager 2. Sending options == Changelog == = 4.8.2 = - Add missing files to repo = 4.8.1 = - Add missing files to repo = 4.8 = Warning: Beta version for test purpose only - Add Gutenberg support - Add many hooks = 4.7.1 = Release date: 2018-06 - Add shortcode attributes: title and label = 4.7 = Release date: 2017-12 - Adds `eelv_newsletter_addressbook_list` action hook - Code refactoring = 4.6.1 = Release date: 2017-05-18 - Fix cross-site scripting (XSS) vuln in address book - Fix cross-site request forgery (CSRF) vuln in address book = 4.6 = Release date: 2017-05-17 - Adds variables in templates: {blog_name}, {blog_url}, {blog_description}, {blog_image} = 4.5 = Release date: 2017-03 - Add limit "option" in CLI command - More customizable HTML in subscribe forms - Separate notices when many forms are in the same page = 4.4 = Release date: 2017-02 - Add: WP-CLI support - Add: Some verbose output while sending - Add: Optimize Ajax calls = 4.3 = Release date: 2016-06-28 Add site favicon in archive template Add action `eelv_newsletter_sending_options($post)` Add action `eelv_newsletter_custom_box_dest($post_id)` Add action `eelv_newsletter_editor_variables` Add filter `eelv_newsletter_content($content, email, $wp_user_datas, $nl_id)` Add `$archive` parameter to `eelv_newsletter_parse_recipients($contacts)` filter Display date within local date and time format in sending options page Fix untranslated strings Code cleanup Update credentials = 4.3 = Release date: 2016-10 Add: Locker to avoid sending overlapping Add: Less SQL transactions Fix: Some sent emails where not stored in log = 4.2.3 = Release date: 2016-04-27 Fix: The first newsletter is never sent = 4.2.2 = Release date : 2016-03-10 Fix PHP warning " Trying to get property of non-object" = 4.2.1 = Release date : 2015-10-29 * remove use of