Skip to content

phpBB Migration Center v1.0.0 Beta 4

Choose a tag to compare

@meis2m meis2m released this 08 Sep 15:17
· 11 commits to main since this release

🚀 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 vB6SourceProvider with dedicated extraction steps for forums (vb6_forums_step), topics (vb6_topics_step), and posts (vb6_posts_step) optimized for vBulletin 6's unified node table hierarchy.
  • Argon2id Authentication & Native MD5 Pre-Hash: Upgraded vb_password_driver to 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 ADMINISTRATORS group (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) with m_* permissions.

4. 📚 Simplified Documentation & Beginner-Friendly Setup

  • Streamlined README.md with 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

  1. 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.
    
  2. Open the Migration tab at the top of your ACP, configure your database connection, and start the migration.