説明
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 にはウィジェットがあるため、好きな場所にライブ検索フォームを挿入できます。
スクリーンショット
ブロック
このプラグインは1個のブロックを提供します。
- Search Form The best WordPress search you can find.
インストール
- プラグインをダウンロードし、ファイルを解凍します
searchwp-live-search
を~/wp-content/plugins/
ディレクトリにアップロードします- WordPress の「プラグイン」メニューから、プラグインを有効化します
- オプションで設定をカスタマイズします: 詳しいドキュメンテーションはこちら
- オプションで結果テンプレートをカスタマイズします: 詳しいドキュメンテーションはこちら
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
値を好きなようにカスタマイズできます。
評価
貢献者と開発者
変更履歴
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
- 最初のリリース !