README

日本語版 README

WPPack Tidy Admin is a WordPress plugin that tidies up wp-admin. It takes plugin vendors' upsell menus, promotional banners, review requests and setup nags out of your way and relocates them into consistent, WordPress-native places: upgrade guidance and Premium feature pages move to an Upgrades button next to the standard Help button on each plugin's own screens (a running discount shows there too), documentation and support links join the Help button beside it, and setup reminders collect into a single Pending plugin setup dashboard widget instead of nagging on every screen. Nothing functional is removed — every page and link stays reachable, and each cleanup can be toggled per plugin, feature by feature.

This plugin does not exist to stop anyone from upgrading to paid plugins. We understand that paid plugins fund and motivate the development of the free plugins we all rely on — which is exactly why upgrade information stays available: quietly, in one predictable place.

But a wp-admin where those promotions shout for attention with no restraint or coordination violates guideline 11 of the WordPress.org plugin guidelines ("Plugins should not hijack the admin dashboard"), and it confuses everyone who works in it every day. This plugin is an answer to “Please Stop Abusing WordPress Admin Notices” (WP Tavern, 2016).

Our goal is a better experience for everyone who uses WordPress, through a tidy, organized admin UI.

To plugin developers: please do not work against this plugin. We are meeting you halfway — and we hope it helps more people enjoy WordPress, and your plugins.

How it works

• One module per target plugin (src/Modules/); a module registers only when its target plugin is active.
• Shared mechanics (src/Support/), fed by each module's declarations:
  • Submenu relocation — upsell submenus are hidden from the sidebar and collected into an "Upgrades" screen-meta button styled exactly like core Help; documentation/support submenus go to a plugin-specific "Help" button. However they are hidden, the pages themselves always stay registered and reachable.
  • plugins.php link cleanup — Pro/Premium links are removed from the plugin list rows (functional links such as Docs and FAQ stay).
  • Notice removal — promotional notices (review requests, campaigns, cross-sells) are unhooked by callback name.
  • Setup notice relocation — functional setup notices (missing API key, first-run configuration) keep showing on the plugin's own screens and in the "Pending plugin setup" dashboard widget, and disappear on their own once the plugin considers setup complete.
  • Admin CSS — promotional UI rendered inside React/Vue bundles, which PHP hooks cannot control, is hidden with CSS.
• Each module pins the plugin major versions its removals were verified against (supportedMajorVersions()); a catalog test fails when a target plugin moves to an unverified major.
• Settings › Tidy Admin lets you disable tidying per plugin — entirely, or feature by feature: every module lists its actual cleanups (e.g. "Remove the HelpScout support beacon", "Hide the license fields") as individually toggleable checkboxes. Everything is ON by default.

Supported plugins

What gets tidied for each plugin is listed, feature by feature, on Settings › Tidy Admin (and declared in src/Modules/). Currently supported, with the major versions the cleanups were verified against:

Installation

Require wppack/tidy-admin-plugin with Composer (type wordpress-plugin) and activate it, or drop the tidy-admin/ directory into wp-content/plugins/. No configuration.

Testing

The test suite boots a real WordPress via wp-phpunit and installs the real target plugins from wp-packages.org, so modules are exercised against actual plugin code. Catalog tests verify that every module still points at an existing plugin main file and that the installed version is within the module's verified majors — catching renames and unverified upgrades.

$ docker compose up -d mysql-test   # test database (127.0.0.1:3309)
$ composer install
$ vendor/bin/phpunit
$ vendor/bin/phpstan analyse
$ vendor/bin/php-cs-fixer fix --dry-run