معرفی افزونه جُستا

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

جستا با جستجوی زنده AJAX، پشتیبانی از عبارت های فارسی و تشخیص شکل های مختلف ی، ک و فاصله میان کلمات، احتمال پیدا نشدن محصولات را کاهش می دهد. ویجت اختصاصی المنتور، شورتکد [joosta]، ۹ طرح آماده و گزارش های شمسی جستجو نیز امکان طراحی نوار جستجو و بررسی نیازهای کاربران را در اختیار مدیر فروشگاه قرار می دهد.

جُستا در یک نگاه

جُستا برای فروشگاه فارسی نوشته شده. نتایج زنده از طریق AJAX می‌آید و قیمت و موجودی مستقیم از ووکامرس خوانده می‌شود.

• جستجوی زنده AJAX بدون رفرش صفحه
• قیمت، تخفیف، موجودی و امتیاز در کارت نتیجه
• جستجو در عنوان، دسته، برچسب، برند، توضیحات و SKU
• نرمال‌سازی فارسی (ک/ك، ی/ي، نیم‌فاصله، اعداد فارسی)
• گروه مترادف آماده + قابل ویرایش در پنل
• ویجت المنتور + کد کوتاه [joosta]
• ۹ پریست ظاهر فرم
• Dropdown / Modal / Fullscreen
• گزارش جستجو با تاریخ شمسی و CSV
• سازگاری با Woodmart و HPOS

چرا جستجوی پیش‌فرض وردپرس کافی نیست؟

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

• محصول پیدا نمی‌شود: مشتری «لپ‌تاپ ایسوس ۱۶ گیگ» تایپ می‌کند و نتیجه‌ای نمی‌بیند یا نتیجه اشتباه می‌گیرد.
• نتیجه نامرتبط: صفحه جستجو باز می‌شود، بلاگ بالاتر می‌آید و مشتری گیج می‌شود.
• ترک سایت: به فروشگاه رقیب می‌رود و شما نمی‌فهمید دنبال چه محصولی بوده.
• فروش از دست می‌رود: مشتری آماده خرید بوده، محصول را ندیده و شما هم از عبارت جستجو خبر ندارید.

جُستا در برابر جستجوی پیش‌فرض وردپرس

مقایسه با افزونه‌های جستجوی Ajax رایج

جستجوی زنده در فروشگاه چه شکلی است؟

قیمت و موجودی قبل از کلیک

با هر کاراکتر، کارت محصول با تصویر، قیمت تومان و وضعیت موجود/ناموجود در dropdown می‌آید. صفحه جستجوی وردپرس باز نمی‌شود. مشتری قبل از ورود به صفحه محصول تصمیم می‌گیرد.

• قیمت مستقیم از ووکامرس
• موجود و ناموجود در همان کارت
• بدون reload صفحه
• اسکلتون لودر هنگام جستجو
• هایلایت عبارت جستجو در نتایج

جستجوهای اخیر و پرجستجو

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

فیلتر بدون خروج از جستجو

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

• دسته و برچسب
• بازه قیمت
• فقط موجود
• فقط محصولات تخفیف‌دار
• امتیاز
• پاک کردن فیلترها با یک کلیک

پشتیبانی فارسی 

۱) نرمال‌سازی فارسی: مشتری با کیبورد عربی یا انگلیسی تایپ می‌کند. جُستا قبل از جستجو حروف را یکسان می‌کند: ك و ک، ي و ی، نیم‌فاصله و اعداد فارسی.

۲) گروه‌های مترادف: اگر مشتری «لپ تاپ» بنویسد، جُستا می‌داند منظور همان لپتاپ، Laptop یا Notebook است. گروه‌های آماده دارید و در پنل می‌توانید گروه جدید بسازید.

۳) کلمات پرجستجو: جدول عبارت‌های پرجستجو نشان می‌دهد مشتری واقعاً چه تایپ کرده. از همین جدول برای مترادف، اصلاح عنوان محصول و پیدا کردن تقاضای بدون پوشش استفاده کنید.

۴) اولویت نتایج: وقتی «گوشی سامسونگ» جستجو می‌شود، محصولی که در عنوان آمده بالاتر می‌رود — نه پست بلاگ. محصولات موجود هم بالاتر از ناموجودها قرار می‌گیرند.

وقتی جستجو درست کار کند

سناریو ۱ — پیدا کردن محصول
قبل: مشتری ۵ دسته‌بندی را باز می‌کند و هنوز محصول را پیدا نکرده.
بعد: یک بار «لپ‌تاپ ایسوس» تایپ می‌کند و نتیجه فوری می‌بیند.

سناریو ۲ — پشتیبانی
قبل: تیکت «لینک محصول را بفرستید» و ۲۰ دقیقه انتظار.
بعد: مشتری خودش SKU یا نام را جستجو می‌کند.

سناریو ۳ — خروج از سایت
قبل: جستجو نتیجه نمی‌دهد و مشتری به فروشگاه دیگر می‌رود.
بعد: حتی با تایپ «لپتاپ» بدون نیم‌فاصله محصول پیدا می‌شود.

سناریو ۴ — تصمیم خرید
قبل: صفحه جستجو reload می‌شود و فقط عنوان متن می‌آید.
بعد: کارت ووکامرس با قیمت، موجودی و امتیاز — تصمیم سریع‌تر.

نمونه استفاده در فروشگاه‌های مختلف

لوازم دیجیتال: مشتری مدل دقیق را می‌داند، نه دسته‌بندی. با تایپ RTX یا نام کارت گرافیک مستقیم به محصول می‌رسد.

موبایل: برند + مدل تایپ می‌کند. از بین صدها گوشی، مدل دقیق جدا می‌شود.

پوشاک: برند و سبک را جستجو می‌کند. کل کاتالوگ برند را نمی‌بیند؛ فقط آنچه نوشته.

لوازم یدکی: شماره قطعه دارد. جستجو با SKU مستقیم به قطعه درست می‌رسد — یک نتیجه اشتباه یعنی مرجوعی.

کتاب: عنوان فارسی یا انگلیسی را تایپ می‌کند و مستقیم به صفحه کتاب می‌رود.

گزارش جستجو با تاریخ شمسی

در پنل جُستا می‌بینید مشتری چه جستجو کرده، روی چه نتیجه‌ای کلیک کرده و کجا نتیجه‌ای پیدا نشده است.

• KPI روزانه و روند ۷ روزه
• عبارت‌های پرجستجو
• آخرین جستجوها
• جستجوهای بدون کلیک
• جستجوهای بدون نتیجه
• تاریخ شمسی در داشبورد و گزارش‌ها
• خروجی CSV

اگر عبارتی چند بار جستجو شده و کلیک نداشته، عنوان، تصویر یا موجودی همان محصولات را بررسی کنید. داده‌ها در دیتابیس وردپرس شما می‌ماند و به سرور خارجی ارسال نمی‌شود.

ظاهر فرم و چیدمان نتایج

چیدمان فرم: classic، icon، icon-flexible و icon-flexible-inv

چیدمان نتایج: Dropdown، Modal و Fullscreen

۹ پریست ظاهر فرم: Classic، Minimal، Underline، Pill، Bordered، Soft، Glass، Compact و Accent-bar

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

لیست امکانات جُستا

• جستجوی زنده AJAX در محصول، نوشته، صفحه و پست‌تایپ‌های اضافی
• جستجو در عنوان، دسته، برچسب، برند، توضیحات و SKU
• کارت نتیجه با تصویر، قیمت، تخفیف، موجودی، امتیاز و SKU
• فیلتر دسته، برچسب، قیمت، موجودی، امتیاز و محصولات تخفیف‌دار
• چیدمان نتایج: Dropdown، Modal و Fullscreen
• چیدمان فرم: classic، icon، icon-flexible و icon-flexible-inv
• ۹ پریست ظاهر فرم
• ویجت المنتور با کنترل محتوا، چیدمان، فیلتر و استایل
• کد کوتاه [joosta] بدون نیاز به المنتور
• تاریخچه جستجو (localStorage / کوکی / حساب کاربری)
• پرجستجو خودکار یا دستی
• اسکلتون لودر و هایلایت عبارت
• گزارش: پرجستجو، تاریخچه، بدون کلیک، بدون نتیجه
• تاریخ شمسی + خروجی CSV
• کش AJAX با TTL قابل تنظیم
• پاک‌سازی خودکار کش هنگام ذخیره محصول
• محدودیت نرخ درخواست (Rate Limit)
• Import و Export تنظیمات JSON
• سازگاری با Woodmart و HPOS
• REST API و بیش از ۳۰ هوک برای توسعه‌دهنده
• مستندات داخل افزونه
• حذف تمیز با uninstall.php

کنترل از پنل وردپرس

نوع محتوای قابل جستجو، فیلدهای جستجو، کش، استایل کارت، رنگ‌بندی و چیدمان نتایج در پنل جُستا تنظیم می‌شود.

• انواع محتوا: محصول، نوشته، صفحه و پست‌تایپ‌های سفارشی
• عملکرد: TTL کش و پاک‌سازی خودکار
• ظاهر کارت: چیدمان تصویر، قیمت و موجودی
• رنگ‌بندی: هماهنگی با هدر و برند فروشگاه
• پرجستجو و مترادف: بدون کد، از پنل

نصب و استفاده

1. خرید و دانلود فایل ZIP از راست‌چین
2. افزونه‌ها ← افزودن ← آپلود ZIP ← فعال‌سازی
3. قرار دادن ویجت یا کد کوتاه در هدر
4. تنظیم پیکربندی و ظاهر از منوی جُستا

روش ۱ — المنتور: ویجت «جستجوی جُستا» را در هدر یا هر بخش قالب بگذارید. نوع محتوا، چیدمان، overlay و ظاهر فرم را از تب‌های ویجت تنظیم کنید.

روش ۲ — کد کوتاه:

[joosta]
[joosta type="product,post" form_style="pill"]
[joosta layout="icon-flexible" overlay="dropdown" max_results="12"]

بعد از نصب یا تغییر ظاهر، کش سایت را پاک کنید. ایندکس‌گذاری اولیه و سرویس خارجی لازم نیست.

سازگاری

• ووکامرس: قیمت، موجودی، SKU، HPOS و ووکامرس ۸
• Woodmart: لایه اختصاصی برای هدر sticky، RTL و z-index
• Elementor: ویجت کامل؛ استفاده از المنتور اجباری نیست
• سایر تم‌ها: Astra، GeneratePress و تم‌های بلاکی با شورت‌کد [joosta]

جُستا CSS تم را به‌زور عوض نمی‌کند. ویجت یا شورت‌کد را هر جا بگذارید کار می‌کند.

برای توسعه‌دهنده و تیم فنی

• بیش از ۳۰ هوک و فیلتر (مثل joosta_search_results و joosta_before_search)
• REST API: GET /wp-json/joosta/v1/search
• Import / Export تنظیمات JSON بین staging و production
• TTL کش و Rate Limit قابل تنظیم
• مستندات داخل افزونه + HOOKS.md
• migration در آپدیت نسخه‌ها
• uninstall.php برای حذف تمیز داده‌ها

add_filter('joosta_search_results', function($results, $query) {
  // مثال: اولویت به محصولات تخفیف‌دار
  return $results;
}, 10, 2);

نیازمندی‌ها

• وردپرس ۵.۸ به بالا
• PHP ۸.۰ به بالا
• ووکامرس ۵.۰ به بالا برای جستجوی محصولات
• المنتور اختیاری

جستجوی زنده روی فروشگاه خودتان — بدون Elasticsearch، بدون اشتراک ماهانه، بدون سرویس خارجی