=== Subscribe2 === Contributors: MattyRob, Skippy, RavanH Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=2387904 Tags: posts, subscription, email, subscribe, notify, notification Requires at least: 2.0.x Tested up to: 2.8.4 Stable tag: 5.0 Sends a list of subscribers an email notification when new posts are published to your blog == Description == Subscribe2 provides a comprehensive subscription management and email notification system for WordPress blogs that sends email notifications to a list of subscribers when you publish new content to your blog. Email Notifications can be sent on a per-post basis or periodically in a Digest email. Additionally, certain categories can be excluded from inclusion in the notification and post can be excluded on an individual basis by setting a custom field of 's2mail' to 'no'. The format of the email can also be customised for per-post notifications, subscribe2 can generate emails for each of the following formats: * plaintext excerpt * plaintext full post * HTML full post The plugin also handles subscription requests allowing users to publically subscribe by submitting their email address in an easy to use form or to register with your blog which enables greater flexibility over the email content for per-post notifications for the subscriber. Admins are given control over the presentation of the email notifications, can bulk manage subscriptions for users and manually send email notices to subscribers. Subscribe2 supports two classes of subscribers: the general public, and registered users of the blog. The general public may subscribe and unsubscribe. They will receive a limited email notification when new post is made or periodically (unless that post is assigned to one of the excluded categories you defined). The general public will receive a plaintext email with an excerpt of the post: either the excerpt you created when making the post, the portion of text before a tag (if present), or the first 55 words of the post. Registered users of the blog can elect to receive email notifications for specific categories (unless Digest email are select, then it is an opt in or out decision). The Users->Subscription menu item will allow them to select the delivery format (plaintext or HTML), amount of message (excerpt or full post), and the categories to which they want to subscribe. You, the blog owner, have the option (Options->Subscribe2) to allow registered users to subscribe to your excluded categories or not. == Installation == 1. Copy the entire /subscribe2/ directory into your /wp-content/plugins/ directory. 2. Activate the plugin. 3. Click the "Settings" admin menu link, and select "Subscribe2". 4. Configure the options to taste, including the email template and any categories which should be excluded from notification 5. Click the "Manage" admin menu link, and select "Subscribers". 6. Manually subscribe people as you see fit. 7. Create a [WordPress Page](http://codex.wordpress.org/Pages) to display the subscription form. When creating the page, you may click the "S2" button on the QuickBar to automatically insert the subscribe2 token. Or, if you prefer, you may manually insert the subscribe2 token: ***Ensure the token is on a line by itself and that it has a blank line above and below.*** This token will automatically be replaced by dynamic subscription information and will display all forms and messages as necessary. 8. In the WordPress "Settings" area for Subscribe2 define the default page ID in the "Appearance" section to the ID of the WordPress page created in step 7. == Frequently Asked Questions == = Where else can I get help? = So, you've downloaded the plugin an it isn't doing what you expect. First you should read the documentation. There is a ReadMe.txt file and a PDF startup guide installed with the plugin. Next you could search in the [Subscribe2 Forum](http://getsatisfaction.com/subscribe2/), the [WordPress forums](http://wordpress.org/support/) or the [Subscribe2 blog FAQs](http://subscribe2.wordpress.com/category/faq/). No joy there? Well, if you can't find an answer to your question you can get [paid support](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=2387904) by donating at least £20 to the plugin author. == Screenshots == 1. The Posts->Mail Subscribers admin page generated by the plugin. 2. The Tools->Subscribers admin page generated by the plugin. 3. The Users->Subscriptions admin page generated by the plugin. 4. The Options->Subscribe2 admin page generated by the plugin. == Changelog == = Version 5.0 by Matthew Robinson = * Change version number to reflect change in the on going support of the plugin which is now a searchable forum or a paid service * Added links to online Subscribe2 resources into the Options->Subsribe2 page * Fixed Digest Time Dropdown to recall Cron Task scheduled time * Fixed code using updated [Admin Menu Plugin](http://wordpress.org/extend/plugins/ozh-admin-drop-down-menu/) API * Fixed foreach() error in widget rename function * Improved layout of widget control boxes * Improved identification of Administrator level users on blogs where usermeta table entries for user_level are low or missing * Removed avatar plugin support on WPMU due to processing overhead * Improved the layout of the digest email with respect to inclusion of unnecessary white space * Extended maximum script runtime for servers not using PHP in safe mode = Version 4.18 by Matthew Robinson = * Option to sort digest posts in ascending or descending order * Check that plugin options array exists before calling upgrade functions * Improved reliability of the Preview function * Extended Preview function to digest emails * Fixed a code glitch that stopped CATS and TAGS from working * Fixed incorrect sender information is emails are set to come from Post Author * Simplified email notification format options in Users->Subscriptions for per-post notifications * Added Bulk Manage option to update email notification format * Simplified the usermeta database entries from two format variables down to one * Removed trailing spaces from some strings for improved i18n support * Improved Bulk Subscribe and Unsubscribe routines to avoid database artefacts * Moved Select/Deselect All check box to the top of the category list in admin pages * Fixed small layout glitch in Manage->Subscribers screen * Added ChangeLog section to ReadMe to support WordPress.org/extend development = Version 4.17 by Matthew Robinson = * Tested for compatibility with WordPress 2.8.x * Added TAGS and CATS keyword for per-post notification templates * Fixed bug where confirmation emails may have an empty sender field if notifications come from post author * Fixed a bug in WPMU CSS * Added option to exclude new categories by default * Fixed a bug where emails may not be sent to subscribers when a user subscribes or unsubscribes * Improved accessing of 'Admin' level users on blogs where user_level is set below 10 * Added ability to send email previews to currently logged in user from Settings->Subscribe2 * Styled admin menu form buttons to fit with WordPress theme * Improved handling of confirmation sending to reduce errors = Version 4.16 by Matthew Robinson = * Correct minor layout issue in Settings->Subscribe2 * Allow users to define the div class name for the widget for styling purposes * Select from a greater number of notification senders via dropdown list in Settings * Improved efficiency of newly added WordPressMU code * Added ability to manage across-blog subscriptions when using WordPressMU * Fixed bug whereby Public Subscribers may not have got notification emails for posts if Private Posts were blocked * Added ability to define email Subject contents in Settings->Subscribe2 * Sanity checks of email subject and body templates to ensure they are not empty * Introduced s2_html_email and s2_plain_email filters to allow manipulation of email messages after construction * Amended handling of database entries to simplify code and database needs * Improved the layout of the Subscriber drop down menu * Added bullet points to the TABLE of posts * Ensure database remains clean when categories are deleted * Added new option to manage how auto-subscribe handles excluded categories = Version 4.15 by Matthew Robinson = * Fixed E_DEPRECATE warning caused by a variable being passed by reference to the ksort() function * Fixed called to undefined function caused by typo * Fixed a syntax error in the SQL code constructors affecting some users = Version 4.14 by Matthew Robinson = * Reordered some functions to improve grouping * Stop s2mail custom variable being added if empty * Localised 'Send Digest Notification at' string * Add support for template tags in Post->Mail Subscribers emails * Improve handling of translation files for more recent version of WordPress * Implemented