کوئریهای سراسری و مدیر کوئری (Global Queries & Query Manager)
از Bricks 2.1 میتوانید کوئریهای سراسری قابل استفاده مجدد بسازید و مدیریت کنید. این امکان به شما اجازه میدهد منطق کوئری را یکبار تعریف کنید و در کل وبسایت دوباره از آن استفاده کنید. هر تغییری که در یک کوئری سراسری اعمال کنید، بهطور خودکار در همه جاهایی که استفاده شده اعمال میشود.
این قابلیت کارایی، یکنواختی و نگهداری را برای سایتهایی که به کوئریهای پیچیده وابستهاند بهبود میدهد.
ساخت کوئری سراسری
- تعریف کوئری محلی
- یک المان nestable (مثلاً Container، Block، Div) درج کنید.
- Query Loop را فعال کنید.
- تنظیمات کوئری را پیکربندی کنید (مثلاً post type، posts per page).
- ذخیره بهعنوان کوئری سراسری
- روی آیکون Save جدید در کنترل query کلیک کنید.
- موارد زیر را وارد کنید:
- Name (مثلاً «Latest Three Properties»)
- Description (اختیاری، برای وضوح تیم)
- Category (اختیاری، برای گروهبندی کوئریها)
- روی Create کلیک کنید.
کوئری اکنون سراسری میشود و میتوان آن را در سراسر سایت دوباره استفاده کرد.
همچنین میتوانید کوئری سراسری را داخل Query Manager بسازید.
استفاده از کوئری سراسری
- هنگام افزودن Query Loop جدید، روی آیکون globe کلیک کنید.
- از فهرست کوئریهای سراسری موجود یکی را انتخاب کنید.
- Bricks منطق کوئری ذخیرهشده را بهطور خودکار اعمال میکند.
اگر کوئری سراسری وجود نداشته باشد، آیکون globe در دسترس نیست.
ویرایش کوئریهای سراسری
میتوانید کوئری سراسری را به چند روش ویرایش کنید:
- Query Manager (پیشنهادی):
- Toolbar: Manage → Query Manager، یا
- از Command Palette → Manage Queries استفاده کنید.
- ویرایش درونخطی:
- داخل Query Control، روی آیکون Edit (مداد) کلیک کنید.
- Bricks نشان میدهد که در حال ویرایش کوئری سراسری هستید (تغییرات همهجا اعمال میشود).
ویرایشها همه instanceهایی که از کوئری سراسری استفاده میکنند را بهروز میکند. برای مثال، تغییر «Posts per page» از «3» به «5» هر حلقهای که به آن کوئری ارجاع میدهد را بهروز میکند.
قطع اتصال کوئری سراسری
- از Disconnect برای تبدیل کوئری سراسری به کوئری محلی استفاده کنید.
- کوئری محلی تنظیمات سراسری را بهعنوان نقطه شروع به ارث میبرد، اما ویرایشهای بعدی روی کوئری سراسری اصلی یا instanceهای دیگر تأثیر نمیگذارد.
- وقتی میخواهید کوئری کمیمتفاوت در یک زمینه خاص داشته باشید مفید است.
Query Manager
Query Manager جدید به شما امکان میدهد همه کوئریهای سراسری را بسازید، سازماندهی کنید، ویرایش کنید و import و export کنید.
از روشهای زیر قابل دسترسی است:
- Toolbar در Manage → Query Manager
- از Command Palette → Manage Queries
- Query control Globe → Gear icon
Import و Export
کوئریهای سراسری را میتوان از Query Manager بهصورت فایل JSON export و import کرد.
- Export: فایل JSON حاوی کوئریها و دستهها ایجاد میکند.
- Import: فایل JSON را در سایت وردپرس دیگر آپلود کنید تا کوئریها دوباره استفاده شوند.
این مانند export/import کلاسها و متغیرها کار میکند.
خلاصه
قابلیت Global Queries & Query Manager در Bricks 2.1 به شما امکان میدهد:
- کوئریهای قابل استفاده مجدد بسازید.
- آنها را با یک کلیک در سراسر سایت اعمال کنید.
- یکبار ویرایش کنید، همهجا بهروز شود.
- برای تنوعهای محلی Disconnect کنید.
- برای قابلحمل بودن import/export کنید.
این مدیریت کوئری را یکنواختتر، کارآمدتر و مقیاسپذیرتر در پروژهها میکند.