افزونه جستجوی پیشرفته لایو ایجکس | SearchWP Live Ajax Search

SearchWP Live Ajax Search

Live Search با استفاده از جستجوی AJAX فرم جستجوی شما را بهبود می بخشد و به شما امکان می دهد نتایج جستجو را بدون نیاز به هدایت به صفحه نتایج مشاهده کنید. طراحی شده برای کار با هر قالب و هرگونه پیکربندی SearchWP، جستجوی زنده ساده ترین راه برای بهبود سریع فرم های جستجوی شماست!

Live Search به SearchWP نیازی ندارد، بنابراین در wordpress.org در دسترس است. اگر SearchWP را نصب و فعال کرده باشید، Live Search به طور خودکار از آن استفاده می کند. اگر این کار را نکنید، نتایج جستجوی بومی وردپرس ارائه می شود.

استفاده

پس از بارگذاری و فعال کردن Live Search، هر فرم ایجاد شده با استفاده از () get_search_form با Live Search و با استفاده از پیکربندی پیش فرض به طور خودکار بهبود می یابد. از موتور جستجوی پیش فرض SearchWP استفاده می شود (یا اگر SearchWP در دسترس نیست، جستجوی بومی وردپرس) و قالب پیش فرض اعمال می شود. با این وجود می توانید همه چیز را تا حد زیادی تنظیم کنید.

اگر از () get_search_form استفاده نمی کنید، می توانید به سادگی یک ویژگی داده برای فعال کردن Live search اضافه کنید، مانند این موارد:

1. <?php
2. // if your form is generated using get_search_form() you do not need to do this
3. // as SearchWP Live Search does it automatically out of the box
4. ?>
5. <form action=”” method=”get”>
6. <p>
7. <label for=”s”><?php _e( ‘Search’ , ‘mytextdomain’ ); ?></label>
8. <input type=”text” name=”s” id=”s” value=”” data-swplive=”true” />
9. </p>
10. <p>
11. <button type=”submit”><?php _e( ‘Search’ , ‘mytextdomain’ ); ?></button>
12. </p>
13. </form>

اگر می خواهید SearchWP از فعال کردن خودکار جستجوی زنده در فرم های تولید شده با () get_search_form جلوگیری کند، از فیلتر searchwp_live_search_hijack_get_search_form استفاده کنید.

تنظیم موتور جستجو و پیکربندی مورد استفاده در هر فرم جستجو

شما می توانید موتور جستجوی مورد استفاده را با تنظیم ویژگی data-swpengine در فیلد ورودی خود متناسب با نام موتور جستجوی مورد نظر خود تنظیم کنید. این تنها هنگامی نصب می شود که SearchWP نصب و فعال شده باشد و از engine تعریف شده در پیکربندی عملی برخوردار باشد.

شما می توانید پیکربندی مورد استفاده در هر فرم جستجو را با تنظیم ویژگی data-swpconfig در ورودی خود تنظیم کنید. برای تنظیم این موارد از فیلتر searchwp_live_search_configs استفاده کنید.

تنظیم نتایج

نتایج Live Search توسط سیستم الگویی ارائه می شود. مشاهده خواهید کرد که فایلی وجود دارد که با این پلاگین ارسال می شود: ~ / wp-content / plugins / searchwp-live-ajax-search / templates / search-results.php. این فایل برای نمایش نتایج جستجو استفاده می شود. توصیه می شود اگر می خواهید نتایج جستجو را تنظیم کنید، مراحل زیر را انجام دهید:

1. پوشه ای را با عنوان inside your theme directory ایحاد کنید .searchwp-live-ajax-search
2. search-results.php را از فهرست ~ / wp-content / plugins / searchwp-live-ajax-search / templates / در آن پوشه کپی کنید.
3. کپی قالب خود را از search-results.php مانند هر الگوی قالب دیگری تنظیم کنید.
4. به صورت اختیاری برای هر موتور جستجو فایل های اضافی ایجاد کنید مانند: search-results-supplemental.php برای یک موتور جستجو با نام supplemental.

تعیین موقعیت

Live Search برخی از استایل های اساسی را برای تعیین موقعیت مناسب نتایج ارائه می دهد. همچنین یک قالب پیش فرض را تولید می کند. با حفظ موقعیت پیش فرض CSS می توانید یک حالت بصری پیش فرض را حذف کنید:

1. <؟ php
2. function my_remove_searchwp_live_search_theme_css() {
3. wp_dequeue_style (‘searchwp-live-search’)؛
4. }
5. add_action (‘wp_enqueue_scriptts’، ‘my_remove_searchwp_live_search_theme_css’)؛

نکته مهم

توجه: قالب پیش فرض همچنین انیمیشن چرخان (spinner animation) را پیاده سازی می کند اگر قالب پیش فرض را حذف می کنید، باید انیمیشن keyframe زیر را به CSS قالب خود اضافه کنید.

1. keyframes searchwp-spinner-line-fade-quick {
2. ۰٪ ، ۳۹٪ ، ۱۰۰٪ {
3.  opacity: 0.25;}
4. ۴۰٪ {
5. تیرگی: ۱؛
6. }
7. }

اگر می خواهید CSS موقعیت یابی را نیز حذف کنید، می توانید این کار را با استفاده از فیلتر searchwp_live_search_base_styles انجام دهید.

می توانید محتوا را به دو روش تغییر موقعیت دهید:

1. یک ویژگی داده را به ورودی فرم خود اضافه کنید که حاوی عنصر انتخاب کننده است selectordata-swpparentel = “. masthead .my-search-results-parent”
2. یک ویژگی parent_el به پیکربندی اضافه کنید (به searchwp_live_search_configs مراجعه کنید)

فیلترها

فیلترهای زیر برای استفاده در Live Search در دسترس هستند:

searchwp_live_search_hijack_get_search_form

تعیین کنید آیا Live Search به طور خودکار فرم های جستجو ایجاد شده توسط () get_search_form را افزایش می دهد. پیش فرض درست است، برای غیرفعال کردن:

1. <؟ php
2. add_filter( ‘searchwp_live_search_hijack_get_search_form’, ‘__return_false’ );

searchwp_live_search_get_search_form_engine

موتور جستجو را مشخص کنید که هنگام فعال کردن خودکار Live Search در فرم های تولید شده توسط () get_search_form استفاده شود. پیش فرض “default” است.

توجه: فقط با SearchWP نصب و فعال می شود.

پیکربندی های خود را اضافه کنید، کدام تنظیمات برام کدام موتور جستجو استفاده می شود، تأخیر جستجو، حداقل کاراکتر ها، موقعیت پنجره نتایج.

می توانید به صورت اختیاری مقادیر موجود در کلید پیش فرض را نادیده بگیرید، یا گزینه دلخواه خود را اضافه کرده و هنگام تنظیم ویژگی data-swpconfig بر روی ورودی جستجوی خود از آنها استفاده کنید.

این پیکربندی پیش فرض است:

توجه: حداقل کارارکتر پیش فرض ۳ است (که همان SearchWP است) اما تنظیمات پیکربندی برای Live Search پارامترهای جداگانه ای هستند و وقتی پارامترهای مشابه SearchWP تنظیم شده باشند، به روز نمی شوند.

می توانید مقادیر این پیش فرض ها را تغییر دهید، یا پیکربندی های جدا شده خود را به آن اضافه کرده و چندین پیکربندی در دسترس خود داشته باشید.

searchwp_live_search_base_styles

تعیین کنید که آیا CSS موقعیت پیش فرض صفحه نتایج، اعمال می شود یا خیر.

توجه: این جدا از ظاهر بصری نتایج جستجو است و فقط موقعیت یابی را کنترل می کند.