نصب نشدن افزونه می‌تواند از محدودیت حساب، بستهٔ نادرست، منابع یا اتصال ناشی شود. اولین قدم، ثبت متن کامل خطاست؛ صرفِ ندیدن دکمهٔ نصب با خطای حافظه یکسان نیست. این راهنما برای وردپرس خودمیزبان است؛ سرویس‌های مدیریت‌شده می‌توانند سیاست متفاوتی داشته باشند.
۱. آیا حساب شما اجازهٔ نصب دارد؟
در شبکهٔ چندسایته، نصب معمولاً به مدیریت شبکه مربوط است. مدیر یک زیرسایت الزاماً همان اختیار را ندارد. در سایت مدیریت‌شده نیز ممکن است سیاست استقرار، تغییر فایل را محدود کرده باشد. برای رفع این وضعیت، محدودیت امنیتی را خودسرانه در wp-config.php خاموش نکنید؛ مسیر مجاز نصب را از مسئول سرویس بگیرید.
۲. پیام حجم را از پیام حافظه جدا کنید
خطای upload_max_filesize مربوط به سقف دریافت فایل است؛ Memory Exhausted به حافظهٔ اجرای PHP مربوط می‌شود. حجم مجازِ ارسال، اندازهٔ کل درخواست و محدودیت وب‌سرور نیز می‌توانند دخیل باشند. افزایش یک عدد لزوماً همهٔ لایه‌ها را تغییر نمی‌دهد. مقدار مؤثر همان سایت را بررسی و تغییر کنترل‌شده را با پشتیبانی هماهنگ کنید.
۳. فایل ZIP درست را انتخاب کرده‌اید؟
بستهٔ فروشنده ممکن است شامل مستندات و ZIP نصب باشد؛ کل بستهٔ چندلایه لزوماً افزونهٔ قابل نصب نیست. منبع رسمی، راهنمای نصب، نسخه و نیازمندی PHP و وردپرس را کنترل کنید. فایل را برای عبور از محدودیت، فقط تغییر نام ندهید و بستهٔ ناشناس را جایگزین نسخهٔ معتبر نکنید.
۴. پوشهٔ مقصد و دسترسی نوشتن
اگر پیام از موجودبودن پوشه یا کپی‌نشدن فایل می‌گوید، نصب قبلی، مالکیت و ظرفیت دیسک را بررسی کنید. پوشهٔ موجود ممکن است نسخهٔ سالمِ در حال استفاده باشد؛ آن را بدون پشتیبان حذف نکنید. مجوز ۷۷۷ یا تغییر مالکیت گسترده راه‌حل عمومی نیست. از پشتیبانی بخواهید نیاز حداقلیِ همان مسیر را بررسی کند.
۵. دانلود یا اتصال قطع شده است؟
نام میزبان مقصد، زمان و پیام شبکه را ثبت کنید. بازشدن صفحه از رایانهٔ شما، اتصال خروجی PHP از هاست را ثابت نمی‌کند. اگر خطا TLS یا timeout است، همان شاخه را بررسی کنید؛ برای عبور از مشکل، اعتبارسنجی گواهی یا فایروال را خاموش نکنید.
نصب دوباره را با برنامه انجام دهید
- نسخهٔ پشتیبان و حالت قبلی افزونه را نگه دارید.
- سازگاری و مراحل مدیریت افزونه در مستندات وردپرس را بررسی کنید.
- فقط یک مسیر نصب را اجرا کنید و تأیید یا خطای نهایی را بخوانید.
- فعال‌سازی را جدا از نصب بدانید و پس از آن، مسیر مهم سایت را آزمون کنید.
برای گزارش نصب نشدن افزونه، نام و نسخه، متن خطای بدون اطلاعات حساس، روش نصب و زمان را ارائه دهید. ارتقای حساب، خرید افزونه یا تعویض هاست را پیش از تشخیص علت، راه‌حل قطعی معرفی نکنید.
راهنمای مرتبط
بازبینی فنی و منابع: ۲۷ مهر ۱۴۰۵. تاریخ انتشار اولیه و مسیر قبلی حفظ شده‌اند.
