Repository navigation
phpBB Migration Center v1.0.0 Beta 4
🚀 phpBB Migration Center v1.0.0-beta.4
We are pleased to announce the release of v1.0.0-beta.4 of the phpBB Migration Center extension for phpBB 3.3+. This milestone introduces full support for vBulletin 6.x and Simple Machines Forum (SMF 2.x), standardizes cross-engine administrator and moderator privilege mapping, and includes an updated beginner-friendly installation guide.
🌟 What's New in Beta 4
1. ⚡ Complete vBulletin 6 Support
- Node-Based Data Extraction: Added
vB6SourceProviderwith dedicated extraction steps for forums (vb6_forums_step), topics (vb6_topics_step), and posts (vb6_posts_step) optimized for vBulletin 6's unifiednodetable hierarchy. - Argon2id Authentication & Native MD5 Pre-Hash: Upgraded
vb_password_driverto support vBulletin 6's dual-stage authentication (password_verify(md5($password), $token)), ensuring existing members and administrators can log in seamlessly without resetting their passwords.
2. 🔌 Simple Machines Forum (SMF 2.x) Migration Suite
- Full Engine Implementation: Added SMF source provider, database adapter, BBCode message converter, user/group normalizers, and config detector.
- 15-Step Pipeline Support: Migrates users, groups, boards, topics, posts, attachments, user avatars, personal messages & attachments, polls, bans, and node permissions from SMF 2.0.x and 2.1.x.
- Multi-Algorithm Passwords: Dedicated support for SMF 2.0 (
sha1(strtolower($username) . $password)) and SMF 2.1 (SHA256/SHA512/Bcrypt) with transparent upgrade to phpBB Argon2id/Bcrypt upon first successful login.
3. 🛡️ Standardized Administrator & Moderator Role Preservation
- Unified privilege mapping across all supported platforms (XenForo, vBulletin 3/4/6, MyBB, SMF).
- Users designated as administrators in the source board are automatically placed into the phpBB
ADMINISTRATORSgroup (ID 5) and granted the Full Administrator role (auth_role_id = 4,a_*capabilities), ensuring instant, unrestricted access to the phpBB Administration Control Panel (ACP). - Moderators are mapped to
GLOBAL_MODERATORS(Group ID 4) withm_*permissions.
4. 📚 Simplified Documentation & Beginner-Friendly Setup
- Streamlined
README.mdwith zero fluff and exact, verified platform matrix. - Added a 3-step illustrated installation guide with folder hierarchy trees designed for users new to phpBB extensions.
📦 Verified Supported Platforms
| Source Forum | Verified Versions | Migrated Components |
|---|---|---|
| XenForo | 2.x |
Users, Passwords, Groups, Forums, Topics, Posts, Attachments, Avatars, Conversations (PMs) |
| vBulletin | 3.8.x, 4.2.x, 6.x |
Users, Passwords, Groups, Forums, Topics, Posts, Attachments, Avatars, PMs, Polls, Bans |
| MyBB | 1.8.x |
Users, Passwords, Groups, Forums, Topics, Posts, Attachments, Avatars, PMs |
| SMF | 2.0.x, 2.1.x |
Users, Passwords, Groups, Boards, Topics, Posts, Attachments, Avatars, PMs, Polls, Bans |
🧪 Test Suite & Quality Assurance
- Standalone CI test runner passing 30 out of 30 unit and integration test suites:
- XenForo normalizers, converters, path resolvers, tree builders, and permission translators.
- vBulletin 3/4/6 migration, password drivers, and schema separation.
- MyBB 1.8 password verification, message converters, and config detection.
- SMF 2.x password drivers, message converters, config detection, and normalizers.
- Cross-engine administrator and moderator permission test suite.
📥 Installation
- Upload the files to your phpBB root under:
phpBB_ROOT/ext/phpbbseo/migrationcenter/ 2. Navigate to ACP > Customise > Extension Management > Manage extensions and click Enable. - Open the Migration tab at the top of your ACP, configure your database connection, and start the migration.