PHPackages                             jazzsequence/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. jazzsequence/notifications

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

jazzsequence/notifications
==========================

A WordPress plugin to display a notification above your site that uses custom post types.

1.1.5(1y ago)231GPL-3.0-or-laterPHP

Since Jan 12Pushed 1y ago2 watchersCompare

[ Source](https://github.com/jazzsequence/notifications)[ Packagist](https://packagist.org/packages/jazzsequence/notifications)[ RSS](/packages/jazzsequence-notifications/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)DependenciesVersions (3)Used By (0)

Notifications
=============

[](#notifications)

Easy, customizable notifications for your WordPress site

Description
-----------

[](#description)

How many times have you needed to display a notice across your site? Too many, if you ask me. I wrote this plugin because many of the notification bar plugins out there leave much to be desired. Either there are too many options or not enough or not the ones that I want. Plus, it's not easy to create a notice -- you have to go to some crazy screen and set options unique to that plugin.

This plugin uses custom post types, so notifications are set up like mini-posts that we all know and love. Multiple controls, as well as a built-in filter, enable developers and casual users alike to easily customize the notification bar to your heart's content.

**Update:** This plugin now supports the [Theme Hook Alliance](https://github.com/zamoose/themehookalliance) `tha_body_top` action. If you are using the `body_open` action in your child theme, please change this to `tha_body_top`, e.g.

`do_action( 'tha_body_top' );`

Usage
-----

[](#usage)

Notifications looks for the `body_open` hook. This hook was first [proposed on Trac](http://core.trac.wordpress.org/ticket/12563#comment:10) by [Andrew Nacin](https://twitter.com/nacin) as a way to hook into an action that fires immediately after the `` tag in the code.

Want to filter the output to customize how the notification gets displayed? Use the `notf_notification_filter` filter in your plugin or theme, like this:

```
     function my_test_filter( $output ) {
     	$output = ''.notf_message().'';
     	return $output;
     }
     add_filter( 'notf_notification_filter', 'my_test_filter' );
```

**Important:** Use the `notf_message` function in your filter to return the actual notification.

Installation
------------

[](#installation)

### Via Composer

[](#via-composer)

Notifications can be installed on Composer-based WordPress sites by using the following command:

`composer require jazzsequence/notifications`

### Via Git Updater

[](#via-git-updater)

Notifications supports Andy Fragen's Git Updater method of managing plugins.

1. Download and install Git Updater on your WordPress site.
2. From the Git Updater admin pages, navigate to Install Plugin and use the following values:

**Plugin URI:** `jazzsequence/notifications`
**Repository Branch:** `main`
**Remote Repository Host:** GitHub
**GitHub Access Token:** (optional, leave blank)

### Via WordPress Plugin Repository

[](#via-wordpress-plugin-repository)

The plugin can be installed via the WordPress plugin repository, however, the version in the repository may not be the most current version. Use the standard methods of searching for and installing the plugin from the Plugins page in your WordPress dashboard.

Changelog
---------

[](#changelog)

### 1.1.5

[](#115)

- Installable with Git Updater and update installation notes.

### 1.1.4

[](#114)

- Installable with `composer install jazzsequence/notifications`

### 1.1.3

[](#113)

- Checks for messages before trying to output them (thanks [Daron Spence](http://github.com/Daronspence)!)

### 1.1.2

[](#112)

- Updates support for [Theme Hook Alliance](https://github.com/zamoose/themehookalliance) action hook instead of arbitrary, theme-specific hooks.

### 1.1.1

[](#111)

- fixes validation \_doing\_it\_wrong()

### 1.1

[](#11)

- added sticky option, to stick the notification to the top of the page, rather than scrolling with the page.

### 1.0.1

[](#101)

- removes menu order (can conflict with other post types with same menu order)

### 1.0

[](#10)

- first public release

Upgrade Notice
--------------

[](#upgrade-notice)

### 1.1.2

[](#112-1)

**Please update your themes to support the new `tha_body_top` action!**

``

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance42

Moderate activity, may be stable

Popularity7

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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 ~10 days

Total

2

Last Release

481d ago

### Community

Maintainers

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

---

Top Contributors

[![jazzsequence](https://avatars.githubusercontent.com/u/991511?v=4)](https://github.com/jazzsequence "jazzsequence (29 commits)")

### Embed Badge

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

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

###  Alternatives

[minishlink/web-push

Web Push library for PHP

1.9k12.0M53](/packages/minishlink-web-push)[laravel-notification-channels/twilio

Provides Twilio notification channel for Laravel

2587.7M12](/packages/laravel-notification-channels-twilio)[spatie/url-signer

Generate a url with an expiration date and signature to prevent unauthorized access

4422.3M16](/packages/spatie-url-signer)[mattketmo/email-checker

Throwaway email detection library

2742.0M5](/packages/mattketmo-email-checker)[laravel-notification-channels/discord

Laravel notification driver for Discord.

2371.3M11](/packages/laravel-notification-channels-discord)[eduardokum/laravel-mail-auto-embed

Library for embed images in emails automatically

1702.0M5](/packages/eduardokum-laravel-mail-auto-embed)

PHPackages © 2026

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