PHPackages                             askupa-software/amarkal-admin-notification - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Admin Panels](/categories/admin)
4. /
5. askupa-software/amarkal-admin-notification

ActiveWordpress[Admin Panels](/categories/admin)

askupa-software/amarkal-admin-notification
==========================================

Add static/dismissible admin notifications to WordPress

16604[1 issues](https://github.com/amarkal/amarkal-admin-notification/issues)PHP

Since Dec 24Pushed 8y ago1 watchersCompare

[ Source](https://github.com/amarkal/amarkal-admin-notification)[ Packagist](https://packagist.org/packages/askupa-software/amarkal-admin-notification)[ RSS](/packages/askupa-software-amarkal-admin-notification/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

amarkal-admin-notification [![Build Status](https://camo.githubusercontent.com/cc4c2d6a0f61cf1386075dd16212d1d465c3a2ad52a81b2c239c0456464952eb/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f616d61726b616c2f616d61726b616c2d61646d696e2d6e6f74696669636174696f6e2f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/amarkal/amarkal-admin-notification/build-status/master) [![Scrutinizer Code Quality](https://camo.githubusercontent.com/d1555f183c3c57dc25c4710c6e248a468a7734d4da85310b5eba5ee9eb920f50/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f616d61726b616c2f616d61726b616c2d61646d696e2d6e6f74696669636174696f6e2f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/amarkal/amarkal-admin-notification/?branch=master) [![License](https://camo.githubusercontent.com/d188773d1e42345ca962ea6fc380b95718673e52fe59160bc38e5889034e3289/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d47504c2d2d332e302532422d7265642e737667)](https://raw.githubusercontent.com/amarkal/amarkal-admin-notification/master/LICENSE)
=======================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#amarkal-admin-notification---)

**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](https://blog.askupasoftware.com/adding-staticdismissible-admin-notifications-wordpress/)

[![amarkal-admin-notification - ](https://camo.githubusercontent.com/5c1353facc16927beb0d8bb3bdb9f2feaf2b5ef2812a1a4548680a28e2e74325/68747470733a2f2f61736b757061736f6674776172652e636f6d2f77702d636f6e74656e742f75706c6f6164732f323031342f30312f77702d61646d696e2d6e6f74696669636174696f6e732e676966)](https://camo.githubusercontent.com/5c1353facc16927beb0d8bb3bdb9f2feaf2b5ef2812a1a4548680a28e2e74325/68747470733a2f2f61736b757061736f6674776172652e636f6d2f77702d636f6e74656e742f75706c6f6164732f323031342f30312f77702d61646d696e2d6e6f74696669636174696f6e732e676966)

Overview
--------

[](#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](https://make.wordpress.org/core/2015/04/23/spinners-and-dismissible-admin-notices-in-4-2/). 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
------------

[](#installation)

### Via Composer

[](#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

[](#manually)

[Download the package](https://github.com/amarkal/amarkal-admin-notification/archive/master.zip) from github and include `bootstrap.php` in your project:

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

Usage
-----

[](#usage)

### amarkal\_admin\_notification

[](#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](https://codex.wordpress.org/Plugin_API/Action_Reference/network_admin_notices) hook internally.

### amarkal\_reset\_admin\_notification

[](#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.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 87.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/968f78380ddac9ca295244f1cd8d53e3abfe572a0a7351e9bc1b7fc2f85e6bfe?d=identicon)[askupasoftware](/maintainers/askupasoftware)

---

Top Contributors

[![ykadosh](https://avatars.githubusercontent.com/u/7763083?v=4)](https://github.com/ykadosh "ykadosh (29 commits)")[![IvanRF](https://avatars.githubusercontent.com/u/6751650?v=4)](https://github.com/IvanRF "IvanRF (4 commits)")

---

Tags

amarkalwordpresswordpress-framework

### Embed Badge

![Health badge](/badges/askupa-software-amarkal-admin-notification/health.svg)

```
[![Health](https://phpackages.com/badges/askupa-software-amarkal-admin-notification/health.svg)](https://phpackages.com/packages/askupa-software-amarkal-admin-notification)
```

###  Alternatives

[jeroennoten/laravel-adminlte

Easy AdminLTE integration with Laravel

4.0k4.8M43](/packages/jeroennoten-laravel-adminlte)[dmstr/yii2-adminlte-asset

AdminLTE backend theme asset bundle for Yii 2.0 Framework

1.1k1.8M67](/packages/dmstr-yii2-adminlte-asset)[dwij/laraadmin

LaraAdmin is a Open source Laravel Admin Panel / CMS which can be used as Admin Backend, Data Management Tool or CRM boilerplate for Laravel with features like CRUD Generation, Module Manager, Media, Menus, Backups and much more

1.6k68.7k](/packages/dwij-laraadmin)[filament/spatie-laravel-media-library-plugin

Filament support for `spatie/laravel-medialibrary`.

1764.8M125](/packages/filament-spatie-laravel-media-library-plugin)[bezhansalleh/filament-exceptions

A Simple &amp; Beautiful Pluggable Exception Viewer for FilamentPHP's Admin Panel

193195.9k13](/packages/bezhansalleh-filament-exceptions)[filament/infolists

Easily add beautiful read-only infolists to any Livewire component.

1220.8M36](/packages/filament-infolists)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
