get_search_query

（2.3.0以降）
get_search_query - 検索キーフレーズをする

説明

string get_search_query( [ bool $escaped = true ] )
ユーザによって検索フォームで入力された検索キーフレーズを取得する。

パラメータ

  • $escaped
    エスケープ処理を行う場合はtrue、行わない場合はfalseを指定

返り値

検索キーフレーズを返す。検索キーフレーズが未入力の場合は""を返す。

注意

返り値はstripslashes関数(PHP)によってバックスラッシュを取り除かれた文字列になる。

使用例

  • 検索キーフレーズを取得する。
    <?php $query = get_search_query( ); ?>
  • エスケープ処理を行わずに検索キーフレーズを取得する。
    <?php $query = get_search_query( false ); ?>

フィルター

'get_search_query'フィルターを呼び出す。$queryには、 get_query_var( 's' )で取得した値が格納される。 
$query = apply_filters( 'get_search_query', $query );

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/general-template.php

最終更新 : 2018年05月27日 10:50

関連

参考

Code Reference: get_search_query

お勧め

サイトヘルス機能を使ってみた（2019年4月12日 更新）

先月末にWordPress 5.2 Beta1が、今日はWordPress 5.2 Beta2（以降5.2Beta2）が公開された。5.2ではブロックエディターの機能が強化され、サイトの安全性とパフォーマンス向上に役立つとされるサイトヘルス機能が追加される。

管理者ページに文言を表示する（2012年4月19日 更新）

お客様向けに管理者ページをカスタマイズする機会が増えてきている。カスタマイズするページや表示場所、表示内容によっていくつかの手段があるが、今回はページの冒頭部分に任意の文言を表示する方法を紹介する。

WordPressのコーディングスタンダードとPSR-2がかみ合わない（2018年5月27日 更新）

先日パソコンのストレージを換装して開発環境を再構築。エディタのEclipseは「Neon（4.6）」から「Oxygen（4.7）」へ切り替わった。コードを書き始めるとそこはかとなく違和感があり、調べていくとPHPの「Code Style（Formatter）」が「PSR-2」に設定されていることが原因だった。

Widgets on dashboard：プラグイン作ってみました（2014年5月7日 更新）

サイトバーなどのページ構成パーツとしてウィジェットを利用し、ある程度頻繁に更新している場合、毎回ウィジェットページを表示するのはちょっとだけ面倒かも。そんなわけで、シンプルにダッシュボードで直接編集できればいいかなと思い、調べてみました。

5.7の機能拡張：投稿一覧画面向けのフィルター（2021年2月18日 更新）

昨日、予定通り公開された「WordPress 5.7 Beta 3（以降Beta 3）」。WordPressはバージョンアップ毎にアクションやフィルターが追加されており、今回のバージョンアップでは投稿一覧画面に影響を与えるフィルターが追加されていた。