بررسی مشکلات رایج هنگام نصب افزونه ها و رفع آن ها

وردپرس، به عنوان محبوب ترین سیستم مدیریت محتوا، با هزاران افزونه قدرتمند امکان گسترش و شخصی سازی بی نظیری را فراهم می کند. اما گاهی اوقات، همین افزونه ها می توانند به منبعی برای سردرگمی و کلافگی تبدیل شوند، به خصوص زمانی که در مرحله نصب با خطاهای ناگهانی روبرو می شوید. از Memory Exhausted گرفته تا Destination folder already exists، این خطاها می توانند روند کاری شما را متوقف کنند و سوالاتی را در ذهنتان ایجاد کنند که چگونه این مشکل را حل کنید. این مقاله به شما کمک می کند تا با رایج ترین مشکلات هنگام نصب افزونه ها در وردپرس آشنا شوید، علت آنها را درک کنید و با راهکارهای عملی و گام به گام، به راحتی آنها را رفع کنید.

🛡️ تفاوت WordPress.com و WordPress.org نصب افزونه فقط در نسخه .org ممکن است.

⚙️ بررسی دسترسی های نقش کاربری فقط مدیران سایت می توانند افزونه نصب کنند.

تفاوت WordPress.com و WordPress.org (چرا در نسخه رایگان .com افزونه نصب نمی شود؟)

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

در مقابل، WordPress.com یک سرویس میزبانی شده است که توسط شرکت Automattic ارائه می شود. این پلتفرم برای افراد مبتدی یا کسانی که نمی خواهند درگیر جزئیات فنی شوند، گزینه مناسبی است. اما در پلن های رایگان و حتی برخی پلن های پولی آن، شما اجازه نصب افزونه های دلخواه را ندارید. این محدودیت به دلیل ساختار میزبانی و امنیتی این پلتفرم اعمال می شود. اگر سایت شما روی WordPress.com است و می خواهید افزونه نصب کنید، باید به پلن های تجاری و گران قیمت تر ارتقا دهید یا سایت خود را به WordPress.org منتقل کنید که نیازمند تهیه هاست و دامنه مستقل است.

بررسی دسترسی های نقش کاربری (آیا شما ادمین هستید؟)

وردپرس دارای یک سیستم مدیریت نقش کاربری قدرتمند است که به شما امکان می دهد دسترسی های مختلفی را به کاربران سایت خود بدهید. این نقش ها شامل مدیر کل (Administrator)، ویرایشگر (Editor)، نویسنده (Author)، مشارکت کننده (Contributor) و مشترک (Subscriber) می شوند. تنها کاربرانی که نقش مدیر کل (Administrator) را دارند، اجازه نصب، فعال سازی و حذف افزونه ها و قالب ها را دارا هستند. اگر شما مدیر سایت نیستید و صرفاً یک ویرایشگر یا نقش دیگری دارید، گزینه افزودن افزونه (Add New) را در پیشخوان وردپرس خود مشاهده نخواهید کرد.

در چنین شرایطی، باید با مدیر اصلی سایت یا شرکتی که سایت را برای شما طراحی کرده است، تماس بگیرید و درخواست دسترسی مدیر کل را داشته باشید یا از آنها بخواهید که افزونه مورد نظرتان را برای شما نصب کنند. این یک اقدام امنیتی برای جلوگیری از نصب افزونه های مخرب توسط کاربران با دسترسی کمتر است.

خطاهای مربوط به محدودیت منابع (Memory Exhausted)

یکی از رایج ترین خطاهایی که هنگام نصب افزونه های جدید یا حتی در حین کار با وردپرس مشاهده می کنید، خطای Fatal error: Allowed memory size of X bytes exhausted است. این خطا به این معنی است که اسکریپت PHP وردپرس شما به حداکثر میزان حافظه ای که برای آن تعیین شده است، رسیده و دیگر نمی تواند ادامه کار دهد. این محدودیت حافظه توسط تنظیمات سرور (هاست) شما و همچنین تنظیمات هسته وردپرس تعیین می شود.

راه حل: افزایش محدودیت حافظه PHP

برای رفع این مشکل، باید میزان حافظه PHP را افزایش دهید. این کار را می توانید به چند روش انجام دهید:

1. ویرایش فایل wp-config.php:این یکی از ساده ترین روش ها است. به وسیله FTP یا فایل منیجر هاست خود وارد ریشه سایت وردپرسی تان شوید و فایل `wp-config.php` را باز کنید. سپس خط زیر را قبل از خط `/ That’s all, stop editing! Happy blogging. /` اضافه کنید:

   define(‘WP_MEMORY_LIMIT’, ‘256M’);

   این کد، محدودیت حافظه را به 256 مگابایت افزایش می دهد. در صورت لزوم می توانید آن را به ‘512M’ نیز تغییر دهید.
   

2. ویرایش فایل php.ini:اگر به فایل `php.ini` در هاست خود دسترسی دارید (که معمولاً در هاست های اشتراکی این دسترسی محدود است)، می توانید خط زیر را در آن پیدا کرده و مقدار آن را افزایش دهید:

   memory_limit = 256M;

3. تماس با پشتیبانی هاست:اگر با ویرایش فایل ها راحت نیستید یا دسترسی لازم را ندارید، بهترین راه این است که با پشتیبانی شرکت هاستینگ خود تماس بگیرید و از آنها بخواهید که محدودیت حافظه PHP سایت شما را افزایش دهند.

خطای حجم فایل (upload_max_filesize)

گاهی اوقات، هنگام آپلود یک افزونه، با خطایی مانند The uploaded file exceeds the upload_max_filesize directive in php.ini مواجه می شوید. این خطا به این معنی است که فایل افزونه ای که قصد آپلود آن را دارید، از حداکثر حجم مجاز برای آپلود فایل ها در سرور شما بزرگتر است. این محدودیت نیز توسط تنظیمات PHP در سرور شما تعیین می شود.

راه حل: افزایش حداکثر حجم آپلود فایل

برای رفع این مشکل نیز می توانید از روش های مشابه افزایش حافظه PHP استفاده کنید:

1. ویرایش فایل php.ini:اگر به فایل `php.ini` دسترسی دارید، خطوط زیر را پیدا کرده و مقادیر آنها را افزایش دهید (مثلاً به 64M یا 128M):

   upload_max_filesize = 64M;
   post_max_size = 64M;

   توجه داشته باشید که `post_max_size` نیز باید حداقل به اندازه `upload_max_filesize` باشد.
   

2. ویرایش فایل .htaccess:در برخی از سرورها، می توانید این مقادیر را در فایل `.htaccess` که در ریشه سایت شما قرار دارد، تنظیم کنید. خطوط زیر را به انتهای این فایل اضافه کنید:

   php_value upload_max_filesize 64M
   php_value post_max_size 64M

3. تماس با پشتیبانی هاست:باز هم، اگر این روش ها برایتان پیچیده است، با پشتیبانی هاست خود تماس بگیرید و از آنها بخواهید که حداکثر حجم آپلود فایل را برای شما افزایش دهند.

خطاهای مربوط به فایل زیپ و فرمت نامعتبر (PCLZIP_ERR_BAD_FORMAT)

این دسته از خطاها معمولاً زمانی رخ می دهند که فایل افزونه ای که قصد آپلود آن را دارید، مشکل دار است. خطاهایی مانند PCLZIP_ERR_BAD_FORMAT (-10) : Unable to find End of Central Dir Record signature یا The package could not be installed. No valid plugins were found نشان دهنده مشکل در فایل زیپ یا محتوای آن است.

✅ مزایا راه حل های ساده و سریع، افزایش پایداری سایت.

⚠️ محدودیت ها نیاز به دسترسی به هاست، ریسک خطا در صورت عدم دقت.

راه حل: بررسی فایل افزونه

این خطاها معمولاً به یکی از دلایل زیر اتفاق می افتند:

• فایل ناقص یا خراب:ممکن است فایل زیپ افزونه به درستی دانلود نشده باشد یا در حین دانلود آسیب دیده باشد.

  راه حل:افزونه را مجدداً از منبع معتبر آن دانلود کنید و دوباره امتحان کنید.
  

• فایل زیپ اشتباه:گاهی اوقات توسعه دهندگان، فایل های اضافی مانند مستندات، لایسنس یا فایل های ویدیویی را در یک پوشه اصلی زیپ قرار می دهند. در این صورت، شما باید فایل زیپ اصلی افزونه را که معمولاً داخل آن پوشه اصلی قرار دارد، آپلود کنید.

  راه حل:فایل زیپ دانلود شده را از حالت فشرده خارج کنید و ببینید آیا یک فایل زیپ دیگر با نام افزونه در داخل آن وجود دارد یا خیر. معمولاً فایل اصلی افزونه همان فایلی است که نام افزونه را دارد و شامل پوشه های وردپرس مانند `wp-admin` و `wp-content` نیست.
  

• فرمت فایل اشتباه:شما فقط می توانید فایل های با فرمت `.zip` را برای نصب افزونه آپلود کنید. اگر به اشتباه فایل دیگری را آپلود کنید، با خطا مواجه می شوید.

  راه حل:از صحیح بودن فرمت فایل اطمینان حاصل کنید.
  

تکراری بودن پوشه مقصد (Destination folder already exists)

یکی از خطاهایی که ممکن است هنگام نصب افزونه مشاهده کنید، Destination folder already exists است. این خطا به این معنی است که وردپرس قصد دارد افزونه را در پوشه ای نصب کند که از قبل با همان نام در مسیر `wp-content/plugins/` وجود دارد. این مشکل معمولاً در یکی از دو حالت زیر رخ می دهد:

• شما قبلاً این افزونه را نصب کرده اید، اما به دلایلی (مثلاً نصب ناقص یا تداخل) آن را حذف کرده اید، اما پوشه آن به طور کامل پاک نشده است.
• شما سعی در نصب مجدد یک افزونه فعال یا غیرفعال دارید.

راه حل: حذف پوشه افزونه موجود

برای رفع این مشکل، باید پوشه افزونه ای را که در حال حاضر در هاست شما وجود دارد، به صورت دستی حذف کنید. این کار را از طریق فایل منیجر هاست یا FTP انجام دهید:

1. با استفاده از FTP یا فایل منیجر هاست خود وارد مسیر `wp-content/plugins/` شوید.
2. پوشه ای که نام آن با افزونه ای که قصد نصب آن را دارید، یکسان است (مثلاً `akismet` برای افزونه Akismet) را پیدا کنید.
3. این پوشه را حذف کنید.
4. سپس مجدداً برای نصب افزونه از طریق پیشخوان وردپرس اقدام کنید.

گم شدن پوشه موقت (Missing a temporary folder)

خطای Missing a temporary folder یک خطای کمتر رایج اما آزاردهنده است که معمولاً به دلیل پیکربندی نادرست PHP در سرور شما رخ می دهد. وردپرس برای آپلود فایل ها نیاز به یک پوشه موقت دارد تا فایل های آپلود شده را به طور موقت در آن ذخیره کند. اگر این پوشه تعریف نشده باشد یا دسترسی لازم را نداشته باشد، با این خطا مواجه می شوید.

راه حل: تعریف پوشه موقت

این مشکل معمولاً نیاز به دسترسی به فایل `wp-config.php` دارد:

1. با استفاده از FTP یا فایل منیجر هاست خود وارد ریشه سایت وردپرسی تان شوید و فایل `wp-config.php` را باز کنید.
2. خط زیر را قبل از خط `/ That’s all, stop editing! Happy blogging. /` اضافه کنید:

   define(‘WP_TEMP_DIR’, dirname(__FILE__) . ‘/wp-content/temp/’);

3. سپس یک پوشه با نام `temp` در مسیر `wp-content` ایجاد کنید.
4. اگر این کار مشکل را حل نکرد، ممکن است نیاز باشد با پشتیبانی هاست خود تماس بگیرید تا تنظیمات `sys_temp_dir` در `php.ini` را بررسی کنند.

مشکلات شبکه چندسایته (Multisite)

اگر سایت وردپرسی شما بخشی از یک شبکه چندسایته (Multisite) است، ممکن است نتوانید افزونه ها را به طور مستقیم نصب کنید. در یک شبکه چندسایته، فقط مدیر شبکه (Network Administrator) می تواند افزونه ها را نصب و فعال کند. این افزونه ها سپس می توانند توسط مدیران سایت های فردی در شبکه فعال یا غیرفعال شوند، اما نصب مستقیم آنها از طریق سایت های فرعی امکان پذیر نیست.

راه حل: تماس با مدیر شبکه

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

1 فایل منیجر

2 افزونه زیپ

3 آپلود

4 فعال سازی

نصب دستی از طریق فایل منیجر (هاست)

این روش، رایج ترین و اغلب مطمئن ترین راه برای نصب افزونه ها زمانی است که نصب از طریق پیشخوان وردپرس با مشکل مواجه می شود. شما به پنل هاست خود (مانند cPanel یا DirectAdmin) و دسترسی به فایل منیجر نیاز دارید.

مراحل نصب از طریق فایل منیجر:

1. دانلود فایل افزونه:ابتدا فایل زیپ افزونه مورد نظر را از منبع معتبر آن (مانند مخزن وردپرس یا سایت توسعه دهنده) دانلود کنید.
2. استخراج فایل زیپ:فایل زیپ دانلود شده را در کامپیوتر خود از حالت فشرده خارج کنید. این کار یک پوشه با نام افزونه ایجاد می کند (مثلاً `akismet`). مطمئن شوید که پوشه اصلی افزونه را استخراج کرده اید و نه یک پوشه شامل چندین فایل زیپ.
3. ورود به فایل منیجر هاست:وارد پنل هاست خود شوید و به بخش فایل منیجر (File Manager) بروید.
4. پیمایش به پوشه افزونه ها:به مسیر `public_html/wp-content/plugins/` (یا مسیری مشابه در هاست شما) بروید.
5. آپلود پوشه افزونه:پوشه ای که در مرحله 2 استخراج کرده بودید (مثلاً `akismet`) را به داخل این مسیر آپلود کنید. برخی فایل منیجرها امکان آپلود مستقیم پوشه را دارند. اگر نه، می توانید کل پوشه را زیپ کرده و سپس آپلود کنید و در هاست از حالت فشرده خارج کنید.
6. فعال سازی افزونه:پس از اتمام آپلود، وارد پیشخوان وردپرس خود شوید. به بخش افزونه ها > افزونه های نصب شده بروید. افزونه ای که آپلود کرده اید در لیست ظاهر خواهد شد. روی دکمه فعال کردن کلیک کنید.

نصب از طریق FTP

روش FTP (File Transfer Protocol) نیز بسیار شبیه به نصب از طریق فایل منیجر است و برای کاربران حرفه ای تر که با نرم افزارهای FTP مانند FileZilla کار می کنند، گزینه مناسبی است. این روش به خصوص برای آپلود فایل های بزرگ یا در شرایطی که دسترسی به فایل منیجر هاست محدود است، کارآمد است.

مراحل نصب از طریق FTP:

1. دانلود و استخراج فایل افزونه:همانند روش قبل، فایل زیپ افزونه را دانلود و در کامپیوتر خود از حالت فشرده خارج کنید تا پوشه اصلی افزونه را به دست آورید.
2. اتصال به FTP:یک نرم افزار FTP (مانند FileZilla) را باز کنید و با استفاده از اطلاعات هاست خود (نام کاربری، رمز عبور، هاست و پورت) به سرور متصل شوید. این اطلاعات را می توانید از شرکت هاستینگ خود دریافت کنید.
3. پیمایش به پوشه افزونه ها:در پنل سمت راست نرم افزار FTP (که فایل های سرور را نمایش می دهد)، به مسیر `public_html/wp-content/plugins/` بروید.
4. آپلود پوشه افزونه:پوشه افزونه ای که در کامپیوتر خود استخراج کرده بودید (در پنل سمت چپ نرم افزار FTP) را به داخل پوشه `plugins` در سرور بکشید و رها کنید. منتظر بمانید تا تمامی فایل ها آپلود شوند.
5. فعال سازی افزونه:پس از اتمام آپلود، وارد پیشخوان وردپرس خود شوید و از بخش افزونه ها > افزونه های نصب شده، افزونه را فعال کنید.

فعال سازی Debug Mode در وردپرس

برای فعال سازی Debug Mode، باید فایل `wp-config.php` را ویرایش کنید:

1. با استفاده از FTP یا فایل منیجر هاست خود وارد ریشه سایت وردپرسی تان شوید و فایل `wp-config.php` را باز کنید.
2. خط زیر را پیدا کنید:

   define(‘WP_DEBUG’, false);

3. مقدار `false` را به `true` تغییر دهید:

   define(‘WP_DEBUG’, true);

4. همچنین می توانید دو خط زیر را نیز اضافه کنید تا خطاها به جای نمایش در سایت، در یک فایل لاگ ذخیره شوند:

   define(‘WP_DEBUG_LOG’, true);
   define(‘WP_DEBUG_DISPLAY’, false);

5. پس از ذخیره فایل، دوباره سعی کنید افزونه را نصب کنید. این بار، پیام های خطای دقیق تری (یا در سایت یا در فایل `wp-content/debug.log`) نمایش داده می شود که می تواند به شما در شناسایی مشکل کمک کند.
6. نکته مهم: پس از اتمام عیب یابی، حتماً `WP_DEBUG` را دوباره به `false` تغییر دهید، زیرا فعال نگه داشتن آن می تواند اطلاعات حساسی را به کاربران نمایش دهد و بر عملکرد سایت تأثیر بگذارد.

❓ سوالات متداول