Skip to content

phpBB SEO Lite 1.0.9

Choose a tag to compare

@meis2m meis2m released this 04 Sep 21:06
· 8 commits to main since this release

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.
  • 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_enabled in ACP Permalinks. Defaults to false with 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: RouteCacheCompiler conditionally 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.
  • .htaccess Cleanup Preview & Recovery: Inspects and cleanly previews removal of framework rewrite rules from .htaccess with 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

  1. Download phpbbseo_framework_1.0.9.zip.
  2. Extract and replace the files in ext/phpbbseo/framework/.
  3. 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+