phpBB SEO Lite 1.0.9
phpBB SEO Framework Lite 1.0.9
🚀 Overview
phpBB SEO Framework Lite 1.0.9 introduces full backward-compatibility and 301 migration for boards previously running Ultimate SEO URL (USU), featuring Approach A Symfony Router collision protection with fail-closed safety, and introduces the ACP Safe Uninstall Suite for pre-flight diagnostics, .htaccess cleanup preview, and safe uninstallation.
🌟 What's Changed
1. 🔄 Legacy Ultimate SEO URL (USU) Compatibility & Migration
- Comprehensive Legacy URL Mapping: Seamlessly resolves and 301-redirects historical USU patterns across all content types:
- Topics:
{slug}-t{id}.html,t{id}.html,.htm, extensionless, underscore delimiters, nested subfolders, and pagination (-s{start}). - Forums:
{slug}-f{id}.html,f{id}.html,.htm, extensionless, underscore delimiters, and pagination (-s{start}). - Members:
member{id}.html,user{id}.html,user_{id}.html, extensionless,.htm. - Posts:
post{id}.html,post_{id}.html, extensionless,.htm.
- Topics:
- Approach A Router Collision Avoidance: Integrates with phpBB's Symfony Router prior to claiming legacy patterns to prevent shadowing routes registered by core controllers or third-party extensions.
- Fail-Closed Exception Handling: Safely aborts legacy claims if unexpected router errors occur, ensuring native phpBB routing is never disrupted.
- Configurable Admin Toggle (Default: OFF): Controlled via
phpbbseo_legacy_usu_enabledin ACP Permalinks. Defaults tofalsewith a prominent warning notice so sites without USU history return normal 404 responses for arbitrary-f{id}/-t{id}requests. - Pre-Bootstrap Route Cache Integration:
RouteCacheCompilerconditionally compiles legacy patterns only when the legacy setting is active.
2. 🛡️ ACP Safe Uninstall Suite
- Pre-Flight Diagnostics & Safeguards: Added a dedicated Safe Uninstall tool in ACP (
ACP_PHPBBSEO_SAFE_UNINSTALL) providing step-by-step diagnostics before deactivating or removing the extension. .htaccessCleanup Preview & Recovery: Inspects and cleanly previews removal of framework rewrite rules from.htaccesswith automated backup recovery.- Route Cache Purge: Cleans up runtime compiled routes (
store/compiled_routes.php) on deactivation.
3. 🎨 Admin Control Panel & Lifecycle Enhancements
- Modernized ACP Interface: Updated navigation headers, tab styles, and responsive notices.
- Robust Test Suite: Added comprehensive unit tests covering USU migration resolutions, edge-case URL formats, router collision guards, and safe uninstall manager workflows.
📦 Installation / Update
- Download
phpbbseo_framework_1.0.9.zip. - Extract and replace the files in
ext/phpbbseo/framework/. - Purge the board cache via the ACP or delete the contents of the
cache/directory.
📋 Compatibility
- phpBB: 3.3.0 – 3.3.17+
- PHP: 8.1 – 8.4+