=== Subscriber by BestWebSoft ===
Contributors: bestwebsoft
Donate link: http://bestwebsoft.com/donate/
Tags: add subsribe form, display subscribe form, subscriber, subscriber plugin, subscribe to newsletters, subscriber list, subscriber widget, subscription, website newsletters, subscribe, newsletters, add subscriber widget
Requires at least: 3.8
Tested up to: 4.5.3
Stable tag: 1.3.2
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Add email newsletter sign up form to WordPress posts, pages and widgets. Collect data and subscribe your users.

== Description ==

The Subscriber plugin is an exclusive add-on for the Sender Plugin by BestWebSoft.
This plugin allows your site visitors to subscribe for newsletters, coming from your website. It is a simple and effective tool for businessmen as well as for those people who just want to share their ideas with others. Moreover, it has minimum settings but maximum feedback.

http://www.youtube.com/watch?v=ytjxGd4hXDU

<a href="http://www.youtube.com/watch?v=YJOQSGXPjRY" target="_blank">Subscriber by BestWebSoft Video instruction on Installation</a>

<a href="http://wordpress.org/plugins/subscriber/faq/" target="_blank">Subscriber by BestWebSoft FAQ</a>
<a href="http://support.bestwebsoft.com" target="_blank">Subscriber by BestWebSoft Support</a>

<a href="http://bestwebsoft.com/products/subscriber/?k=ec88b21e8b31454de5a80a997b2f6450" target="_blank">Upgrade to Subscriber Pro by BestWebSoft</a>

= Features =

* Add 'Subscriber Form Registation' widget, where your site visitors can subscribe for your newsletters.
* Add shortcode to display Subscribe Form in post, page or widget content.
* Add "Subscribe" checkbox to Contact Form plugin by BestWebSoft.
* Manage the list of subscribers on the plugin settings page ("Subscribers" tab).

If you have a feature, suggestion or idea you'd like to see in the plugin, we'd love to hear about it! <a href="http://support.bestwebsoft.com/hc/en-us/requests/new" target="_blank">Suggest a Feature</a>

= Recommended Plugins =

The author of the Subscriber also recommends the following plugins:

* <a href="http://wordpress.org/plugins/sender/">Sender</a> - this plugin sends mail to registered users. There is also a premium version of the plugin - <a href="http://bestwebsoft.com/products/sender/?k=87e536ef51413f30ebada1bb46dcdf39">Sender Pro</a>, allowing to create and save templates for letters, edit the content of messages with a visual editor TinyMce, set priority оf mailing, create and manage mailing lists.
* <a href="http://wordpress.org/plugins/captcha/">Captcha</a> - The Captcha plugin allows you to implement a super security captcha form into web forms. It protects your website from spam by means of math logic, easily understood by human beings. This captcha can be used for login, registration, password recovery, comments forms.
There is also a premium version of the plugin - <a href="http://bestwebsoft.com/products/captcha/?k=087fd14aa72b0c2680b4ec1ad896e63a">Captcha Pro</a>, allowing compatibility with BuddyPress (Registration form, Comments form, "Create a Group" form), Contact Form 7 and Subscriber.
* <a href="http://wordpress.org/plugins/email-queue/">Email Queue</a> - This plugin gives you an opportunity to organize a simple and effective mail queue. You can assign priorities to plugins that send mail. You can manage outgoing messages: trash them or delete completely. You can use searching, filtering and bulk operations with your mail. The plugin works with plugins produced by BestWebSoft team only.
* <a href="http://wordpress.org/plugins/updater/">Updater</a> - This plugin updates WordPress core and the plugins to the recent versions. You can also use the auto mode or manual mode for updating and set email notifications.
There is also a premium version of the plugin <a href="http://bestwebsoft.com/products/updater/?k=eae2aa18f1ba0036cc937a130f05f001">Updater Pro</a> with more useful features available. It can make backup of all your files and database before updating. Also it can forbid some plugins or WordPress Core update.

= Translation =

* Czech (cs_CZ) (thanks to <a href="mailto:info@pamadessoft.cz">PaMaDeSSoft</a>, www.pamadessoft.cz)
* Russian (ru_RU)
* Ukrainian (uk)

Some of these translations are not complete. We are constantly adding new features which should be translated. If you would like to create your own language pack or update the existing one, you can send <a href="http://codex.wordpress.org/Translating_WordPress" target="_blank">the text of PO and MO files</a> for <a href="http://support.bestwebsoft.com/hc/en-us/requests/new" target="_blank">BestWebSoft</a> and we'll add it to the plugin. You can download the latest version of the program for work with PO and MO files  <a href="http://www.poedit.net/download.php" target="_blank">Poedit</a>.

= Technical support =

Dear users, our plugins are available for free download. If you have any questions or recommendations regarding the functionality of our plugins (existing options, new options, current issues), please feel free to contact us. Please note that we accept requests in English only. All messages in other languages won't be accepted.

If you notice any bugs in the plugins, you can notify us about it and we'll investigate and fix the issue then. Your request should contain URL of the website, issues description and WordPress admin panel credentials.
Moreover we can customize the plugin according to your requirements. It's a paid service (as a rule it costs $40, but the price can vary depending on the amount of the necessary changes and their complexity). Please note that we could also include this or that feature (developed for you) in the next release and share with the other users then. 
We can fix some things for free for the users who provide translation of our plugin into their native language (this should be a new translation of a certain plugin, you can check available translations on the official plugin page).

== Installation ==

1. Upload the `subscriber` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Plugin settings are located in 'BWS Panel', 'Subscriber'.

<a href="https://docs.google.com/document/d/1c3snoIZgS1e9AgYjps19HJ-cIhDLACMPiqfduH5tAaw/edit" target="_blank">View a Step-by-step Instruction on Subscriber Installation</a>.

http://www.youtube.com/watch?v=YJOQSGXPjRY

== Frequently Asked Questions ==

= Can I create a newsletter subscriber in the backend of the site? =

Yes. You just need to create a new user with the role of "Mail Subscriber" in Users > Add New.

= How can the user unsubscribe from the newsletter? =

1) The user should go to your site, enter his/her e-mail in the Subscribe Form, mark the "unsubscribe" checkbocx and click the "Submit" button. 
2) If everything has been done correctly, he/she will recieve a mail with a link for unsubscription.
3) If the user follows that link, he/she will be automatically unsubscribed from the newsletters.

= How can the previously registered users subscribe for the newsletter? =

The previously registered users can subscribe for the newsletter exactly as any other site visitor thru the Subscribe Form or mark the "Subscribe for newsletters" checkbox on their Profile editing page.  

= Why do I need the blacklist? =

If you do not want the user to receive letters of mailing for some reason, you can move him to the blacklist. Users from the black list can not receive letters and resubscribe for the mailing.

= I would like to add checkbox "Subscribe" to the custom form on my website. How can I do this? =

1. Install the Subscribe plugin and activate it.
2. Open the file with the form (where you would like to add checkbox "Subscribe" to).
3. Find a place to insert the code for the checkbox "Subscribe" output.
4. Insert the necessary lines: 

if ( has_filter( 'sbscrbr_checkbox_add' ) ) {
	$sbscrbr_checkbox = apply_filters( 'sbscrbr_checkbox_add', false );
	if ( isset( $sbscrbr_checkbox['content'] ) ) {
	 	echo $sbscrbr_checkbox['content'];
	}
}

If the form is HTML you should insert the line with the PHP tags:

<?php if ( has_filter( 'sbscrbr_checkbox_add' ) ) {
	$sbscrbr_checkbox = apply_filters( 'sbscrbr_checkbox_add', false );
	if ( isset( $sbscrbr_checkbox['content'] ) ) {
	 	echo $sbscrbr_checkbox['content'];
	}
} ?>

5. Then you should add the lines to the function of the entered data checking:

if ( isset( $_POST['submit'] ) && has_filter( 'sbscrbr_checkbox_check' ) ) {
	$sbscrbr_check = apply_filters( 'sbscrbr_checkbox_check', array(
		'email' => isset( $_POST['email'] ) ? $_POST['email'] : ''
	) );
	if ( isset( $sbscrbr_check['response'] ) ) {
		echo $sbscrbr_check['response']['message'];
	}
}

or 

<?php if ( isset( $_POST['submit'] ) && has_filter( 'sbscrbr_checkbox_check' ) ) {
	$sbscrbr_check = apply_filters( 'sbscrbr_checkbox_check', array(
		'email' => isset( $_POST['email'] ) ? $_POST['email'] : ''
	) );
	if ( isset( $sbscrbr_check['response'] ) ) {
		echo $sbscrbr_check['response']['message'];
	}
} ?>

where:

- $_POST['submit'] is a name of the submit form button;
- $_POST['email'] is a name of the field with entered e-mail;

= I have some problems with the plugin's work. What Information should I provide to receive proper support? =

Please make sure that the problem hasn't been discussed on our forum yet (<a href="http://support.bestwebsoft.com" target="_blank">http://support.bestwebsoft.com</a>). If not, please provide the following data along with your problem's description:

1. the link to the page, on which the problem occurs
2. the plugin’s name and version. If you are using a pro version - your order number.
3. the version of your WordPress installation
4. copy and paste your system status report into the message. Please read more here: <a href="https://docs.google.com/document/d/1Wi2X8RdRGXk9kMszQy1xItJrpN0ncXgioH935MaBKtc/edit" target="_blank">Instruction on System Status</a>

== Screenshots ==

1. Subscribe Form in frontend of site.
2. Subscriber Basic Settings page.
3. Subscriber Email Notifications page.
4. Subscriber Subscribers page.
5. Subscribe Form Registation widget settings.

== Changelog ==

= V1.3.2 - 21.07.2016 =
* Bugfix : Decoding of special characters in emails was added.

= V1.3.1 - 13.07.2016 =
* NEW : Classes has been added for form's blocks for an ability to stylize it.
* NEW : An anchor has been added to the form to make the page scroll down to the form after submitting.
* Update: BWS panel section was updated.
* Pro : An ability to disable Subscription confirmation.

= V1.3.0 - 20.05.2016 =
* NEW : Ability to use HTML letters created with TinyMce visual editor through Sender Pro by BestWebSoft plugin.

= V1.2.9 - 25.04.2016 =
* NEW : Ability to add custom styles.
* Bugfix : Bug with checking Contact Form version has been fixed.

= V1.2.8 - 31.03.2016 =
* NEW : An ability to add "Subscribe" checkbox to Contact Form plugin by BestWebSoft.
* Update: BWS plugins section was updated.

= V1.2.7 - 18.01.2016 =
* NEW : The Czech language file was added.
* Bugfix : Bug with sorting by columns was fixed.

= V1.2.6 - 25.12.2015 =
* Bugfix : Fixed captcha working.

= V1.2.5 - 03.12.2015 =
* NEW : An ability to disable the notifications about new subscribers was added. 

= V1.2.4 - 30.09.2015 =
* NEW : A button for Subscriber shortcode inserting to the content was added.
* Bugfix : Fixed captcha displaying.

= V1.2.3 - 03.07.2015 =
* New : Ability to restore settings to defaults.
* Update: Input maxlength is added.
* Update: BWS plugins section was updated.

= V1.2.2 - 27.05.2015 =
* Bugfix : We fixed bug with unsubscribing user via the link in an email.
* Update : We updated all functionality for wordpress 4.2.2.

= V1.2.1 - 21.04.2015 =
* Bugfix : We fixed bug with displaying the lists of the users. 

= V1.2.0 - 07.04.2015 =
* Bugfix : Subscriber shortcode checking for WP versions 3.6 and below was fixed.
* Bugfix : Fixed duplicate messages.
* Bugfix : We fixed syntax error.

= V1.1.9 - 03.02.2015 =
* Bugfix : False error display when subscribing from a form was fixed.
* Bugfix : The empty "From" field in the letter to the administrator was fixed. 
* Update : We added style for subscriber form.

= V1.1.8 - 26.01.2015 =
* Bugfix : We fixed selectbox on plugin settings page.
* Bugfix : We have changed adding script variables.
* Bugfix : We have fixed Unsubscribe checkbox redundance on the user profile page with activated Sender Pro plugin.

= V1.1.7 - 06.01.2015 =
* Update : BWS plugins section is updated.
* Update : We updated all functionality for wordpress 4.1.

= V1.1.6 - 20.10.2014 =
* Bugfix : We fixed email headers.

= V1.1.5 - 11.09.2014 =
* Update : We updated all functionality for wordpress 4.0.
* Bugfix : Duplication of mailout with Sender Pro for the user registered after installation of the Subscriber plugin was fixed.

= V1.1.4 - 18.08.2014 =
* Bugfix : Security Exploit was fixed.

= V1.1.3 - 28.07.2014 =
* Update : We updated all functionality for Limit Attempts Pro plugin.

= V1.1.2 - 17.07.2014 =
* Update : We updated all functionality for Email Queue plugin.

= V1.1.1 - 26.05.2014 =
* Update : We updated all functionality for wordpress 3.9.1.
* NEW    : The Ukrainian language file is added to the plugin.
* Bugfix : Fixed 404 error after form submitting.
* NEW    : Compatibility with Captcha Pro plugin.

= V1.1 - 01.04.2014 =
* Update : BWS plugins section is updated.
* Bugfix : Problem with deleting plugin is fixed.
* Bugfix : Fixed output administrator`s login on settings page.

= V1.0 - 27.02.2014 =
* NEW : Russian language files were added to the plugin.

== Upgrade Notice ==

= V1.3.2 =
* Bugs fixed.

= V1.3.1 =
Classes has been added for form's blocks for an ability to stylize it. An anchor has been added to the form to make the page scroll down to the form after submitting. BWS panel section was updated. An ability to disable Subscription confirmation.

= V1.3.0 =
Ability to use HTML letters created with TinyMce visual editor through Sender Pro by BestWebSoft plugin.

= V1.2.9 =
Ability to add custom styles. Bug with checking Contact Form version has been fixed.

= V1.2.8 =
An ability to add "Subscribe" checkbox to Contact Form plugin by BestWebSoft.  BWS plugins section was updated.

= V1.2.7 =
The Czech language file was added. Bug with sorting by columns was fixed.

= V1.2.6 =
Fixed captcha working.

= V1.2.5 =
An ability to disable the notifications about new subscribers was added.

= V1.2.4 =
A button for Subscriber shortcode inserting to the content was added. Fixed captcha displaying

= V1.2.3 =
Ability to restore settings to defaults. Input maxlength is added. BWS plugins section was updated.

= V1.2.2 =
We fixed bug with unsubscribing user via the link in an email. We updated all functionality for wordpress 4.2.2.

= V1.2.1 =
We fixed bug with displaying the lists of the users.

= V1.2.0 =
Subscriber shortcode checking for WP versions 3.6 and below was fixed. Fixed duplicate messages. We fixed syntax error.

= V1.1.9 =
False error display when subscribing from a form was fixed. The empty "From" field in the letter to the administrator was fixed. We added style for subscriber form.

= V1.1.8 =
We fixed selectbox on plugin settings page. We have changed adding script variables. We have fixed Unsubscribe checkbox redundance on the user profile page with activated Sender Pro plugin.

= V1.1.7 =
BWS plugins section is updated. We updated all functionality for wordpress 4.1.

= V1.1.6 =
We fixed email headers.

= V1.1.5 =
We updated all functionality for wordpress 4.0. Duplication of mailout with Sender Pro for the user registered after installation of the Subscriber plugin was fixed.

= V1.1.4 =
Security Exploit was fixed.

= V1.1.3 =
We updated all functionality for Limit Attempts Pro plugin.

= V1.1.2 =
We updated all functionality for Email Queue plugin.

= V1.1.1 =
We updated all functionality for wordpress 3.9.1. The Ukrainian language file is added to the plugin. Fixed 404 error after form submitting.  Compatibility with Captcha Pro plugin.

= V1.1 =
BWS plugins section is updated. Problem with deleting plugin is fixed. Fixed output administrator`s login on settings page.

= V1.0 =
Russian language files were added to the plugin.