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

پرسش‌هایی که بیش از بقیه پرسیده می‌شوند. اگر پاسخ پرسش خود را اینجا پیدا نکردید، صفحه‌ی عیب‌یابی را ببینید.

افزونه رایگان است؟

بله. افزونه با پروانه‌ی GPL-2.0-or-later منتشر می‌شود، هیچ نسخه‌ی پولی یا امکانات قفل‌شده ندارد و همه‌ی کنترل‌ها در اختیار شماست. متن کامل پروانه داخل بسته‌ی نصب (LICENSE) است.

افزونه به چه چیزهایی نیاز دارد؟

وردپرس 6.7 یا جدیدتر، PHP 7.4 یا جدیدتر و افزونه‌ی المنتور. بدون المنتور، افزونه فعال می‌ماند ولی هیچ ویجتی ثبت نمی‌کند و هیچ سرباری روی سایت نمی‌گذارد. جزئیات در پیش‌نیازها و سازگاری.

آیا افزونه روی سایت‌های چپ‌به‌راست هم کار می‌کند؟

بله. استایل‌ها با خواص منطقی CSS نوشته شده‌اند، پس با تغییر جهت سند چیدمان درست برعکس می‌شود. ترجمه‌ی انگلیسی هم همراه بسته است و با تغییر زبان سایت فعال می‌شود.

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

ابتدا مطمئن شوید المنتور فعال است، سپس صفحه‌ی ویرایشگر را کامل تازه کنید (با Ctrl + Shift + R). ویجت‌ها در دسته‌ی «ویجت‌های WidgetCore» قرار دارند و با جستجوی واژه‌های wgcr، «جستجو» یا «سوالات متداول» هم پیدا می‌شوند. اگر باز هم دیده نشدند، جدول عیب‌یابی نصب را ببینید.

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

سه علت رایج: عبارت کمتر از دو نویسه است (جستجو از دو نویسه شروع می‌شود)، REST API سایت مسدود شده است، یا یک بهینه‌ساز جاوااسکریپت فایل search.js را با تأخیر بارگذاری می‌کند. مسیر /wp-json/wgcr/v1/search?q=test را در مرورگر باز کنید؛ اگر JSON نگرفتید، REST مسدود است.

تفاوت «حالت لیست» و «حالت نمایش در صفحه» چیست؟

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

می‌توانم ظاهر نتایج را کاملاً خودم بسازم؟

بله، دو راه دارید: استفاده از یک قالب المنتور به‌عنوان قالب نتایج (راه پیشنهادی)، یا بازنویسی استایل با متغیرهای CSS و کلاس‌های ویجت. در نتایج قالبی، افزونه هیچ پوشش یا استایلی اضافه نمی‌کند تا ظاهر صد درصد از قالب شما بیاید. راهنماها: قالب‌های المنتور و استایل‌دهی.

جستجو در پست‌تایپ سفارشی کار می‌کند؟

بله. در بخش «کوئری»، «منبع» را روی پست‌تایپ سفارشی بگذارید و اسلاگ پست‌تایپ را در فیلد «پست‌تایپ سفارشی» بنویسید. فقط پست‌تایپ‌های عمومی و قابل‌جستجو مجازند؛ attachment و elementor_library همیشه بیرون می‌مانند.

ویجت سوالات متداول چه اثری روی سئو دارد؟

وقتی کنترل «اسکیمای FAQ (JSON-LD)» روشن باشد، یک بلوک FAQPage با همه‌ی پرسش‌ها و پاسخ‌های همان ویجت در صفحه چاپ می‌شود. این داده‌ی ساخت‌یافته به موتورهای جستجو کمک می‌کند پرسش‌ها را در نتایج نشان دهند. اگر چند ویجت در یک صفحه باشد، فقط اولین ویجت اسکیما می‌گیرد.

چرا فقط اولین ویجت سوالات متداول اسکیما می‌دهد؟

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

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

از نسخه‌ی 0.0.7 به بعد، به‌روزرسانی مستقیماً از انتشارهای مخزن گیت‌هاب انجام می‌شود؛ بدون کتابخانه‌ی جانبی. در فهرست افزونه‌ها یک پیوند «بررسی به‌روزرسانی» هست و کلید بومی «به‌روزرسانی خودکار» وردپرس هم کار می‌کند. توضیح کامل در به‌روزرسانی.

مخزن گیت‌هاب من خصوصی است. به‌روزرسانی کار می‌کند؟

بله، اگر ثابت WGCR_GITHUB_TOKEN را با یک توکن دارای دسترسی خواندن در wp-config.php تعریف کنید. توکن به‌صورت هدر Authorization: Bearer به درخواست‌های API اضافه می‌شود. توکن را هیچ‌وقت در فایل‌های پوسته یا مخزن عمومی نگذارید.

به‌روزرسانی، تنظیمات ویجت‌ها را پاک می‌کند؟

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

می‌توانم فیلد جستجو را بیرون از المنتور بگذارم؟

بله، با شورت‌کد [wgcr_search]. همه‌ی تنظیمات اصلی به‌صورت ویژگی در دسترس‌اند و می‌توانید آن را داخل محتوا، در الگوی پوسته یا با do_shortcode() در PHP استفاده کنید. مرجع کامل در شورت‌کد جستجو.

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

خیر. تنها درخواست‌های شبکه‌ی افزونه، REST داخلی خود سایت شما و (هنگام بررسی به‌روزرسانی) API گیت‌هاب است. هیچ اسکریپت، فونت یا استایلی از دامنه‌ی خارجی بارگذاری نمی‌شود و هیچ ردیابی انجام نمی‌شود.

افزونه با افزونه‌های کش و بهینه‌سازها سازگار است؟

بله، با دو نکته: مسیر /wp-json/ را از کش کامل صفحه بیرون بگذارید، و فایل search.js را از «تأخیر در اجرا» و «ترکیب» خارج کنید. در غیر این صورت ممکن است جستجو دیر راه بیفتد یا اصلاً کار نکند.

سقف تعداد نتایج چقدر است؟

در هر درخواست حداکثر 50 نتیجه (WGCR_SEARCH_MAX_RESULTS). اگر لازم است سقف را تغییر دهید، همان ثابت را در wp-config.php تعریف کنید؛ این مقدار در ویجت، شورت‌کد و REST اعمال می‌شود.

افزونه چه ویجت‌هایی دارد؟

ویجت‌های افزونه یک مجموعه‌ی روبه‌رشدند: فهرست به‌روز هر ویجت با شناسه و کاربردش در صفحه‌ی ویجت‌ها است و هر ویجت صفحه‌ی راهنمای مستقل خودش را دارد. هم‌اکنون 2 ویجت منتشر شده است؛ همه در دسته‌ی اختصاصی «ویجت‌های WidgetCore» ثبت می‌شوند و فقط در صفحه‌هایی که استفاده شوند دارایی‌هایشان بارگذاری می‌شود.

تغییرات هر نسخه را از کجا ببینم؟

در صفحه‌ی Changelog همین مستندات، و همچنین در بخش یادداشت‌های هر انتشار در گیت‌هاب. هنگام به‌روزرسانی هم همان یادداشت‌ها در صفحه‌ی «جزئیات افزونه» نمایش داده می‌شوند.