راهنمای جامع و گام‌به‌گام رفع خطای لینک‌های داخلی بعد از تغییر دامنه وردپرس

تغییر دامنه وردپرس معمولاً باعث به جا ماندن آدرس‌های قدیمی در متن برگه، تصاویر، ویجت‌ها و تنظیمات افزونه‌ها می‌شود که نتیجه آن بروز خطای ۴۰۴ و افت سئو است. در این مقاله کاربردی، روش‌های استاندارد جایگزینی آدرس قدیمی با جدید در دیتابیس را بدون خراب شدن داده‌های سریالی (Serialized Data) و همراه با پاکسازی کش المنتور آموزش می‌بینید تا تمام لینک‌های داخلی به‌طور کامل اصلاح شوند.

چرا بعد از تغییر دامنه، لینک‌های داخلی اصلاح نمی‌شوند؟

زمانی که دامنه سایت وردپرسی خود را تغییر می‌دهید و آدرس‌های `siteurl` و `home` را در تنظیمات به‌روزرسانی می‌کنید، هسته وردپرس به‌طور خودکار متن نوشته‌ها، برگه، تصاویر آپلودشده و تنظیمات افزونه‌ها را ویرایش نمی‌کند. تمام این موارد به‌صورت آدرس مطلق (Absolute URL) با دامنه قدیم در جداول پایگاه داده ذخیره شده‌اند.

چالش اصلی در این فرایند، وجود داده‌های سریالی شده (Serialized Data) در وردپرس است. زبان PHP برای ذخیره‌سازی آرایه‌ها و اشیاء در دیتابیس، طول رشته‌ها را محاسبه می‌کند (مثلا `s:19:”http://old-domain.com”`). اگر آدرس جدید طول متفاوتی داشته باشد و به‌صورت دستی تغییر یابد، رشته سریالی نامعتبر شده و تنظیمات قالب یا افزونه مربوطه کلاً از کار می‌افتد.

روش اول: جایگزینی خودکار با افزونه Better Search Replace (پیشنهادی)

این روش برای ۹۹ درصد سایت‌های وردپرسی بهترین گزینه است. برای اجرای بدون خطای این روش، مراحل زیر را به ترتیب انجام دهید:

1. پشتیبان‌گیری: قبل از هر کاری، یک بک‌آپ کامل از دیتابیس تهیه کنید.
2. نصب افزونه: افزونه رایگان Better Search Replace را از مخزن وردپرس نصب و فعال کنید.
3. ورود به محیط ابزار: از منوی مدیریت به مسیر ابزارها > Better Search Replace بروید.
4. تنظیم مقادیر:
   • در کادر Search for آدرس قدیم (مثلاً `https://old-domain.com`) را وارد کنید.
   • در کادر Replace with آدرس جدید (مثلاً `https://new-domain.com`) را وارد کنید.
5. انتخاب جداول: تمام جداول دیتابیس را انتخاب کنید (کلید Ctrl یا Cmd را نگه دارید و همه را انتخاب کنید).
6. تست آزمایشی (Dry Run): تیک گزینه Run as a dry run را بزنید و روی دکمه اجرای جایگزینی کلیک کنید. این حالت هیچ تغییری در دیتابیس اعمال نمی‌کند و فقط تعداد موارد یافت شده را نشان می‌دهد.
7. اجرای نهایی: پس از اطمینان از صحت آمار، تیک Run as a dry run را بردارید و مجدداً دکمه را بزنید تا تغییرات واقعی اعمال شوند.

اگر در زمینه بهینه‌سازی کدهای قالب یا افزونه‌های خود نیاز به الگوهای آماده دارید، می‌توانید به بخش تکه‌کدهای وردپرس مراجعه کنید.

روش دوم: اصلاح آدرس‌ها با دستورات WP-CLI (مخصوص سایت‌های بزرگ)

اگر به SSH سرور دسترسی دارید، به پوشه اصلی وردپرس (Root) بروید و دستورات زیر را اجرا کنید. این روش بسیار سریع‌تر از افزونه‌های وب است.

ابتدا دستور را به‌صورت تست (Dry Run) اجرا کنید تا تعداد تغییرات مشخص شود:

wp search-replace 'https://old-domain.com' 'https://new-domain.com' --dry-run

در صورت صحت نتایج، دستور اصلی را جایگزین کنید:

wp search-replace 'https://old-domain.com' 'https://new-domain.com' --skip-columns=guid

نکته: پارامتر `–skip-columns=guid` باعث می‌شود ستون GUID در جدول `wp_posts` تغییر نکند. طبق استاندارد وردپرس، آدرس GUID ستون شناسه فید RSS است و نباید بعد از انتشار مطلب تغییر کند.

روش سوم: اجرای دستورات SQL و خطرات داده‌های سریالی

اگر به هر دلیلی مجبور به استفاده از phpMyAdmin هستید، دستورات زیر را فقط برای جداول بدون داده سریالی اجرا کنید:

-- اصلاح محتوای نوشته‌ها و برگه‌ها
UPDATE wp_posts SET post_content = REPLACE(post_content, 'http://old-domain.com', 'https://new-domain.com');

-- اصلاح آدرس دیدگاه‌ها
UPDATE wp_comments SET comment_content = REPLACE(comment_content, 'http://old-domain.com', 'https://new-domain.com');

-- اصلاح لینک دیدگاه‌دهندگان
UPDATE wp_comments SET comment_author_url = REPLACE(comment_author_url, 'http://old-domain.com', 'https://new-domain.com');

برای مشاهده سایر نمونه دستورات کاربردی دیتابیس و برنامه‌نویسی می‌توانید از بخش مجموعه تکه‌کدهای کاربردی بازدید کنید.

گام حیاتی: بازسازی لینک‌های المنتور و پاکسازی کش CSS

بسیاری از کاربران پس از جایگزینی دیتابیس متوجه می‌شوند که هنوز برخی از لینک‌ها یا پس‌زمینه‌های ایجاد شده با المنتور به دامنه قدیم اشاره دارند. دلیل این مسئله، ذخیره‌سازی آدرس‌ها در فایل‌های مجزای CSS و کش داخلی المنتور است.

برای حل کاملاً قطعی این مشکل، مراحل زیر را طی کنید:

1. به منوی المنتور > ابزارها در پیشخوان وردپرس بروید.
2. تب جایگزینی URL را انتخاب کنید.
3. آدرس قدیمی و جدید را وارد کرده و روی جایگزینی URL کلیک کنید.
4. سپس به تب کلیات (General) بروید و روی دکمه بازسازی فایل‌ها و داده‌ها (Regenerate Files & Data) کلیک کنید.

اگر قالب شما از استایل‌های سفارشی استفاده می‌کند، بررسی فایل‌های CSS نیز پیشنهاد می‌شود. در صورت نیاز به افزودن استایل‌های تصحیح‌کننده می‌توانید راهنماهای تکه‌کدهای CSS را مطالعه کنید.

مقایسه روش‌های جایگزینی آدرس در وردپرس

جدول زیر به شما کمک می‌کند متناسب با حجم سایت و سطح دسترسی خود، بهترین ابزار را برای اصلاح لینک‌های داخلی انتخاب کنید:

عیب‌یابی سریع و رفع مشکلات رایج

اگر وب‌سایت شما علاوه بر اسکریپت‌های وردپرس از کدهای جاوااسکریپت اختصاصی برای هدایت آدرس‌ها استفاده می‌کند، بخش تکه‌کدهای جاوااسکریپت می‌تواند به شما در مدیریت ریدایرکت‌ها کمک کند.

پرسش‌های متداول