the_search_query()


WordPressのthe_search_query()関数は、検索フォームでユーザーが入力した検索クエリを表示するために使用されます。この関数は、検索結果ページでユーザーが何を検索したかを表示する際に役立ちます。

構文

the_search_query();
  • the_search_query()は引数を取りません。

例1: 検索クエリの表示

検索結果ページでユーザーが入力した検索クエリを表示する基本的な例です。

<?php the_search_query(); ?>

例2: 検索クエリをエスケープして表示

セキュリティを考慮して、検索クエリをエスケープして表示します。

<?php echo esc_html( get_search_query() ); ?>

例3: 検索フォームに検索クエリを表示

検索フォームの入力フィールドに、前回の検索クエリを表示します。

<input type="text" name="s" value="<?php the_search_query(); ?>" />

例4: 検索クエリが空の場合の処理

検索クエリが空の場合にデフォルトのテキストを表示します。

<?php if ( get_search_query() ) { the_search_query(); } else { echo '検索キーワードを入力してください'; } ?>

例5: 検索クエリをタイトルに表示

検索結果ページのタイトルに検索クエリを表示します。

<title><?php echo get_search_query(); ?>の検索結果</title>

例6: 検索クエリをメタタグに表示

検索クエリをメタタグのdescriptionに表示します。

<meta name="description" content="<?php echo esc_attr( get_search_query() ); ?>の検索結果">

例7: 検索クエリをURLに含める

検索クエリをURLに含めてリダイレクトします。

<?php wp_redirect( home_url( '/?s=' . urlencode( get_search_query() ) ) ); exit; ?>

例8: 検索クエリをログに記録

検索クエリをログファイルに記録します。

<?php error_log( '検索クエリ: ' . get_search_query() ); ?>

注意点

  • the_search_query()は、検索結果ページでのみ使用することを推奨します。
  • 検索クエリを表示する際は、エスケープ処理を行い、セキュリティに注意してください。

関連機能：