عیبیابی
راهنمای عیبیابی افزونهی WidgetCore؛ ویجت دیده نمیشود، جستجو نتیجه نمیدهد، استایلها بهم ریختهاند، بهروزرسانی کار نمیکند و مشکلات عملکرد، همراه با روش تشخیص هر مورد.
این صفحه بر پایهی «نشانه → علت → راهحل» نوشته شده است. اگر نشانهی شما اینجا نیست، از بخش «تشخیص سریع» پایین صفحه شروع کنید.
نصب و فعالسازی
| نشانه | علت | راهحل |
|---|---|---|
| افزونه در فهرست نیست | ساختار پوشه اشتباه است | باید wp-content/plugins/widgetcore/widgetcore.php باشد؛ یک لایه پوشهی اضافه را حذف کنید |
| خطای «هدر افزونه نامعتبر» | فایل اصلی جابهجا شده | widgetcore.php باید در ریشهی پوشهی افزونه باشد |
| فعال میشود ولی ویجتی نیست | المنتور فعال نیست | المنتور را فعال کنید و ویرایشگر را تازه کنید |
| خطای PHP هنگام فعالسازی | نسخهی PHP قدیمیتر از 7.4 | نسخهی PHP را از کنترل پنل میزبان بالا ببرید |
| «این افزونه با نسخهی وردپرس شما سازگار نیست» | وردپرس قدیمیتر از 6.7 | وردپرس را بهروز کنید |
دیدهنشدن ویجتها در ویرایشگر
المنتور فعال است؟
در «افزونهها» وضعیت المنتور را ببینید.
کش ویرایشگر را تازه کنید
با Ctrl + Shift + R صفحهی ویرایشگر را کامل بارگذاری کنید.
دستهی درست را نگاه کنید
ویجتها در دستهی «ویجتهای WidgetCore» هستند؛ در جستجوی پنل
wgcrرا تایپ کنید.تداخل افزونهها را بررسی کنید
بقیهی افزونهها را موقتاً غیرفعال کنید؛ اگر ویجتها برگشتند، افزونهی مخرب را پیدا کنید.
جستجو نتیجه نمیدهد
| نشانه | علت | راهحل |
|---|---|---|
| هیچ اتفاقی نمیافتد | عبارت کمتر از 2 نویسه | دستکم دو نویسه تایپ کنید |
| پیام «خطا در دریافت نتایج» | REST مسدود یا خطای سرور | curl روی /wp-json/wgcr/v1/search?q=test بزنید و کد وضعیت را ببینید |
| پنل باز میشود ولی خالی است | منبع اشتباه یا فیلتر رده خیلی محدود | «منبع» و «دستهها و برچسبها» را بررسی کنید |
| فقط در ویرایشگر کار میکند | بهینهساز جاوااسکریپت | search.js را از ترکیب/تأخیر خارج کنید |
| نتایج قدیمی میماند | کش سمت سرور روی /wp-json/ | مسیر REST را از کش بیرون بگذارید |
| در سایت چندزبانه فقط یک زبان | منبع روی پستتایپ زبان دیگر است | در هر زبان یک ویجت با منبع مناسب بگذارید |
تشخیص سریع REST
curl -s -o /dev/null -w "%{http_code}\n" "https://example.com/wp-json/wgcr/v1/search?q=test"| کد | معنا |
|---|---|
200 | REST سالم است؛ مشکل در سمت مرورگر یا جاوااسکریپت است |
400 | پارامتر q نامعتبر است (کمتر از 2 نویسه) |
401 یا 403 | چیزی REST را محدود کرده است (افزونهی امنیتی یا قوانین سرور) |
404 | مسیر REST مسدود یا پیوندهای یکتا درست نیستند |
500 | خطای سرور؛ لاگ خطای PHP را ببینید |
اگر 404 گرفتید، «تنظیمات → پیوندهای یکتا» را باز کنید و یک بار «نام نوشته» را ذخیره کنید تا قواعد بازنویسی تازه شوند.
ظاهر و استایل
| نشانه | علت | راهحل |
|---|---|---|
| استایلها اعمال نمیشوند | search.css بارگذاری نشده | در ابزار توسعهدهنده ببینید فایل با ?ver=0.0.7 بارگذاری شده یا نه |
| پس از بهروزرسانی ظاهر قدیمی است | کش مرورگر یا CDN | کش CDN را خالی کنید؛ خود افزونه نسخه را به نشانی فایل اضافه میکند |
| ستونها اثر ندارند | حالت نمایش روی «لیست» است | حالت را به «نمایش در صفحه» تغییر دهید |
| کارتها همارتفاع نیستند | «ارتفاع برابر» خاموش است یا کاشی روشن است | کاشی را خاموش و ارتفاع برابر را روشن کنید |
| پنل زیر یک عنصر دیگر پنهان میشود | z-index پوشش سایت | z-index پنل را در CSS سفارشی بالا ببرید (پیشفرض 999) |
| CSS سفارشی اثر نمیکند | وزن انتخابگر کمتر است | انتخابگر را با .wgcr-search شروع کنید |
ویجت سوالات متداول
| نشانه | علت | راهحل |
|---|---|---|
| آیتمها باز نمیشوند | اسکریپت ویجت اجرا نشده | کش را خالی کنید و تداخل بهینهسازها را بررسی کنید |
| همهی آیتمها باز میمانند | حالت روی «آزاد» است | «حالت باز شدن» را روی آکاردئون بگذارید |
| پاسخ کامل دیده نمیشود | ارتفاع پاسخ محاسبه نشده | صفحه را یک بار resize کنید یا کش را خالی کنید؛ اسکریپت ارتفاع را دوباره میسنجد |
| اسکیما در صفحه نیست | کنترل خاموش یا ویجت دوم | کنترل «اسکیمای FAQ» را روشن و ویجت را اول بگذارید |
| آیکون سفارشی نمیچرخد | نوع آیکون سفارشی نیست | «آیکون» را روی «سفارشی (کتابخانه المنتور)» بگذارید |
بهروزرسانی
| نشانه | علت | راهحل |
|---|---|---|
| نسخهی جدید دیده نمیشود | کش 12 ساعتهی وردپرس | پیوند «بررسی بهروزرسانی» را بزنید |
| خطای دانلود بسته | مخزن خصوصی بدون توکن | WGCR_GITHUB_TOKEN را در wp-config.php تعریف کنید |
| مهلت زمانی درخواست | خروجی سرور به api.github.com مسدود است | دسترسی خروجی را باز کنید |
| «جزئیات افزونه» خالی است | انتشار بدون یادداشت | متن یادداشت را در انتشار بنویسید |
| پس از بهروزرسانی افزونه غیرفعال شد | ساختار پوشه در ZIP انتشار | بسته باید پوشهی widgetcore/ داشته باشد؛ از بستهی رسمی انتشار استفاده کنید |
عملکرد
| نشانه | علت | راهحل |
|---|---|---|
| جستجو کند است | limit بزرگ یا orderby="rand" | تعداد نتایج را کم و مرتبسازی را relevance یا date بگذارید |
| هر تایپ یک درخواست میفرستد | انتظار درست | افزونه 250 میلیثانیه تأخیر و لغو درخواست قبلی دارد؛ اگر بیشتر میبینید، بهینهساز را بررسی کنید |
| بار سرور بالاست | شمارش کل نتایج | صفحهبندی را «هیچکدام» یا «بارگذاری با کلیک» بگذارید تا no_found_rows فعال بماند |
| CSS قالب تکرار میشود | قالب در هر نتیجه استایل چاپ میکند | افزونه استایلها را یکجا جمع میکند؛ اگر هنوز تکرار میشود، استایل را در تنظیمات قالب المنتور بگذارید نه درون محتوا |
تشخیص سریع (چکلیست)
نسخهها را ببینید
وردپرس ≥ 6.7، PHP ≥ 7.4، المنتور فعال، WidgetCore نسخهی 0.0.7.
خطاهای PHP را بخوانید
«ابزارها → سلامت سایت» و در صورت نیاز
WP_DEBUG_LOG.REST را آزمایش کنید
curlروی مسیر جستجو؛ کد وضعیت باید 200 باشد.داراییها را ببینید
در تب Network باید
search.cssوsearch.jsبا?ver=بارگذاری شوند.بدون بهینهساز امتحان کنید
موقتاً افزونههای کش/بهینهساز را غیرفعال کنید و دوباره تست کنید.
افزونه را دوباره نصب کنید
چون افزونه دادهای ذخیره نمیکند، حذف و نصب دوباره بیخطر است.