Download the PHP package yahnis-elsts/admin-notices without Composer
On this page you can find all versions of the php package yahnis-elsts/admin-notices. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Short Description A utility library for WordPress plugins that makes it easier to create admin notices. Supports persistently dismissible notices.
All versions of admin-notices with dependencies
Informations about the package admin-notices
Easy Admin Notices
A PHP utility library for WordPress plugins that helps create admin notices.
- Fluent interface.
- Persistently dismissible notices with optional dismissal duration.
- Show notices on specific pages.
- Show notices to users who have a specific capability.
- PHP 5.3 or later.
- WordPress 4.2 or later.
Install with Composer:
Alternatively, you can install it manually:
- Download the latest release.
- Move the
admin-noticesdirectory to your plugin.
- Load the library:
A note on load order: To ensure that persistently dismissible notices will work correctly, you should
require the library before the
admin_init action. For example, you can put the
require in a
plugins_loaded hook, or simply at the top of your plugin.
You don't have to put this code in a hook. The
show() method is smart. It checks if the
admin_notices action was already executed and either displays the notice immediately or adds a new
admin_notices hook that will display the notice when appropriate. It also checks any capability requirements and page filters before actually showing the notice (see Preconditions).
WordPress comes with several built-in CSS classes for different types of admin notices. You can use the following shortcut methods to simultaneously set the notice type and the contents of the notice.
Instead of passing a string to one of the type-specific methods, you can set the contents of the notice by calling one of the following methods.
Set the contents of the notice to a text string.
text() will escape
HTML special characters like
& and so on.
Set the contents of the notice to a HTML string. Unlike
text(), this method does not perform any escaping or encoding.
Usually, the contents of a notice are wrapped in a single paragraph (
<p>) tag. To prevent this wrapping, use
rawHtml() to set the notice content. This is useful if you want to use complex HTML or to display a long message where one paragraph is not enough.
Add an "(x)" icon to the notice. Clicking the icon will hide the notice. However, this doesn't prevent the notice from reappearing in the future. Use
persistentlyDismissible() for that.
Make the notice persistently dismissible. When the user dismisses the notice, the library stores a flag in the database that prevents the notice from showing up again. Persistently dismissible notices must have a unique ID.
$scope parameter controls whether clicking "(x)" will hide the notice for everyone or just for the current user. The supported values are:
AdminNotice::DISMISS_PER_SITE- hide the notice site-wide. This is the default.
AdminNotice::DISMISS_PER_USER- hide the notice only for the current user.
$duration parameter controls how long (in seconds) the notice will be considered dismissed for. By default, notices will be dismissed permanently.
- You must load
admin_initaction to make sure that the default AJAX handlers get set up correctly.
- It's safe to call
show()on a dismissed notice. It won't display the notice, and it won't throw an error either.
Persistently dismiss the notice. Only works on notices that have been flagged as
$duration parameter controls how long (in seconds) the notice will be considered dismissed for. By default, the duration is the same as the duration passed to
persistentlyDismissible(). You can also pass
AdminNotice::DISMISS_PERMANENTLY to dismiss the notice permanently.
Restore a previously dismissed notice.
isDismissed() : boolean
Check if the notice has been dismissed.
Delete all "this notice is dismissed" flags that have the specified ID prefix from the database. If you're using persistently dismissible notices, it's a good idea to call this function when your plugin is uninstalled.
For example, if your notice IDs start with
myplugin-, you can remove the database entries like this:
These methods control where notices will appear and who will be able to see them.
Show the notice only on the specified admin page(s).
$screenId can be either the screen ID of a page (i.e. a string), or an array of screen IDs.
See Admin Screen Reference for a list of screens and their IDs. In the case of plugin and theme admin pages, the screen ID is usually the same as the value returned by the
Show the notice only to users who have the specified
Show now or later
After creating a notice, call one of these methods to display it.
Automagically show the notice on the current page when all preconditions are met.
Show the notice on the next admin page that's visited by the current user. The notice will be shown only once.
This method is useful for plugin activation hooks, redirects, and other situations where you can't display a notice immediately for whatever reason. The library will store the notice in the database. It will display the notice the next time that the
admin_notices action is called in the context of the current user, whether happens during this page load or the next one, or a week later.
Immediately display the notice. This method bypasses any checks and preconditions and just outputs the notice directly. It's mainly intended for debugging.