WidgetCoreمستندات WidgetCore

نصب و فعال‌سازی

راهنمای گام‌به‌گام نصب افزونه‌ی WidgetCore در وردپرس با سه روش (بارگذاری ZIP، FTP و WP-CLI)، فعال‌سازی، بررسی ویجت‌ها در المنتور و حذف افزونه.

نصب افزونه مثل هر افزونه‌ی دیگر وردپرس است. در این صفحه سه روش، بررسی نتیجه و رفتار حذف افزونه توضیح داده شده است.

روش 1 — بارگذاری از پیشخوان (پیشنهادی)

  1. بسته را دانلود کنید

    فایل widgetcore.zip را از صفحه‌ی دانلود بگیرید. آن را از حالت فشرده خارج نکنید.

  2. به بخش افزونه‌ها بروید

    در پیشخوان وردپرس: «افزونه‌ها → افزودن افزونه» و سپس دکمه‌ی «بارگذاری افزونه» در بالای صفحه.

  3. فایل را انتخاب و نصب کنید

    همان فایل ZIP را انتخاب کنید و «هم‌اکنون نصب کن» را بزنید.

  4. فعال کنید

    بعد از نصب، روی «فعال‌کردن افزونه» کلیک کنید.

روش 2 — کپی دستی با FTP یا فایل‌منیجر

  1. بسته را از حالت فشرده خارج کنید

    پوشه‌ی widgetcore/ به دست می‌آید.

  2. پوشه را در wp-content/plugins/ بگذارید

    مسیر نهایی باید wp-content/plugins/widgetcore/widgetcore.php باشد.

  3. افزونه را فعال کنید

    در «افزونه‌ها» روی «فعال‌سازی» بزنید.

روش 3 — WP-CLI

bash
wp plugin install "https://github.com/WidgetCore/Plugin/releases/latest/download/widgetcore.zip" --activate

اگر المنتور نصب است ولی فعال نیست، آن را هم فعال کنید:

bash
wp plugin activate elementor
wp plugin list --status=active --fields=name,version,update_version

فعال‌سازی چه چیزی را تغییر می‌دهد

اتفاقهوکنتیجه
ثبت دسته‌ی ویجتelementor/elements/categories_registeredدسته‌ی «ویجت‌های WidgetCore» در ویرایشگر
ثبت ویجت‌هاelementor/widgets/registerهمه‌ی ویجت‌های مجموعه (فهرست در صفحه‌ی ویجت‌ها)
ثبت دارایی‌هاwp_enqueue_scripts (اولویت 5)search.css و search.js فقط در صفحه‌هایی که لازم است
بارگذاری ترجمهinit (اولویت 1)متن‌ها به زبان سایت
ثبت مسیر RESTrest_api_init/wp-json/wgcr/v1/search
اتصال به‌روزرسانupdate_plugins_github.comبررسی نسخه‌ی جدید از گیت‌هاب

افزونه هیچ جدولی در پایگاه‌داده نمی‌سازد، هیچ گزینه‌ای (option) ذخیره نمی‌کند و هیچ فایل رسانه‌ای اضافه نمی‌کند.

بررسی نصب

  1. ویجت‌ها را در المنتور ببینید

    یک صفحه را با المنتور باز کنید؛ باید دسته‌ی «ویجت‌های WidgetCore» با ویجت‌های افزونه در پنل باشد.

  2. REST را آزمایش کنید

    آدرس https://example.com/wp-json/wgcr/v1/search?q=test&limit=2 را باز کنید؛ باید آرایه‌ی JSON برگردد.

  3. نسخه را ببینید

    در «افزونه‌ها» شماره‌ی نسخه‌ی WidgetCore باید 0.0.7 باشد.

اگر هر کدام از این‌ها کار نکرد، صفحه‌ی عیب‌یابی را ببینید.

غیرفعال‌سازی و حذف

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

نصب در سایت‌های چندزبانه

افزونه خودش چندزبانه نیست؛ زبان متن‌ها از زبان جاری وردپرس (determine_locale()) می‌آید. اگر از افزونه‌های چندزبانه استفاده می‌کنید:

  • در هر زبان یک ویجت جستجوی جداگانه بگذارید و «منبع» آن را روی پست‌تایپ همان زبان تنظیم کنید.
  • اگر ترجمه‌ی شخصی‌سازی‌شده می‌خواهید، فایل .mo خود را در wp-content/languages/plugins/ بگذارید؛ این مسیر بر ترجمه‌ی داخل بسته اولویت دارد (توضیح کامل در زبان و ترجمه).