WidgetCoreمستندات WidgetCore

Changelog

تغییرات همه نسخه‌های منتشرشده افزونه WidgetCore، از جدیدترین به قدیمی‌ترین.

v0.0.7

  • به‌روزرسانی مستقیم از مخزن گیت‌هاب — هدر Update URI به‌همراه هوک‌های هسته‌ی وردپرس و بدون کتابخانه‌ی جانبی: دریافت آخرین انتشار WidgetCore/Plugin و دارایی widgetcore.zip.
  • یادداشت‌های هر نسخه در صفحه‌ی «جزئیات افزونه» نمایش داده می‌شود و کلید بومی «به‌روزرسانی خودکار» برای ویجت‌کور کار می‌کند.
  • پیوند «بررسی به‌روزرسانی» در فهرست افزونه‌ها، همراه با پیامی که نتیجه را گزارش می‌کند.
  • ثابت اختیاری WGCR_GITHUB_TOKEN برای مخزن‌های خصوصی. اگر بعداً این هدر حذف شود، به‌روزرسانی به مخزن رسمی افزونه‌های وردپرس برمی‌گردد.

v0.0.6

  • جستجوی زنده: نتایجی که با قالب المنتور ساخته می‌شوند دیگر پوشش کارت و استایل‌های ویجت را نمی‌گیرند — بدون لینک تودرتو، بدون فاصله‌ی داخلی، بدون استایل hover و انتخاب، و نشانگر ماوس هرگز یک نتیجه را علامت‌گذاری نمی‌کند (پیمایش با کیبورد فقط یک حلقه‌ی بیرونی نشان می‌دهد).
  • جستجوی زنده: در حالت نمایش «صفحه» هم پنل نتایج بدون استایل است، بنابراین همه‌چیز از قالب خود شما می‌آید.
  • جستجوی زنده: فهرست نتایج در حالت «صفحه» هم‌اندازه‌ی نتایج بزرگ می‌شود (کنترل بیشترین ارتفاع، خود پنل را اسکرول می‌کند) و پیمایش بی‌نهایت نسبت به پنجره‌ی مرورگر کار می‌کند.
  • هر بسته‌ی منتشرشده شماره نسخه‌ی خودش را دارد؛ در نتیجه مرورگر، search.css یا search.js کش‌شده‌ی نسخه‌ی قدیمی را به‌کار نمی‌برد.

v0.0.5

  • نسخه‌گذاری: افزونه اکنون از شمارنده‌ی هر انتشار استفاده می‌کند (0.0.1 → 0.0.2 … 0.0.9 → 0.1.0 … 0.9.9 → 1.0.0)؛ ورودی‌های پیشین هم بر همین اساس شماره‌گذاری شدند.
  • جستجوی زنده: تعداد نتایج با کنترل «تعداد در هر صفحه» در بخش چیدمان تعیین می‌شود (1 تا 50، پیش‌فرض 12) و کنترل قدیمی «تعداد نتایج» از بخش عمومی حذف شد. ویجت‌هایی که مقدار قدیمی را ذخیره کرده‌اند همان را نگه می‌دارند تا «تعداد در هر صفحه» یک بار تنظیم شود.
  • جستجوی زنده: کنترل «ستون‌ها» اکنون کار می‌کند — در حالت نمایش «صفحه» نتایج در یک شبکه‌ی CSS واکنش‌گرا چیده می‌شوند (دسکتاپ / تبلت / موبایل، پیش‌فرض 3 / 2 / 1). حالت فهرست تک‌ستونی می‌ماند و این کنترل را پنهان می‌کند.
  • جستجوی زنده: «نوع نوشته‌ی دلخواه» از فهرست پرس‌وجو به انتخاب «منبع» منتقل شد؛ با انتخاب آن فیلد نامک ظاهر می‌شود و نامک دیگر منبعِ صریحاً انتخاب‌شده را باطل نمی‌کند.
  • جستجوی زنده: کنترل‌های استایل «جعبه‌ی نتایج» در حالت «صفحه» اکنون داخل بخش «پنل نتایج» قرار دارند و فقط در همان حالت نمایش داده می‌شوند؛ کنترل تراز افقی هم دیگر کنترل فاصله‌ی بیرونی را باطل نمی‌کند.
  • جستجوی زنده: کنترل‌های پرس‌وجو اعمال می‌شوند — شامل/استثنای رده‌ها از هر رده‌بندی عمومی، بازه‌ی تاریخ، مرتب‌سازی بر اساس (ارتباط، تاریخ، عنوان، نویسنده، تصادفی، ترتیب فهرست) و جهت آن، اولویت نوشته‌های چسبان، و یک شناسه‌ی پرس‌وجو برای فیلتر wgcr_search_query_args/{query_id}. پارامترهای REST و ویژگی‌های شورت‌کد هم اضافه شدند.
  • جستجوی زنده: کنترل‌های صفحه‌بندی اعمال می‌شوند — شماره‌ی صفحه، قبلی/بعدی، دکمه‌ی «بارگذاری بیشتر» (متن، آیکون، شناسه) و پیمایش بی‌نهایت داخل پنل نتایج، همراه با تراز، فاصله و پیام دلخواه «نوشته‌ی بیشتری نیست».
  • جستجوی زنده: «چیدمان آجری» و «ارتفاع یکسان» اکنون در حالت نمایش «صفحه» کار می‌کنند.
  • جستجوی زنده: فایل‌های استایل <link> قالب به‌جای درج شدن به‌صورت متن، مانند یک استایل واقعی (یک بار در هر صفحه) بارگذاری می‌شوند؛ پیکان «مشاهده‌ی همه»، جابه‌جایی هنگام hover و نوار انتخاب از جهت متن پیروی می‌کنند و حرکت برای prefers-reduced-motion کاهش می‌یابد.
  • جستجوی زنده: فهرست قالب‌ها و رده‌ها فقط داخل ویرایشگر المنتور پرس‌وجو می‌شود، نه در هر بار نمایش سایت.
  • جستجوی زنده: limit در شورت‌کد مقادیر 1 تا 50 را می‌پذیرد و ویژگی جدید columns (حالت صفحه) اضافه شد؛ سقف limit در REST به 50 افزایش یافت (WGCR_SEARCH_MAX_RESULTS).
  • پرسش‌های متداول: پاسخ‌های بسته‌شده از ترتیب Tab خارج می‌شوند، کلیدهای بالا/پایین، Home و End بین پرسش‌ها حرکت می‌کنند، ویرایش درون‌خطی در پیش‌نمایش ویرایشگر کار می‌کند و کاهش حرکت رعایت می‌شود.
  • آیکون‌های SVG مشترک (wgcr_svg_icon()) جای تابع‌های تکراری هر دو ویجت را گرفتند.
  • سازگاری با وردپرس 7.1.2 و المنتور 4.3.2 و نیز وردپرس 6.7.4 با المنتور 4.0.8 بررسی شد.

v0.0.4

  • جستجوی زنده: نتایجی که از قالب المنتور ساخته می‌شوند اکنون CSS خود قالب را همراه دارند (یک بار در هر پاسخ درج می‌شود)، بنابراین قالب‌های سفارشی در هر دو حالت نمایش، استایل‌داردهی‌شده دیده می‌شوند.
  • جستجوی زنده: نتایجِ قالب با هندلرهای سمت کاربر المنتور راه‌اندازی می‌شوند و جای‌دارنده‌های elementor-invisible برای انیمیشن ورود حل می‌شوند، پس قالب‌های انیمیشنی دیگر خالی نمایش داده نمی‌شوند.
  • جستجوی زنده: اگر قالبی بدون محتوای قابل‌مشاهده رندر شود، به‌جای بازگرداندن موارد خالی، کارت پیش‌فرض نتیجه نمایش داده می‌شود.
  • جستجوی زنده: کنترل‌های عرض و تراز جعبه‌ی نتایج اصلاح شدند — هر دو اکنون به خود جعبه‌ی نتایج اعمال می‌شوند نه به کل ویجت، و فاصله‌ی فیلدها در حالت «صفحه» حفظ می‌شود.

v0.0.3

  • جستجوی زنده: تنظیمات محتوا به بخش‌های عمومی (ابتدا حالت نمایش)، چیدمان، پرس‌وجو و صفحه‌بندی بازآرایی شد تا با ویجت‌های حلقه‌ی خود المنتور هم‌خوان باشد. چیدمان یک انتخابگر نوع قالب با پشتیبانی از نوع نوشته‌ی دلخواه، انتخابگر جستجو‌شدنی قالب المنتور با پیوند ویرایش، ستون‌ها، تعداد در هر صفحه، چیدمان آجری، ارتفاع یکسان و قالب جایگزین دارد. پرس‌وجو شامل/استثنای رده‌ها، بازه‌ی تاریخ، ترتیب و شناسه‌ی پرس‌وجو و کنترل نوشته‌ی چسبان را اضافه می‌کند. صفحه‌بندی نوع، تراز، دکمه‌ی «بارگذاری بیشتر» و پیام‌های دلخواه دارد و در بخش استایل، یک بخش جعبه‌ی نتایج (عرض، ارتفاع و بیشتر) برای حالت «صفحه» اضافه شد.
  • جستجوی زنده: حالت نمایش «صفحه» (استایل جعبه‌ی نتایج) اصلاح شد و رندر قالب در REST مقاوم‌تر شد، به‌گونه‌ای که یک قالب خرابِ المنتور دیگر کل درخواست جستجو را از کار نمی‌اندازد.

v0.0.2

  • جستجوی زنده: گزینه‌ی display_mode (پاپ‌آپ / صفحه) اضافه شد. در حالت «صفحه» نتایج در یک ناحیه‌ی همیشه پیدر داخل جعبه‌ی ویجت نمایش داده می‌شوند، نه در پنل بازشو.
  • شورت‌کد [wgcr_search] ویژگی mode="page" را می‌پذیرد.

v0.0.1

  • نخستین انتشار: ویجت پرسش‌های متداول (wgcr-faq) با اسکیما‌ی FAQPage و ویجت جستجوی زنده (wgcr-search) با شورت‌کد [wgcr_search].
  • پشتیبانی کامل چندزبانه؛ ترجمه‌های فارسی (fa_IR) و انگلیسی (en_US) همراه افزونه عرضه می‌شوند.
  • ساخته‌شده بر پایه‌ی استانداردهای کدنویسی افزونه‌های وردپرس (گریز در خروجی، بدون heredoc، پیشوند برای نام‌های سراسری).
  • با پروانه‌ی GPL-2.0-or-later منتشر می‌شود.
  • سازگاری با تازه‌ترین نسخه‌های وردپرس و المنتور پیش از ساخت هر انتشار بررسی می‌شود.