=== bbPress Notify (No Spam) === Contributors: useStrict Donate link: https://www.paypal.me/usestrict Author URI: https://www.usestrict.net/ Plugin URI: https://usestrict.net/2013/02/bbpress-notify-nospam/ Tags: bbpress, email notification, no spam Requires at least: 3.1 Tested up to: 5.3.2 Text Domain: bbPress_Notify_noSpam License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Stable tag: 2.8.1 Requires PHP: 5.6 == Description == Give bbPress notifications your personal touch by deciding who gets the emails and what they look like. = Features include = * Send notifications in HTML, Plain text, or Multipart format, with full image support. * Override bbPress' core subscription messages with your own; * Set Notification recipient roles for new topics; * Set Notification recipient roles for new replies; * Set Notification e-mail subject and body templates for both new topics and replies; * Send Background Notifications (to avoid delays in loading pages for large user databases); * Extensible through almost 40 actions and filters; Click here for the full documentation.
= Premium Add-Ons = Take your notifications to the next level with one or more of these add-ons.== Installation == 1. Upload the entire plugin folder via FTP to `/wp-content/plugins/`. 2. Activate the plugin through the 'Plugins' menu in WordPress. 3. Go to the bbPress Notify (No-Spam) in the main admin menu -> Settings to customize the settings. == Frequently Asked Questions == = Why am I not receiving notifications of a topic/reply that I created? = * Make sure the setting to notify authors of their own posts is checked in both the Topics and Replies screen. = Where are the settings? = * As of version 2.0, the settings are no longer in the Forums screen but have their own location in the Admin menu area. = People are getting timeouts when posting a new Topic or Reply. Why? = * When a new Topic or Reply is created, bbpnns is triggered to send notifications regarding that new post. If there are too many recipients, it may take too long for bbpnns to iterate through the recipient list and the webserver will throw a timeout message; the person posting it will think their message didn't get saved. To get around this problem, turn on the option to send messages in the background. That will create a scheduled action for the next time the wp-cron runs, and bbpnns will try to override any time limits while running. = Why are some of my users not getting notified? = * If you have *not* turned on Background Notifications, see the FAQ item above. If you have turned it on and some users are still not getting notified, it could be that your host is not letting bbpnns finish doing its thing, even though the timeout settings have been overridden. Some hosts will have scripts monitoring long running processes and have them killed, regardless of the PHP timeout values. A solution for this is to have bbpnns work faster, and for that we've released the [Bulk Mailer add-on](https://usestrict.net/product/bbpress-notify-no-spam-bulk-mailer) which connects with an existing Mailgun or SendGrid account and sends notifications to up to 1000 recipients in the time it would otherwise take to send to a single one. = Can a user turn off notifications? = * Originally, this plugin was developed to alert Administrators of new topics and replies. After a few iterations, users requested the ability to send messages to other roles, which could then be characterized as spam. To allow your users to opt-out from receiving notifications, please consider purchasing the [Opt-out Add-on](http://usestrict.net/product/bbpress-notify-no-spam-opt-out-add-on/) or disable per-role notifications in favor of Overriding Core Subscriptions. = Does this plugin integrate with BuddyPress? = * Out of the box, no. However, you can get BuddyPress Group notification functionality using our premium [bbpnns/BuddyPress Bridge plugin](http://usestrict.net/product/bbpress-notify-no-spam-buddypress-bridge/). = Does this plugin integrate with X, Y, Z Membership/Privacy plugin? = * We can't add support for all sorts of third party plugins inside the core bbpnns plugin. It would become way too bloated. However, we do support some of the more popular membership and privacy plugins such as Private Groups, MemberPress, AccessAlly and Ultimate Member. See the Premium Addons section above for the links to each one. If you're using a different plugin and need support, reach out and let us know. We'll look into adding it. = Can this plugin be customized? = * If you have some WordPress coding experience, customizing should be really easy as we offer around 40 filters and actions. However, if you need help, reach out and let us know your specs for an estimate. == Screenshots == 1. The settings page - General tab 2. The settings page - Topics tab 3. The settings page - Replies tab 4. The settings page - Support tab == Changelog === = 2.8.1 = * Enhancement - better user control when running in the background. = 2.8 = * Added new feature - Auto subscribe forum users to newly created topic so they also get replies notifications. See bbPress Notify (No-Spam) > Settings > Topics tab > bbPress Forums Subscriptions Override section. * Added i18n files. = 2.7 = * Work around membership plugins blocking content during mailouts. = 2.6.1 = * Added support for bbpress 2.6 moderation functionality. = 2.6 = * Changed behaviour of notify_authors checkbox: Originally it would only remove authors if they were already in the recipient list. Now it will also add authors if they're not in recipients and the setting is checked. = 2.5.7 = * Call bbp_new_topic and bbp_new_reply in Dry Run with full param list to avoid breaking third-party plugins. = 2.5.6 = * Fix login controller's maybe_add_redirect() to use given URL instead of pulling the permalink from the DB. = 2.5.5 = * Fix dry-run sending messages when run with background notifications enabled. = 2.5.4 = * Pass reply-url through login query string logic. = 2.5.3 = * Add safeguards to dry-run to keep bbpress from sending notifications. = 2.5.2 = * Fix nonce handling in old 1.x to 2.x db conversion. = 2.5.1 - * Better encoding of href variables in convert_images_and_links(). = 2.5 = * Added ability to include forum subscribers in a reply notification. * Improved trace messages. = 2.4 = * Added feature: Dry run tests to help identify which settings are adding/dropping which users from the recipient list. = 2.3.1 = * Encode href variable in convert_images_and_links() if necessary. = 2.3 = * Added action bbpnns_doing_notify_on_save. = 2.2.1= * Fix: Lines ending in
- Reply by Email Add-on: Users can create new topics or replies directly from their mailbox. No need to click links or open the forums in a browser. Heck, they can even dictate their topics/replies if they want!
- Bulk Mailer Add-on: Having trouble with mailout timouts because you have too many users? This is the solution. Integrate bbpnns with Mailgun or SendGrid and send messages in batches of 1000 instead of one-by-one.
- Opt-out Add-on: Users can choose not to receive any notifications, or simply unsubscribe from the thread with a single click. A must-have for CAN-SPAM and CASL laws!
- Digest Add-on: Users can choose to receive daily, weekly, or monthly digests.
- bbPress Moderation Integration: Make bbpnns work with bbPress Moderation.
- bbPress Private Groups Integration: Make bbpnns respect bbPress Private Groups rules.
- BuddyPress Integration: Notify BuddyPress Group members of new Group Forum topics and replies. It also shows individual Opt Out and Digest settings in each user's BuddyPress profile screen.
- MemberPress Integration: Make sure your members have access to Opt Out and Digest settings in their MemberPress profile screens, and only get notified of topics/replies they have access to.
- Ultimate Member Integration: Make sure your members have access to Opt Out and Digest settings in their Ultimate Member profile screens.
- AccessAlly Integration: A must for those using AccessAlly, so their users won't receive notifications for forums they don't have access to.
mb_internal_encoding()
with iconv_get_encoding()
as at least one host didn't have mb_string
enabled.
* Add: Admin option to enable or disable Subject line encoding. Admin -> Settings -> Forums -> E-mail Notifications -> Encode Topic and Reply Subject line.
* Add: uninstaller.
= 1.9.2 =
* Fix filters bbpnns_filter_email_subject_in_build and bbpnns_filter_email_body_in_build to pass $type and $post_id
= 1.9.1 =
* New action: bbpnns_email_failed_single_user, allows for better handling of failed emails. Params: $user_info, $filtered_subject, $filtered_body, $recipient_headers
* New action: bbpnns_before_wp_mail, executed immediately before wp_mail() call. Params: $user_info, $filtered_subject, $filtered_body, $recipient_headers
* New action: bbpnns_after_wp_mail, executed immediately after wp_mail() call. Params: $user_info, $filtered_subject, $filtered_body, $recipient_headers
= 1.9 =
* New Filter: bbpnns_skip_notification
* New Filter: bbpnns_available_tags
* New Action: bbpnns_after_email_sent_single_user
* New Action: bbpnns_after_email_sent_all_users
* Change: Only filter subject and body if user is OK to receive message
* Change: Reduce DB calls by one per user
* Change: stop using PHP4-style pass-by-reference. PHP5 always passes by reference now.
* Change: Improve Encoding of subject line
= 1.8.2.1 =
* Fix: added a workaround for emails with UTF-8 Characters in the subject line that weren't being sent.
= 1.8.2 =
* Added: support for people using wpMandrill and getting emails without newlines. We turn on nl2br momentarily while sending out our emails.
This option can be overridden by using the filter 'bbpnns_handle_mandrill_nl2br'.
= 1.8.1 =
* Fix: no longer return if wp_mail fails for a given email address. This was an issue for people using wpMandrill with an address in the blacklist.
= 1.8 =
* New Filter: bbpnns_post_status_blacklist
* New Filter: bbpnns_post_status_whitelist
* New Action: bbpnns_before_topic_settings
* New Action: bbpnns_after_topic_settings
* New Action: bbpnns_after_reply_settings
* New Action: bbpnns_register_settings
= 1.7.3 =
* Remove admin message as it's not getting dismissed properly.
* Update tested up to.
= 1.7.2 =
* Fix parameters for 'bbp_new_reply' filter
* Added call to 'bbp_get_reply_forum_id()' in case the forum_id was blank (should no longer happen with 'bbp_new_reply' filter fix)
= 1.7.1 =
* Notify about existence of Opt-Out add-on
= 1.7 =
* Added support for Opt-Out add-on
* Added labels to all input fields
= 1.6.7 =
* Added support for tags [topic-forum], and [reply-forum]. ([Towfiq I.](https://wordpress.org/support/topic/feature-forum-name-in-email))
= 1.6.6.1 =
* Removed Pro message.
= 1.6.6 =
* Added subject filter in _build_email: bbpnns_filter_email_subject_in_build
* Added body filter in _build_email: bbpnns_filter_email_body_in_build
* Renamed filter: bbpnns-filter-recipients => bbpnns_filter_recipients_before_send
* Renamed filter: bbpnns-filter-email-subject => bbpnns_filter_email_subject_for_user
* Renamed filter: bbpnns-filter-email-body => bbpnns_filter_email_body_for_user
= 1.6.5 =
* Added user-contributed filters: bbpress_reply_notify_recipients, and bbpress_topic_notify_recipients
= 1.6.4 =
* Added filters: bbpnns-filter-recipients, bbpnns-filter-email-subject, and bbpnns-filter-email-body
= 1.6.3.1 =
* Fixed: buggy dismiss link in previous commit.
= 1.6.3 =
* Added notice about bbPress Notify Pro project at Kickstarter.
= 1.6.2 =
* Fix bug where topic and reply post_types were not set in time to send post.
* Only send notification if post_status is publish, besides not being spam.
* Adjustments to notify_on_save
* Added tests for notify_on_save
= 1.6.1 =
* Passing $post_id and $title variables to filters added in 1.6.
= 1.6 =
* Added support for filters 'bbpnns_topic_url', 'bbpnns_reply_url', and 'bbpnns_topic_reply'
= 1.5.5 =
* Improved Tests
* Renamed some variables.
= 1.5.4 =
* Fix: Make sure bbPress is installed and avoid race conditions when loading.
= 1.5.3 =
* Fix: corrected missing newlines in topic/reply content email.
= 1.5.2 =
* Fix: admin-only emails not working due to missed boolean casting.
= 1.5.1 =
* Fixed bug, 'hidden forum override reply' setting not registered
* Added filters: bbpnns_skip_topic_notification, bbpnns_skip_reply_notification, bpnns_excerpt_size, bbpnns_extra_headers
= 1.5 =
* Added override option to only send emails to Admins in case a Forum is hidden.
* Added tests
= 1.4.2 =
* Tweak: make sure we have unique recipients. In some installs, duplicate emails were being sent.
= 1.4.1 =
* Fixed: preg_replace error in some installs.
= 1.4 =
* Fixed: Strict notices.
* Added: Settings link in Plugins page.
* Added: Logging failed wp_mail call.
* Added: Option to send notifications when adding/updating a topic or reply in the admin.
* Added: Enforce replacement of