Adding a New Notification

To add a new Notification, go to the ‘Add New’ menu item under ‘Notifications’ in the admin sidebar or click the ‘Add New’ button when viewing ‘All Notifications’.

You’ll then be presented with a screen that allows you to create a new notification.

Please note: You may see a flash of various inputs and options as the page loads which then disappear after the page is fully loaded. This is because the page uses javascript to load all options and then shows them and hides them depending on the notification chosen. This is normal and expected behaviour in the plugin.

The first thing you’ll want to do is create a title for your notification. This allows you to distinguish notifications from each other when viewing the ‘All Notifications’ screen. It’s purely a label for your benefit.

Section – ‘Notification Settings’

Screenshot 2015-09-29 15.28.34

Notification For

You’ll then want to set your notification type. Please see here for a description of each notification.

Email Formatting

You can choose between sending this email notification out as HTML with nice formatting, using the WYSIWYG editor or as Plain Text, showing all HTML inline. Either option is useful but depends on your circumstances on which you’ll want to use.

Additional Email Fields

Ticking the ‘Set “From” Name & Email, CC, BCC” checkbox allows you to customise the header of your email a bit more than normal.

WordPress traditionally send out emails from “WordPress” using a “wordpress@yourdomain.com” email address. If you’d like to change that to something that sounds a little nicer, you can do so here.
Additionally, for notifications that support it, you can set the user roles or users that will receive a carbon copy (CC) or blind carbon copy (BCC) of this email. You can select more than one. This is useful if you want to include other users in on emails but they aren’t necessarily the primary recipient.

Send this notification to the Author only

Some notifications will allow you to send the notification to the author of the post / page / trackback / pingback, etc. only. Clicking this checkbox will hide the User Roles / Users selection box.

Do not send this Notification to the User that triggered it

This essentially stops you from receiving notifications about things that you’ve done. For example, you’re an Author and you have a notification for ‘Post Updated’ that sends to the ‘Author’ user role, and you update a lot of posts, you don’t necessarily want to be notified of this as you already know you’ve updated post. Ticking this checkbox and saving it stops the notification from going through to you or anyone else that this might effect.

Handy Feature

Ticking the two checkboxes listed above on any New Comment / Awaiting Moderation or Comment Reply notifications, will prevent the post author from receiving notifications of their own comments and comment replies. They’ll still receive notifications of new comments from others though.

Send To

Choose the user roles and/or users that you want to send the notification to. You can select as many as you like.

If your site has more than 100 users, to prevent slowing down the WordPress Admin, the list of user roles and users in the ‘Select User Roles / Users’ box will be replaced with ‘live search’ instead. To use this, just start typing a username to load a list of matching users and select them as normal. A complete list of user roles will always show above the list of matching users but won’t show until a character is entered into the select box.

Subject

This is the subject of your email and can include shortcodes.

Message Body

This is the body of your email notification and is where the fun happens – you can customise this to include HTML, formatting, shortcodes, you name it! Getting stylish with this will allow you to really jazz-up your WordPress emails. If you need help with shortcodes for your chosen notification, there’s a link to the shortcodes section of this website to the left of the WYSIWYG editor.

Stop additional paragraph and line break HTML from being inserted into my notifications

By default, the WordPress WYSIWYG editor will wrap any content in paragraph (p) and line break (br) tags. If you’re having issues with formatting, try ticking this checkbox, saving the notification, and seeing if that helps.

Section – ‘Save Notification’

Screenshot 2015-09-29 15.51.33

Disable Notification

If you want to stop this notification from sending out emails, you can disable it here. You can easily see which notifications are enabled or disabled via the ‘tick’ icon in the ‘All Notifications’ screen. If you’re using BNFW to override a default WordPress notification (such as the ‘New User Registration – For Admin’ notification) it will disable the default notification too.

Screenshot 2015-09-29 15.49.53

Send Me a Test Email

This button will show once you’ve saved the notification for the first time. Clicking this will send you (the currently logged in user, only) a notification so that you can check for any issues with formatting – it’s doesn’t necessarily prove that a notification will work in the future, just that it looks correctly when it does. Shortcodes will not be replaced with content.