ویجتکور چیست؟
معرفی افزونهی WidgetCore برای المنتور؛ مجموعهی ویجتهای کاربردی از جمله «سوالات متداول» با اسکیمای FAQPage و «جستجوی زنده» با شورتکد، همراه با پیشنیازها و مسیر مطالعهی مستندات.
ویجتکور (WidgetCore) یک افزونهی رایگان و متنباز برای وردپرس است که مجموعهای از ویجتهای کاربردی و آمادهی استفاده به المنتور اضافه میکند؛ از جمله آکاردئون سوالات متداول با خروجی ساختیافتهی FAQPage و جستجوی زنده که نتایج را بدون بارگذاری مجدد صفحه نشان میدهد و با شورتکد [wgcr_search] هم در هر جای سایت قابل استفاده است. هر ویجت افزونه صفحهی راهنمای مستقل خودش را در همین مستندات دارد و مجموعه با هر نسخه بزرگتر میشود.
تمرکز افزونه بر سه چیز است: دسترسپذیری واقعی (کیبورد، ARIA و کاهش حرکت)، پشتیبانی کامل از فارسی و راستبهچپ (ترجمههای fa_IR و en_US داخل بسته) و سبک بودن (بدون کتابخانهی جاوااسکریپت خارجی و بدون درخواست اضافه).
ویجتهای افزونه
در یک نگاه
| مورد | مقدار |
|---|---|
| نسخهی جاری | 0.0.7 |
| تعداد ویجتها | 2 |
| رشتههای ترجمهشده | 192 |
| حداقل وردپرس | 6.7 |
| حداقل PHP | 7.4 |
| افزونهی لازم | المنتور (Elementor) |
| آزمایششده با | وردپرس 7.1.2 و المنتور 4.3.2 |
| پروانه | GPL-2.0-or-later |
| دامنهی متنی | widgetcore |
| شورتکد | [wgcr_search] |
| مسیر REST | /wp-json/wgcr/v1/search |
مسیر پیشنهادی مطالعه
پیشنیازها را بررسی کنید
وردپرس 6.7 به بالا، PHP 7.4 به بالا و فعال بودن المنتور. جزئیات در صفحهی پیشنیازها و سازگاری.
افزونه را دانلود و نصب کنید
بستهی ZIP را از صفحهی دانلود بگیرید و طبق راهنمای نصب فعال کنید.
اولین ویجت را روی صفحه بگذارید
در ویرایشگر المنتور، دستهی «ویجتهای WidgetCore» را باز کنید و ویجت دلخواه را بکشید.
رفتار ویجت را تنظیم کنید
برای جستجو، حالتهای نمایش و صفحهبندی را ببینید؛ برای سوالات متداول، بخش ویجت FAQ.
بهروز بمانید
بهروزرسانی مستقیم از مخزن گیتهاب انجام میشود؛ راهنما در صفحهی بهروزرسانی.
ساختار افزونه
افزونه از چند بخش کوچک و مستقل تشکیل شده است؛ دانستن این بخشها برای عیبیابی کمک میکند:
| بخش | نقش |
|---|---|
widgetcore.php | ثبت دستهی ویجتها، بارگذاری ترجمهها و ثبت داراییها |
widgets/class-faq-widget.php | ویجت سوالات متداول، استایل و اسکریپت درونخطی آن |
widgets/class-search-widget.php | ویجت جستجوی زنده و همهی کنترلهای آن |
includes/search/search-shared.php | منطق مشترک جستجو، شورتکد و رندر خروجی |
includes/search/rest-search.php | مسیر REST جستجو و پارامترهای آن |
includes/update/github-updater.php | بهروزرسانی از مخزن گیتهاب |
assets/search/search.css و search.js | ظاهر و رفتار سمت کاربر جستجو |
languages/ | فایلهای ترجمهی fa_IR، en_US و الگوی .pot |
چه چیزی در افزونه نیست
- هیچ کتابخانهی جاوااسکریپت یا CSS خارجی بارگذاری نمیشود؛ همهچیز داخل بسته است.
- هیچ دادهای به سرور شخص ثالثی فرستاده نمیشود. تنها درخواست شبکهی افزونه، همان REST داخلی وردپرس و (هنگام بررسی بهروزرسانی) API گیتهاب است.
- ویجتها فقط داخل المنتور ثبت میشوند؛ اگر المنتور غیرفعال باشد، افزونه چیزی به سایت اضافه نمیکند.