PHPackages                             digitoimistodude/air-notifications - 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. [Mail & Notifications](/categories/mail)
4. /
5. digitoimistodude/air-notifications

ActiveWordpress-plugin[Mail & Notifications](/categories/mail)

digitoimistodude/air-notifications
==================================

Easy way to create and manage public notifications at the site.

1.0.7(9mo ago)460[1 issues](https://github.com/digitoimistodude/air-notifications/issues)GPL-3.0+PHP

Since Aug 19Pushed 6mo ago2 watchersCompare

[ Source](https://github.com/digitoimistodude/air-notifications)[ Packagist](https://packagist.org/packages/digitoimistodude/air-notifications)[ Docs](https://https://github.com/digitoimistodude/air-notifications)[ RSS](/packages/digitoimistodude-air-notifications/feed)WikiDiscussions master Synced yesterday

READMEChangelog (8)DependenciesVersions (9)Used By (0)

Air notifications
=================

[](#air-notifications)

You need Advanced Custom Fields PRO plugin installed to use this plugin.

Creates a custom post type for notifications and adds following ACF fields for it:

- Start time
- End time
- Content of the notification
- Allow closing ( used to check if closing button needs to be added )
- Location ( to have different locations for the notifications on the same page )
- Show on page ( specifying certain pages to show the notification on. Notification will be shown on all pages if nothing is selected )

Registering a notification locations
------------------------------------

[](#registering-a-notification-locations)

By default Air notifications has one default notification locations set. You might want to change its name, since most likely wont match your use case( using Finnish and location at top of the page ). You can also add more locations if you need them.

Adding/modifying notification locations is done using filter `air_notifications_locations`.

```
  add_filter( 'air_notifications_locations', function( $locations ) {
    $locations['your-location'] = 'Your location';

    return $locations;
  } );
```

Adding notifications to templates
---------------------------------

[](#adding-notifications-to-templates)

In order to show notifications on your page, you need to call them in your template. This is done by adding the following action to your template. The action takes notification location as a parameter.

```
  do_action( 'air_notifications_show_notifications', 'your-location' );
```

Disabling default notification css
----------------------------------

[](#disabling-default-notification-css)

If you want to use the default notification template, but dont want to load its css, you can disable it.

```
  add_filter( 'air_notifications_disable_css', '__return_true' );
```

### Custom notification templates

[](#custom-notification-templates)

Default notification template can be replaced by your own custom one. You will need to name it like `notification-template-your-location.php`. So if you are replacing the default location you will need to create file `notification-template-default.php`. These templates need to be saved in `yourtheme/templates`.

In these templates you have access to the notification data by `$notification` variable.

If you want to add the ability to dismiss the notification you will need to make sure you do 3 things.

- Make sure your main wrapper by default has `display: none`, this to prevent the notification from appearing and then disappearing if it had already been closed before.
- Add class `air-notification` to your main wrapper
- Add data attribute `data-notification-id` to your main wrapper and your button. Value for this should be unique since it will be saved in the users localstorage, when closing a notification. `$notification['guid']` is created just for this use.

Also note that the notifications have an option `is_dismissable`, this can be used to check if your notification needs the button at all.

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance57

Moderate activity, may be stable

Popularity13

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 81.1% 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.

###  Release Activity

Cadence

Every ~155 days

Recently: every ~222 days

Total

8

Last Release

278d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ac8f1091787825c059e30ad39ca1f58453f45c5ae0c585ba3be00904d045b8b2?d=identicon)[ronilaukkarinen](/maintainers/ronilaukkarinen)

---

Top Contributors

[![EliasKau](https://avatars.githubusercontent.com/u/1349003?v=4)](https://github.com/EliasKau "EliasKau (30 commits)")[![ronilaukkarinen](https://avatars.githubusercontent.com/u/1534150?v=4)](https://github.com/ronilaukkarinen "ronilaukkarinen (3 commits)")[![Tumppex](https://avatars.githubusercontent.com/u/77620588?v=4)](https://github.com/Tumppex "Tumppex (3 commits)")[![timiwahalahti](https://avatars.githubusercontent.com/u/415544?v=4)](https://github.com/timiwahalahti "timiwahalahti (1 commits)")

---

Tags

wordpresswordpress-pluginpluginwordpress

### Embed Badge

![Health badge](/badges/digitoimistodude-air-notifications/health.svg)

```
[![Health](https://phpackages.com/badges/digitoimistodude-air-notifications/health.svg)](https://phpackages.com/packages/digitoimistodude-air-notifications)
```

###  Alternatives

[etailors/mautic-amazon-ses

Amazon SES Mailer Plugin for Mautic

522.0k](/packages/etailors-mautic-amazon-ses)

PHPackages © 2026

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