Notification

Description

This plugin allows you to send custom email notifications about various events in WordPress. It also comes with a simple API by which you can add literally any trigger action.

In messages you can use defined merge tags which will be later changed to content applicable for trigger.

There is also option to disable the notifications for specific post, comment or user in case you don’t want to send notification for a secret article.

See Notification homepage and check Developer docs

Default recipients

Plugin comes with few registered by default recipient types:

  • Email address – free type email address
  • Administrator – takes an email from General Settings page
  • User – takes an email from WordPress user profile
  • Merge tag – email rendered by merge tag

Default triggers

These are already defined in plugin’s core and are ready to use. You can enable or disable them on the Settings page.

Any Post Type:

  • Published post notification
  • Updated post notification
  • Post send for review (pending post) notification
  • Post moved to trash notification

Comment / Pingback / Trackback:

  • New comment notification
  • Comment approved notification
  • Comment unapproved notification
  • Comment marked as spam notification
  • Comment moved to trash notification

User:

  • User registered
  • User profile updated
  • User logged in
  • User deleted

Media:

  • Media added
  • Media updated
  • Media deleted

Feel free to suggest new core triggers in support forum

Useful links

Screenshots

  • Trigger edit screen
  • All triggers
  • Settings

Installation

Requirements

This plugin require at least PHP 5.3.0.

Plugin install

Download and install this plugin from Plugins -> Add New admin screen.

Distributing in a plugin or theme

Notification can be loaded also as a part of any plugin or theme. To do it just include plugins’s load.php file. It will figure out if it’s loaded from theme or from plugin.

See the detailed guide

FAQ

How to change notification email headers?

There’s no such option at the moment. Please use some other plugin to adjust wp_mail() headers.

How to register my triggers?

With register_trigger() function. See the detailed guide

How do I fire my trigger to send an email?

With notification() function. See the detailed guide

Can I deregister trigger I don’t want to use?

Yes, with deregister_trigger() function. See the detailed guide

Can I bundle the plugin with my plugin or theme?

Yes, you can. See the detailed guide

Reviews

like this one

i like this plugin, because its very light and easy to use.
for me: must have plugin.

thanks for this plugin.
greets from germany

Great notification plugin

Have tested this plugin and its working great for all kind of notifications. Also very easy to implemented. Keep up your good work!

Per

Lovely plugin +++++

I love this plugin,
I it easy to use.

I am only missing an integrated function so I can check whether or not a custom field is set, if set to a specific value then It should be triggered.

Please can you implement this function?

regards

Right tool for the job!

Handy add-on works as advertised: plug in, deploy, enjoy!

Comparisons are inevitable and in my experience, where others (even more popular in terms of user base at the moment) have failed to trigger notifications, this little fella worked from the onset. Of course, ymmv but this is how it went in my case.

Offering more than enough options, it’s just the matter of easy setup and you’re ready to go.

But most importantly, behind such a good software lies a good person, friendly, pleasant and ready to help. Thanks a bunch Kuba Mikita, wish you all the best!

Read all 25 reviews

Contributors & Developers

“Notification” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

3.0

  • [Fixed] Ignore tags which has been passed to notification but hasn’t be registered in the trigger
  • [Fixed] Conflict with Advanced Custom Fields
  • [Added] Filters for post and comment types to output disbale metabox. notification/disable/post_types_allowed and notification/disable/comment_types_allowed, default to saved general settings
  • [Added] Extensions screen
  • [Added] While registering triggers you can now provide a default title and recipients
  • [Changed] bbPress post types are no longer available in the settings. Triggers for bbPress are provided by addon https://github.com/Kubitomakita/notification-bbpress
  • [Changed] Place where merge tags metabox actions are executed
  • [Changed] Chosen to Selectize.js

2.4

  • [Fixed] Bug with “Can’t use method return value in write context” in Settings class, thanks to @rozv
  • [Fixed] Settings priorities, now every CPT registered not later than init 15 will be catched by the plugin, thanks to @rozv
  • [Fixed] Double protocol in links added via TinyMCE insert link feature, thanks to Jozsef
  • [Fixed] Notices in Notification validation method
  • [Fixed] Empty Recipient value, ie. Administrator
  • [Added] Post type triggers can be disabled for an user
  • [Added] Database Upgrader
  • [Added] User triggers – registered, profile updated, logged in, deleted
  • [Added] Taxonomies merge tags for post types
  • [Added] Media triggers – added, updated, deleted
  • [Changed] Post updated notification is now triggered only if the post has been published before, suggested by nepali65
  • [Changed] Content Type triggers setting has been changed to Enabled triggers

2.3.1

  • [Fixed] Bug with not activated “Disable” option

2.3

  • [Changed] Removed unused default post controls
  • [Changed] Better error handling, plugin will not die now unless WP_DEBUG is active
  • [Changed] Role class parse_value() method now must define 3rd parameter $human_readable
  • [Added] Role recipient
  • [Added] Option to disable notification for specific post (and in future for user or comment), thanks to Jeff Lehman
  • [Changed] string, integer and float merge tags used in the message subject are now rendered

2.2

  • [Added] notification/metabox/trigger/tags/before and notification/metabox/trigger/tags/after actions to merge tags metabox
  • [Added] notification/metabox/recipients/before and notification/metabox/recipients/after actions to recipients metabox
  • [Added] notification/metabox/trigger/before and notification/metabox/trigger/after actions to trigger metabox
  • [Fixed] Settings register action priority
  • [Fixed] Post type trashed template
  • [Changed] Gulpfile to not include any browser
  • [Fixed] Comment type added template
  • [Changed] Comment added trigger now is Akismet compatibile, thanks to Nels Johnson
  • [Changed] Core triggers current type global to anonymous functions, thanks to Bartosz Romanowski @toszcze

2.1

  • [Fixed] Warning when no post or comment type are selected in the settings. Thanks to JoeHana
  • [Fixed] post published trigger
  • [Changed] Post type name in trigger title is now singular
  • [Added] {author_login} merge tag to each post trigger
  • [Added] Promo video: https://www.youtube.com/watch?v=usdBMPjdiuw

2.0.1

  • [Fixed] Issue with not sent emails because of wrong current post type while registering notification action. Thanks to Karl Camenzuli

2.0

  • [Fixed]: Correct choice selected for WP User recipient after saving notification. Thanks to whitwye
  • [Added]: Settings API
  • [Added]: Setting – what to remove upon plugin removal
  • [Added]: Plugin cleanup procedure
  • [Added]: Plugin deactivation feedback popup
  • [Added]: Conditional tag is_notification_defined() to check if notification will be send
  • [Added]: Post permalink to comment triggers
  • [Changed]: Notifications class is now singleton and partialy moved to Admin class
  • [Changed]: Notification trigger metabox is now under the subject
  • [Changed]: On the single Notification edit screen there are only allowed metaboxes displayed
  • [Changed]: You can now controll what post types and comment types trigger use via plugin Settings

1.4

  • [Fixed]: Missing 3rd argument on page publish
  • [Fixed]: Namespace issue for PHP < 5.3
  • [Fixed]: Constant notification on post edit. Thanks to @pehbeh
  • [Changed]: Allow for merge tags empty values. Thanks to kokoq
  • [Added]: Admin notice: beg for a review. It will display only if there’s at least one notification set, on the Notification plugin screens and can be dismissed easly.

1.3.1

  • [Fixed]: Error with “Can’t use function return value in write context” in empty() function. Thanks to Błażej Zabłotny

1.3

  • [Added]: PHP version check
  • [Changed]: Typos in readme.txt file thanks to justyn-clark (https://github.com/Kubitomakita/Notification/pull/1)

1.2

  • [Added]: New User recipient (takes WordPress users)
  • [Added]: Post/Page updated trigger
  • [Added]: Template for triggers. You can now load default template for user
  • [Changed]: Default post published trigger for posts and pages – it was triggered every time post was updated
  • [Changed]: In Notifications table values are now parsed before displaying
  • [Changed]: Readme file

1.1.2

  • Changed priority for main init action from 10 to 5
  • Added ‘notification/cpt/capability_type’ filter for capability mapping

1.1

  • Added ability to distribute in any plugin or theme

1.0

  • Release