مرکز انتقال و مهاجرت به ویبولتین ۶ (Migration Center)
سیستم جامع و بدون قطعی انتقال انجمنهای فعال به vBulletin 6
انتقال امن، کامل و ساختاریافته انجمنها از پلتفرمهای XenForo 2.x، phpBB 3.x، MyBB 1.8.x و SMF 2.x به ویبولتین ۶.
مشخصات فنی:
وبسایت رسمی: https://web-start.net/
مخزن گیتهاب: https://github.com/web-start-net/vbu...gration-center
۱. معرفی و ویژگیهای کلیدی
انتقال یک جامعه مجازی پرمخاطب با صدها هزار یا میلیونها پست، همواره نیازمند مدیریت دقیق حافظه سرور، جلوگیری از توقف یا تایماوت اسکریپت و حفظ رتبه و اعتبار سئو در موتورهای جستجو است.
افزونه vBulletin Migration Center با شناسه wsmigrationcenter بهطور اختصاصی برای معماری مدرن ویبولتین ۶ طراحی شده است تا چالشهای رایج اسکریپتهای تبدیل قدیمی، از جمله کمبود حافظه (memory_limit)، خطای تایماوت (max_execution_time)، انقضای توکنهای سشن مدیریت و بههمریختگی کدهای BBCode را بهصورت ریشهای برطرف کند.
قابلیتهای برجسته سیستم
۲. سیستمهای مبدأ پشتیبانیشده
۳. راهنمای نصب و راهاندازی
پیشنیازها
مرحله ۱: دانلود افزونه
فایل پکیج زیر را دانلود و از حالت فشرده خارج کنید:
wsmigrationcenter-1.0.0.zip
مرحله ۲: آپلود فایلها
محتویات پوشه upload/ را دقیقاً در روت انجمن ویبولتین ۶ خود آپلود نمایید.
ساختار نهایی فایلها باید به شکل زیر باشد:
[مسیر روت ویبولتین]/
│
├── core/
│ ├── admincp/
│ │ └── wsmigrationcenter.php
│ │
│ ├── includes/
│ │ └── xml/
│ │ └── product_wsmigrationcenter.xml
│ │
│ └── packages/
│ └── wsmigrationcenter/
│
└── legacy_redirect.php
مرحله ۳: ورود به کنترل پنل مدیریت
وارد کنترل پنل مدیریت ویبولتین (AdminCP) شوید و به مسیر زیر بروید:
Plugins & Products → Manage Products → Add/Import Product
مرحله ۴: وارد کردن محصول
فایل زیر را انتخاب کنید:
سپس روی دکمه Import کلیک کنید.
مرحله ۵: اجرای افزونه
از منوی سمت چپ پنل مدیریت، گزینه زیر را باز کنید:
اکنون افزونه آماده پیکربندی و شروع فرآیند مهاجرت است.
۴. راهنمای تنظیم مسیر پوشه مبدأ (Source Filesystem Path)
در مرحله اول ویزارد (Step 1)، فیلدی با عنوان زیر وجود دارد که مسیر فیزیکی پوشه انجمن قبلی شما روی سرور را دریافت میکند:
Source Filesystem Root Path
چرا وارد کردن این مسیر ضروری است؟
۱. تشخیص خودکار تنظیمات دیتابیس:
افزونه با استفاده از دکمه Auto-Detect، فایلهای پیکربندی انجمن قبلی را شناسایی و اطلاعات اتصال به پایگاه داده را بدون نیاز به ورود دستی استخراج میکند.
۲. انتقال فایلهای فیزیکی:
برای انتقال آواتارها و فایلهای پیوست، افزونه باید به پوشههای فیزیکی ذخیرهسازی آنها در هاست دسترسی داشته باشد.
نمونه مسیرها بر اساس نوع میزبانی
الف) هاستهای اشتراکی سیپنل و دایرکتادمین (cPanel / DirectAdmin)
نمونه مسیرهای رایج:
/home/username/public_html/forum
/home/username/public_html/xenforo
نکته: در File Manager سیپنل، معمولاً میتوانید مسیر Home حساب کاربری خود را در نوار بالای صفحه مشاهده کنید.
ب) سرورهای مجازی و اختصاصی لینوکس (Ubuntu / Debian / CentOS / AlmaLinux)
نمونه مسیرهای رایج:
/var/www/html/forum
/var/www/forum
نکته: در محیط ترمینال SSH، دستور زیر را اجرا کنید تا مسیر دقیق پوشه فعلی نمایش داده شود:
cd /path/to/forum && pwd
خروجی دستور را در فیلد Source Filesystem Root Path وارد کنید.
ج) محیطهای لوکال تست (XAMPP / Laragon / WAMP)
نمونه مسیرها:
C:/xampp/htdocs/bb
C:/xampp/htdocs/forum
C:/laragon/www/forum
نکته: در محیط ویندوز، استفاده از اسلش / یا بکاسلش \ هر دو پشتیبانی میشوند.
۵. اجرای خط فرمان (CLI) برای پایگاههای داده میلیونی
برای انجمنهای فوقالعاده بزرگ و پرترافیک با میلیونها پست، میتوانید فرآیند انتقال را مستقیماً از طریق خط فرمان سرور اجرا کنید.
استفاده از CLI مزایای مهمی دارد:
مراحل اجرای دستور
ابتدا از طریق SSH وارد سرور شوید و به پوشه اصلی ویبولتین ۶ بروید.
مرحله ۱: ورود به پوشه اصلی انجمن
cd /var/www/html/forum
مرحله ۲: اجرای اسکریپت مهاجرت
دستور زیر را با شناسه اجرای واقعی مهاجرت (Run ID) اجرا کنید:
php core/packages/wsmigrationcenter/cli/migrate.php --run_id=YOUR_RUN_ID --batch_size=500
در این دستور:
برای مثال، مقدار 500 به این معناست که سیستم در هر بچ، حداکثر ۵۰۰ رکورد را برای پردازش در نظر میگیرد.
نکته مهم: اجرای CLI باید با همان دسترسی فایلها و تنظیمات دیتابیس موردنیاز ویبولتین انجام شود.
پایان مستندات معرفی، نصب و راهاندازی افزونه vBulletin Migration Center
وبسایت رسمی: https://web-start.net/
مخزن گیتهاب: https://github.com/web-start-net/vbu...gration-center
سیستم جامع و بدون قطعی انتقال انجمنهای فعال به vBulletin 6
انتقال امن، کامل و ساختاریافته انجمنها از پلتفرمهای XenForo 2.x، phpBB 3.x، MyBB 1.8.x و SMF 2.x به ویبولتین ۶.
مشخصات فنی:
- نسخههای سازگار: vBulletin 6.0.0 تا 6.2.2+
- نسخههای PHP: 8.1، 8.2، 8.3 و 8.4
- نسخه افزونه: 1.0.0
وبسایت رسمی: https://web-start.net/
مخزن گیتهاب: https://github.com/web-start-net/vbu...gration-center
۱. معرفی و ویژگیهای کلیدی
انتقال یک جامعه مجازی پرمخاطب با صدها هزار یا میلیونها پست، همواره نیازمند مدیریت دقیق حافظه سرور، جلوگیری از توقف یا تایماوت اسکریپت و حفظ رتبه و اعتبار سئو در موتورهای جستجو است.
افزونه vBulletin Migration Center با شناسه wsmigrationcenter بهطور اختصاصی برای معماری مدرن ویبولتین ۶ طراحی شده است تا چالشهای رایج اسکریپتهای تبدیل قدیمی، از جمله کمبود حافظه (memory_limit)، خطای تایماوت (max_execution_time)، انقضای توکنهای سشن مدیریت و بههمریختگی کدهای BBCode را بهصورت ریشهای برطرف کند.
قابلیتهای برجسته سیستم
- ۸ مرحله کامل و تفکیکشده انتقال: گروههای کاربری، کاربران، آواتارها، انجمنها و دستهها، تاپیکها و نظرسنجیها، پستها و پاسخها، فایلهای پیوست و پیامهای خصوصی.
- موتور پردازش دومنظوره: پردازش دستهای بلادرنگ درون مرورگر از طریق AJAX، همراه با نمایش سرعت رکوردهای پردازششده در ثانیه، درصد پیشرفت و دکمههای توقف و ادامه؛ همچنین اسکریپت پسزمینه خط فرمان (CLI) مخصوص انجمنهای فوقالعاده حجیم.
- تشخیص خودکار مسیر و تنظیمات (Auto-Detect): با وارد کردن مسیر پوشه انجمن مبدأ، فایلهای پیکربندی مانند config.php یا Settings.php خوانده شده و مشخصات اتصال دیتابیس بهصورت خودکار استخراج میشوند.
- انتقال شفاف بدون تغییر رمز عبور کاربران: نیازی به بازنشانی رمز عبور یا ارسال ایمیل به کاربران نیست! هنگام نخستین ورود کاربر به ویبولتین ۶، هش رمز عبور قبلی اعتبارسنجی شده و در لحظه به الگوریتم بومی و امن ویبولتین تبدیل و ذخیره میشود.
- حالت شبیهسازی مجازی (Dry Run): امکان اجرای کامل تست انتقال بدون اعمال تغییرات دائمی یا دستکاری دیتابیس زنده ویبولتین.
- سیستم ریدایرکت خودکار ۳۰۱ سئو: تولید خودکار قوانین ریدایرکت برای وبسرورهای Nginx و Apache (.htaccess)، به همراه شبیهساز زنده تست آدرسها برای جلوگیری از بروز خطای ۴۰۴ و حفظ رتبه گوگل.
- مجموعه ابزارهای بهینهسازی و بازسازی پس از انتقال: ابزار داخلی بازسازی ایندکس جستجوی بومی ویبولتین (fulltext_native)، بازسازی شمارندههای آماری تاپیکها و کاربران و پاکسازی حافظه کش.
۲. سیستمهای مبدأ پشتیبانیشده
| XenForo | 2.0.x تا 2.3.x | تشخیص خودکار کانفیگ، خواندن پوشههای چندلایه آواتارها و پیوستها، تبدیل نقلقولهای تودرتو و پارامتریک به BBCode استاندارد vB6 |
| phpBB | 3.0.x تا 3.3.x | تبدیل ساختار مدرن XML مربوط به s9e\TextFormatter، جداسازی گروههای سیستمی از گروههای سفارشی همراه با رنگها و رنکها، انتقال گزینههای نظرسنجی و پیوستها |
| MyBB | 1.8.x | پارس خودکار inc/config.php، پشتیبانی از الگوریتم دوگانه رمز عبور MyBB (mybb_md5)، حذف پیامهای خصوصی تکراری صندوق ورودی و خروجی و انتقال کامل پیوستها |
| SMF (Simple Machines) | 2.0.x تا 2.1.x | تشخیص خودکار Settings.php، تفکیک دستهها و بخشها برای جلوگیری از تداخل شناسهها، انتقال آواتارها و پیوستهای فایلبندیشده بر اساس هش |
۳. راهنمای نصب و راهاندازی
پیشنیازها
- انجمن فعال ویبولتین ۶ با نسخه 6.0.0 تا 6.2.2+
- نسخه PHP 8.1 یا بالاتر
- اکستنشنهای موردنیاز PHP:
- pdo_mysql
- mbstring
- json
- gd
- دسترسی حساب مدیر ارشد با مجوز canadminsettings
مرحله ۱: دانلود افزونه
فایل پکیج زیر را دانلود و از حالت فشرده خارج کنید:
wsmigrationcenter-1.0.0.zip
مرحله ۲: آپلود فایلها
محتویات پوشه upload/ را دقیقاً در روت انجمن ویبولتین ۶ خود آپلود نمایید.
ساختار نهایی فایلها باید به شکل زیر باشد:
[مسیر روت ویبولتین]/
│
├── core/
│ ├── admincp/
│ │ └── wsmigrationcenter.php
│ │
│ ├── includes/
│ │ └── xml/
│ │ └── product_wsmigrationcenter.xml
│ │
│ └── packages/
│ └── wsmigrationcenter/
│
└── legacy_redirect.php
مرحله ۳: ورود به کنترل پنل مدیریت
وارد کنترل پنل مدیریت ویبولتین (AdminCP) شوید و به مسیر زیر بروید:
Plugins & Products → Manage Products → Add/Import Product
مرحله ۴: وارد کردن محصول
فایل زیر را انتخاب کنید:
کد:
core/includes/xml/product_wsmigrationcenter.xml
کد:
مرحله ۵: اجرای افزونه
از منوی سمت چپ پنل مدیریت، گزینه زیر را باز کنید:
کد:
Migration Center → Overview / Wizard
اکنون افزونه آماده پیکربندی و شروع فرآیند مهاجرت است.
۴. راهنمای تنظیم مسیر پوشه مبدأ (Source Filesystem Path)
در مرحله اول ویزارد (Step 1)، فیلدی با عنوان زیر وجود دارد که مسیر فیزیکی پوشه انجمن قبلی شما روی سرور را دریافت میکند:
Source Filesystem Root Path
چرا وارد کردن این مسیر ضروری است؟
۱. تشخیص خودکار تنظیمات دیتابیس:
افزونه با استفاده از دکمه Auto-Detect، فایلهای پیکربندی انجمن قبلی را شناسایی و اطلاعات اتصال به پایگاه داده را بدون نیاز به ورود دستی استخراج میکند.
۲. انتقال فایلهای فیزیکی:
برای انتقال آواتارها و فایلهای پیوست، افزونه باید به پوشههای فیزیکی ذخیرهسازی آنها در هاست دسترسی داشته باشد.
نمونه مسیرها بر اساس نوع میزبانی
الف) هاستهای اشتراکی سیپنل و دایرکتادمین (cPanel / DirectAdmin)
نمونه مسیرهای رایج:
/home/username/public_html/forum
/home/username/public_html/xenforo
نکته: در File Manager سیپنل، معمولاً میتوانید مسیر Home حساب کاربری خود را در نوار بالای صفحه مشاهده کنید.
ب) سرورهای مجازی و اختصاصی لینوکس (Ubuntu / Debian / CentOS / AlmaLinux)
نمونه مسیرهای رایج:
/var/www/html/forum
/var/www/forum
نکته: در محیط ترمینال SSH، دستور زیر را اجرا کنید تا مسیر دقیق پوشه فعلی نمایش داده شود:
cd /path/to/forum && pwd
خروجی دستور را در فیلد Source Filesystem Root Path وارد کنید.
ج) محیطهای لوکال تست (XAMPP / Laragon / WAMP)
نمونه مسیرها:
C:/xampp/htdocs/bb
C:/xampp/htdocs/forum
C:/laragon/www/forum
نکته: در محیط ویندوز، استفاده از اسلش / یا بکاسلش \ هر دو پشتیبانی میشوند.
۵. اجرای خط فرمان (CLI) برای پایگاههای داده میلیونی
برای انجمنهای فوقالعاده بزرگ و پرترافیک با میلیونها پست، میتوانید فرآیند انتقال را مستقیماً از طریق خط فرمان سرور اجرا کنید.
استفاده از CLI مزایای مهمی دارد:
- عدم وابستگی به مرورگر کاربر
- جلوگیری از محدودیت زمان اجرای درخواستهای وب
- کاهش احتمال بروز خطای Timeout
- امکان پردازش دستهای رکوردها با حجم قابل تنظیم
- مناسب برای انتقال انجمنهای بسیار حجیم
مراحل اجرای دستور
ابتدا از طریق SSH وارد سرور شوید و به پوشه اصلی ویبولتین ۶ بروید.
مرحله ۱: ورود به پوشه اصلی انجمن
cd /var/www/html/forum
مرحله ۲: اجرای اسکریپت مهاجرت
دستور زیر را با شناسه اجرای واقعی مهاجرت (Run ID) اجرا کنید:
php core/packages/wsmigrationcenter/cli/migrate.php --run_id=YOUR_RUN_ID --batch_size=500
در این دستور:
- YOUR_RUN_ID: شناسه اجرای فرآیند مهاجرت که باید با شناسه واقعی Run جایگزین شود.
- --batch_size=500: تعداد رکوردهایی که در هر مرحله پردازش میشوند.
برای مثال، مقدار 500 به این معناست که سیستم در هر بچ، حداکثر ۵۰۰ رکورد را برای پردازش در نظر میگیرد.
نکته مهم: اجرای CLI باید با همان دسترسی فایلها و تنظیمات دیتابیس موردنیاز ویبولتین انجام شود.
پایان مستندات معرفی، نصب و راهاندازی افزونه vBulletin Migration Center
وبسایت رسمی: https://web-start.net/
مخزن گیتهاب: https://github.com/web-start-net/vbu...gration-center



