JetEngine Tutorial حرفه‌ای درس آموزشی

Dynamic Tags سفارشی و قالب‌سازی حرفه‌ای جت‌انجین

وقتی داده نمایشی خاصی لازم دارید (ترکیب فیلدها، محاسبه، مقدار شرطی)، دو ابزار حرفه‌ای دارید: Callbackهای Dynamic Tag سفارشی با کد PHP (هوک jet-engine/... با فیلترهای فرمت) و قالب‌های Listing با توابع شرطی داخلی. مثال کاربردی: نمایش «موجود / ناموجود» بر اساس متافیلد عددی، محاسبه قیمت با تخفیف، یا ترکیب نام و تاریخ در یک ویجت. برای توسعه‌دهنده‌ها، جت‌انجین هوک‌های PHP خوبی دارد که خروجی هر ویجت را قابل فرمت می‌کند.

مراحل قدم‌به‌قدم

  1. ۱

    شرطی‌سازی نمایش در لیستینگ

    در ویجت داخل قالب لیستینگ، بخش Conditions را باز کنید؛ شرط بر اساس متافیلد (مثلاً فقط وقتی stock > 0 نشان داده شود) — بدون کد، نمایش شرطی حرفه‌ای.

  2. ۲

    فرمت مقدار فیلد

    برای فیلدهای عددی/تاریخ، فرمت‌های آماده جت‌انجین را ببینید (جداسازی هزارگان، تاریخ شمسی با افزونه جلالی)؛ در Callbackهای فیلد، PHP ساده مقدار را دگرگون می‌کند.

  3. ۳

    Dynamic Tag سفارشی با کد

    در functions.php یا افزونه قطعه‌ای، با هوک‌های جت‌انجین تگ سفارشی ثبت کنید که مقدار ترکیبی برگرداند؛ مثلاً «قیمت با تخفیف» از دو متافیلد محاسبه‌شده — خروجی تمیز بدون HTML تزریق‌شده در محتوا.

  4. ۴

    الگوی ماژولار قالب

    قالب‌های لیستینگ را به بخش‌های قابل استفاده مجدد بشکنید (کارت پایه، کارت با آیکون‌ها) و در صفحات مختلف باز استفاده کنید؛ تغییر طراحی کارت، همه کاتالوگ‌ها را به‌روز می‌کند.

نکات مهم

  • ◆ کد سفارشی را در child theme یا افزونه قطعه‌ای نگه دارید؛ آپدیت قالب آن را نمی‌پاشد.
  • ◆ شرط‌های نمایش را با داده لبه (فیلد خالی، صفر، تاریخ گذشته) تست کنید.
  • ◆ برای تغییرات فرمت مشترک، callback سراسری بهتر از تنظیم تکراری در هر ویجت است.