SearchWP Live Ajax Search

説明

SearchWP は必須ではありませんが、利用可能であれば利用します。詳しいドキュメンテーションを searchwp.com でご覧ください。

SearchWP Live Ajax Search は、検索フォームで AJAX 対応のライブ検索 (動的検索) を可能にします。開発者の強い味方となるように設計された SearchWP Live Ajax Search は、開発者の作業を妨げることなく、全面的にカスタマイズ可能にすることを目標にしています。あらゆる WordPress テーマと連動するように設定されており、テンプレートローダーを使用して結果を表示します。テンプレートベースのアプローチにより、多くの面倒なオプションに煩わされることなく SearchWP Live Search の実装をシームレスにカスタマイズできます。

SearchWP と最適に機能 (ただし SearchWP は必要なし)

SearchWP Live Ajax Search は SearchWP と「併用すると最適に使用」できますが、SearchWP は必須ではありません。SearchWP がインストールされ有効化されている場合、SearchWP Live Ajax Search をカスタマイズして、「検索フォームごとに」任意の検索エンジンを使用するように設定できます。

カスタマイズ

SearchWP Live Ajax Search の実装は、開発者が定義した任意の数の構成を含め、大幅にカスタマイズできます。結果はテンプレートローダーに基づいており、開発者は SearchWP Live Ajax Search により制限されることなく、結果テンプレートを他の WordPress テーマファイルと同様の方法で作成できます。

検索フォームの入力フィールドに HTML5のデータ属性 ( data-swplive="true") を1つ追加するだけで、「すべてが」機能するようになります。これは、get_search_form() から生成されたすべての検索フォームに対して魔法のように自動的に行われます。

ウィジェットのサポート

SearchWP Live Ajax Search にはウィジェットがあるため、好きな場所にライブ検索フォームを挿入できます。

スクリーンショット

  • SearchWP Live Ajax Search 結果のドロップダウン
  • SearchWP Live Ajax Search 設定ページ
  • SearchWP Live Ajax Search フォーム設定ページ
  • SearchWP Live Ajax Search フォーム埋め込みオプション

ブロック

このプラグインは1個のブロックを提供します。

  • Search Form The best WordPress search you can find.

インストール

  1. プラグインをダウンロードし、ファイルを解凍します
  2. searchwp-live-search~/wp-content/plugins/ ディレクトリにアップロードします
  3. WordPress の「プラグイン」メニューから、プラグインを有効化します
  4. オプションで設定をカスタマイズします: 詳しいドキュメンテーションはこちら
  5. オプションで結果テンプレートをカスタマイズします: 詳しいドキュメンテーションはこちら

FAQ

ドキュメンテーションはありますか ?

もちろんです ! 詳しいドキュメンテーションをご覧ください

検索フォームにライブ検索を追加するにはどうすればよいですか ?

SearchWP Live Ajax Search は、get_search_form() で生成された検索フォーム上で自動的に有効化されます。ただし、次のフィルターでこれを防ぐことができます。

add_filter( 'searchwp_live_search_hijack_get_search_form', '__return_false' );

カスタム検索フォームで SearchWP Live Ajax Searchを手動で有効にしたい場合は、フックしたい input に data 属性 data-swplive="true" を追加するだけです。

検索結果はどのように生成されるのですか ?

デフォルトでは、SearchWP を使用している場合には、SearchWP Live Ajax Search はデフォルトの SearchWP 検索エンジンを使用します。SearchWP を使用していない場合は、WordPress ネイティブの検索結果が示されます。SearchWP が使用する検索エンジンをカスタマイズしたい場合は、フォーム input に属性 data-swpengine="supplemental" を追加するだけです。’supplemental’ を使用する検索エンジン名に置き換えてください。

結果テンプレートをカスタマイズするにはどうすればよいですか ?

SearchWP Live Ajax Search はテンプレートローダーを使用しています。プラグインのフォルダーには templates フォルダーがあり、search-results.php が含まれています。これは、検索結果の出力にそのまま使用されます。この出力をカスタマイズするには、searchwp-live-ajax-search という名前のフォルダーをテーマディレクトリに作成し、そこに search-results.php をコピーするだけです。SearchWP Live Ajax Search は、プラグイン付属のファイルの代わりに「そのファイルを使用」するため、他のテーマテンプレートファイルと同様にファイルをカスタマイズすることができます。

SearchWP Live Ajax Search は2つのスタイルセットを出力します。 1つ目のスタイルセットは、結果のラッパーを適切に配置できるように準備し、2つ目のスタイルセットは視覚的な外観をコントロールします。このような抽象化は、カスタマイズをできるだけ簡単にするためのものです。 該当するスタイルシートをデキューすることで、デフォルトの「テーマ」だけでなく基盤の CSS も無効化できます。 詳しくはドキュメンテーションをご覧ください。

スピナーをカスタマイズするにはどうすればよいですか ?

SearchWP Live Ajax Search では、使用する設定を完全にカスタマイズできるフィルター (searchwp_live_search_configs) を使用します。このフィルターで渡される配列に新しいキーを追加するだけで、default 値を好きなようにカスタマイズできます。

評価

2024年7月8日 1 reply
After initially a bad experience with support, since they have been extremely helpful with this plugin and have provided code and knowledge bases to help do the things we want
2023年12月20日 1 reply
Установил, активировал. Вроде работает, будем разбираться.
2023年12月18日 1 reply
Great job to the developer! This is amazing. The customization options have been thought through incredibly well.
2023年5月16日
data-swpengine attribute was exactly what I was looking for, I’ve should come here much earlier 🙂
34件のレビューをすべて表示

貢献者と開発者

SearchWP Live Ajax Search はオープンソースソフトウェアです。以下の人々がこのプラグインに貢献しています。

貢献者

“SearchWP Live Ajax Search” は5ロケールに翻訳されています。 翻訳者のみなさん、翻訳へのご協力ありがとうございます。

“SearchWP Live Ajax Search” をあなたの言語に翻訳しましょう。

開発に興味がありますか ?

コードを閲覧するか、SVN リポジトリをチェックするか、開発ログRSS で購読してみてください。

変更履歴

1.8.3

  • 一部のケースで発生するキャッシュプラグインとの問題を防ぎました。
  • ユーザー指定のディレクトリパスからカスタムテンプレートを読み込むためのサポートを追加しました。

1.8.2

  • Relevanssi Premium との連携を修正しました。

1.8.1

  • Live Search カスタムテンプレートの使用時に、一部のケースで発生していた不適切な結果を修正しました。

1.8.0

  • 検索フォームを追加しました。
  • SearchWP カスタム検索ソースのサポートを追加しました。
  • Live Ajax Search の設定ページで既存のカスタマイズオプションを改善し、新しいカスタマイズオプションを追加しました。
  • 翻訳ファイルを更新しました。
  • SearchWP が有効化されている場合の、プラグインリスト内の設定リンクの場所を修正しました。

1.7.6

  • SearchWP の現在のバージョンとシームレスに動作するように、設定ページの外観とメニュー構造を変更しました。

1.7.5

  • SearchWP の現在のバージョンに合わせて、管理設定ページのビジュアルスタイルを変更しました。

1.7.4

  • 一部のケースで、ウィジェットの高度な設定ボタンが設定を表示せずに消える問題を修正しました。
  • カスタムの親要素が構成で設定されている場合、本文の内容が上書きされる現象を修正しました。

1.7.3

  • SearchWP から最新の更新を取得するプラグイン内通知システムを追加しました。

1.7.2

  • SearchWP Modal Search Form プラグインの次期バージョンとの互換性を追加しました。
  • SearchWP プラグインのレガシーバージョンの問題を修正しました。

1.7.1

  • プラグインの翻訳を修正しました。

1.7.0

  • プラグインの動作をより簡単にコントロールするために、新しく設定管理ページを追加しました。
  • パフォーマンス向上のために、大幅なコードリファクタリングを実施しました。

1.6.3

  • 検索フィールド引数 ‘swpengine’ のサニタイズを改善しました。
  • プラグイン全体で、クラスの直接アクセスの制限を標準化しました。

1.6.2

  • WordPress ネイティブ検索で使用する際に、クエリに渡す引数を制限しました。

1.6.1

  • 1.6.0で導入された PHP 通知の問題を修正しました

1.6.0

  • ブロックエディター (Gutenberg) での検索フォームブロックのサポートを追加しました

1.5.0

  • SearchWP を使用しない場合の post_status、post_type、posts_per_page クエリー変数のサポートを追加しました
  • 翻訳ソースを更新し、修正されたテキストドメインで翻訳を更新しました
  • バンドルプロセスをリファクタリングしました
  • バンドルの依存関係を更新しました

1.4.6

  • SearchWP 4との互換性を追加しました

1.4.5

  • 引用フレーズのサポートに関する問題を修正しました
  • 登録時に検索から除外される投稿タイプに関する問題を修正しました (SearchWP による検索にのみ適用)

1.4.4

  • 場合によって bundle.js で発生する問題を修正しました

1.4.3

  • SearchWP が検索を実行する際にフィルターを抑制することで、SearchWP との互換性を向上しました
  • SearchWP Modal Search Form との互換性を修正しました

1.4.2

  • カスタム構成がスピナーを無効にする際の問題 (JavaScript エラー) を修正しました

1.4.1

  • スピナーのカスタマイズが正しく適用されるのを妨げる可能性がある問題を修正しました

1.4

  • デフォルトの結果テンプレートから投稿タイプを削除しました
  • 検索文字列における HTML エンティティに関する問題を修正しました
  • 翻訳ソースと翻訳を更新しました
  • bundler のビルドプロセスを更新しました
  • 該当する場合、アクセシビリティを更新しました
  • 検索入力が変更されると、保留中の検索が自動的にキャンセルされるようになりました

1.3.1

  • 結果テンプレート関数呼び出しのタイプミスを修正しました

1.3.0

  • アクセシビリティを多数改善しました (@geoffreycrofte に感謝)
  • 最小文字数に達していない場合のメッセージを追加しました。
  • ドイツ語の翻訳を追加しました (@stefan-meier に感謝)
  • ポーランド語の翻訳を追加しました (@boguslawski-piotr に感謝)
  • オランダ語の翻訳を追加しました (Stefan G. に感謝)
  • 翻訳ソースを更新しました

1.2.0

  • ビルドプロセスをよりシンプルに作り直しました
  • スクリプトのデバッグをサポートしました (mgratch に感謝)
  • 他のコードとの統合性を高めるため、フォームアクションの要件を削除しました (mgratch に感謝)
  • 再入力が速すぎると検索が行われない問題を修正しました (pierrestoffe に感謝)

1.1.8

  • Enter キーが押されたときに AJAX のキャンセルを防止するための設定オプションを追加しました
  • カスタマイズを簡単にするアクションをいくつか追加しました
  • 結果テンプレートの場所をカスタマイズするフィルターを追加しました

1.1.7

  • エンジン名が欠落していた問題を修正しました

1.1.6

  • 1つのページの複数のライブ検索インスタンスが、異なるエンジンを使用できない問題を修正しました

1.1.5

  • カスタム設定が使用されていても、カスタム設定内で results_destroy_on_blur プロパティが定義されていない場合に、このプロパティが正しく適用されない問題を修正しました

1.1.4

  • さらなる拡張 / 統合を容易にするために、多数の JavaScript イベントを追加しました

1.1.3

  • 旧バージョンのプラグインの JavaScript アセットが導入される、ビルドプロセスの問題を修正しました。

1.1.2

  • 結果を組み込みの投稿タイプに限定しなくなりました
  • 結果ペインの外側をクリックしたときに、結果ウィンドウが自動的に削除されないように results_destroy_on_blur 設定オプションを追加しました

1.1.1

  • SearchWP 補助エンジンがウィジェット構成に表示されない問題を修正しました
  • フランス語の翻訳を追加しました
  • セルビア語の翻訳を追加しました

1.1

  • WordPress ネイティブ検索を使用する際のデフォルトの投稿ステータスを定義しました
  • 検索前にクエリー引数を操作するための新規フィルター searchwp_live_search_query_args
  • 検索フィールドの上に結果を配置する際のオフセットを修正しました

1.0.6

  • PHP 警告のクリーンアップ

1.0.5

  • 新規アクション: searchwp_live_search_alter_results
  • Relevanssi のサポートを追加しました (Dave の WordPress Live Search の実装に基づいて)

1.0.4

  • ドキュメンテーションに記載されているように、デフォルトの結果テンプレートフォルダー名を searchwp-live-ajax-search に修正しました。
  • クエリーが空になった場合、結果ボックスを非表示にするように改善しました (Lennard Voogdt に感謝)
  • SearchWP と連携した場合に、結果にメディアが表示されない問題を修正しました

1.0.3

  • 結果なしという誤ったセットが返される問題を修正しました (Lennard Voogdt に感謝)

1.0.2

  • Enter/Return キーを押した場合に、検索クエリーが結果ページに渡されない問題を解決しました
  • DOING_AJAX の誤検出の可能性を修正しました (justinsainton に感謝)
  • デフォルトの結果テンプレートにおける get_the_ID() への不要な呼び出しを削除しました (justinsainton に感謝)
  • デフォルトの結果テンプレートにおいて、パーマリンクと投稿タイプ名にエスケープ処理を追加しました (justinsainton に感謝)
  • WordPress コアの翻訳文字列をカスタム文字列の代わりに利用するようにしました (justinsainton に感謝)
  • 既存のフィルターに対応できるように get_search_form フィルターの優先順位を上げました

1.0.2

  • セルビア・クロアチア語翻訳を追加しました (Andrijana Nikolic に感謝)

1.0.1

  • ディレクトリ URL の問題を修正しました
  • indexOf の JavaScrip エラーを修正しました

1.0

  • 最初のリリース !