README.txt

=== Better Notifications for WP ===
Contributors: voltronik
Donate link: https://betternotificationsforwp.com/donate/
Tags: notification, email, push, sms, alert, HTML, customize, bulk, trigger, CC, BCC
Requires at least: 4.0
Tested up to: 5.4.1
Requires PHP: 5.6
Stable tag: 1.8.3
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Supercharge your WordPress notifications using a WYSIWYG editor and shortcodes. Default and new notifications available. Add more power with Add-ons.

== Description ==

Better Notifications for WP is a simple but powerful plugin for beginners to advanced users that allows you to customise the email notifications that WordPress sends using the WYSIWYG editor and shortcodes. All of the default WordPress email notifications are available to customise as well as lots of new ones. You can choose to send notifications to individual users, multiple users, all users in a user role, multiple roles - you name it! You can also power-up your notifications with [Premium Add-ons](https://betternotificationsforwp.com/downloads/). Emails are sent out via your WordPress website (using `wp_mail`) but can be sent via SMTP using an appropriate 3rd party plugin should you wish.

Here's a quick walkthrough of the plugin in action:
[youtube https://www.youtube.com/watch?v=MxPUyRZPJ1Q]

= An Example: =
You want all the users in the Editor role to be notified via email when a new post is published and you'd like to customise it to include your logo along with the author's name and date / time it was published - with this plugin, that's easy.

> A handy list of shortcodes you can use is available [here](https://betternotificationsforwp.com/shortcodes/ "Shortcodes for use in Better Notifications for WP").

= Premium Add-ons =
Power-up your notifications using add-ons:

[Notification Add-on Bundles](https://betternotificationsforwp.com/add-on-bundles/) - Everything you need for your WordPress notifications. Save big when you buy an add-on bundle. Instant access.

[Subscriptions (GDPR)](https://betternotificationsforwp.com/downloads/subscriptions-gdpr/) - Allow users to manage their subscriptions for BNFW notifications.

[Conditional Notifications](https://betternotificationsforwp.com/downloads/conditional-notifications/) - Limit certain notifications depending on which categories, tags, post formats, or terms you choose.

[Custom Fields](https://betternotificationsforwp.com/downloads/custom-fields/) - Provides a number of new shortcodes allowing you to include data from custom fields and custom user fields created using [ACF](https://wordpress.org/plugins/advanced-custom-fields/).

[Send to Any Email](https://betternotificationsforwp.com/downloads/send-to-any-email/) - Send notifications to non-WordPress Users.

[Digest](https://betternotificationsforwp.com/downloads/digest/) - Group multiple notifications into a single digest notification.

[Global Override](https://betternotificationsforwp.com/downloads/per-post-override/) - Override some of the settings of notifications directly when editing a post, page, or custom post type.

[Reminders](https://betternotificationsforwp.com/downloads/update-reminder/) - Send a reminder to your users and/or user roles when a post, page, or custom post type hasn't been updated after a set amount of time. Also send a notification when a user hasn't logged in for a set amount of time.

[Multisite](https://betternotificationsforwp.com/downloads/multisite/) - Adds new notifications and shortcodes for WordPress Multisite to Better Notifications for WP.

[Profile Builder](https://betternotificationsforwp.com/downloads/profile-builder/) - Adds compatibility and new notifications and shortcodes for Profile Builder Free, Hobbyist, and Pro plugins to Better Notifications for WP.

...and more coming soon!

= Notifications =
The notifications that are currently available to use are:

**Admin**

* New User Registration - For Admin
* User Lost Password - For Admin
* Password Changed - For Admin
* User Email Changed - For Admin
* User Role Changed - For Admin
* User Logged In - For Admin
* WordPress Core Automatic Background Updates
* Privacy – Confirm Action: Export Data Request – For Admin
* Privacy – Confirm Action: Erase Data Request – For Admin

**Transactional**

* New User Registration - For User
* New User - Post-registration Email
* User Lost Password - For User
* Password Changed - For User
* User Email Changed Confirmation - For User
* User Email Changed - For User
* User Role Changed - For User
* User Logged In - For User
* Comment Reply
* Privacy – Confirm Action: Export Data Request – For User
* Privacy – Confirm Action: Erase Data Request – For User
* Privacy – Data Export – For User
* Privacy – Data Erased – For User
* Profile Builder – Approval Request for Admin ([Profile Builder Add-on](https://betternotificationsforwp.com/downloads/profile-builder/))
* Profile Builder – Email Confirmation ([Profile Builder Add-on](https://betternotificationsforwp.com/downloads/profile-builder/))
* Profile Builder – Account Approved ([Profile Builder Add-on](https://betternotificationsforwp.com/downloads/profile-builder/))
* Profile Builder – Account Unapproved ([Profile Builder Add-on](https://betternotificationsforwp.com/downloads/profile-builder/))
* User Login Reminder ([Reminders Add-on](https://betternotificationsforwp.com/downloads/custom-fields/))

**Posts / Custom Post Types**

* New Post Published
* Post Updated
* Post Pending Review
* New Private Post
* Post Scheduled
* Published Post Moved to Trash
* New Comment
* New Comment Awaiting Moderation
* Post - Comment Approved
* Post - Custom Field Updated ([Custom Fields Add-on](https://betternotificationsforwp.com/downloads/custom-fields/))
* Post - Update Reminder ([Reminders Add-on](https://betternotificationsforwp.com/downloads/update-reminder/))
* New Trackback
* New Pingback

**Pages**

* New Page Published
* Page Updated
* Page Pending Review
* New Private Page
* Page Scheduled
* Page - New Comment
* Page - New Comment Awaiting Moderation
* Page - Comment Approved
* Page - Comment Reply
* Page - Custom Field Updated ([Custom Fields Add-on](https://betternotificationsforwp.com/downloads/custom-fields/))
* Page - Update Reminder ([Reminders Add-on](https://betternotificationsforwp.com/downloads/update-reminder/))

**Media**

* New Media Published
* Media Updated
* Media - New Comment
* Media - New Comment Awaiting Moderation
* Media - Comment Approved
* Media - Comment Reply

**Posts**

* New Category
* New Tag

**Custom Post Types**

* New Term

**Multisite ([Multisite Add-on](https://betternotificationsforwp.com/downloads/multisite/))**

* New Site Activated or Created - For Network Admin
* New User Created - For Network Admin
* Network Admin Email Change Attempted - For New Network Admin
* Network Admin Email Changed - For Old Network Admin
* New Site Activated or Created - For Site Admin
* Site Deleted - For Site Admin
* Site Admin Email Change Attempted - For New Site Admin
* Site Admin Email Changed - For Old Site Admin
* New Site Activated - For User
* New User Created - For User
* New User Invited to Site - For User

If you'd like to see a notification in the list above, please drop me a line in the forum and I'll see what I can do to add it.

> Like this plugin? Please leave it [a great review](https://wordpress.org/support/plugin/bnfw/reviews/?rate=5#new-post)! Don't think the plugin is worthy of 5 stars? Having problems? Let me know in the [forum](https://wordpress.org/support/plugin/bnfw/) and I'll do my best to help.

> DISCLAIMER
> This is an incredibly useful and highly rated plugin however, it's possible that overuse or abuse of this plugin could upset your users by sending them too many notifications. By downloading / installing / using this plugin, you take full responsibility of the management / quantity / types of notifications that are sent out from it including abiding by any SPAM laws in your country / operating areas, dealing with / responding to subscription / unsubscription requests, complaints, and so on. I accept no liability or responsibility for SPAM or abuse of this plugin from the user(s) of or anyone that may receive notifications as a result of the use of this plugin. I'm trusting you, please don't abuse your users.



== Installation ==

1. Upload the 'bnfw' plugin folder to the '/wp-content/plugins/' directory or install it via your WordPress Admin.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Use the settings in the new 'Notifications' Menu item in the sidebar to configure the plugin.
4. (Optional) Install a plugin to use SMTP instead of `wp_mail()`. I recommend [Post SMTP Mailer/Email Log](https://wordpress.org/plugins/post-smtp/).
5. Test by creating a notification with some [shortcodes](https://betternotificationsforwp.com/shortcodes/ "Shortcodes for use in Better Notifications for WP").



== Frequently Asked Questions ==

> Full Documentation for BNFW can be found [here](https://betternotificationsforwp.com/documentation/ "Documentation for Better Notifications for WP").

= Is this plugin compatible with the new Block Editor (Gutenberg) in WordPress 5? =

Yes and no. Most notifications work but full support can't be guaranteed for all notifications at the moment. Full support is on the roadmap but for the time being, I'd recommend using the [Classic Editor plugin](https://wordpress.org/plugins/classic-editor/) with BNFW.

= What are shortcodes? Where can I use them in this plugin? =

Shortcodes are text in square brackets that output content of some kind. For example, if you want to add the content of a post to a notification for 'New Post Published', you can use the `[post_content]` shortcode to display this in the email that is sent out.

Shortcodes can be used in the 'Subject' and 'Message Body' of your notifications, except for a select few (due to a restriction in WordPress).

> A handy list of shortcodes you can use is available [here](https://betternotificationsforwp.com/shortcodes/ "Shortcodes for use in Better Notifications for WP").

= What are some scenarios this plugin could be used for? =

* Outreach: A blog/news site with hundreds of subscribers and want to use it to alert them of new blog posts.
* Communication: A small, internal WordPress site and use it to alert staff of new posts or comments.
* Monitor: A website for an awesome new product or service and use it for notifications of pingbacks and trackbacks.
* Security: To receive alerts of password reset requests and their corresponding user.

The possibilities are endless!

= Does this plugin work with anti-spam plugins, such as Akismet? =

Yes! There is an option for suppressing comments marked as SPAM in the plugin settings.

= Does this plugin and the add-ons work with Multisite? =

Yes! Full support for WordPress Multisite was added in 1.6.13, alongside the release of the [Multisite Add-on](https://betternotificationsforwp.com/downloads/multisite/).

= Notifications aren't coming through! =

First of all, follow [this article](https://betternotificationsforwp.com/how-can-i-receive-the-best-support/) about how to find out what might be causing the problem. Additionally, please take a look at [this help document](https://betternotificationsforwp.com/documentation/getting-started/how-to-improve-email-delivery/) to see how you might improve email delivery when using Better Notifications for WP.

Many hosts place a limit on the number of emails that can be sent out within an hour so this may also cause some delay in emails arriving. [This article](https://support.mailpoet.com/knowledgebase/lists-of-hosts-and-their-sending-limits/) has a fairly extensive list of hosts and their corresponding email rate limits that's worth checking out. Alternatively, please check with your host directly to find out what your limit is.

If you're still having problems, please drop me a line in the [Free Support Forums](https://wordpress.org/support/plugin/bnfw) and I'll do my best to help.

= Some of my shortcodes aren't working! =

It's possible you're inserting a shortcode into a notification that cannot use it. For example: the 'New Category' email notification cannot use any of the author or time shortcodes as WordPress only stores the category name, category slug and category description in the database by default. It's also worth checking the spelling and underscores in any shortcodes as well as if they are wrapped in square brackets `[]`.

= Other emails from WordPress / other plugins are being messed up! =

WordPress, by default, sends all emails in Plain Text. If you'd like to include code or use the WYSIWYG editor as part of Better Notifications for WP in your emails, you can change this to HTML using the global setting in Better Notification for WordPress. This can be found under the 'Notifications > Settings' screen. Changing this global email format setting will affect how all emails are sent out from WordPress however, so you may experience formatting issues with emails sent out from other plugins if you change the email format setting in this way. If you do, change this setting to Plain Text. You can also set the email format on a per-notification basis when setting-up a new Notification. The caveat is that WordPress will only either allow setting the email format globally (for all emails) or individually for anything that's non-transactional.

= Custom Post Type 'X' isn't showing in the list of available custom post types =

This is most likely because it's `public` setting is set to `false`. Try changing this and see if it shows up in the list. If the custom post type has been created by a plugin and is set to private (such as [TablePress](https://wordpress.org/plugins/tablepress/ "TablePress")), you'll need to get in touch with the plugin author to see if they'll consider changing it to public instead so that BNFW can send out notifications for it.

= Can I translate this plugin? =

Yes, of course! The plugin is completely translation-friendly and if you send me your .po file, I'll make sure to include it in the plugin and credit you in the changelog.



== Screenshots ==

1. All Notifications

2. Add New / Edit Notification



== Changelog ==

= 1.8.3 - 1st June 2020 =
* Fixed: If you activate BNFW and have not created any notifications, the default WordPress personal data export and erase request emails did not get sent.
* Added: Compatibility with the 1.2 release of the [Custom Fields add-on](https://betternotificationsforwp.com/downloads/custom-fields/).

= 1.8.2 - 14th May 2020 =
* Fixed: Email addresses stored in custom fields weren't being used in Comment notifications when the Custom Fields add-on was installed.
* Fixed: Two PHP notices showing above the subscriptions form when the Subscriptions add-on was installed.
* Fixed: 'The User Lost Password - For User' notification wasn't outputting shortcodes in the message subject.
* Fixed: 'The User Lost Password - For User' notification had an incorrect shortcode when inserting the default email content.

= 1.8.1 - 21st April 2020 =
* Added: Core changes to allow the [Global Override add-on](https://betternotificationsforwp.com/downloads/per-post-override/) to only send out notifications once.
* Fixed: A range of issues relating to the [Global Override add-on](https://betternotificationsforwp.com/downloads/per-post-override/). 

= 1.8 - 8th April 2020 =
* POTENTIAL BREAKING CHANGES - Please edit and re-save each comment notification you have set-up to ensure that the correct notification is selected and saved.
* New: A huge overhaul of the comment notifications which now gives a great comment management workflow.
* New: New Comment, New Comment Awaiting Moderation, Comment Approved, and Comment Reply notifications are now availble to all posts, pages, custom post types, and media attachments.
* Improved: The 'Send this notification to the Author' checkbox has been overhauled to work better for the above notifications. See the relevant section in [this support document](https://betternotificationsforwp.com/documentation/notifications/adding-a-new-notification/) for more information.

= 1.7.7 - 27th March 2020 =
* New: Three new notifications! "New Media Published", "Media Updated", "Media Comment" - complete with new shortcodes for caption, alt text, dimensions, etc.
* New: "User Logged In - For Admin" notification - sends a notification to the admin when users log in.
* New: "User Logged In - For User" notification - sends a notification to the user when they log in.
* New: "Published to Trash" notification - sends a notification when a published post is moved to the trash.
* Improved: Support for plugins that allow users to be assigned to multiple user roles.

= 1.7.6 - 30th January 2020 =
* New Notification: New Comment Approved. This is sent after the comment has been approved.
* New: You can now output the description for the first available category in any new Post/Page/Custom Post Type notification, as well as to New Comment, Comment Awaiting Moderation, and Comment Reply notifications using the shortcode `[post_category_description]`. You can also use the `[post_category_slug]` notification to output the first available category slug.
* Added: Merged two pull requests that came in via the GitHub clone of this plugin relating to filters - ([#1](https://github.com/jackmcconnell/bnfw/pull/4/commits/501d7cdcb9855ad5aa08e4510f752f9ff319567f) and [#2](https://github.com/jackmcconnell/bnfw/pull/5)).
* Added: `$update` as 3rd parameter to `bnfw_trigger_insert_post` filter.
* Added: Additional translatable strings.
* Improved: 'Post Pending Review' notifications are now only sent for the first update to a post that is pending review. Subsequent updates will not trigger another notification. 
* Fixed: Advanced Custom Fields (ACF) was triggering incorrect notifications when post/page/custom post types were submitted via a front-end form. 
* Fixed: The `[post_excerpt]` shortcode now conforms to the `excerpt_length` filter.
* Fixed: Post Pending Review notifications were being sent in duplicate in certain situations.
* Fixed: Added an additional check to ensure a Multisite doesn't crash when BNFW is enabled on a site with no Administrator users.
* Fixed: Multisite notifications were showing the HTMl/Text options for notifications that could only support text.

= 1.7.5 - 23rd September 2019 =
* Added: Support for the new [Digest add-on](https://betternotificationsforwp.com/downloads/digest/)!
* Added: Support for some big changes coming to the [Custom Fields add-on](https://betternotificationsforwp.com/downloads/custom-fields/).
* Added: New Spanish translation.
* Fixed: An issue relating to shortcodes in the [Multisite add-on](https://betternotificationsforwp.com/downloads/multisite/).
* Fixed: Any 'Privacy' notifications are now hiding options that can't be overridden.
* Fixed: Disabling automatic paragraphs on the 'User Lost Password - For User' notification wasn't working.

= 1.7.4 - 19th August 2019 =
* New: You can now filter the mail headers in BNFW using `bnfw_mail_headers`. More details [here](https://betternotificationsforwp.com/documentation/actions-and-filters/).
* Added: Better support for the new Block Editor (Gutenberg) and all post/page/custom post type notifications. More and better support coming soon.
* Added: Support for the upcoming [Digest add-on](https://betternotificationsforwp.com/downloads/digest/).
* Fixed: The 'New User Registration - For Admin' notification was sending out the default WordPress notification as well as the BNFW notification in some cases.
* Fixed: The 'New Comment - Awaiting Moderation' notification was missing from the [Global Override add-on](https://betternotificationsforwp.com/downloads/per-post-override/).
* Fixed: A fatal error which occasionally occurred when a user changes their password on the front-end.

= 1.7.3 - 10th April 2019 =
* New: Notification - 'User Email Changed - For Admin'. This is sent to an admin after a user has successfully changed and confirmed a new email address.
* New: Notification - 'User Email Changed Confirmation - For User'. This is sent to a user in order for them to confirm a change to their email address.
* Added: You can now Enable or Disable a notification by hovering over it on the 'All Notifications' screen as well as enabling or disabling notifications in bulk from the Bulk Actions dropdown menu.
* Fixed: The 'User Email Changed - For User' and 'User Password Changed' notifications were no longer being disabled when attempting to override it since WordPress 5.0.
* Fixed: An issue where the new Block Editor (Gutenberg) caused double notifications upon publishing a post. Better support for Gutenberg will be coming this year. For now, it is recommended to use the [Classic Editor](https://wordpress.org/plugins/classic-editor/) plugin.
* Fixed: The 'New User Registration - For Admin' and 'New User Registration - For User' notifications should work better now after the changes that were made in 1.7.
* Fixed: The 'Send this Notification to the Author' checkbox was missing from the 'New Comment' notification.
* Fixed: The `[comment_moderation_link]` shortcode was outputting blank when used on the 'Post – New Comment Awaiting Moderation' notification and sent to non-Administrator user roles.
* Fixed: The `[edit_post]` shortcode was escaping ampersands in the URL.

= 1.7.2 - 21st November 2018 =
* Fixed: WYSIWYG editor and meta box compatibility for Gutenberg. After the public release of WordPress 5.0 BNFW will continue to use the Classic Editor, as opposed to the new block editor.
* Fixed: New Comment Awaiting Moderation notifications weren't being sent to the Post Author, where selected.

= 1.7.1 - 5th November 2018 =
* New: Full support for the new [Subscriptions (GDPR)](https://betternotificationsforwp.com/downloads/subscriptions-gdpr/) add-on.
* Fixed: Comments marked as SPAM were triggering the 'New Comment Awaiting Moderation' notification.
* Fixed: An issue relating to the 'New Comment Awaiting Moderation' notification not saving when used in conjunction with the Send To Any Email and Custom Fields add-ons.
* Fixed: A couple of minor javascript errors relating to BNFW add-ons.

= 1.7 - 5th September 2018 =
* A huge update packed full of new features and bug fixes, especially for those that like privacy and comment notifications!
* New: Six GDPR / Privacy Notifications. These allow you to override all the new notifications that WordPress 4.9.6 introduced relating to exporting and erasing user data. These are: Privacy – Confirm Action: Export Data Request – For User, Privacy – Confirm Action: Erase Data Request – For User, Privacy – Data Export – For User, Privacy – Data Erased – For User, Privacy – Confirm Action: Export Data Request – For Admin, Privacy – Confirm Action: Erase Data Request – For Admin.
* New: The 'New Comment / Awaiting Moderation' notification has now been split into two so you can have a notification for just New Comments, or just Comments Awaiting Moderation, or both! Can be used on Posts, Pages, and Custom Post Types.
* New: Shortcode - `[user_role]`. This outputs the user's role (or roles if assigned to more than one).
* New: Shortcode - `[first_image]`. Outputs the URL of the first image in a post/page/custom post.
* New: Shortcode - `[post_type_archive]`. Outputs the link for the post type / custom post type archive page.
* New: Shortcode - `[post_category_slug]`. Outputs the category slug of a post or the first category slug if the post is assigned to multiple categories.
* New: Shortcode - `[comment_moderation_link]`. This outputs the link to the WP Admin where you can moderate a new comment.
* New: Shortcode - `[comment_parent_content]`. This outputs the content of the parent comment when used in a Comment Reply notification.
* New: Three Comment Moderation Shortcodes - `[comment_moderation_approve]`, `[comment_moderation_spam]`, `[comment_moderation_delete]`. All for new comments. All should be self-explanatory.
* New: A new column is available in the 'All Notifications' screen that shows which users are excluded from a notification.
* Added: Dutch translation (props Piet).
* Changed: The 'New User Registration - For Admin' notification can now override/be overridden by notifications that use the `wp_new_user_notification_email_admin` filter, introduced in WordPress 4.9.
* Updated: Some of the default content that can be quickly added to a default notification was out-of-date.
* Changed: Freemius has now been removed in favour for the previous iteration of user tracking. This is now an opt-in checkbox on the Notifications > Settings page. Please consider checking this box to help make BNFW even better.
* Fixed: The 'Send this notification to the Author' checkbox still required a user or role to be entered into the 'Send To' box as well.
* Fixed: The `[edit_post]` shortcode wasn't outputting anything when a non-Editor role could post on the front-end.
* Fixed: Email addresses beginning with numbers weren't being saved when used in conjunction with the Send to Any Email add-on.
* Fixed: The SVG icon on WordPress.org wasn't exported correctly.

= 1.6.14 - 25th May 2018 =
* New: As part of my plans for implementing GDPR within BNFW, you can now exclude users and/or roles from your notifications in the new 'Except For' box.
* New: You can now include the post/page author in addition to the list of users and user roles in your notifications (not either/or).
* New: You can now enable the output of shortcodes again when using the `[post_content]` shortcode in your notifications via a new checkbox in the Settings screen.
* New: A list of available actions and filters in BNFW is now available in the [website documentation](https://betternotificationsforwp.com/documentation/actions-and-filters/).
* Updated: The user tracking SDK I use (Freemius) has been updated to allow Multisite network admins to opt-in an entire multisite or delegate opt-in to site-level admins.
* Fixed: Media inserted via the WYSIWYG editor wasn't showing. This should now be fixed.
* Fixed: An issue where the `[post_term taxonomy="X"]` shortcode could only be used once in a notification.
* Fixed: All date shortcodes are now translatable.

= 1.6.13 - 5th April 2018 =
* Added: Full support for the new [Multisite](https://betternotificationsforwp.com/downloads/multisite/) add-on.
* Fixed: Multisite-only - the user_id was being used instead of the username in the login URL in the Lost Password - For User notification.
* Fixed: Multisite-only - the New User Registration - For User notification wasn't working at all.
* Fixed: Multisite-only - Permalink shortcodes weren't using the correct structure and instead were using the default `?p=123` structure when used on sub-sites.
* Fixed: Some user shortcodes were only being outputted for the first user in a user role.
* Fixed: An occasional issue where some notifications weren't appearing for custom post types.

= 1.6.12 - 1st March 2018 =
* New: Lots of new global user shortcodes! It's always been a bit difficult to explain how the user shortcodes changes between notifications - sometimes they're for the author of a post, sometimes they're the recipient user. Now, all user shortcodes are used solely for the author and a new set of global user shortcodes are available for the recipient. Full details are on the [Shortcodes](https://betternotificationsforwp.com/documentation/notifications/shortcodes/) documentation page.
* Added: Preliminary changes for the upcoming [Multisite](https://betternotificationsforwp.com/downloads/multisite/) add-on.

= 1.6.11 - 13th February 2018 =
* Fixed: Update Reminder and Custom Field Updated notifications weren't showing for custom post types.

= 1.6.10 - 31st January 2018 =
* New: Faster customisation! You can now add the subject and message body from a default WordPress email to notifications. Just choose a default WordPress email and click the 'Insert Default Content' button next to the WYSIWYG editor when adding or editing a notification.
* New: If you want to allow other user roles to create or edit notifications, you can now grant them the 'bnfw' capability using a role editor.
* Added: A new notice will display at the top of all Notification screens explaining how you can improve email deliverability. You can dismiss this permanently at any time.
* Added: Inline help tips are now available when creating or editing a notification. Handy if you want to remember how something works but don't want to sift through the documentation.
* Added: Merged two pull request that came in via the GitHub clone of this plugin - ([#1](https://github.com/jackmcconnell/bnfw/pull/1) and [#2](https://github.com/jackmcconnell/bnfw/pull/2)).
* Added: For faster support, there is now a Priority Support menu item in the BNFW Notifications menu. Priority Support is available to customers with an active subscription to an add-on.
* Improved: All date related shortcodes now output in the date and time format set in Settings > General in the WordPress Admin.
* Improved: The list of available notifications has been re-ordered to make more sense.
* Improved: A warning will now show if the total user count in the Send To box is more than 200 users.
* Improved: Usage tracking will now only load on single sites and not on sites that are part of a Multisite network.
* Updated: Usage tracking SDK updated to the latest version.
* Fixed: Warnings were showing when posting a new comment on the front-end.

= 1.6.9 - 7th December 2017 =
* Merry Christmas & Happy New Year!
* New: Support for new [Profile Builder Add-on](https://betternotificationsforwp.com/downloads/profile-builder/).
* Fixed: An issue where the YouTube video wasn't showing properly on the BNFW WP.org plugin page.

= 1.6.8 - 23rd November 2017 =
* New: All shortcodes that are correctly registered within WordPress will now be stripped from the `[post_excerpt]` and `[post_content]` shortcodes so as to not cause layout or styling issues within your notifications.
* Added: A minimum PHP version of 5.6 is now required to run BNFW.
* Fixed: Compatibility with the [Reminders](https://betternotificationsforwp.com/downloads/update-reminder/) and [Conditional Notifications](https://betternotificationsforwp.com/downloads/conditional-notifications/) add-ons.
* Reminder: You may be asked to opt into plugin tracking when updating. Please consider doing so as it really helps with the development of the plugin. Full details on what is tracked is available on [this page](https://betternotificationsforwp.com/documentation/settings/what-information-will-be-tracked-by-opting-into-usage-tracking/).

= 1.6.7 - 10th August 2017 =
* New: Shortcode - `[current_time]` Will output the current time as per the settings in WordPress > Settings.
* New: Shortcode - `[current_date]` Will output the current date as per the settings in WordPress > Settings.
* New: Shortcode - `[admin_email]` Adds the email address of the main site admin as per the settings in WordPress > Settings.
* Fixed: BNFW now respects the post status of posts submitted via ACF's front-end forms (acf_form).
* Fixed: Privately Published posts that are updated now trigger the 'Post Updated' notification.
* Changed: The opt-in for plugin tracking in BNFW has changed. You may be asked to opt-in / opt-out when updating the plugin.

= 1.6.6 - 28th June 2017 =
* Fixed: New Comments on Custom Post Types weren't always sending notifications.
* Fixed: An issue where using the `bnfw_trigger_insert_post()` filter wasn't always working correctly.
* Fixed: An issue where checking a notification was disabled wasn't always working correctly.
* Added: Support for limiting 'New User Registration - For User' notifications to specific user roles in the recently updated [Conditional Notifications add-on](https://betternotificationsforwp.com/downloads/conditional-notifications/).
* Added: Support for huge logic enhancements to the soon to be updated [Global Override add-on](https://betternotificationsforwp.com/downloads/per-post-override/).
* Added: Support for the new 'User Login Reminder' notification in the soon to be updated [Reminders add-on](https://betternotificationsforwp.com/downloads/update-reminder/).

= 1.6.5 - 18th May 2017 =
* New: ACF Form compatibility has now been re-added! Props to @elliotcondon for the help.
* Remember to subscribe to the [mailing list](http://voltronik.us2.list-manage2.com/subscribe?u=57c012217219b2d81dda0085f&id=28eebdab28) if you want to be notified of new add-ons for BNFW and receive 10% off your first add-on purchase.

= 1.6.4 - 18th April 2017 =
* New: You can now use `[global_user_username]` in any notification to output the recipient's username.
* New: When a user is assigned to multiple roles which have been added to a notification, they will only receive the notification once and not once for each role that the notification is configured to send to.
* Improved: Clearer labelling on new custom post type notifications.
* Removed / Fixed: The addition of ACF Form compatibility in the last version was causing a range of issues, some minor, some serious. Until a more robust solution is found, this has been removed from the plugin whilst I try and get in touch with the author of ACF and work on a solution or collaboration.
* Fixed: The 'Send To' select box was being overlayed by the dropdown that shows when clicking in the box.
* Fixed: Searching for a user when a site has more than 200 users in the 'Send To' box now works as expected.

= 1.6.3 - 13th March 2017 =
* Added: Support for the new [Send to Any Email add-on](https://betternotificationsforwp.com/downloads/send-to-any-email/).
* Added: Support for Advanced Custom Field (ACF) front-end forms. Finally!
* Updated: French translation (props @matcho).
* Improved: The 'Lost Password' notifications now begin with 'User Lost Password' to make them easier to understand.
* Fixed: The 'Reply To' fields weren't saving correctly.
* Fixed: Ensure post shortcodes are rendered before sending (props @cliffpaulick).
* Fixed: A minor issue with the custom field selection box when using the [Custom Fields add-on](https://betternotificationsforwp.com/downloads/custom-fields/).

= 1.6.2 - 17th February 2017 =
* Fixed: The 'Shortcode Help' button wasn't working correctly for some of the new notifications.

= 1.6.1 - 17th February 2017 =
* New & Improved: The 'Password Changed - For User', 'Password Changed - For Admin', and 'User Email Changed - For User' notifications have now been fully implemented.
* New: You can now use `[post_term taxonomy="TAXONOMY_NAME"]` to output the term(s) from the chosen taxonomy.
* Improved: Any anti-SPAM plugin should now work with BNFW, not just Akismet.
* Improved: Emails sent via the "Send me a Test Email" button now prepend the Subject line with "Test Email: " so that you can tell which is a test notification and which is a real notification when using an email log plugin.
* Fixed: The Global User Shortcodes weren't outputting anything when used in the 'User Email Changed - For User' notification.
Fixed: When a 'Lost Password – For User' notification had been set-up but disabled, it wasn't disabling the default WordPress notification.
* Fixed: The 'WordPress Core Automatic Background Updates' notification wasn't working at all.
* Fixed: The Global User Shortcodes were being output incorrectly in test emails.
* Fixed: The `[featured_image]` shortcode was outputting the shortcode name as opposed to a blank when no featured image is set.
* Fixed: A number of warnings and notices relating to the 'Lost Password' notifications when on WordPress's Lost Password screen.
* Fixed: The 'Add-on Licenses' screen was displaying HTML characters where there shouldn't be any.
* Fixed: An error was occurring when triggering notifications when used in conjunction with the latest version of the Custom Fields add-on.
* Fixed: Some language translation strings were incorrect.
* Updated: EDD_SL_Plugin_Updater is now at the latest version for add-ons.

= 1.6 - 12th December 2016 =
* Merry Christmas & Happy New Year!
* New: Anonymous tracking of the features you use in BNFW is now an opt-in checkbox on the Notifications > Settings page. Please consider checking this box to help make BNFW even better. You'll also receive a 10% off coupon code when you sign-up to the [mailing list](http://voltronik.us2.list-manage2.com/subscribe?u=57c012217219b2d81dda0085f&id=28eebdab28) too.
* New: Notifications for privately published posts / pages / custom post types.
* New: Notification and accompanying shortcode for customising WordPress Core Automatic Background Updates (Success / Fail / Critical).
* New: Notification for User Password Changed.
* New: Notification for User Email Changed - For User.
* New: Shortcodes for showing the old and new user role when used in conjunction with the User Role Changed notifications.
* New: You can now add a 'Reply To' name and email address in the Additional Email Fields for all notifications that support it.
* New: You can now prevent yourself from receiving notifications of comments or replies to comments on one of your posts by combining the two checkboxes 'Send this notification to the Author only' and 'Do not send this Notification to the User that triggered it'.
* New: All transactional notifications can now be set to either HTML or Plain Text.
* Improved: Better compatibility with [Theme My Login](https://en-gb.wordpress.org/plugins/theme-my-login/).
* Improved: Re-worded a checkbox to be more understandable. It did say, "Disable this Notification for the User that triggered it", but now says, "Do not send this Notification to the User that triggered it".
* Improved: Compatibility with Mashshare.
* Fixed: Global User Shortcodes weren't being outputted correctly in the 'Lost Password - For User' notification.
* Fixed: Child themes weren't being registered correctly in the filter when using the front-end forms filter.
* Fixed: The number of options within notifications was being limited to the number of blog posts WordPress was set to show.
* Fixed: The 'Shortcode Help' button wasn't linking to the BNFW website correctly for some BNFW add-ons.

= 1.5.3 - 13th September 2016 =
* Fixed: User Roles in the 'User Roles / Users' admin column were being displayed only in lowercase.
* Fixed: The `[wp_capabilities]` shortcode wasn't outputting properly. It now displays the higher-level capabilities that the user has.

= 1.5.2 - 6th September 2016 =
* Fixed: Custom User Roles were showing 0 users in the 'To' field.
* Added: Generic CSS classes to BNFW admin.
* Updated: German Translation to show English in certain places where translation text breaks the WP Admin UI (props @helmi).
* Full code review and submission to WordPress VIP!

= 1.5.1 - 5th August 2016 =
* Fixed: 'Text' mode in the WYSIWYG editor didn't show any buttons when the BNFW Per-post Override Add-on was activated.

= 1.5 - 25th July 2016 =
* New: Global Site Shortcodes! Include these in any notification to output the site title (`[global_site_title]`), site tagline (`[global_site_tagline]`), or site URL (`[global_site_url]`).
* New: Global User Shortcodes! Include these in any notification to output the user's first name (`[global_user_firstname]`), user's last name (`[global_user_lastname]`), or user's email address (`[global_user_email]`).
* New: The 'User Role Changed' notification has been split into two transactional notifications - one that can be sent to users and one that can be sent to admins.
* New: Shortcode `[featured_image]`. Outputs the URL for the featured image (if one is available).
* New: Shortcode `[user_avatar]`. Outputs the User's avatar when used in a capable notification.
* New: Shortcode `[commenter_avatar]`. Outputs the comment author's avatar for comment-based notifications.
* Improved: 'Comment Reply' notifications are now available to use for Pages and Custom Post Types.
* Improved: When sending notifications to user roles in the 'To' field, it will now show how many users are in that role.
* Improved: The 'Lost Password - For User', 'User Role Changed - For Admin', and 'User Role Changed - For User' notifications now have the option to 'Stop additional paragraph and line break HTML from being inserted into my notifications' via the checkbox below the WYSIWYG editor on the Add New / Edit Notification screen.

= 1.4.1 - 3rd June 2016 =
* Fixed: Multiple emails were being sent for a single notification for a small number of users. After lots of hunting and lots of testing, I'm hoping this should now be fixed.
* Fixed: The 'User Role Changed' notification was broken after the update to WordPress 4.5.
* Fixed: The 'Password Reset - For User' and 'New User - Post-registration Email' notifications were being sent in HTML but with all carriage returns / line breaks stripped out.
* Fixed: User shortcodes for new comments on custom post types weren't being outputted properly.
* Fixed: The 'Notifications' BNFW menu item in the Sidebar in the WordPress Admin was showing for non-admins.
* Added: German Translation (props Michael Schröttle).

= 1.4 - 8th April 2016 =
* New: Shortcode `[post_slug]`. Output the post slug.
* New: Shortcode `[edit_post]`. Outputs the link to edit the post / page / custom post.
* New: Shortcode `[post_parent_permalink]`. Outputs a permalink to the post / page / custom post's parent item.
* New: Shortcode `[author_link]`. Outputs a link to the post / page / custom post's author archive.
* New: You can now add the collection of User Shortcodes to the 'Lost Password - For User' email.
* New: Support for the 'O2' plugin, when used in conjunction with the 'P2' Theme via a filter. Please see the [documentation](https://betternotificationsforwp.com/documentation/) for details.
* Improved: Users were getting confused with the 'Welcome Email', thinking it operated like that in the 'SB Welcome Email Editor' plugin. The name of this notification has been changed from 'New User - Welcome Email' to 'New User - Post-registration Email' to help differentiate its functionality in BNFW.
* Improved: The screen where you add your license(s) after purchasing any BNFW add-on(s) is now called 'Add-on Licenses', instead of going to 'Settings' and adding them there.
* Improved: Setting a notification to send to 'the author only' now shows a label in the 'User Roles / Users' column in the 'All Notifications' screen.
* Improved: 'New Comment / Awaiting Moderation', 'New Trackback', and 'New Pingback' notifications now show the 'Send this notification to the Author only' checkbox.
* Improved: If a notification is present but disabled, the default WordPress notification (if there is one), will not be sent.
* Fixed: New Post Published notifications weren't being sent if you had the Per-post Override add-on installed.

= 1.3.9.5 - 26th February 2016 =
* Fixed: New Post Published notifications were triggering multiple times due to `auto_draft_to_publish`.

= 1.3.9.4 - 15th February 2016 =
* Filter improvements for the new [Per-post Override add-on](https://betternotificationsforwp.com/downloads/per-post-override/).

= 1.3.9.3 - 12th February 2016 =
* General bug fixes and updates relating to future add-ons and the new [Per-post Override add-on](https://betternotificationsforwp.com/downloads/per-post-override/) which allows you to override your notifications for each post / page / custom post.
* Added: New Post Published notifications now trigger on `auto_draft_to_publish`. This may or may not effect you if you publish through a front-end form or from an app.

= 1.3.9.2 - 29th January 2016 =
* The [Add-on Store](https://betternotificationsforwp.com/downloads/) is now live! Looking for some extra, premium functionality in your notifications? You might find an add-on for it!
* New: A filter is now available for adding compatibility to themes for creating posts using `wp_insert_post`. Please see the bottom of the [FAQ](https://wordpress.org/plugins/bnfw/faq/) for details.
* Fixed: 'User Role Changed' notifications were being triggered for new users.
* Fixed: The label for custom taxonomies was showing in the Notification select box even if you didn't have any.
* Fixed: A warning was showing when no 'CC' or 'BCC' details were added but the 'Name' and 'From' details were specified.
* Fixed: A warning was showing after a taxonomy was deleted but a notification existed for it.
* Fixed: Replaced select2 v4 script for full version for better compatibility with other plugins.
* Fixed: The javascript in the plugin is now translatable.
* Added: French translation - props Mygale06.

= 1.3.9.1 - 9th January 2016 =
* Fixed: Missing shortcode link for new 'User Role Changed' notification.
* Fixed: Duplicate 'User Role Changed' listing in the Notification select box.

= 1.3.9 - 9th January 2016 =
* Happy New Year!
* New: Transactional notification for when a User Role Changed. This is sent to the user when their User Role is changed.
* Fixed: Ensure that at least one User or User Role is selected before saving a notification.
* Fixed: select2 v4 update and compatibility with Ultimate Member and ACF Pro.

= 1.3.8 - 16th December 2015 =
* Fixed: Notifications weren't being sent out at all. After lots of testing, I think this should now be resolved.
* Fixed: An issue where quotes in the Subject field were causing part of/all the field content to be removed.
* Improved: If you have more than 100 users on your site, the User Roles / Users select box will show the first 100 users only. You can search through the rest by typing the first character of a username in the select box and it will show you any matching users.

= 1.3.7 - 11th December 2015 =
* Fixed: An issue where EDD_SL_Plugin_Updater class was already declared by another plugin.

= 1.3.6 - 11th December 2015 =
* Merry Christmas to you all!
* New: Password Reset notifications can now be in HTML or Plain Text.
* Improved: The Users / User Role select box now utilises live search instead of showing all users in a long list if you have more than 100 users. This should be a huge performance improvement if your site has a lot of users.
* Updated: select2.js library updated to v4.
* Fixed: Compatibility with password reset notifications in WordPress 4.1.0 and below.
* Fixed: An issue where the 'Tag' label was showing incorrectly in the 'All Notifications' screen.
* I've added a short disclaimer to the [Description Tab](https://wordpress.org/plugins/bnfw/) regarding SPAM and overuse/abuse of this plugin which I recommend a quick read through.

= 1.3.5 - 9th October 2015 =
* Fixed: A large bug that was causing issues with Password URL shortcodes in the 'New User Registration - For User' and 'Password Reset - For User' notifications.
* Fixed: An issue where the 'disabled wpautop' checkbox was appearing on transactional emails.
* Fixed: Some labels in the 'All Notifications' screen weren't formatted correctly.
* Fixed: Translations weren't referenced correctly. Auto-translation will be [done by WordPress.org automatically](https://make.wordpress.org/plugins/2015/09/01/plugin-translations-on-wordpress-org/) at some point in the future.

= 1.3.4 - 2nd October 2015 =
* New: Choose automatic or manual paragraph / line breaks in the WYSIWYG editor. This fixes an issue where they were inserted automatically when they weren't desired. The checkbox for this is below the WYSIWYG editor.
* New: You can now add images to your notifications using the 'Add Media' button above the WYSIWYG editor.
* New: Portuguese Brazil translation for v1.3.3 (props Glayton Caixeta).
* New: BNFW now has it's own [website](https://betternotificationsforwp.com/)!
* New: Buttons have been added linking to the Documentation and Shortcode Help sections of the website next to the WYSIWYG editor.
* New: Support for premium add-ons, coming very soon! More info and sign-up for updates [here](https://wordpress.org/support/topic/add-ons-are-coming-sign-up-for-updates).
* New: Added a video overview of BNFW showing it's features and functionality to the main plugin page and website.
* Fixed: The 'New User Registration - For User' now works again after WordPress 4.3 broke it.
* Fixed: HTML using quotes was being escaped in emails.
* Fixed: The 'Settings' sidebar menu item wasn't highlighting properly.
* I also added all previous release dates to this changelog.
* If you liked this plugin, please feel free to leave an honest [review](https://wordpress.org/support/view/plugin-reviews/bnfw?filter=5#postform). If you didn't or have a problem, please send me a message in the [Support Forum](https://wordpress.org/support/plugin/bnfw).

= 1.3.3 - 22nd August 2015 =
* New: You can now send a notification to the Post Author only, where a notification supports it.
* New: There is now an option in the Settings screen to globally set WordPress to send emails in either HTML or Plain Text. Please read the [FAQ](https://wordpress.org/plugins/bnfw/faq/) for more information about this as there is a small caveat.
* New: Support for WordPress 4.3.
* New: Pending posts that are changed to Published now trigger the 'New Post / Page Notification'.
* Improved: Scheduled notifications now trigger two notifications, one for when they're saved as Scheduled ('Post Scheduled' / 'Page Scheduled') and one for when they're actually published ('New Post Published / New Page Published').
* Improved: Swapped the green tick for a dashicons tick for a slightly more speedier, native-feeling plugin.
* Improved: Reduced the flash of hidden elements when loading the New / Edit Notification screen.
* Fixed: WordPress 4.3 doesn't allow passwords to be automatically created for new users and will instead, send them to a password generator page. The `[password]` shortcode has been replaced with `[password_url]`. `[password]` should still work though so it won't break your existing notifications.
* Fixed: Some output was being showed when WP_DEBUG was enabled.
* Fixed: Removed the 'slug' field when enabled from Screen Options.

= 1.3.2 - 20th July 2015 =
* Fixed: Replaced a deprecated function which might cause a warning to show when `WP_DEBUG` was enabled.

= 1.3.1 - 18th July 2015 =
* Fixed: The P2 theme wasn't triggering new post or comment notifications.
* Fixed: Sometimes the shortcode help link at the bottom of the notification editor wouldn't link to the help page properly.

= 1.3 - 2nd July 2015 =
* New: Option to disable notifications going to the user that triggered them.
* New: Comment Reply Notification. This is a transactional notification that will only trigger when replying to the original comment (i.e. Up to 2-levels deep).
* New: New Shortcode: Update Author. Use `[post_update_author]` in any Post or Page notifications to see which user updated the post.
* New: Choose between sending the notification as plain text or HTML.
* New: A basic implementation of shortcode help has been added into the plugin. Click the link below the message body editor to see which shortcodes can be used for the currently selected notification.
* Improved: The 'New User Registration' (For Admin & User) and 'Welcome Email' notifications now allow you to use all of the 'User' shortcodes.
* Fixed: Formatting in emails sent from other plugins were being effected by BNFW.
* Fixed: Notifications for Categories, Terms and Tags weren't getting triggered.
* Fixed: Notifications weren't getting triggered when using the P2 theme (please see the [FAQ](https://wordpress.org/plugins/bnfw/faq/) for more information about this).
* Fixed: Additional Email fields were being shown for transactional notifications that couldn't use them.

= 1.2 - 19th May 2015 =
* New: WYSIWYG Editor for notifications!
* New: From Name, From Email, CC and BCC options are now available to use for each notification!
* New: 'Send Me a Test Email' button. Save your notification first and then send yourself a test email! This will only go to you and not to any of the other users selected in the notification. Shortcodes will not be expanded but will be shown in place.
* Improved: The User Role / Users drop down box has been unified for simplicity.
* Fixed: Lost Password (For User) notifications were being sent in plain text.
* Fixed: Not all custom post types were showing when setting up a new notification.
* Fixed: Notifications for New Terms not generating notification emails.
* Fixed: Custom Taxonomies missing from columns in the All Notifications screen.
* Fixed: Added a space after lists of tags, categories, and terms.
* Thank you again for all of your support, feedback, and awesome reviews. You people make WordPress great!

= 1.1.5.3 - 21st April 2015 =
* Compatibility with WordPress 4.2.

= 1.1.5.2 - 15th April 2015 =
* Fixed: Custom Post Type Pending Posts not being sent.
* Fixed: Post excerpt not outputting anything.
* Removed: `[closedpostboxes_page], [rich_editing], and [admin_color]` as was a bit defunct and causing issues.
* Changed: `[post_author]` now outputs the display name instead of the author ID.
* Improved: Clarity of custom post type and taxonomy labels.

= 1.1.5.1 - 13th April 2015 =
* Fix for Custom Post Type notifications not populating shortcodes.
* Fix for Custom Taxonomy terms not sending out notification emails.

= 1.1.5 - 10th April 2015 =
* New Shortcode: [permalink].
* New Notifications: 'Scheduled Posts' and 'Scheduled Pages'.
* New Shortcodes for the above Notifications: [post_scheduled_date] and [post_scheduled_date_gmt].
* New Notification: 'New Page Published'.
* New Notification: 'Page 'Updated'.
* New Notification: 'Page Pending Review'.
* New Notification: 'New Page - Comment'.
* Fixed: A few bugs reported via the forums and some others that i've found - thanks everyone!

= 1.1 - 16th March 2015 =
* Lots of cool new stuff and more to come soon!
* Transactional notifications (notifications intended only for the end user) have been added as a new group in the notifications select box.
* New Notification: Post Pending Review (for all post types).
* New Notification: New User Registration (Transactional).
* New Notification: Password Reset (Transactional).
* New Notification: New User Welcome Email (Transactional).
* Added an option to enable or disable each notification.
* Better support for custom taxonomies and terms.
* Fixed: A few PHP warnings were showing when using `WP_DEBUG`.
* Fixed: HTML tags being stripped from `[post_content]` and `[comment_content]`.
* Removed: Some WordPress Multisite shortcodes that didn't work properly. Proper support for Multisite will come later.
* If you liked this plugin, please leave a review. If you didn't or have a problem, please send me a message in the Support Forum.

= 1.0.2 - 17th January 2015 =
* Bug fix for `[ID]` shortcode not outputting anything.
* Bug fix for `[post_category]` showing as empty.
* Added tags shortcode for use in certain notifications using `[post_tag]`.

= 1.0.1 - 21th December 2014 =
* Bug fix for notifications not being sent to custom user roles or individual users of custom roles.
* Added a 'Notification Type' column to the notifications screen.
* Renamed 'User Roles' column in notifications screen to 'User Roles/Users'.

= 1.0 - 17th December 2014 =
* First major release - we're no longer in beta!
* Total overhaul. The plugin has been completely re-written.
* Auto-importer: Your old notifications will be imported when updating the plugin.
* New 'Generator' for easily creating and editing your notifications.
* More options and notification types as per feedback via the forums - thanks everyone!
* Granular control over choosing either user roles or individual users you'd like to send a notification to.
* Fully translatable.
* Loads of bugfixes and improvements.

= 0.2.1 beta - 4th June 2013 =
* Minor Bugfixes

= 0.2 beta - 8th April 2013 =
* Added an option to suppress SPAM comment notifications.

= 0.1 beta - 25th March 2013 =
* Initial version of the plugin.
* Settings page for configuring notification types for roles.
* Email Templates page for customising emails using HTML and shortcodes.



== Upgrade Notice ==

= Migrating from 0.2.1 to 1.0 =

Version 1 features an auto-importer which should migrate all of your notifications from any previous versions of the plugin to 1.0.
Please ensure that you check, double check and test your notifications before and after upgrading.