Skip to content
Add static/dismissible admin notifications to WordPress
PHP
Branch: master
Clone or download

Latest commit

Latest commit c8869f1 Dec 24, 2017

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE Initial commit Jul 19, 2016
Notifications.php Fixes #9 Mar 26, 2017
README.md Updated repo URL Dec 24, 2017
bootstrap.php Improved code quality Mar 27, 2017
composer.json Updated repo URL Dec 24, 2017
composer.php Improved manual bootstrapping process Mar 26, 2017
functions.php Updated repo URL Dec 24, 2017

README.md

amarkal-admin-notification Build Status Scrutinizer Code Quality License

amarkal-admin-notification lets you add static/dismissible notifications to the WordPress administration. Dismissible notifications are permanently dismissed and will not show when the page reloads. For an in-depth tutorial, see Adding Static/Dismissible Admin Notifications to WordPress

amarkal-admin-notification -

Overview

amarkal-admin-notification lets you easily add notifications to the WordPress administration with different options to choose from. In WordPress 4.2 dismissible notifications became supported. However, a dismissed notification becomes visible again when the user refreshes the page or navigates away. amarkal-admin-notification handles that by storing an option in the database once a notification is dismissed.
amarkal-admin-notification is lightweight and trace free - it will only initiate if there is at least one registered notification, and will only store a database option if a user dismisses a notification. amarkal_reset_admin_notification() will remove the option from the database if there are no more dismissed notifications.

Installation

Via Composer

If you are using the command line:

$ composer require askupa-software/amarkal-admin-notification:dev-master

Or simply add the following to your composer.json file:

"require": {
    "askupa-software/amarkal-admin-notification": "dev-master"
}

And run the command

$ composer install

This will install the package in the directory vendors/askupa-software/amarkal-admin-notification. Now all you need to do is include the composer autoloader.

require_once 'path/to/vendor/autoload.php';

Manually

Download the package from github and include bootstrap.php in your project:

require_once 'path/to/amarkal-admin-notification/bootstrap.php';

Usage

amarkal_admin_notification

Register a notification to be printed in the administration.

amarkal_admin_notification( $handle, $html, $type = 'success', $dismissible = false, $class = '', $network = false )

This function is used to register a notification for a given handle. The handle is used as the notification's ID. If the notification is dismissible, the handle is used to permanently dismiss the notification. When a dismissible notification is dismissed, the amarkal_dismissed_notices option is updated with the handle added to it.

Parameters

  • $handle (String) The notification's ID. Also used to permanently dismiss a dismissible notification. If a given handle has previously been registered, a PHP notice will be triggered.
  • $html (String) The text/HTML content of the notification.
  • $type (String) The notification's type. One of error, warning, info, success.
  • $dismissible (Boolean) Whether to add a "dismiss" button to allow the user to permanently dismiss the notification.
  • $class (String) An additional CSS class to be added to the notification for styling purposes.
  • $network (Boolean) Whether to show this notification in the network administration as well. Uses the network_admin_notices hook internally.

amarkal_reset_admin_notification

Reset a dismissible notification.

amarkal_reset_admin_notification( $handle )

This function can be used to make a previously dismissed notification visible again. It does that by removing the given $handle from the list of dismissed notifications stored in the option amarkal_dismissed_notices. If the list of dismissed notification is empty, the option will be removed from the database.

Parameters

  • $handle (String) The handle of the notification to be reset.
You can’t perform that action at this time.