RDSCO Elementor Widgets

نام فارسی افزونه: افزونه های المنتور راهکار دیجیتال شریف

این افزونه یک مجموعه توسعه‌پذیر از ویجت‌های اختصاصی Elementor است. نسخه 2.12.2 شامل چهار ویجت بومی Elementor است:

• دفتر تلفن با حفظ کامل قابلیت‌های نسخه 2.3.1
• آرشیو AJAX نوشته‌ها برای استفاده در قالب‌های Archive المنتور، با هشت سبک نمایش و فیلترهای ACF قابل انتخاب برای هر دسته
• نمایش مطالب برای صفحات عادی Elementor با انتخاب یک یا چند دسته، جستجوی AJAX و دو استایل آیکن/تصویر شاخص
• باکس جستجو با جستجوی زنده، فیلتر تاریخ و دسته، سه حالت نمایش و صفحه‌بندی AJAX

نسخه 2 به بعد شورت‌کد و صفحه تنظیمات جداگانه ندارد و تمام ویجت‌ها مستقیماً از پنل Elementor مدیریت می‌شوند.

نیازمندی‌ها

• WordPress 6.0 یا جدیدتر
• PHP 7.4 یا جدیدتر
• Elementor 3.20 یا جدیدتر
• ACF برای مدیریت راحت فیلدهای دفتر تلفن؛ در نبود ACF، داده خام post meta خوانده می‌شود

نصب و استفاده

1. فایل ZIP شاخه main را دانلود و مانند یک افزونه وردپرس نصب کنید.
2. Elementor را نصب و فعال کنید.
3. در پنل ویجت‌ها، بخش «افزونه های راهکار دیجیتال شریف» را باز کنید.
4. برای دفتر تلفن، ویجت «دفتر تلفن» را به صفحه اضافه کنید.
5. برای آرشیو نوشته‌ها، در Elementor → Theme Builder → Archive ویجت «آرشیو AJAX نوشته‌ها» را جایگزین Archive Posts / Loop Grid پیش‌فرض کنید.
6. برای صفحات عادی، ویجت «نمایش مطالب» را اضافه کنید و یک یا چند ID دسته‌بندی را در تنظیمات وارد کنید.
7. برای جستجوی پیشرفته، ویجت «باکس جستجو» را اضافه و دسته‌های مجاز را از فهرست انتخاب کنید.

برای فیلترهای ACF در آرشیو، در نوشته‌ها ← دسته‌ها دستهٔ موردنظر را ویرایش کنید، «فیلتر بر اساس فیلدهای ACF» را فعال کنید و فیلدهای مجاز آن دسته را انتخاب کنید. تعداد فیلدها محدود نیست، اما در هر درخواست حداکثر ۱۰ گزینه برای هر فیلتر بارگذاری می‌شود؛ گزینه‌ها به شکل کلیدهای قابل کلیک نمایش داده می‌شوند و جستجو و «نمایش موارد بیشتر» در ستون کناری برای دسترسی به بقیه وجود دارد. فیلدهای گزینه‌دار و فیلدهای دارای مقدار مستقیم (از جمله متن، عدد، تاریخ و شناسه رسانه/نوشته/کاربر) پشتیبانی می‌شوند؛ فیلدهای ساختاری دارای زیرفیلد مانند Repeater، Group و Flexible Content نیاز به پیاده‌سازی جداگانه دارند. در تنظیمات ویجت آرشیو «نمایش فیلترها» را روشن نگه دارید. مجوزها برای هر دسته مستقل هستند و اگر ACF فعال نباشد، فیلتر ACF نمایش داده نمی‌شود.

برای نمایش سال در سبک «تایم لاین»، عدد سال را به‌تنهایی در چکیدهٔ مطلب وارد کنید (مثلاً ۱۴۰۳). سال به صورت بزرگ و کم‌رنگ پشت عنوان نشان داده می‌شود و تصویر شاخص، در صورت وجود، کنار عنوان قرار می‌گیرد. متن کوتاه سمت دیگر از ابتدای محتوای مطلب خوانده می‌شود. اگر چکیده متن معمولی باشد، طبق رفتار قبلی همان متن در بخش توضیحات نمایش داده خواهد شد.

در تایم‌لاین، بخش عنوان یک‌سوم و بخش توضیحات دو‌سومِ فضای محتوا را می‌گیرند؛ در عرض‌های کم، برای خوانایی زیر هم قرار می‌گیرند.

نسخه 2 به بعد شورت‌کدی ثبت نمی‌کند. اگر صفحه‌ای از نسخه‌های آزمایشی قبلی هنوز شورت‌کد دارد، آن را حذف و ویجت بومی Elementor را جایگزین کنید.

ویجت دفتر تلفن

ساختار داده دفتر تلفن

هر مخاطب یک نوشته عادی WordPress در دسته‌ای با نامک contacts است:

ویجت جست‌وجوی AJAX، فیلتر وابسته حوزه/واحد، فیلتر برچسب بدون خروج از صفحه، صفحه‌بندی، نمایش واکنش‌گرا، سایدبار اطلاعات تماس از سمت چپ، حفاظت نمایشی ایمیل، QR Code و دانلود vCard را فراهم می‌کند.

شماره مستقیم هشت‌رقمی با پیش‌شماره 031 نمایش داده می‌شود و لینک تماس نیز همان شماره یازده‌رقمی را استفاده می‌کند.

در بخش «متای فیلدهای اضافه» می‌توان ردیف‌ها را آزادانه افزود، حذف و مرتب کرد. هر ردیف شامل Field Name و یکی از نقش‌های زیر است:

• متن عادی
• حوزه
• رایانامه
• شماره تماس مستقیم
• شماره داخلی

عنوان نمایشی هر ردیف از Label تعریف‌شده در ACF خوانده می‌شود و در نبود ACF از نام فیلد استفاده خواهد شد.

برای حفظ کارایی، حداکثر ۲۰ متای یکتا پذیرفته می‌شود و جست‌وجو فقط میان همان متاهای امضاشده انجام می‌گیرد تا بازدیدکننده نتواند meta key دلخواهی را وارد Query کند.

خروجی ویجت مستقیماً از کادر جست‌وجو آغاز می‌شود. حوزه فعالیت و واحد سازمانی در یک ردیف به‌صورت Dropdown نمایش داده می‌شوند و با تغییر حوزه، فهرست واحدها از طریق AJAX فقط با واحدهای مرتبط همان حوزه بازسازی می‌شود.

تنظیمات رنگ، پس‌زمینه، تایپوگرافی، Border، Radius، Padding و فاصله‌ها از کنترل‌های بومی Elementor قابل مدیریت هستند.

ویجت آرشیو AJAX نوشته‌ها

ویجت «آرشیو AJAX نوشته‌ها» برای جایگزینی Archive Posts یا Loop Grid پیش‌فرض Elementor در قالب‌های Archive ساخته شده است.

رفتار اصلی

ویجت دسته آرشیو جاری را به‌صورت خودکار از Query وردپرس تشخیص می‌دهد و نیازی به انتخاب دستی دسته در تنظیمات ویجت ندارد.

ویژگی‌های پیش‌فرض:

• نمایش 16 نوشته در هر صفحه
• گرید 4 ستونه دسکتاپ
• گرید 2 ستونه تبلت
• گرید 1 ستونه موبایل
• جستجوی زنده AJAX
• فیلتر زیر‌دسته‌ها
• فیلتر برچسب‌ها
• ترکیب همزمان جستجو + زیر‌دسته + برچسب
• صفحه‌بندی AJAX
• دکمه «نمایش مطالب بیشتر» با Append کردن نتایج
• نمایش تعداد نتایج در پایین لیست
• بدون Reload کامل صفحه

فعال‌سازی فیلتر برای دسته‌ها

در مسیر:

نوشته‌ها → دسته‌ها → افزودن / ویرایش دسته

تنظیمات اختصاصی آرشیو هر دسته در این بخش قرار دارد:

دارای فیلتر

اگر این گزینه فعال شود، ویجت در آرشیو آن دسته ستون فیلتر را نمایش می‌دهد.

فیلتر کناری شامل زیر‌دسته‌های همان دسته است. برچسب‌های مرتبط، در صورت فعال بودن، در یک ردیف مستقل زیر کادر جستجو نمایش داده می‌شوند.

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

تصویر دسته

برای هر دسته یا زیر‌دسته می‌توان از Media Library یک تصویر اختصاصی انتخاب کرد.

تصویر زیر‌دسته‌ها در فهرست فیلتر آرشیو نمایش داده می‌شود و در صفحه مدیریت دسته‌ها نیز یک ستون تصویر وجود دارد.

استایل نمایش دسته‌بندی

نوع نمایش نتایج آرشیو برای هر دسته به‌صورت مستقل قابل انتخاب است:

• کارت ۱: همان کارت تصویری فعلی با قاب مربع
• کارت ۲: کارت تصویری مینیمال با عکس شاخص برش‌خورده و متن زیر عکس
• آیکن باکس ۱: باکس فشرده با آیکن پیش‌فرض نوشته
• آیکن باکس ۲: باکس فشرده با تصویر شاخص کوچک؛ در نبود تصویر، آیکن پیش‌فرض نمایش داده می‌شود
• آیکن باکس ۳: چیدمان کارت مشابه طرح نمونه، با تصویر شاخص بدون کادر و پس‌زمینه در سمت چپ؛ در نبود تصویر، آیکن پیش‌فرض نمایش داده می‌شود
• هاور باکس ۱: عنوان روی تصویر شاخص، پوشش تیره برای خوانایی و گرادیانت فیروزه‌ای هنگام هاور

نمایش تگ‌ها در لاین بالا

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

کد بالای صفحه (فقط HTML)

HTML امن ذخیره‌شده در این فیلد، بالای کل ویجت آرشیو همان دسته نمایش داده می‌شود.

کد زیر ستون فیلترها (فقط HTML)

HTML امن ذخیره‌شده در این فیلد، پس از گروه‌های فیلتر در ستون کناری همان دسته نمایش داده می‌شود.

در این دو فیلد HTML و CSS داخل تگ `