phpBB SEO Pro

PRO SUITE
1 / 9
Live Real-Time Audit

SEO Quality Content Analyzer

Automated 12-factor real-time audit while typing new topics with instant SEO scoring and actionable ranking recommendations.

12-factor checks: Keyword density, word count, headings & links
Instant Crawling

IndexNow Instant Search Indexing

Instantly notify Bing, Yandex, and major engines the second a topic is created, edited, or updated via background cron.

Zero crawl wait: Real-time search engine push notifications
Google Rich Results

Advanced JSON-LD Discussion Schema

Official DiscussionForumPosting schema embedding approved replies, authors, avatars, and first-post images for rich SERP snippets.

Google rich cards: Boost click-through rate with rich snippet graphs
Search Console Sync

Google Search Console Intelligence

Synchronize 28-day organic performance, track top keywords, and unlock high-potential SEO opportunities right in ACP.

Actionable insights: Real organic clicks, impressions and rankings
Snippet Optimization

Advanced Titles & SERP Preview

Dynamic formula title patterns with per-forum metadata overrides and live desktop/mobile Google SERP preview simulator.

Pixel-perfect previews: Craft high-CTR titles before publishing
Crawl Protection

Dynamic robots.txt & Crawl Budget

Automatic noindex protection for search pages, member lists, and syndication feeds to prevent thin content crawl waste.

Crawl efficiency: Maximize bot attention on high-value discussions
Dead-Link Detection

Automated 404 Error Monitor

Aggregated missing URL capture with search engine bot detection, referrer tracking, and automatic data retention cleanup.

Zero log bloat: Atomic hit counts and last seen tracking
Social Networks

Social SEO & Open Graph Cards

Rich sharing previews for Telegram, WhatsApp, Twitter/X and Facebook with intelligent 4-tier automated image discovery.

Viral link previews: Crisp cards with custom Twitter/X handle attribution
AI Search & Agents

AI Search Readiness: llms.txt & WebMCP

Prepare your forum for the next generation of AI search. Automatically generate standardized /llms.txt feeds, WebMCP tool endpoints, and fine-tune bot access for ChatGPT, Claude, and Perplexity.

Instant llms.txt feeds, WebMCP agent tools & granular AI crawler controls
User avatar
admin
Site Admin
phpBB SEO Framework Lite – Complete Configuration Guide
⚙️ phpBB SEO Framework Lite – Complete Configuration Guide

Simple recommended settings for a clean and search-friendly phpBB setup

After installing phpBB SEO Framework Lite, you will find the Framework settings inside the phpBB Administration Control Panel.

This guide explains the most important settings in simple terms, what they do, and what we recommend for most phpBB communities.

You do not need to change every option.

For a new installation, the default settings are a good starting point.


1. SEO Permalinks

Permalinks control how your public phpBB URLs are displayed.

Instead of a native phpBB URL such as:

Code: Select all

viewtopic.php?t=123
the Framework can generate:

Code: Select all

/topic/example-topic-123/
For a forum:

Code: Select all

viewforum.php?f=5
can become:

Code: Select all

/forum/support-forum-5/
Recommended setting:

Keep the default permalink structure unless you have a specific reason to change it.

Why is this useful?

Clean URLs are easier for users to understand, easier to share, and provide a consistent canonical URL for search engines.

Tip:

Avoid changing your URL structure repeatedly after your site has already been indexed.


2. Topic & Forum Slugs

A slug is the readable part of an SEO URL.

Example topic title:

Code: Select all

How to Install phpBB SEO Framework
Example SEO URL:

Code: Select all

/topic/how-to-install-phpbb-seo-framework-123/
The number at the end is the phpBB resource ID and helps keep URLs stable and unique.

If a topic title changes later, the Framework can keep track of the previous slug and redirect old URLs to the current canonical URL.

Why is this useful?

Old links from Google, bookmarks, or other websites are less likely to become broken URLs.


3. Titles & Meta

Enable the Titles & Meta Engine.

This controls the HTML title and meta description that search engines can use for your pages.

A topic can produce a title such as:

Code: Select all

How to Install phpBB SEO Framework Lite - phpBB SEO
A forum can produce:

Code: Select all

Installation & Configuration - phpBB SEO
Recommended Topic Title Pattern:

Code: Select all

{topic_title} - {site_name}
Recommended Forum Title Pattern:

Code: Select all

{forum_name} - {site_name}
Recommended Meta Description Maximum Length:

Code: Select all

160
Why is this useful?

The title is one of the most important pieces of information search engines use to understand a page.

A good meta description can also make your search result easier to understand and more attractive to users.

Tip:

Keep titles natural. Do not repeat the same keyword many times.

A separate detailed Titles & Meta guide will cover tokens and advanced patterns.


4. Automatic Topic Meta Descriptions

When a custom description is not provided, the Framework can generate a clean description from topic content.

phpBB formatting and BBCode are cleaned before the final description is created.

For example:

Code: Select all

[b]How to Install phpBB SEO[/b]

This guide explains the installation process.
can become a clean description such as:

Code: Select all

How to Install phpBB SEO. This guide explains the installation process.
Why is this useful?

You do not have to manually write a meta description for every discussion on a large forum.


5. Canonical URLs

Canonical URLs tell search engines which URL should be treated as the main version of a page.

Example:

A native URL:

Code: Select all

viewtopic.php?t=123
and an SEO URL:

Code: Select all

/topic/example-topic-123/
should not compete as two separate pages.

The SEO URL becomes the canonical version.

Recommended:

Keep canonical URL handling enabled.

Why is this useful?

It helps prevent duplicate URL variants from being treated as separate pages by search engines.


6. Automatic 301 Redirects

The Framework can redirect old or native URLs to their current SEO URL.

Example:

Code: Select all

viewtopic.php?t=123
becomes:

Code: Select all

/topic/example-topic-123/
using a permanent redirect.

Old slugs can also redirect to the current slug.

Why is this useful?

It consolidates visitors and search engine signals onto one preferred URL instead of splitting them between multiple versions.


7. Pagination

Multi-page topics and forums receive clean page URLs.

Example:

Code: Select all

/topic/example-topic-123/page/2/
or the pagination format configured by the Framework.

You normally do not need to configure anything manually after the permalink system is working.

Why is this useful?

Page 2, page 3, and later pages remain accessible through consistent URLs instead of falling back to broken or duplicate paths.


8. XML Sitemap

The Framework generates XML sitemaps that help search engines discover public phpBB content.

Your main sitemap is normally available at:

Code: Select all

https://example.com/sitemap.xml
Open this URL after installation and make sure it loads correctly.

Recommended:

Keep the sitemap enabled for public content you want search engines to discover.

Why is this useful?

Large forums can contain thousands or millions of URLs. A sitemap gives search engines a structured way to discover them.

You can later submit the sitemap URL to Google Search Console.


9. Member & Group URLs

The Framework can also create clean URLs for supported member profiles and groups.

Example member:

Code: Select all

/member/admin-2/
Example group:

Code: Select all

/group/global-moderators-4/
These normally work automatically.

SEO note:

Whether all member profile pages should be indexed is a separate SEO decision.

Large forums may prefer more restrictive indexing rules for low-value profile pages.


10. Web Server Rewrite Configuration

SEO URLs require the correct rewrite configuration on your web server.

Supported servers include:

Apache 2.4+

LiteSpeed

Nginx

If native phpBB URLs work but SEO URLs return:

Code: Select all

404 Not Found
the first thing to check is your web server rewrite configuration.

Important:

Do not copy rewrite.php to the phpBB root directory.

It must remain inside:

Code: Select all

ext/phpbbseo/framework/rewrite.php

11. ACP Update Checker

The Framework ACP can check the official GitHub Releases repository for newer Lite versions.

The current installed version is shown in the ACP.

If a newer release is available, the Framework can display an update notification with the official release link.

Update checks are cached and do not run during normal frontend browsing.

Why is this useful?

SEO and compatibility fixes can be important, so administrators can quickly see when a newer Framework release is available.


12. Recommended Settings for Most Forums

For a normal phpBB community, a safe starting configuration is:

✅ SEO Permalinks enabled

✅ Default URL patterns

✅ Titles & Meta enabled

✅ Topic title first, site name second

✅ Automatic topic meta descriptions enabled

✅ Canonical URLs enabled

✅ 301 redirects enabled

✅ XML Sitemap enabled

✅ Default pagination structure

✅ Do not frequently change established URL patterns


13. After Saving Your Settings

After changing important SEO settings, purge the phpBB cache:

Code: Select all

ACP → General → Purge the cache
Then test:

🔹 Board index

🔹 One forum

🔹 One topic

🔹 A multi-page topic if available

🔹 A member profile

🔹 sitemap.xml

Also test a native URL such as:

Code: Select all

viewtopic.php?t=123
and confirm that it reaches the correct SEO URL.


⚠️ Before Changing URLs on an Existing Forum

If your forum is already established and indexed by search engines, avoid changing URL patterns simply for appearance.

A URL structure that has already been indexed may have backlinks, bookmarks, and search engine history.

If you are unsure, ask before changing permalink patterns.


📚 Next Guides

For more detailed configuration, see the dedicated guides for:

🔹 SEO-Friendly URLs & Permalinks

🔹 Titles & Meta

🔹 XML Sitemap & Google Search Console

🔹 Apache / LiteSpeed Rewrite Configuration

🔹 Nginx Configuration

🔹 Canonical URLs & 301 Redirects

🔹 Troubleshooting Common SEO Problems

If your SEO URLs are working and the default settings are enabled, you already have a good starting configuration. 🚀

phpBBSEO.com

GitHub Repository

— phpBB SEO Team