Kntnt Bogo Category Rules Fix

Kntnt Bogo Category Rules Fix resolves a WordPress permalink conflict between Bogo multilingual routing and Slim SEO’s removal of the category base. Broad language-prefixed category rules can intercept ordinary page URLs, causing localized pages to return 404 errors. This plugin replaces those catch-all rules with rules for real category paths, allowing pages and category archives to resolve correctly.

How it works

• Repairs rewrite rules after Bogo generates them.
• Includes hierarchical category paths, category feeds, and archive pagination.
• Preserves single-post rules containing both a category and a post slug.
• Leaves rules unchanged when Bogo is unavailable or the category structure is not the bare %category% structure.

Categories retain priority over pages with exactly the same path. Use distinct paths where necessary.

Setup

Requires Bogo, pretty permalinks, and a category structure without a category base, such as Slim SEO’s corresponding feature produces.

After installing or removing the plugin, visit Settings → Permalinks and click Save Changes to rebuild rewrite rules. Rebuild rules after category path changes if your category-base plugin does not already do so.

Installation

Requires WordPress and PHP 8.1 or later, plus the plugin-specific dependencies described above.

As a must-use (MU) plugin

1. Download this repository using Code → Download ZIP and extract it.
2. Connect to your site using SFTP, SSH, or your hosting file manager.
3. Create wp-content/mu-plugins/ if it does not exist.
4. Copy kntnt-bogo-category-rules-fix.php directly into that directory. WordPress does not automatically load PHP files inside MU-plugin subdirectories.
5. The plugin loads automatically without activation and appears under Plugins → Must-Use.

As a regular WordPress plugin

If you prefer a regular plugin or do not have access to the MU-plugin directory, you can install this plugin normally:

1. Download the repository ZIP using Code → Download ZIP.
2. In WordPress, go to Plugins → Add New Plugin → Upload Plugin.
3. Select the ZIP, click Install Now, and then Activate Plugin.

You need permission to install plugins. Install only one copy: remove the MU copy before activating a regular copy, or deactivate and remove the regular copy before installing it as MU.

Updates and removal

This repository does not include an automatic updater. To update an MU installation, replace its PHP file. For a regular installation, upload the new ZIP and use WordPress’s replacement option. To remove an MU installation, delete its PHP file; for a regular installation, deactivate and delete it in Plugins. Follow any plugin-specific setup or removal steps above.

License

Copyright (C) 2026 Kntnt.

Licensed under the GNU General Public License, version 2 or (at your option) any later version (GPL-2.0-or-later). See LICENSE for the full GPL v2 text.