=== 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 : `<?php add_action('eelv_newsletter_select_recipients','my_recipients_select_function'); function my_recipients_select_function(){ echo'<input type="checkbox" name="my_recipients" value="my_recipients"> My recipients'; } ?> ` To parse the query and correctly add emails to the queue, use : `<?php add_filter('eelv_newsletter_parse_recipients','my_recipients_parse_function'); function my_recipients_parse_function(){ if(isset($_GET['my_recipients'])){ return 'first@email.dom,second@email.com'; } } ?> ` 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 <? shortcuts * Update textdomain to match plugin slug = 4.2.0 = Release date : 2015-10-20 * More accurate sending date * GLobal UI: Use of native Dashicons * Improved UI in archives: Progress bar * Fix headers encoding * Put JS and CSS in separated directories * Code cleanup = 4.1.2 = * minified JS and CSS on front * default date is local date on sending form = 4.1.1 = * Fix a cron bug * More verbose queue list * Explicitly display locale time = 4.1.0 = Release date : 2015-09-18 * Modulable cron interval * Better performances * Code cleanup = 4.0.1 = Release date : 2015-09-11 * Update version * Wrap sender name in quotes = 4.0.0 = Release date : 2015-09-10 * Add import addressbook by CVS * Allow scheduled sending * New editor helper with preview of post and autocompleter * New multi-instance widget with more options * Fix header's Message-id (thanks to Inglebard) * Small code refactoring * improved translation = 3.13.5 = * more WP 4.3 compliant = 3.13.4 = * WP 4.3 compliant = 3.13.3 = * Fix: Better use of imagettftext (removes PHP warning) = 3.13.2 = * Add: Send per burst and burst interval options * Move full use of wp_mail to branch 4.0 * Some code cleanup = 3.13.1 = * Add: Use of wp_mail function to make the plugin more hookable * Some code cleanup = 3.13.0 = * Add: Usage statistics in skins list * Add: Security improvement in options page * Fix: Unwanted slashes in options saving = 3.12.3 = * Fix: remove bad div end tag = 3.12.2 = * Fix: update shortcode help = 3.12.1 = * Fix: text-domain issue = 3.12.0 = * Add: Configuration help : check if shortcodes are present * Fix: Archives widget bug with post loops = 3.11.0 = * Add: Configuration option : End of line \r\n and \n to fix problem on some servers such as qmail * Add: plugin icon = 3.10.0 = * Add: Configuration option : MIME type HTML or HTML+PlainText * Add: Remove styles from plain text part * Fix: Default skins add header images only if there is one = 3.9.1 = * Fix: Un/Subscribe shortcode attribute error = 3.9.0 = * Add: Shortcode wizard to insert answer links * Add: Export contacts from a group as CSV * Add: Hooks to add some external address books * Fix: [nl_date] & [desinsc_url] not parsed * Fix: Encoding on Mac clients by using "Quoted-printable" instead of "8bit" = 3.8.7 = * Fix: JS error on subscribe form from shortcode = 3.8.6 = * Fix: bug on archives list front page = 3.8.5 = * Fix: Change headers end of line to CRLF (\r\n) to match more servers http://fr2.php.net/manual/fr/function.mail.php * Fix: Remove some PHP warnings = 3.8.4 = * Fix: Activation generate error = 3.8.3 = * Fix: subscription widget bug = 3.8.1 = * Fix: Break lines after inserted posts in newsletter editor to prevent posts in other posts = 3.8.0 = * Add: More options in skin management and for default content * Add: Remove autoP formating for skins and newsletters * Add: 2 cols preformated template * Add: Ability to load skin's default content unregardless to the selected skin * Add: Displays real posts in realtime preview for default content * Fix: Refresh after selecting a skin in newsletter editing = 3.7.0 = * Add: Edit default content for each newsletter skin * Add: Edit item style for each default content with realtime preview * Add: Archives widget * Add: Better address book list displaying * Add: Update the online newsletter displaying * Fix: Huge code improvement * Fix: Wording & translation * Fix: Few bugs = 3.6.7 = * Add : 5sec. delay between two bursts * Add : Custom wpdb query for users adressing in order to get only required datas (improves performances) = 3.6.6 = * Fix : Integration in WP 3.8 = 3.6.5 = * Fix : suscription bug = 3.6.4 = * Fix : update edit.php to post.php * Fix : performances optimisation * Fix : suscription bug = 3.6.3 = * Fix : Addressing assignation problem = 3.6.2 = * Add : Double verification for users role, for preventing conflict with custom capabilities = 3.6.1 = * Fix : Important bug fix with role selection for recipients * Add : Add addressing possibility with `login` values * Fix : French translation = 3.6.0 = * Add : Add addressing possibility with `name` and `email` values * Add : Default WP `aligncenter`, `alignleft` and `alignright` style support * Add : Edit spy image's text = 3.5.9 = * Fix : Options stripslashes * Fix : Address book fields focus = 3.5.8 = * Fix : Minor bug fix = 3.5.7 = * Fix : Correctly allow multiple form occurences * Fix : French translation = 3.5.6 = * Add : widget options : texts, classes * Add : widget placeholder replacement for old browsers = 3.5.5 = * Add : Pre-checked option for share buttons * Add : Default style for widget, suscribe/unsuscribe show/hide occurence * Fix : Auto update option version * Fix : Change licence from CC to GPL = 3.5.4 = * Fix : use wp_enqueue_style function = 3.5.3 = * Fix : Adjust color of red-list emails = 3.5.2 = * Fix : Keeps newsletter submenu opened on news-type page = 3.5.1 = * Fix : User role setting for news-types = 3.5.0 = * Add : News-type taxonomy * Add : Group destination for suscribe-form (shortcode attribute) * Fix : Minor Cross Site Scripting (XSS) in group management page * Fix : better HTML syntax in suscribe form * Fix : some words = 3.4.3 = * Add : Mime format for correct plain text displaying * Add : show a thickbox for answer links in a preview page * Fix : shows a correction * Fix : alerts text correction = 3.4.2 = * Add : Check for missing parameters in sending form * Fix : Help page duplicate content * Fix : Translation fix * Fix : SQL syntax error in answer page * Fix : PHP warning in configuration page = 3.4.1 = * Fix : french translation fix * Fix : edit options version = 3.4.0 = * Add : Answer functionnality : requires to create an anwser page with the shortcode [nl_reply_form] * Fix : enhance archives columns view * Fix : spy image headers = 3.3.4 = * Fix : Hide new available options from network = 3.3.3 = * Add : Display an alert for new available options = 3.3.2 = * Add : Adjust capabilities for Admins, Editors (can'nt edit configuration or reload parameters) and Authors (can'nt send newsletters) = 3.3.1 = * Fix : Remove HTML tags from suscribe-from alerts, JS XSS vulnerability fix = 3.3.0 = * Add : Move plugin to English and then retranslate it into french... :-/ * Add : Change newsletter skin directly from send page * Add : Send a confirmation e-mail to (un)suscribers * Add : Some help and legend * Fix : Replace deprecated functions * Fix : Remove some php warnings = 3.2.2 = * Fix : Check if apply_filter('the_content') doesn't make content empty = 3.2.1 = * Fix : CSS fix in admin = 3.2.0 = * Add : Title and share-links options for converting posts into newsletters * Add : Option for hidding archives link under subscription form = 3.1.5 = * Fix : bug in configuration page = 3.1.4 = * Minor add : duplicate en_US translation to en_UK = 3.1.3 = * Minor add : Enhanced english translation = 3.1.2 = * Minor add : Shows percentage rate of reading * Fix : Issue while checking reading status of an email * Fix : Enhance functions compability with has_cap * Fix : Performances optimisations = 3.1.0 = * Add : Reading tracking : now appears in archives list * Fix : Archive front page override other post-types = 3.0.0 = * Add : Reading tracking : try to know if sent emails is readen by recepient (optional) * Add : Enhanced status icons * Add : Enhanced english translation = 2.9.0 = * Add : Optionnal share links * Add : Enhanced english translation = 2.8.0 = * Add : Higlight unsuscribe link in configuration page * Add : Enhanced english translation * Fix : Minor HTML bugs in back-office = 2.7.4 = * Fix: Archive display centered = 2.7.3 = * Fix: Rename some functions for preventing uncompability = 2.7.2 = * Add: Enhanced english translation = 2.7.1 = * Fix: Sql error [Multiple primary key defined] dbdelta = 2.7.0 = * Add: Archives are displayed in a new, blank and clean page * Fix: Select-box to insert pages into a newsletter was listing posts = 2.6.7 = * Add: Custom content now works for creation, not just edit newsletter = 2.6.6 = * Fix: Performances optimisation = 2.6.5 = * Fix: broken link for stylesheet = 2.6.4 = * Add: custom column for archives to display queue and sent * Add: Choice of the archive status : publish or private (for tests) * Add: Some more lines for completing translation, soon soon! = 2.6.3 = * Add: custom email to receive a copy of any campaign send (manage it in the network admin) * Add: Performances optimisation * Add: Add some lines for completing translation, not finished yet ! = 2.6.2 = * Fix: broken link for status icons = 2.6 = * Publication in the wordpress repository == Upgrade notice == = 4.8 Beta = Warning: Beta version for test purpose only = 4.6.1 = Security update: fixes XSS/CSRF vulnerabilities in address book = 4.1.0 = The default burst interval has changed to 50 mails per 5 minutes. = 3.8.7 = Subscribe form shortcode attributes changed ! suscribe becomes subscribe unsuscribe becomes unsubscribe = 3.8.0 = AutoP is removed form skins and newsletters. Please, re-edit them. == Languages == = Français = * fr_FR : 100% = English = * en : 100%