Tony Hayes

AdminSanity brings sanity through sanitization to your WordPress Admin Area. Cleanly.
AdminSanity started as a Gist to address the WordPress Admin Menu clutter, automatically splitting and re-ordered menu to clean up the mess that appears as more and more plugins are added to a WordPress site. This idea was inspired by <a href="https://core.trac.wordpress.org/ticket/47012" rel="nofollow ugc">this TRAC proposal for a “Simplified WordPress Admin Navigation”</a>, as a proof of concept for a potential core Feature plugin.
Now, it includes modules not just for cleaning up and improving accesss to both the Admin Menu and Admin Bar, but also includes a module for turning Admin Notice clutter at the top of your admin screen into an tabbed notice type display interface! This means a sigh of relief guaranteed, or your money back! (Actually nevermind – it’s free – just like your Admin Area soon will be free of clutter!)
Oh and plus did I mention it supports responsive width changes and admin colour schemes?! 😀
<h4>AdminSanity Menu</h4>
The AdminSanity Menu module automatically sorts the Admin Menu into three sections:
<ul>
<li>Content – Dashboard, all Post Types | Media, Links and Comments</li>
<li>Manage – Settings, [Plugin Settings], Appearance, Plugins, Users, Tools</li>
<li>Extensions – any other extra top level menu items not present by default</li>
</ul>
And, to add an extra layer of navigation accessibility, a meta-menu level has been added to each of the Admin Menu sections, with the corresponding labels: Content, Manage and Extensions. So that rather than trying to replace the existing Admin Menu design (which would be hard to make backwards compatible), it is just adapted to provide improved menu access.
Additionally, a new “Plugin Settings” menu item has been added, with any Settings submenu items moved there that are not there by default (ie. from WordPress itself.) This greatly improves the ease of navigation in your admin area when searching for either Core or Plugin settings.
Then, for even faster ease of access, an “Expand menu” icon has been added at the top of the Admin Menu (to complement the existing “Collapse menu” icon at the bottom) which expands to provide a full page three column display of the entire Admin Menu with all submenus expanded so you can instantly see every menu at once. Wow!
<h4>AdminSanity Notices</h4>
The AdminSanity Notice module attempts to solve probably the most long-standing thorn in any WordPress user’s side – the distracting amount of NOTICES at the top of every single Admin page! By providing a tabbed interface for notice types (Error, Update, Warnings, Messages, Notices), you get a colour-coded and at-a-glance display of how many notices of each type there are, so you can prioritize and stay on task.
Clicking on any of the notice types instantly displays all the notices for that type. Nice! And as an added bonus, if you want to access Notices by their user notice level, you can do that too. Clicking on the Notices label reveals an extra tab menu that is sorted by notice type instead: All, General, Network, Admin and User. Neat!
<h4>AdminSanity Bar</h4>
After experiencing the Admin Bar getting cluttered also and splitting itself into two lines (and thus making some of the bar items unclickable!) I decided to add some responsive height handling to fix the bar display when this happened. And also, add a new “Shuffle” Cycler icon to the start of the Admin Bar, which cycles the visibility of the different Admin Bar items. Each click of the icon will cycle through three display options, giving you faster access to what you were looking for:
<ul>
<li>All Bar menu items (Default Admin Bar view)</li>
<li>Default Bar menu items (added by WordPress)</li>
<li>Non-default Bar menu items (from plugins and themes)</li>
</ul>
And again, similar to the Admin Menu, for faster ease of access to all Admin Bar items at once, a “Dropdown” toggle item is added at the end of the Admin Bar, providing an expanded view of all bar menu items and their submenus (including nested submenus which are accessible via dropdown arrows for those submenu items.) Nifty!
<h4>Come Get Some Admin Sanity!</h4>
Isn’t it time for AdminSanity to bring some sanity back to your Admin Area?!

AdminSanity

AdminSanity brings sanity through sanitization to your WordPress Admin Area. Cleanly.

Spider Themes

Muaz BK

Al Imran

NoticePilot is not another admin notice plugin. It is a self-hosted remote campaign distribution platform built specifically for WordPress plugin and theme authors.
If you maintain a WordPress plugin or theme that runs on hundreds or thousands of sites, you need a reliable way to push announcements, update prompts, sale banners, or deprecation warnings to your users — without shipping a new plugin release for every message. NoticePilot solves this with a hub-to-remote architecture: you manage campaigns centrally on your own site, and a lightweight PHP SDK bundled in your plugin automatically fetches and displays them on every remote installation.
<h4>Who Is This For?</h4>
NoticePilot is purpose-built for WordPress plugin and theme developers who need to communicate with their users across multiple remote installations from a single, self-hosted dashboard. It is not a tool for managing or suppressing admin notices on a single site — there are many plugins already serving that purpose.
<h4>What Makes It Different?</h4>
Unlike most admin-notice plugins, NoticePilot is a complete developer communication platform:
<ul>
<li>Hub-to-Remote Architecture — One central dashboard pushes campaigns to unlimited remote WordPress sites via a REST API. No third-party SaaS, no external dependencies — everything runs on your own WordPress installation.</li>
<li>Single-File PHP SDK — Bundle one PHP file into your plugin or theme. Initialize with a single line of code. The SDK handles fetching, caching, rendering, and dismissal automatically.</li>
<li>Privacy-First Analytics — Track impressions, clicks, and dismissals across all remote sites without collecting personal data. Remote site URLs are MD5-hashed before storage — no IP addresses, usernames, or cookies are ever saved.</li>
<li>Audience Targeting — Deliver the right message to the right users by targeting campaigns based on plan type (free or pro), plugin version (with comparison operators like <code><</code>, <code>></code>, <code>=</code>), and WordPress user roles.</li>
<li>Campaign Scheduling — Set start and end dates for time-sensitive campaigns. Expired campaigns are auto-disabled via WP-Cron — no manual clean-up required.</li>
<li>Rich HTML Support — Write full HTML including inline CSS, <code><style></code> blocks, and custom layouts. Your content renders exactly as authored on every remote site.</li>
<li>Smart Dismissal Handling — Users who dismiss a notice won’t see it again for a configurable duration. Dismissals are stored locally on the remote site using a FIFO strategy, keeping only the 20 most recent dismissed IDs.</li>
<li>Scalable Analytics Engine — Raw events roll up into daily summaries via an hourly WP-Cron job with automatic pruning. Built for scale — no unbounded table growth.</li>
</ul>
<h4>How It Works</h4>
<ol>
<li>Create a Product — Each product represents a plugin, theme, or service you maintain. NoticePilot generates a unique REST API endpoint for it automatically.</li>
<li>Add Campaigns — Write rich HTML content, set optional scheduling and audience-targeting rules, then enable the campaign.</li>
<li>Integrate the SDK — Download the single-file PHP SDK from your product card, bundle it with your plugin or theme, and initialize it with one line of code. The SDK polls your hub on a configurable schedule and renders active campaigns as WordPress admin notices on remote sites.</li>
<li>Track Performance — Monitor impressions, clicks, dismissals, and click-through rates from the analytics dashboard. Drill down by product or by individual campaign with daily breakdowns.</li>
</ol>
<h4>Real-World Use Cases</h4>
<ul>
<li>Plugin authors: Push update prompts, deprecation warnings, or feature announcements to all users of your plugin — without shipping a new release.</li>
<li>Theme authors: Announce seasonal sales, new theme versions, or compatibility updates directly inside the WordPress admin on every active installation.</li>
<li>Agency developers: Broadcast maintenance windows, policy changes, or onboarding tips across all client sites from a single central hub.</li>
<li>Freemium plugins: Show upgrade prompts exclusively to free-plan users while displaying different messaging to pro users — all without code changes on the remote site.</li>
</ul>
<h4>A Self-Hosted Alternative</h4>
Plugin authors today face a difficult choice: build a custom notice system from scratch for every product (duplicating effort), or rely on third-party SaaS platforms (adding external dependencies and data-privacy concerns). NoticePilot offers a self-hosted, privacy-respecting, zero-external-dependency alternative that runs entirely on your own WordPress installation — giving you full control over your data and your users’ experience.
<h3>SDK Integration Guide</h3>
This section explains the complete end-to-end workflow for wiring the NoticePilot SDK into your own plugin or theme. Follow these steps in order — they cover everything from creating your first product on the hub through to verifying notices appear on remote sites.
<h4>Step 1 — Set Up the Hub</h4>
Install and activate the NoticePilot plugin on your central management site (not on the sites of your customers). This is the one WordPress installation that will act as your private campaign server.
Once activated, navigate to NoticePilot in the WordPress admin sidebar. This is where all products and campaigns live.
<h4>Step 2 — Create a Product</h4>
A “Product” is the bridge between the hub and one of your plugins or themes.
<ol>
<li>Click + Add New Product.</li>
<li>Enter the name of your plugin or theme (e.g. <code>Super SEO Form</code>). NoticePilot automatically generates a URL-safe slug (e.g. <code>super-seo-form</code>). This slug is the identifier your SDK will use when polling for campaigns.</li>
<li>Toggle Enable this site to ON.</li>
<li>Click Save Site.</li>
</ol>
Each product gets its own REST API endpoint in the form:
<pre><code>https://your-hub-site.com/wp-json/noticepilot/v1/content/your-product-slug
</code></pre>
<h4>Step 3 — Add a Campaign</h4>
With your product created, you can add one or more campaigns (notices) to it.
<ol>
<li>Click + Add Content on your product card.</li>
<li>Fill in the fields:
<ul>
<li>Content Title — Internal reference only (e.g. <code>Black Friday Sale 2025</code>).</li>
<li>HTML Content — The full HTML notice rendered on remote sites. Supports inline styles, <code><style></code> blocks, and any custom layout.</li>
<li>Enable this offer — Toggle ON to make the campaign live immediately.</li>
<li>Start / End Date (Optional) — Schedule the campaign for a specific window. Expired campaigns are auto-disabled by WP-Cron.</li>
</ul>
</li>
<li>Click Save Content.</li>
</ol>
You can attach multiple campaigns to a single product. All active and in-schedule campaigns are returned together when the SDK polls the endpoint.
<h4>Step 4 — Download the SDK</h4>
<ol>
<li>On your product card, click the How To Integrate button.</li>
<li>Click Download SDK to download <code>class-remote-notice-client.php</code>.</li>
</ol>
Alternatively, copy the file directly from the <code>sdk/</code> directory of the NoticePilot plugin.
<h4>Step 5 — Bundle the SDK Into Your Plugin or Theme</h4>
Copy <code>class-remote-notice-client.php</code> into your plugin or theme directory. A recommended location is an <code>includes/</code> subdirectory:
<pre><code>your-plugin/
├── your-plugin.php
└── includes/
 └── class-remote-notice-client.php
</code></pre>
The SDK is fully self-contained — no Composer, no external libraries, no additional files required.
<h4>Step 6 — Initialize the SDK</h4>
Add the following code to your plugin’s main PHP file (or to your theme’s <code>functions.php</code>). Replace the placeholder values with your own product slug and hub URL:
<pre><code>// Load the NoticePilot remote notice SDK.
require_once __DIR__ . '/includes/class-remote-notice-client.php';

add_action( 'plugins_loaded', function() {
 Noticepilot_Remote_Notice_Client::init( 'your-product-slug', [
 'api_url' => 'https://your-hub-site.com/wp-json/noticepilot/v1/content/your-product-slug',
 'schedule' => 'daily',
 'capability' => 'manage_options',
 'dismiss_duration' => WEEK_IN_SECONDS,
 ] );
} );
</code></pre>
Copy the exact URL from your product card’s “How To Integrate” panel to avoid typos — the slug in <code>api_url</code> must match the product slug precisely.
<h4>SDK Configuration Options</h4>
<ul>
<li><code>api_url</code> (required) — The full REST URL to your product’s content endpoint on the hub. Find it in the How To Integrate panel on the product card.</li>
<li><code>schedule</code> (optional) — How often the remote site polls the hub for new campaigns. Accepted values: <code>hourly</code>, <code>twicedaily</code>, or <code>daily</code>. Default: <code>daily</code>. Use <code>hourly</code> for time-sensitive campaigns; use <code>daily</code> to reduce server load.</li>
<li><code>capability</code> (optional) — The WordPress capability a user must have to see notices. Default: <code>manage_options</code> (administrators only). Change to <code>edit_posts</code> to show notices to editors as well.</li>
<li><code>dismiss_duration</code> (optional) — How long (in seconds) a dismissed notice stays hidden before it can reappear. Default: <code>WEEK_IN_SECONDS</code>. Pass <code>0</code> to make dismissals permanent for that campaign ID.</li>
</ul>
<h4>Step 7 — (Optional) Pass Targeting Context</h4>
If you use the audience-targeting feature (plan type, plugin version, or user roles), pass a <code>$context</code> array as the third argument to <code>init()</code>:
<pre><code>Noticepilot_Remote_Notice_Client::init( 'your-product-slug', [
 'api_url' => 'https://your-hub-site.com/wp-json/noticepilot/v1/content/your-product-slug',
 'schedule' => 'daily',
], [
 'plan' => 'free', // 'free' or 'pro' — matches Plan Type targeting on the hub.
 'version' => '2.3.1', // Your plugin's current version string — matches Version targeting.
 'roles' => wp_get_current_user()->roles, // Current user's roles array.
] );
</code></pre>
The SDK sends this context to the hub, which filters campaigns before returning them. Campaigns with no targeting rules set are always returned regardless of context.
<h4>Step 8 — Verify the Integration</h4>
<ol>
<li>
Trigger the first fetch manually: After adding the initialization code, log in to a remote WordPress admin that has your plugin active. The SDK registers a WP-Cron event on first load (<code>plugins_loaded</code>). To force an immediate fetch without waiting for the cron, use WP-CLI on the remote site:
wp cron event run noticepilot_rnc_fetch_content_your-product-slug
</li>
<li>
Check the stored contents option: In the remote site’s database, look for the option <code>noticepilot_rnc_your-product-slug_contents</code>. It should contain the JSON-encoded campaign data returned by the hub.
</li>
<li>
View the notice in the admin: Navigate to any admin page on the remote site. Active campaigns appear as standard WordPress admin notices at the top of the page. Each notice has a dismiss (✕) button.
</li>
<li>
Check the analytics: Go back to your hub site → NoticePilot → Analytics. After a page load on the remote site triggers a beacon, you should see an impression logged against your campaign within the hour (after the next rollup cron runs), or immediately after clicking ↻ Refresh Data on the Analytics page.
</li>
</ol>
<h4>How the SDK Works at Runtime</h4>
Understanding what the SDK does automatically helps you diagnose issues:
<ol>
<li>Cron registration — On <code>plugins_loaded</code>, the SDK schedules a repeating WP-Cron event (e.g. <code>noticepilot_rnc_fetch_content_your-product-slug</code>) on the remote site if one is not already registered.</li>
<li>Remote fetch — When the cron fires, the SDK sends a <code>GET</code> request to the <code>api_url</code> endpoint on your hub. The hub checks each campaign’s <code>enabled</code> flag and schedule, then returns the active ones as JSON.</li>
<li>Local caching — The fetched campaigns are stored in the remote site’s <code>wp_options</code> table (key: <code>noticepilot_rnc_your-product-slug_contents</code>). Notices are rendered from this local cache on every page load — no live HTTP request is made on each admin page.</li>
<li>Rendering — On <code>admin_notices</code>, the SDK outputs each cached campaign as a standard <code>.notice</code> div. Campaign HTML is filtered through <code>wp_kses()</code> before output to prevent script injection.</li>
<li>Analytics beacons — Immediately on render, and on link click or dismiss, the SDK fires a <code>navigator.sendBeacon()</code> call to the hub’s analytics tracking endpoint. This is fire-and-forget and does not block the page.</li>
<li>Dismissal — When a user clicks the ✕ button, an AJAX call stores the campaign ID in <code>noticepilot_rnc_your-product-slug_dismissed_ids</code>. Only the 20 most recent IDs are kept. After <code>dismiss_duration</code> seconds, the campaign can reappear.</li>
<li>Cron cleanup — On plugin deactivation (your plugin), the SDK’s cron event is automatically unscheduled.</li>
</ol>
<h4>Developer Notes</h4>
<ul>
<li>Namespace safety — The SDK class is named <code>Noticepilot_Remote_Notice_Client</code>. It checks <code>class_exists()</code> before declaring itself, so it is safe to bundle in multiple plugins on the same site without conflicts.</li>
<li>No singleton collision — Each <code>init()</code> call is keyed by its product slug. Multiple plugins on the same remote site can each run their own SDK instance independently.</li>
<li>Hub availability — The SDK caches results locally, so if your hub server is temporarily unreachable during a cron run, the last successfully fetched campaigns continue to display until the next successful poll.</li>
<li>Detecting the hub — In your plugin’s own code, you can detect whether the hub is installed on the current site with <code>class_exists( '\NoticePilot\Core' )</code>. This is useful for offering hub-specific admin links in a bundled UI.</li>
<li>Forcing a re-fetch — To trigger the fetch action programmatically (e.g. after a plugin update), use: <code>do_action( 'noticepilot_rnc_fetch_content_your-product-slug' );</code></li>
</ul>

NoticePilot – Remote Campaign Hub for WordPress Plugin & Theme Authors

Self-hosted remote campaign hub for plugin and theme authors. Push notices to unlimited sites via a PHP SDK — no SaaS needed.

AdminSanity vs NoticePilot – Remote Campaign Hub for WordPress Plugin & Theme Authors