WP Admin Declutter

Hides promotional/upsell admin notices, marketing banners, and dashboard widgets injected by common WordPress plugins and themes — without touching real WordPress warnings (broken plugins, PHP version issues, security alerts).

Why

Many plugins (WPForms, ElementsKit, Wpmet, 10Web Booster, Hostinger, Astra, Tutor LMS, Ultimate Member, LoginPress, WPCode, and others) inject "upgrade to Pro," review-request, or deal banners into the WP admin. This plugin removes those specifically, using a denylist, rather than blanket-suppressing all admin notices (which would hide legitimate errors too).

What it does

• Unhooks known promotional callbacks from admin_notices, all_admin_notices, network_admin_notices, and user_admin_notices
• Removes marketing dashboard widgets (e.g. "Premium Addons News," WordPress.org news widget, plugin-branded dashboard panels)
• Adds a small CSS fallback for banners that aren't hooked through the standard notice API

Installation

1. Download the latest release zip (wp-admin-declutter.zip).
2. In WordPress: Go to Plugins → Add New → Upload Plugin.
3. Choose the ZIP file, click Install Now, and then Activate.

Building from source

If you want to package the plugin into a ZIP file yourself:

Run the PowerShell script in the root directory:

.\build.ps1

This generates the installable wp-admin-declutter.zip archive containing the correct directory structure.

How to use

Once installed and activated, you will find a new menu item in your WordPress Sidebar: Declutter.

Through this dashboard, you can:

• Toggle preset blocks on or off for popular plugins (WPForms, ElementsKit, Wpmet, Astra, etc.).
• Add custom Notice Callback Keywords to suppress new nag banners.
• Add custom Dashboard Widget IDs to hide.
• Add custom CSS Selectors to block hardcoded HTML promo banners.

Developer Customization / Filters (Optional)

If you prefer to extend the filters programmatically (e.g., inside a child theme's functions.php), you can still use the standard hooks:

add_filter( 'wp_admin_declutter_denylist', function( $denylist ) {
    $denylist[] = 'your_plugin_slug';
    return $denylist;
});

Similarly, dashboard widgets can be extended with the wp_admin_declutter_widgets filter.

Contributing

Pull requests adding denylist entries for other common plugins/themes are welcome. Please keep entries specific (plugin slug or class prefix) rather than broad terms that might catch legitimate core notices.

Credits

• Muhammad Mehdi - Lead Developer & Creator

Changelog

All notable changes to this project will be documented in this section, following the Semantic Versioning (SemVer) specification.

[1.2.0] - 2026-07-09

Added

• Settings Dashboard: A modern, interactive settings dashboard in the WordPress sidebar under Declutter.
• Preset Toggles: Easy on/off switches for 12 popular plugins and theme upsell notice blocks.
• Custom Rules: Tag managers to dynamically add and remove custom notice callback keywords, dashboard widgets, and CSS selectors.
• Build Automation: PowerShell build script (build.ps1) for packaging the plugin into an installable ZIP archive.

[1.0.0] - 2026-07-08

Added

• Initial release with static denylist filters for popular plugins.

License

GPL v2 or later