سوالات متداول مخزن خالقی

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

چرا افزونه‌ها یا تم‌ها نصب نمی‌شوند؟

• بررسی کنید که تنظیمات API مخزن صحیح باشد
  
• مطمئن شوید اتصال به اینترنت پایدار است
  
• کش افزونه را پاک کنید و دوباره تلاش کنید
  
• از سازگاری نسخه PHP و وردپرس اطمینان حاصل کنید
  



چرا به‌روزرسانی‌ها اعمال نمی‌شوند؟


• بررسی کنید که "بررسی خودکار به‌روزرسانی" فعال باشد
  
• کش وردپرس را پاک کنید
  
• از صفحه "به‌روزرسانی‌ها" در پیشخوان وردپرس استفاده کنید
  
• وضعیت اتصال به مخزن را بررسی کنید
  



چگونه سرعت نصب را افزایش دهیم؟


• کش افزونه را فعال نگه دارید
  
• از اتصال اینترنت سریع استفاده کنید
  
• تعداد درخواست‌های همزمان را محدود کنید
  
• تنظیمات کش را در مخزن خالقی > تنظیمات بررسی کنید
  



چگونه حجم داده‌های دانلود را کاهش دهیم؟


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



چرا خطای اتصال به API رخ می‌دهد؟


• URL API را در تنظیمات بررسی کنید
  
• از دسترسی سرور به اینترنت اطمینان حاصل کنید
  
• کش را پاک کنید و دوباره تلاش کنید
  
• لاگ‌های خطا را در debug.log بررسی کنید
  



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


• از تب «خالقی» در نصب‌کننده‌ها استفاده کنید
  
• جستجو با نام افزونه یا تم را امتحان کنید
  
• از دسته‌بندی‌ها برای فیلتر استفاده کنید
  



آیا افزونه باعث سنگین شدن سایت می‌شود؟


• خیر، با بهینه‌سازی نسخه 0.0.8 مصرف منابع به شدت کاهش یافته
  
• کش هوشمند باعث کاهش ۶۰٪ درخواست‌ها می‌شود
  
• محدودیت نرخ درخواست‌ها از فشار روی سرور جلوگیری می‌کند
  
• معماری ماژولار مصرف حافظه را کاهش می‌دهد
  



چرا آیکون افزونه‌ها در صفحه به‌روزرسانی نمایش داده نمی‌شود؟


• این مشکل در نسخه 0.0.10 کاملاً رفع شده است
  
• آیکون‌ها اکنون در transient به‌روزرسانی گنجانده می‌شوند
  
• اگر مشکل ادامه داشت، کش را پاک کنید و صفحه را رفرش کنید
  
• لاگ‌های debug.log را برای عیب‌یابی پردازش آیکون بررسی کنید
  



چگونه می‌توان وضعیت فعلی را مشاهده کرد؟


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

تغییرات نسخه مخزن خالقی

📦 شاخه 0.4.x

0.4.1 (رفع خطاهای رابط و بومی‌سازی کامل)

• 🐛 رفع خطا: آکاردئون‌های تنظیمات اکنون در سمت سرور بسته رندر می‌شوند و تنها در صورت پیوند مستقیم (deep-link) باز می‌شوند؛ میان آکاردئون‌های کنارهم فقط یک حاشیه نمایش داده می‌شود.
  
• 🌍 بومی‌سازی: برچسب زبانه «وضعیت» و عنوان «گزارش مشکل خالقی» اکنون قابل ترجمه هستند (پیش از این استخراج‌گر به آن‌ها دسترسی نداشت)؛ فایل‌های ترجمه POT و fa_IR/nl_NL بازتولید و به‌طور کامل ترجمه شدند.
  



0.4.0 (بازطراحی رابط مدیریتی و یکپارچه‌سازی با سلامت سایت وردپرس)


• 🎨 بازطراحی: کل رابط مدیریتی اکنون یک صفحه واحد «مخزن خالقی» زیر منوی تنظیمات وردپرس است و با سبک صفحه‌ی Site Health نمایش داده می‌شود؛ سه زبانه دارد — وضعیت (وضعیت زنده اتصال به‌همراه واقعیت‌های محیط و ابزارهای عیب‌یابی)، مجوزها و تنظیمات. منوی سطح بالا و صفحه‌های جداگانه حذف شدند.
  
• 🩺 جدید: بررسی‌های مخزن از طریق فیلتر site_status_tests در سیستم «سلامت سایت» هسته (ابزارها ← سلامت سایت) ثبت می‌شوند — بررسی‌های مستقیم (نسخه افزونه، تنظیمات به‌روزرسانی، کش کاتالوگ، مجوزها، حفاظت پیش‌بررسی، کرون، قابلیت نوشتن پوشه‌ها) در صفحه وضعیت رندر می‌شوند و بررسی زنده اتصال API به‌صورت تست ناهمزمان از طریق نقطه پایانی سلامت هسته اجرا می‌شود.
  
• ℹ️ جدید: بخش اشکال‌زدایی «مخزن خالقی» با نسخه افزونه/وردپرس/PHP، شناسه نمونه، آدرس پایه API، کش و وضعیت قابلیت‌ها در صفحه اطلاعات سلامت سایت نمایش داده می‌شود.
  



📦 شاخه 0.3.x





0.3.12 (رفع خطای به‌روزرسانی: سازگاری با پشتیبان‌گیری ارتقای وردپرس)


• 🐛 رفع خطا: به‌روزرسانی افزونه‌های مخزنی دیگر با خطای «نمی‌توان نسخه قدیمی را به پوشه upgrade-temp-backup منتقل کرد» در وردپرس 6.3+ شکست نمی‌خورد. نصاب قبلاً پوشه‌ی مقصد را داخل هوک upgrader_source_selection حذف می‌کرد، پیش از آنکه هسته نسخه‌ی قدیمی را برای بازگشت پشتیبان‌گیری کند؛ اکنون حذف مقصد به هسته سپرده می‌شود و فقط در جریان‌های نصب تازه/سفارشی خود نصاب پاک‌سازی می‌کند.
  



0.3.11 (سخت‌سازی پیش‌بررسی و بومی‌سازی)


• 🐛 رفع خطا: سخت‌سازی پیش‌بررسی سلامت بسته‌ها — خواندن نسخه از داخل کامنت DocBlock و تحمل فایل‌های خالی؛ رفع شکست «ادامه با وجود خطا» هنگام حذف padding از base64 توسط add_query_arg؛ بررسی فقط هنگام فعال بودن Upgrader مطابق (پلاگین/قالب)؛ پاک‌سازی کش مخزن دیگر وضعیت ردشده/اجبار را پاک نمی‌کند؛ هدایت صحیح به صفحه‌ی مدیریت پس از اجبار نصب.
  
• 🌍 بومی‌سازی: تمام متن‌های رابط پیش‌بررسی به‌صورت منبع انگلیسی نوشته شد و ترجمه‌های fa_IR و nl_NL بازتولید شد؛ منو و اعلان‌ها اکنون با زبان سایت نمایش داده می‌شوند.
  



0.3.10 (پیش‌بررسی سلامت بسته‌ها)


• 🛡️ جدید: پیش‌بررسی سلامت برای نصب/به‌روزرسانی افزونه‌ها و قالب‌های مخزنی؛ پیش از جابه‌جایی هر فایل، بسته از نظر خطای Parse بررسی می‌شود و در بروزرسانی بسته‌های فعال، بارگذاری امن سایت از طریق loopback تأیید می‌شود تا در صورت خطای مرگبار، وردپرس نسخه‌ی قبلی را بازیابی کند.
  
• 🧭 جدید: گزینه‌ی «بسته‌های آسیب‌رسان» در تنظیمات (غیرفعال / فقط بررسی سینتکس / بررسی سینتکس + بارگذاری امن)؛ به‌طور پیش‌فرض حالت کامل فعال است و در صورت ردشدن بسته، می‌توان از طریق «ادامه با وجود خطا» نصب را به‌اجبار انجام داد.
  



0.3.9 (رفع خطای مرگبار از بسته‌ی مبهم‌سازی‌شده)


• 🐛 رفع خطا: خطای مرگبار هنگام بارگذاری/فعال‌سازی که از بسته‌ی توزیع مبهم‌سازی‌شده ناشی می‌شد برطرف شد؛ خروجی مبهم‌سازی سنگین اکنون بدون خطا اجرا می‌شود و رفتار زمان اجرا بدون تغییر است.
  



0.3.8 (ارتقای امنیتی: انتشار مقاوم در برابر دستکاری)


• 🛡️ امنیت: بسته‌ی توزیع‌شده با مبهم‌سازی سنگین کد (heavy obfuscation) منتشر می‌شود تا در برابر دستکاری و تحلیل کد مقاوم باشد؛ رفتار زمان اجرا بدون تغییر است.
  



0.3.7 (بهینه‌سازی عملکرد: کش منفی، ویجت غیرمسدودکننده، زمان‌بندی درخواست)


• ⚡ عملکرد:
  
- شکست درخواست‌های مخزن کوتاه‌مدت کش می‌شود (۶۰ ثانیه؛ تا ۵ دقیقه اگر سرور `Retry-After` بدهد)؛ در زمان نامرتب بودن API، صفحات مدیریت دیگر در هر بازدید مسدود نمی‌شوند و پس از بازگشت مخزن هجوم درخواست ایجاد نمی‌شود.
- کاهش مهلت شبکه‌ی خوراک مخزن از ۱۰ به ۶ ثانیه.
- ویجت پیشخوان هنگام سرد بودن کش، رندر صفحه را مسدود نمی‌کند؛ وضعیت به‌صورت غیرهمزمان از طریق درخواست AJAX احرازشده بارگذاری و فقط برای مدیران نمایش داده می‌شود.



0.3.6 (سخت‌سازی امنیتی: محدودسازی پاک‌سازی کش و escape بخش‌های قالب)


• 🛡️ امنیت:
  
- پاک‌سازی کش از مسیر `admin_init` فقط برای مدیران (`manage_options`) و تنها هنگام ارجاع به افزونه‌ی نصب‌شده انجام می‌شود.
- تازه‌سازی وضعیت افزونه‌ها به سطح دسترسی نصب افزونه (`install_plugins`) قفل شد.
- بخش‌های توضیحات قالب در پاسخ‌های API قالب‌ها به‌وضوح با `wp_kses_post` پاک‌سازی می‌شوند.



0.3.5 (انتشار امنیتی: اعتبارسنجی بارگیری‌ها و کنترل دسترسی تم‌ها)


• 🔒 امنیت:
  
- پذیرش آدرس بسته‌ها/لینک‌های دانلود فقط از میزبان‌های معتمد (قابلیت تنظیم با فیلتر `khaleghi_repository_allowed_package_hosts`).
- محدودسازی AJAX نمایش تم‌ها (`wp_ajax_query-themes`) به سطح دسترسی `install_themes`.
- پاک‌سازی پوشه افزونه مقصد هنگام نصب فقط در صورت دانلود واقعی از مخزن خالقی.

• 🧹 بهسازی: حذف اسناد زائد و تصاویر تکراری؛ نگهداری آیکون زمان-اجرا `assets/plugin-icon.svg`.
  



0.3.4 (انتشار یکپارچه و رفع کامل هشدارهای PHP)


• 🐛 رفع خطا:
  
- انتشار قطعی از مانیفست واحد پروژه.
- تضمین وجود آرایه `icons` (با نماد جایگزین `assets/plugin-icon.svg`) و محافظت از فیلدهای فراداده با `??` جهت رفع هشدارهای PHP هسته.



0.3.3 (رفع هشدارهای PHP برگه‌ی نصب برای افزونه‌های بدون آیکون)


• 🐛 رفع خطا: تضمین وجود آرایه `icons` در کارت‌های افزونه برگه نصب و استفاده از نماد جایگزین `assets/plugin-icon.svg`.
  



0.3.0 (بهینه‌سازی عملکرد)


• ⚡ بهبود عملکرد:
  
- حذف `wp_cache_flush()`های مخرب و جایگزینی با پاک‌سازی هدفمند transient/option.
- عدم بارگذاری بخش‌های اداری در درخواست‌های فرانت‌اند.
- خواندن گزینه‌های `Config` یک‌بار در هر درخواست/سایت.
- بررسی وضعیت برگه نصب با یک درخواست AJAX دسته‌ای (batch).
- کش‌کردن نتیجه وضعیت پیشخوان و بررسی اتصال در transientهای کوتاه‌مدت.
- رندر صفحه‌ی «مجوزها» از وضعیت کش‌شده و افزایش فاصله‌ی تأیید مجوز از ۵ دقیقه به ۱ ساعت.
- واگذاری بررسی فوری به‌روزرسانی به اجرای پس‌زمینه (cron).

---



📦 شاخه 0.2.x





0.2.6 (رفع تداخل اسلاگ‌های هم‌پیشوند)


• 🐛 رفع خطا: تطبیق دقیق و هر-اسلاگ افزونه‌ها جهت جلوگیری از تداخل اسلاگ‌های هم‌پیشوند (مانند `rasaadsync` و `rasaadsyncserver`).
  



0.2.4 (ترجمه‌های کامل و به‌روز)


• 🌐 ترجمه: بازتولید فایل‌های ترجمه (POT/PO/MO) با WP-CLI و ترجمه کامل به فارسی (`fa_IR`) و هلندی (`nl_NL`).
  



0.2.3 (داشبورد «محصولات من» و حذف صفحات تکراری مخزن)


• 🎨 رابط کاربری:
  
- ایجاد داشبورد «محصولات من» با نوار خلاصه‌ی زنده و جدول گروه‌بندی‌شده افزونه‌ها/قالب‌ها.
- حذف زیرمنوها و صفحه‌های تکراری «افزونه‌ها» و «قالب‌ها».
- تعریض صفحه‌ی تنظیمات به تمام عرض ستون محتوا.



0.2.2 (بازطراحی کامل منو و صفحه‌ی تنظیمات)


• 🎨 رابط کاربری:
  
- شروع منوی مدیریتی با هاب «محصولات من».
- بازطراحی کامل صفحه تنظیمات یکپارچه (بخش‌های اتصال، همگام‌سازی و تشخیص).



0.2.1 (صفحه‌ی مدیریتی «مجوزها»)


• ✨ امکانات جدید:
  
- افزودن صفحه «مجوزها» با قابلیت نمایش وضعیت، تاریخ انقضا، تعداد فعال‌سازی و دکمه‌ی «بررسی مجدد» زنده.
- افزودن کارت و پیوند «مجوزهای من» به صفحه اصلی.



0.2.0 (سیستم مدیریت مجوز)


• ✨ امکانات جدید:
  
- افزودن زیرسیستم مدیریت مجوز (`Khaleghi\WP\Repository\License`) با API واحد برای افزونه‌ها و تم‌ها.
- پشتیبانی از تأیید token-first، تبادل توکن/کلید، پنجره تحمل ۷۲ ساعته آفلاین، و کش وضعیت ۵ دقیقه‌ای.
- راهنمای کامل توسعه‌دهندگان در `docs/DOCUMENTATION.md`.

---



📦 شاخه 0.1.x





0.1.10 تا 0.1.12 (بهبودهای فراداده و رفع اشکالات جزئی)


• 🔧 0.1.12: اصلاح پیوند بازبینی/امتیاز پوسته به `/themes/` و ترجیح `homepage` مخزن به `author_url`.
  
• ✨ 0.1.11: مصرف فراداده‌های جدید سمت سرور (امتیازها، تعداد نصب فعال، تاریخ ساخت/به‌روزرسانی).
  
• 🔧 0.1.10: رفع گیرکردن بی‌پایان دکمه «در حال به‌روزرسانی...» با افزودن `data-plugin` و URL استاندارد upgrade.
  



0.1.5 تا 0.1.9 (اصلاح جستجو و اتصال API)


• 🔧 0.1.9: حذف میان‌بر نادرست AJAX و ادغام درست نتایج جستجوی پوسته با وردپرس.اُرج.
  
• ✨ 0.1.8: ادغام نتایج مخزن خالقی در جستجوی بومی پوسته‌ها و پلاگین‌های وردپرس.
  
• ✨ 0.1.7: افزودن پیوند «مخزن خالقی» به ردیف فیلتر/مرتب‌سازی صفحه «افزودن پوسته‌ها».
  
• 🔧 0.1.6: اصلاح رندر متادیتا، نویسنده و پرچم‌های سازگاری پوسته‌ها در AJAX.
  
• 🔧 0.1.4 & 0.1.5: رفع خطای API Base URL خالی و خواندن مقدار API در هر درخواست.
  



0.1.0 تا 0.1.3 (بازمعماری کامل و رفع خطاهای پایه)


• 🏗️ بازمعماری: بازنویسی کامل با PHP 8.1+، فضای نام `Khaleghi\WP\Repository` و autoloader PSR-4.
  
• ⚡ عملکرد و امنیت: افزودن Cron زنده، رفع باگ‌های SQL Prepared Statement و CSRF.
  
• 🔧 رفع خطاها: رفع خطای Fatal در `fixPluginActionLinks` (پذیرش array/object)، رفع error خاموش در فیلتر transients، و اصلاح بررسی CORS سمت سرور (0.1.1).
  

---



📜 نسخه‌های اولیه (پیش از 0.1.0)




• v0.0.10: رفع مشکلات نمایش آیکون افزونه‌ها در برگه به‌روزرسانی هسته.
  
• v0.0.8 & v0.0.9: بهبود نمایش اسکرین‌شات‌ها، کش هوشمند و ساختار مجدد.
  
• v0.0.7 / v0.0.7.1: معماری ماژولار و افزودن تب «اهور» برای تم‌ها و افزونه‌ها.
  
• v0.0.6.x: رفع مشکلات نصب/فعال‌سازی، تطبیق case-insensitive و یکپارچه‌سازی به‌روزرسانی‌ها.
  
• v0.0.1: انتشار اولیه.