Understanding clean URLs, slugs, redirects and permanent links in phpBB SEO Framework Lite
One of the main features of phpBB SEO Framework Lite is its SEO-friendly URL system.
This guide explains how SEO URLs work, what a slug is, what happens when titles change, and which settings we recommend.
For most websites, the default configuration is already a good choice.
1. What Are SEO-Friendly URLs?
A normal phpBB topic URL may look like:
Code: Select all
viewtopic.php?t=123Code: Select all
/topic/how-to-install-phpbb-seo-framework-123/Code: Select all
viewforum.php?f=5Code: Select all
/forum/installation-configuration-5/Why is this useful?
Clean URLs are:
2. Understanding the URL Structure
Consider this URL:
Code: Select all
/topic/phpbb-seo-framework-installation-123/Code: Select all
topicCode: Select all
phpbb-seo-framework-installationCode: Select all
123The ID is intentionally retained.
It provides a stable and unique identifier even when multiple topics have similar titles.
3. Supported Public Resources
phpBB SEO Framework can generate clean URLs for supported public phpBB resources.
Forums
Code: Select all
/forum/installation-configuration-5/Code: Select all
/topic/phpbb-seo-framework-installation-123/Code: Select all
/member/example-user-25/Code: Select all
/group/global-moderators-4/Recommended:
For most communities, keep the default resource prefixes unless you have a specific reason to change them.
4. What Is a Slug?
A slug is the readable part of the URL.
For example:
Topic title:
Code: Select all
How to Configure phpBB SEOCode: Select all
how-to-configure-phpbb-seoCode: Select all
/topic/how-to-configure-phpbb-seo-123/5. Persistent Slugs
phpBB SEO Framework uses a persistent slug system.
This means the Framework does not need to blindly regenerate a slug every time a URL is displayed.
The slug information can be stored and resolved by the Framework as part of its SEO URL infrastructure.
Why does this matter?
URLs are an important long-term part of a website.
A persistent system provides a reliable foundation for:
6. What Happens When a Topic Title Changes?
Imagine that a topic originally has this title:
Code: Select all
phpBB SEO InstallationCode: Select all
/topic/phpbb-seo-installation-123/Code: Select all
Complete phpBB SEO Installation GuideCode: Select all
/topic/complete-phpbb-seo-installation-guide-123/The Framework's historical slug and redirect infrastructure allows an outdated SEO URL to be resolved to the current canonical URL.
Example:
Code: Select all
/topic/phpbb-seo-installation-123/Code: Select all
/topic/complete-phpbb-seo-installation-guide-123/SEO benefit:
Existing links, bookmarks and search engine references can continue reaching the correct topic.
7. Native phpBB URLs Still Matter
phpBB and third-party extensions may internally generate native URLs such as:
Code: Select all
viewtopic.php?t=123The Framework integrates with phpBB's URL generation system and can convert supported public URLs into their SEO equivalents.
When a visitor directly requests an old/native URL, canonical redirection can also send the visitor to the preferred SEO URL.
Example:
Code: Select all
viewtopic.php?t=123Code: Select all
/topic/example-topic-123/Important:
Do not modify phpBB core files just to replace native URLs.
8. Post Links & Anchors
Links to individual posts can still point to the correct post inside an SEO topic URL.
For example, a native link may contain:
Code: Select all
viewtopic.php?t=123&p=456#p456Code: Select all
/topic/example-topic-123/#p4569. Multi-Page Topics
Long discussions often contain multiple pages.
The Framework supports clean pagination URLs.
For example:
Page 1:
Code: Select all
/topic/example-topic-123/Code: Select all
/topic/example-topic-123/page/2/Code: Select all
/topic/example-topic-123/page/3/Why is this important?
Pagination must remain consistent so users and search engines can correctly reach later pages of large discussions.
10. Unicode & Multilingual URLs
phpBB SEO Framework is designed for international communities.
The URL infrastructure supports Unicode content and is not limited to English titles.
This is important for communities using languages and writing systems such as:
For example, communities are not forced to translate every topic title into English simply to generate an SEO URL.
11. Canonical URLs
A single page can sometimes be reachable through more than one URL.
For example:
Code: Select all
viewtopic.php?t=123Code: Select all
/topic/example-topic-123/The Framework identifies the preferred public URL and generates the appropriate canonical URL.
Example:
Code: Select all
<link rel="canonical" href="https://example.com/topic/example-topic-123/" />Why is this useful?
Canonical URLs help search engines understand which URL represents the primary version of a page.
12. Why 301 Redirects Are Important
A 301 redirect tells browsers and search engines that a resource has permanently moved to another URL.
For example:
Code: Select all
OLD URL
/topic/old-topic-title-123/
β
301
β
CURRENT URL
/topic/new-topic-title-123/Once your website has been indexed, URLs may exist in:
Changing URL patterns simply because another format looks nicer is usually unnecessary.
For example, do not repeatedly change:
Code: Select all
/topic/example-123/Code: Select all
/threads/example-123/Code: Select all
/discussion/example-123/Recommended:
Choose a clean URL structure and keep it stable.
14. Recommended Configuration
For most phpBB communities:
15. Existing phpBB Communities
If you are installing phpBB SEO Framework on an established community, be more careful than on a new website.
Your existing native URLs may already be indexed and linked from other websites.
Before making major permalink changes:
16. Quick Test After Configuration
After enabling SEO URLs, perform a few simple checks.
Test a forum:
Code: Select all
viewforum.php?f=5Test a topic:
Code: Select all
viewtopic.php?t=123Test pagination:
Open page 2 of a multi-page topic.
Test an individual post:
Click a direct post link and confirm that the browser reaches the correct post.
Test an old slug:
If you have renamed a test topic, verify that its previous SEO URL reaches the current URL correctly.
If native phpBB URLs work:
Code: Select all
viewtopic.php?t=123Code: Select all
404 Not FoundThe problem may be related to the web-server rewrite configuration.
Check:
Detailed Apache/LiteSpeed and Nginx configuration guides are provided separately.
17. A Simple Rule to Remember
Keep it readable.
Keep it unique.
Keep it canonical.
And most importantly, keep it stable.