rwsite / wp-addon-plugin
Performance, security, and admin enhancements for WordPress 6.6+ — WP Tweaker (48 toggles), redirects, cookie banner, Markdown editor, plugin catalog, and comment spam protection.
Package info
github.com/tikhomirov/wp-addon-plugin
Type:wordpress-plugin
pkg:composer/rwsite/wp-addon-plugin
Requires
- php: ^8.2
Requires (Dev)
- brain/monkey: ^2.7
- fakerphp/faker: ^1.23
- laravel/pint: ^1.18
- mockery/mockery: ^1.4
- pestphp/pest: ^2.0
- php-stubs/wordpress-stubs: ^6.8
- phpstan/phpstan: ^2.1
- phpunit/phpunit: ^10.0
- szepeviktor/phpstan-wordpress: ^2.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Transforms a standard WordPress site into a faster, safer, and easier-to-manage installation. The plugin bundles WP Tweaker (48 performance and security tweaks), Redirects, Cookie Banner, Markdown editor, Plugin catalog, Comment spam protection, and admin utilities in one place.
Requirements
| Component | Minimum | Tested |
|---|---|---|
| WordPress | 6.6 | 6.6 – 7.2 |
| PHP | 8.2 | 8.2, 8.3, 8.4 |
| CodeStar Framework | 2.3.1 | bundled copy, sibling plugin, or auto-installed |
The plugin does not support PHP 7.x or WordPress versions below 6.6. CI runs the test suite on PHP 8.2, 8.3, and 8.4.
Features
WP Tweaker — 48 toggles
Performance, security, and housekeeping tweaks grouped in admin settings. Each toggle is independent and can be enabled without touching code.
Categories include:
- Performance — disable emojis, dashicons on frontend, oEmbed, Heartbeat, query strings on static assets, and more
- Security — hide WP version, disable XML-RPC, block user enumeration, disable file editing, block Automattic tracking
- Admin UX — custom admin footer, dashboard cleanup, post list columns, duplicate posts, SVG upload support
- SEO & URLs — hierarchical tags, category base removal, slug transliteration, noindex for archives
Redirects
Rule-based redirect manager with support for exact, prefix, and regex matches. Handles 301/302/307/308, query strings, and import/export.
Cookie Banner
GDPR-oriented cookie consent banner with customizable text, button labels, and styling.
Markdown Editor
Optional Markdown editing mode for posts and pages with live preview.
Plugin Catalog
Built-in catalog of project plugins with GitHub metadata, search, and quick links — useful on multi-plugin setups.
Comment Spam
Rejects spam before it reaches the database, so nothing is stored, no moderation email is sent, and the page cache is never purged.
- Honeypot — a hidden field that form-filling bots trip over
- Time trap — a timestamp written by the browser, because cached pages make a server-side check useless
- Scoring — additive signals (random body token, token-like author, no Cyrillic, dotted email, first visit, extra links and domains repeating the author name, spam niche vocabulary, bulk-registered TLDs) against a threshold
- Moderation hold — comments that score below the threshold but above the hold score go to the moderation queue instead of publishing; option to hold every first comment
- Backlink verification — for pingbacks and trackbacks, as Kama SpamBlock did
- Rate limits — per IP, off by default
- Logging — blocked attempts with IP, reason, score, and user agent, pruned monthly
Other modules
- Image optimization and media cleanup services
- Shortcodes, TinyMCE extensions, comment tweaks
- Integration with CodeStar Framework settings UI
Installation
From Git (submodule)
git submodule add git@github.com:rwsite/wp-addon-plugin.git wp-content/plugins/wp-addon-plugin
Manual
- Download the latest release.
- Upload to
wp-content/plugins/wp-addon-plugin/. - Activate WP Excellence Addon in WordPress admin.
Composer (inside the plugin)
cd wp-content/plugins/wp-addon-plugin
composer install
CodeStar Framework
The admin settings screen is built on CodeStar Framework (CSF). The plugin resolves the framework automatically, in this order:
- Already loaded — e.g. the standalone
codestar-frameworkplugin is active (this repository ships it as a submodule inwp-content/plugins/codestar-framework/). - Bundled copy —
wp-addon-plugin/lib/codestar-framework/(git-ignored; created by the installer). - Automatic install — on the first wp-admin page load, and at most once an hour afterwards, the plugin downloads the pinned
2.3.1release from GitHub intolib/. Requires a user with theinstall_pluginscapability and write access towp-content/plugins/. - Manual install — click Install CodeStar Framework now in the admin notice, or download a release into
wp-content/plugins/codestar-framework/and activate it.
If every source fails, an admin notice shows the underlying download or filesystem error, and the settings screen stays hidden until CSF is available.
Development
composer install composer test # unit tests (Pest) composer test:coverage composer static-analysis composer format:check # Pint composer quality # validate + lint + analyse + test make release # dist/wp-addon-plugin-<version>.zip
Release package
Production ZIP is built with git archive (respects .gitattributes export-ignore — no tests, CI, or dev tooling):
make release
# or: composer run build:zip
Publish on GitHub: push tag v1.6.1 (must match Version in wp-addon-plugin.php). The .github/workflows/release.yml workflow attaches wp-addon-plugin-<version>.zip to the GitHub Release.
Architecture
wp-addon-plugin/
├── wp-addon-plugin.php # Bootstrap
├── src/
│ ├── Core/Plugin.php # Initialization, module loader
│ ├── ControllerWP.php # Option-driven tweak activation
│ ├── Config/ # Settings field definitions
│ └── Services/ # Redirects, assets, media, etc.
├── functions/ # Procedural modules (auto-loaded)
│ ├── seo/
│ ├── posts/
│ ├── shortcodes/
│ └── ...
└── tests/Unit/
Modules under functions/ are loaded automatically by Plugin::loadModules(). Tweaks registered in src/Config/tweaks.php are activated via ControllerWP based on saved settings.
Changelog
See CHANGELOG.md.
License
GPL-2.0-or-later
Author
Aleksey Tikhomirov — rwsite.ru