Follow this checklist to ensure that disabling or uninstalling the framework preserves your search engine rankings and prevents 404 Not Found errors.
1. The Core Rule: Preserve Indexed URLs with 301 Fallbacks
If your forum has had SEO permalinks active (e.g.,
/topic/seo-slug-123/ or /forum/news-2/), search engines have already indexed these clean URLs. If you disable the extension without establishing fallback redirects, incoming visitors and search spiders will receive 404 errors.Before deactivating the extension, add fallback 301 redirect rules to your server configuration.
For Apache (.htaccess):
Add these rules at the very top of your
.htaccess file (before the phpBB core block):
Code: Select all
RewriteEngine On
# Redirect SEO topic URLs back to native viewtopic.php
RewriteRule ^topic/[a-z0-9\-_]+-([0-9]+)/?$ /viewtopic.php?t=$1 [R=301,L]
# Redirect SEO forum URLs back to native viewforum.php
RewriteRule ^forum/[a-z0-9\-_]+-([0-9]+)/?$ /viewforum.php?f=$1 [R=301,L]Insert rewrite directives inside your
server block:
Code: Select all
rewrite ^/topic/[a-z0-9\-_]+-([0-9]+)/?$ /viewtopic.php?t=$1 permanent;
rewrite ^/forum/[a-z0-9\-_]+-([0-9]+)/?$ /viewforum.php?f=$1 permanent;If you need to test another extension or troubleshoot a conflict:
- Log into the phpBB Administration Control Panel (ACP).
- Navigate to Customise -> Manage extensions.
- Locate phpBB SEO Framework (Lite) and click Disable.
3. Full Uninstall: Deleting Extension Data
If you decide to completely remove the extension:
- In Customise -> Manage extensions, after disabling, click Delete data.
- Confirm the deletion prompt.
- phpBB's native migration engine automatically executes
revert_schema(), dropping allphpbb_seo_*tables cleanly. Core phpBB tables (phpbb_topics,phpbb_posts,phpbb_users) remain 100% untouched. - Remove the extension files from your server at
ext/phpbbseo/framework/.
Whenever extensions are disabled or uninstalled, always purge the phpBB production container cache:
- In ACP -> General, click Purge the cache.
- Alternatively, delete all files inside
/cache/production/via FTP or SSH (retaining.htaccessandindex.htm).
Perform a quick health check:
- Visit
https://www.example.com/and confirm board loads normally. - Click a topic link and confirm it navigates to
viewtopic.php?t=.... - Test a legacy rewritten URL (e.g.,
/topic/slug-1/) to verify your 301 fallback redirect executes seamlessly.
If you have questions about reversible migrations or URL preservation, reach out to our team:
Γ°ΕΈβΒ¬ phpBB SEO Migration Center