説明
SearchWP Modal Search Form を使用すれば、アクセスしやすく軽量なモーダル検索フォームを WordPress サイトに簡単に統合できます ! SearchWP Modal Search Form では SearchWP は必須ではありませんが、SearchWP がインストールされ、有効化されている場合には利用します ! 👍
この README
に記載されている情報に加え、詳しいドキュメンテーションもご利用いただけます。
他のモーダルとの違い
SearchWP Modal Search Form は、アクセスしやすく軽量なモーダル検索フォームを簡単に実装できるようにする、という理念に支えられています。そして、優れた開発者 (およびユーザー) エクスペリエンスの実現も重視しています。
SearchWP Modal Search は WordPress と直接統合されます。デフォルトのモーダルフォームテーマは、有効なテーマで設定されたスタイルを基に作成されるため、オーバーヘッド を最小限に抑えられます。また、万能なテンプレートローダーも組み込まれているため、SearchWP Modal Search Form を最小限の手間で「完全にカスタマイズ」することができます。
カスタマイズの簡単さを示す例として、デフォルトのテンプレートを確認してみてください 🤓
サイトにモーダルフォームを追加
SearchWP Modal Search Form を使用すると、WordPress サイトのあらゆる場所にモーダル検索フォームを簡単に実装できます。組み込み済みの次の方法をご利用いただけます。
- メニュー項目として追加
- ショートコードを使用して追加
- Gutenberg ブロックとして追加
- プログラムでテンプレート内に追加
テンプレートのカスタマイズ
SearchWP Modal Search Form には、あらゆるテンプレートに検索フォームを表示する固有のテンプレートローダーがあり、テンプレートごとにモーダルの外観を「完全にカスタマイズ」することができます。
カスタムテンプレートは、次の方法で最も簡単に作成できます。
- テーマ内に
searchwp-modal-form
という名前のフォルダーを作成します - そのフォルダー内に
template.php
という名前 (または末尾が.php
の任意の名前) のファイルを作成します - デフォルトテンプレートの内容をそのファイルにコピーします
- ヘッダーコメントブロックで
SearchWP Modal Form Name
の値をカスタマイズします - ドキュメンテーションを参照しながら、マークアップやスタイルを好みに応じてカスタマイズします
モーダルの開閉時に (jQuery) イベントが発生する場合があります。jQuery は「依存関係はありません」が、jQuery が読み込まれている場合にはイベントが発生します。
// Add a callback when a modal is opened:
jQuery('body').on('searchwpModalOnShow', function(e) {
// Focus an input in the template.
e.el.find('input').focus();
});
// Add a callback when a modal is closed:
jQuery('body').on('searchwpModalOnClose', function(e) {
alert('Modal closed!');
});
詳細については、テンプレートの詳しいドキュメンテーションをご覧ください。
スクリーンショット
ブロック
このプラグインは1個のブロックを提供します。
- Modal Form
インストール
SearchWP Modal Search Form は他のすべての WordPress プラグインと同じ方法でインストールできます。インストールするには、WordPress ダッシュボードにログインして管理メニューの「プラグイン」 >「新規プラグインを追加」
項目を使用し、SearchWP Modal Search Form
を検索します。
または、次のように手動でプラグインをインストールすることもできます。
- プラグインをダウンロードし、ファイルを解凍します
searchwp-modal-form
フォルダーを~/wp-content/plugins/
ディレクトリにアップロードします- WordPress の「プラグイン」メニューから、プラグインを有効化します
- 利用可能な複数の方法で、1つまたは複数のモーダルフォームを追加します
FAQ
-
ドキュメンテーションはありますか ?
-
もちろんです ! 詳しいドキュメンテーションをご覧ください。
-
モーダルフォームをサイトに追加するにはどうすればよいですか ?
-
モーダルフォームトリガーをサイトに追加するには、複数の方法があります。モーダルフォームトリガーは、好きな場所に好きな数だけ追加できます。
- メニュー項目として追加
- ショートコードを使用して追加
- Gutenberg ブロックとして追加
- プログラムでテンプレート内に追加
-
モーダルをカスタマイズするにはどうすればよいですか ?
-
詳細については、テンプレートの詳しいドキュメンテーションをご覧ください。
評価
貢献者と開発者
変更履歴
0.5.3
– 一部のテーマで表示される “Call to undefined method” エラーを修正しました。
0.5.2
– PHP 8.2の非推奨の通知を修正しました。
– デフォルトテンプレートの HTML タグのセマンティクスを改善しました。
– Modal Form Gutenberg ブロックをページに追加する際のエラーを修正しました。
– SearchWP の現在のバージョンとシームレスに連携するように、設定ページの外観とメニュー構造を変更しました。
0.5.1
– SearchWP から最新の更新を取得するためのプラグイン内通知システムを追加しました。
0.5.0
– プラグインの動作をより簡単にコントロールするために設定管理ページを新たに追加しました。
0.4.1
– PHP 8との互換性
0.4.0
– 一部のケースにおける文字エンコーディングの問題を修正しました
– 依存関係を更新しました
– bundler および関連する NPM コマンドを更新しました
0.3.4
– SearchWP 4使用時のエラーを修正しました
0.3.3
– 0.3.2で発生していた特定ケースにおけるエラーを修正しました
0.3.2
– SearchWP 4.0との互換性 (利用可能になり次第)
– メニュー項目の HTML 出力に関する問題を修正しました
0.3.1
– 未使用のスタイルシートのエンキューを削除しました
– 依存関係を更新しました
0.3
– 依存関係を更新しました
– モーダルの開閉時の jQuery イベントを追加しました
0.2.3
– 0.2.2で発生し、Enter キーでの検索を妨げていた不具合を修正しました
0.2.2
– 一部のケースでモーダルトリガーが動作しない問題を修正しました
0.2.1
– $this
コンテキストの致命的エラーを修正しました
0.2
– class
引数のサポートを追加しました
– button
タイプに関する問題を修正しました
0.1
最初のリリース