Customize WordPress vs Rock The Slackbot

Better Notifications for WP is a simple but powerful plugin for that allows you to customise the email notifications that WordPress sends using a 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. Emails are sent out via your WordPress website (using wp_mail) but can be sent via SMTP using a 3rd party plugin should you wish. If you want to let users create their own email notifications/subscriptions/alerts, check out my other plugin: Content Notify. Here’s a quick walkthrough of the plugin in action: 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. Premium Add-ons Power-up your notifications using add-ons: Notification Add-on Bundles – Everything you need for your WordPress notifications. Save big when you buy an add-on bundle. Instant access. Subscriptions (GDPR) – Allow users to manage their subscriptions for BNFW notifications. If you want to let users create their own email notifications/subscriptions/alerts, check out my other plugin: Content Notify. Conditional Notifications – Limit certain notifications depending on which categories, tags, post formats, or terms you choose. Custom Fields – Provides a number of new shortcodes allowing you to include data from custom fields and custom user fields created using ACF. Send to Any Email – Send notifications to non-WordPress Users. Digest – Group multiple notifications into a single digest notification. Global Override – Override some of the settings of notifications directly when editing a post, page, or custom post type. Reminders – 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 – Adds new notifications and shortcodes for WordPress Multisite to Better Notifications for WP. 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) Profile Builder – Email Confirmation (Profile Builder Add-on) Profile Builder – Account Approved (Profile Builder Add-on) Profile Builder – Account Unapproved (Profile Builder Add-on) User Login Reminder (Reminders Add-on) 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) Post – Update Reminder (Reminders Add-on) 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) Page – Update Reminder (Reminders Add-on) 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) 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. If you want to let users create their own email notifications/subscriptions/alerts, check out my other plugin: Content Notify. Like this plugin? Please leave it a great review! Don’t think the plugin is worthy of 5 stars? Having problems? Let me know in the forum 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.

What is Slack? Slack is a team collaboration tool that offers chat rooms organized by topic, as well as private groups and direct messaging. It’s a great way to be productive with your team without clogging up your inbox. What is A Slackbot? Slackbot is Slack’s built-in robot, which helps us send messages to you and your team inside your Slack account. Why Rock The Slackbot? Because it can help you manage your websites, and stay on top of changes, by sending notifications (following numerous WordPress events) to your Slackbot who will pass them along to a channel or direct message in your Slack account. Rock the Slackbot is multisite-friendly. Rock the Slackbot sends customizable notifications for the following events: When a post is published When a post is unpublished When a post is updated When a post is deleted When a post is trashed When a comment is added When a comment is approved When a comment is unapproved When a comment is marked as spam When a comment is trashed When a 404 error is thrown When a menu item is deleted When media is added When media is edited When media is deleted When a user is added When a user is deleted When a user’s role is changed When a plugin, theme, or core update is available When a plugin, theme, or core is updated I’m working to add the following events: When menu item is added When plugins or themes are uploaded When plugins or themes are activated Each event can be customized to allow you to send different event notifications to different Slack channels, e.g. you can send core, theme and plugin updates to your “wp-development” channel while all of your post changes go to your “wp-content” channel. Please use the Issues section of this plugin’s GitHub repo to suggest features, like other notification events. A Slack account is required to use this plugin and is free to use for as long as you want and with an unlimited number of people. Visit the Slack website to learn more and sign up. Send A Simple Slack Message You can use the following send_webhook_message() function to send a simple message to your Slack account. The function accepts the following parameters: $webhook_id_or_url – provide the webhook URL or the ID of one stored in settings $message – the message you want to send $channel – OPTIONAL – the channel you want to send message to. Prefix with # for a specific channel or @ for a specific user. Will use default channel if nothing is passed. // Use this function to send a simple message to Slack rock_the_slackbot()->send_webhook_message( ‘564d3c1cdf52d’, ‘this is a test’, ‘#testchannel’ ); Filters Rock The Slackbot has filters setup to allow you to tweak each WordPress notification before it’s sent. You can setup a filter for all notifications or drill down by event or specific webhook. Each notification filter passes three arguments: $notification – an array containing the notification information: webhook URL (the URL for your Slack account) and the payload (all of the information being sent to Slack) for the notification $notification_event – the slug of the notification event Will be false if you send a custom Slack notification that doesn’t involve a WordPress event $event_args – an array containing notification event specific information Will be false if you send a custom Slack notification that doesn’t involve a WordPress event See Notification Events below to learn which information is passed to the filters for each notification event. Filter all WordPress notifications add_filter( 'rock_the_slackbot_notification', 'filter_rock_the_slackbot_notification', 10, 3 ); function filter_rock_the_slackbot_notification( $notification, $notification_event, $event_args ) { // Change the pieces // Return the notification return $notification; } Filter WordPress notifications by webhook ID // You can find the ID for each of your webhooks on their edit screen in the admin add_filter( 'rock_the_slackbot_notification_(webhook_id)', 'filter_rock_the_slackbot_notification_webhook', 10, 3 ); function filter_rock_the_slackbot_notification_webhook( $notification, $notification_event, $event_args ) { // Change the pieces // Return the notification return $notification; } Filter WordPress notifications by event slug // The event slugs are listed below add_filter( 'rock_the_slackbot_notification_(notification_event)', 'filter_rock_the_slackbot_notification_event', 10, 3 ); function filter_rock_the_slackbot_notification_event( $notification, $notification_event, $event_args ) { // Change the pieces // Return the notification return $notification; } Filter all outgoing webhook payloads that are sent to Slack Whether it’s a WordPress notification or a simple Slack message, all messages to Slack are sent as a payload in an outgoing webhook. This filter allows you to change any payload sent to Slack in an outgoing webhook. add_filter( 'rock_the_slackbot_outgoing_webhook_payload', 'filter_rock_the_slackbot_outgoing_webhook_payload', 10, 2 ); function filter_rock_the_slackbot_outgoing_webhook_payload( $payload, $webhook_url ) { // Change the payload // Return the payload return $notification; } Notification Events Including event specific information passed to filters for each notification event. Content post_published Passed To Filters post – the WP_Post object data of the post that was published old_post_status – the status of the post before it was published new_post_status – the current status of the published post post_unpublished Passed To Filters post – the WP_Post object data of the post that was unpublished old_post_status – the status of the post before it was unpublished new_post_status – the current status of the unpublished post post_updated Passed To Filters post_id – the post ID of the post you updated post_before – the WP_Post object data of the post before it was updated post_after – the WP_Post object data of the post after it was updated post_deleted Passed To Filters post – the WP_Post object data of the post that was deleted post_trashed Passed To Filters post – the WP_Post object data of the post that was trashed is_404 Passed To Filters url – the URL that threw the 404 error referer – the HTTP referer (may not always be defined) ip_address – the IP address of the user who visited the URL (may not always be defined) user_agent – the user agent of the user who visited the URL (may not always be defined) wp_query – the WordPress query variables mysql_request – the MySQL query request Menus menu_item_deleted Passed To Filters menu – the WP_Post object data of the menu that held the menu item menu_item_id – the post ID of the menu item that was deleted Media add_attachment Passed To Filters attachment_post – the WP_Post object data for the attachment you added edit_attachment Passed To Filters attachment_post – the WP_Post object data for the attachment you edited delete_attachment Passed To Filters attachment_post – the WP_Post object data for the attachment you deleted Users user_added Passed To Filters user – the WP_User data for the user you added user_deleted Passed To Filters user – the WP_User data for the user you deleted set_user_role Passed To Filters user – the WP_User data for the user whose role was changed current_user_roles – the current user roles for the user whose role was changed old_user_roles – the old user roles for the user whose role was changed Updates core_update_available Passed To Filters current_version – the current version number of WordPress core new_version – the version number for the WordPress core update core_updated Passed To Filters current_version – the current version number of WordPress core after the update old_version – the old version number for WordPress core before the update plugin_update_available Passed To Filters plugins – includes an array of the plugins who have updates available plugin_updated Passed To Filters plugin – includes an array of the plugin(s) that were updated theme_update_available Passed To Filters themes – includes an array of the themes who have updates available theme_updated Passed To Filters theme – includes an array of the theme(s) that were updated Filter Examples You can use a filter to change the Slack notification to go to a different Slack channel according to post information, like the post category: add_filter( 'rock_the_slackbot_notification', 'filter_rock_the_slackbot_notification', 10, 3 ); function filter_rock_the_slackbot_notification( $notification, $notification_event, $event_args ) { // Only run filter for specific events switch ( $notification_event ) { // This way you can set which events you want to use case 'post_published': case 'post_unpublished': case 'post_updated': case 'post_deleted': case 'post_trashed': // Get category names $categories = wp_get_post_categories( $event_args[ 'post_id' ], array( 'fields' => 'names' ) ); // Replace 'CategoryName' with the category you're looking for if ( in_array( 'CategoryName', $categories ) ) { // Change the channel in the payload // Make sure you prefix the channel name with # $notification[ 'payload' ][ 'channel' ] = '#newchannel'; } break; } // Return the notification return $notification; }