WidgetCoreمستندات WidgetCore

شروع سریع

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

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

گام 1 — نصب افزونه

بسته‌ی widgetcore.zip را از صفحه‌ی دانلود بگیرید و در «پیشخوان → افزونه‌ها → افزودن → بارگذاری افزونه» آپلود کنید. سپس فعال‌سازی را بزنید.

گام 2 — پیدا کردن ویجت‌ها

یک صفحه یا برگه را با المنتور باز کنید. در پنل سمت راست (یا چپ در حالت چپ‌به‌راست)، دسته‌ای به نام ویجت‌های WidgetCore می‌بینید که ویجت‌های افزونه در آن فهرست شده‌اند:

ویجتشناسهکاربرد
سوالات متداولwgcr-faqفهرست پرسش و پاسخ بازشو
جستجوی زندهwgcr-searchفیلد جستجو با نتایج زنده

گام 3 — ساخت اولین سوالات متداول

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

  1. عنوان سوال را بنویسید

    فیلد «عنوان سوال» همان چیزی است که کاربر می‌بیند و در اسکیمای FAQPage هم استفاده می‌شود.

  2. پاسخ را بنویسید

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

  3. آیتم‌های بعدی را اضافه کنید

    با دکمه‌ی «افزودن آیتم» چند پرسش دیگر بسازید و ترتیبشان را با کشیدن عوض کنید.

  4. حالت باز شدن را انتخاب کنید

    «آکاردئون» یعنی فقط یک آیتم باز می‌ماند؛ «آزاد» یعنی چند آیتم هم‌زمان باز می‌شوند.

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

گام 4 — ساخت اولین جستجوی زنده

ویجت جستجوی زنده را روی صفحه بکشید. با تنظیمات پیش‌فرض کار می‌کند:

کنترلمقدار پیش‌فرضنتیجه
حالت نمایش نتایجحالت لیستنتایج در پنلی بازشو زیر فیلد
منبعpostفقط نوشته‌ها جستجو می‌شوند
آیتم در هر برگه12حداکثر 12 نتیجه در هر جستجو
نمایش تصویربلهبندانگشتی هر نتیجه نشان داده می‌شود
نمایش خلاصهبله18 کلمه از متن با نقطه‌چین
صفحه‌بندیهیچکدامفقط همان یک صفحه نتیجه

صفحه را منتشر کنید، در نمای سایت روی فیلد کلیک کنید و دست‌کم دو نویسه تایپ کنید — نتایج بدون بارگذاری مجدد صفحه ظاهر می‌شوند.

گام 5 — جستجو در هر جای سایت با شورت‌کد

اگر می‌خواهید فیلد جستجو را بیرون از المنتور (مثلاً در یک الگوی پوسته یا داخل محتوا) بگذارید، از شورت‌کد استفاده کنید:

[wgcr_search]
[wgcr_search limit="8" thumb="no" placeholder="جستجو در مقالات…"]
[wgcr_search mode="page" columns="3" pagination="load_on_click"]

همه‌ی ویژگی‌ها اختیاری‌اند؛ فهرست کامل در صفحه‌ی شورت‌کد.

بررسی اینکه همه‌چیز کار می‌کند

  1. ویجت‌ها در ویرایشگر دیده می‌شوند

    اگر دسته‌ی «ویجت‌های WidgetCore» نیست، المنتور را فعال کنید و صفحه‌ی ویرایشگر را تازه کنید.

  2. نتایج جستجو برمی‌گردند

    در ابزار توسعه‌دهنده‌ی مرورگر، درخواست /wp-json/wgcr/v1/search باید وضعیت 200 داشته باشد.

  3. متن‌ها به زبان سایت هستند

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

  4. اسکیمای FAQ در منبع صفحه است

    در کد منبع صفحه عبارت "@type":"FAQPage" را جستجو کنید.

قدم بعدی