چگونه تداخل افزونه‌ها در وردپرس را پیدا و رفع کنیم؟

فهرست مطالب

• تداخل افزونه در وردپرس چیست و چرا رخ می‌دهد؟
• نشانه های اصلی تداخل افزونه‌ها
• ۴ روش عملی و گام‌به‌گام برای عیب‌یابی و یافتن تداخل
• مقایسه ابزارهای عیب‌یابی تداخل
• راهکارهای دائمی برای رفع و جلوگیری از تداخل
• پرسش‌های متداول
• عیب‌یابی سریع مشکلات رایج

تداخل افزونه‌ها یکی از شایع‌ترین دلایل بروز خطاهای فنی، سفید شدن صفحه (WSoD)، از کار افتادن دکمه‌ها و افت سرعت در وردپرس است. این مشکل زمانی اتفاق می‌افتد که دو افزونه یا یک افزونه و قالب، سعی کنند از تابع PHP، کتابخانه جاوا اسکریپت یا کلاس CSS یکسانی با نسخه‌های متفاوت استفاده کنند.

تداخل افزونه در وردپرس چیست و چرا رخ می‌دهد؟

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

• تداخل توابع PHP (Function Name Collision): وقتی دو افزونه از یک نام تابع یکسان بدون چک کردن وجود آن استفاده می‌کنند.
• تداخل نسخه‌های jQuery و JavaScript: بارگذاری همزمان چند نسخه مختلف از کتابخانه‌های جاوا اسکریپت که باعث شکست عملکرد عناصر تعاملی می‌شود.
• بازنویسی استایل‌های CSS: زمانی که استایل یک افزونه روی عناصر افزونه دیگر یا قالب تاثیر می‌گذارد. اگر به دنبال رفع این مشکلات هستید، استفاده از تکه‌کدهای کاربردی وردپرس می‌تواند به مدیریت بهتر کدهای سایت کمک کند.
• عدم سازگاری با نسخه PHP: به‌روز نبودن کدهای یک افزونه با نسخه PHP فعال روی سرور.

نشانه های اصلی تداخل افزونه‌ها

تداخل افزونه همیشه به شکل یک خطای بزرگ ظاهر نمی‌شود؛ گاهی اوقات اثرات آن به‌صورت پنهان عملکرد سایت را اختلال می‌بخشد. مهم‌ترین نشانه‌ها عبارتند از:

• صفحه سفید مرگ (White Screen of Death) یا نمایش خطای Critical Error.
• از کار افتادن ویرایشگر بلوک (گوتنبرگ) یا صفحه سازهایی مثل المنتور.
• عدم کارکرد درست دکمه‌های آژاکسی (مثل دکمه افزودن به سبد خرید در ووکامرس).
• وجود خطاهای قرمز رنگ در Console مرورگر که مرتبط با کدهای جاوا اسکریپت است.
• بهم‌ریختگی چیدمان و ظاهر بخش‌هایی از سایت.

۴ روش عملی و گام‌به‌گام برای عیب‌یابی و یافتن تداخل

برای پیدا کردن افزونه مشکل‌ساز می‌توانید از روش‌های زیر استفاده کنید. پیشنهاد می‌شود روش‌ها را به ترتیب انجام دهید.

روش اول: استفاده از افزونه Health Check & Troubleshooting (بدون قطعی برای کاربران)

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

1. افزونه Health Check & Troubleshooting را از مخزن وردپرس نصب و فعال کنید.
2. به مسیر ابزارها > سلامت سایت بروید و وارد تب Troubleshooting (عیب‌یابی) شوید.
3. روی دکمه Enable Troubleshooting Mode کلیک کنید. حالا تمامی افزونه‌ها برای شما غیرفعال شده و قالب به قالب پیش‌فرض تغییر می‌کند.
4. از منوی بالای پیشخوان، افزونه‌ها را یکی‌یکی فعال کنید و مشکل سایت را تست کنید تا افزونه متداخل پیدا شود.
5. پس از اتمام کار، حالت عیب‌یابی را غیرفعال کنید.

روش دوم: روش جستجوی باینری (تست نصف به نصف)

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

1. از تمام افزونه‌ها و دیتابیس خود نسخه پشتیبان (Backup) بگیرید.
2. نیمی از افزونه‌های فعال را غیرفعال کنید.
3. سایت را بررسی کنید. اگر مشکل برطرف شد، افزونه مخرب در نیمه غیرفعال‌شده قرار دارد. اگر مشکل باقی بود، در نیمه فعال است.
4. این فرایند نصف کردن را روی گروه دارای مشکل ادامه دهید تا در چند گام کوتاه به دقیقاً یک افزونه برسید.

روش سوم: فعال‌سازی دیباگ وردپرس (WP_DEBUG)

اگر سایت شما با خطای ۵۰۰ یا صفحه سفید مواجه شده و به پیشخوان دسترسی ندارید، باید حالت دیباگ را از طریق هاست (File Manager) فعال کنید تا کد و مسیر دقیق خطا روی صفحه یا در فایل لاگ ذخیره شود.

1. وارد هاست خود شوید و فایل wp-config.php را ویرایش کنید.
2. خط define('WP_DEBUG', false); را پیدا کرده و آن را به شکل زیر تغییر دهید:

حالا خطای دقیق در فایلی به نام debug.log در پوشه wp-content ذخیره می‌شود. با باز کردن این فایل، مسیر دقیق افزونه‌ای که باعث ایجاد Fatal Error شده است را خواهید دید.

روش چهارم: تغییر نام پوشه افزونه‌ها از طریق FTP یا cPanel

وقتی قفل شده‌اید و هیچ دسترسی به مدیریت ندارید، کافیست به مسیر wp-content در هاست رفته و نام پوشه plugins را به plugins-old تغییر دهید. با این کار تمام افزونه‌ها یکباره غیرفعال می‌شوند و دسترسی شما به پیشخوان بازمی‌گردد.

مقایسه ابزارهای عیب‌یابی تداخل

راهکارهای دائمی برای رفع و جلوگیری از تداخل

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

• جایگزینی افزونه: استانداردترین راه، یافتن یک افزونه جایگزین و بهینه‌تر از مخزن رسمی وردپرس است.
• غیرفعال‌سازی اسکریپت‌های مزاحم: اگر دو افزونه فایل JS مشابهی را بارگذاری می‌کنند، می‌توانید با استفاده از تابع wp_dequeue_script یکی از آن‌ها را از مدار خارج کنید. برای مشاهده نمونه این کدهامی‌توانید به بخش مجموعه تکه‌کدهای برنامه‌نویسی مراجعه کنید.
• رفع تداخل استایل‌ها: اگر کلاسی از یک افزونه ظاهر بخش دیگری را خراب کرده است، می‌توانید با اعمال استایل‌های سفارشی CSS در بخش ویرایشگر استایل، اولویت کلاس‌ها را اصلاح کنید.
• ارسال گزارش به توسعه‌دهنده: مشخصات خطا و نام دو افزونه متداخل را برای سازنده افزونه ارسال کنید تا در آپدیت بعدی آن را اصلاح کند.

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

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