記事のタイトルだけを検索する方法
｜WP_Queryのsearch_columns

なぜタイトルにない記事まで検索結果へ出るのか

sは検索キーワードを指定する引数です。初期状態ではタイトル、抜粋、本文が検索対象になるため、キーワードがタイトルになくても、抜粋や本文に含まれていれば検索結果へ出ます。

検索する場所を制御するのがsearch_columnsです。指定できるのは、タイトルを表すpost_title、抜粋を表すpost_excerpt、本文を表すpost_contentの3つです。

ここでいう抜粋は、データベースのpost_excerptへ保存された文です。 抜粋欄が空の時にthe_excerpt()が本文から抜き出して表示する短文は、post_excerptだけの検索では探せません。SEOプラグインの説明文も、別のメタキーへ保存されていれば対象外です。

タイトル検索だけにしたい、本文に偶然出てくる語句を除きたい時に対象を狭めます。

search_columnsの基本的な使い方

search_columnsはsと組み合わせます。次はWordPressをタイトルだけから探す独自一覧です。クラシック子テーマのtemplate-parts/search-title-list.phpへ保存し、表示したいテンプレートのメインループ内でthe_post()の後にget_template_part( ‘template-parts/search-title-list’ );を呼びます。投稿本文やfunctions.phpの直下へ貼るコードではありません。

この例は結果を比較しやすくするため、公開済みの通常投稿3件をpost__inで選びます。最初にWordPress、後半で本文だけにあるWP_Queryを検索します。ID15・26・53は自分の投稿IDへ置き換え、対象を通常投稿全体へ広げる時はpost__inの行を外します。空配列を渡して「対象0件」を表す指定ではありません。

現在のWP Query Builderでは、詳細設定で「post / publish / 5」、検索語に「WordPress」、Search Columnsに「タイトル（post_title）」、post__inに「53,26,15」、orderbyに「post__in」、ignore_sticky_postsにtrueを入力しました。自動高速化はオフです。次の$argsは、その実画面で生成された内容を変更せずに使っています。

<?php$args = array(    'post_type' => 'post',    'post_status' => 'publish',    'posts_per_page' => 5,    's' => 'WordPress',    'search_columns' => array(        'post_title'    ),    'orderby' => 'post__in',    'post__in' => array(    53,    26,    15),    'ignore_sticky_posts' => true); $query = new WP_Query( $args ); if ( $query->have_posts() ) {   echo '<ul>';    while ( $query->have_posts() ) {      $query->the_post();       printf(         '<li><a href="%s">%s</a>（ID: %d）</li>',         esc_url( get_permalink() ),         esc_html( get_the_title() ),         get_the_ID()      );   }    echo '</ul>';} else {   echo '<p>一致する投稿はありませんでした。</p>';} wp_reset_postdata();

Builderが生成したのは$argsまでです。その後のnew WP_Query()、リンクと投稿IDの表示、0件時の文言、wp_reset_postdata()は、結果を確かめるために手動で追加しています。

sに語句、search_columnsに探す場所を入れます。the_post()を使った後は、通常の別ループと同じくwp_reset_postdata()で投稿データを戻します。

この例は検索対象の違いを見るため、post__inへ比較用の3投稿を53・26・15の順で入れ、orderby => ‘post__in’でその順番を保ちます。関連度による順位の違いは混ぜていません。先頭固定の特別扱いも外しています。確認用として追加した場合は、終了後に呼び出しとファイルを撤去してください。

タイトルだけならID53の1件になる

検索対象を変更する前後で、代表的な検索語の結果を比べます。本番と分けてサーバー上でも試したい場合は、XserverのPHP対応やバックアップ条件を確認できます。

search_columnsを使うと便利な場面

検索結果が多すぎる時や、用語集などをタイトル検索に近づけたい時に向きます。

対象を狭めるほどノイズは減りますが、本文にしかない語句は見つからなくなります。 代表的な検索語で変更前後を比べて決めます。

タイトルと抜粋だけを検索対象にする例

タイトルだけでは狭すぎる場合は抜粋も加えます。次の差分を、最初の$args定義直後、$query = new WP_Query( $args );より前へ置きます。検索語や対象投稿、表示ループはそのままです。

$args['search_columns'] = [ 'post_title', 'post_excerpt' ];

ID53に加え、抜粋にWordPressがあるID26も表示されます。post_contentを含めていないため、本文だけに検索語がある投稿は対象外です。

本文だけにある語でも検索対象を比べる

同じ3投稿でsだけをWP_Queryへ変えると、タイトルのみ・タイトルと抜粋では0件です。search_columnsを[ ‘post_content’ ]へ変えると、本文にその語があるID15が出ます。指定を外した標準の3列検索でもID15が出ます。

0件の時は本文コードの「一致する投稿はありませんでした。」を表示します。タイトルだけの検索で本文の語が出ないことは、クエリの不具合ではなく、指定どおりの結果です。

検索対象を変えた結果の違いが分かったら、WP Query Builderで検索語と対象カラムを整理できます。生成した$argsを表示ループへ渡し、タイトルにある語と本文だけの語で結果を見比べます。

search_columnsでカスタムフィールドは検索できる？

カスタムフィールドの値を探したい場合はACFの値が検索できない時の確認ポイントへ進みます。検索条件を減らしても0件のままなら、投稿が表示されない時のチェックリストで出力側まで切り分けてください。

カスタムフィールドで絞り込みたい場合は、search_columnsではなくmeta_queryを検討します。たとえば、価格、開催日、表示フラグ、商品コードのような値で投稿を絞るなら、検索キーワードsではなく、カスタムフィールドの条件として考えた方が整理しやすいです。

カスタムフィールド、タクソノミー、投稿タイプの条件は、それぞれmeta_query、tax_query、post_typeへ分けます。

search_columnsを使うときの注意点

search_columnsはWordPress 6.2で導入されました。配布テーマやプラグインで使う場合は、対象環境が6.2以降かを確認します。

これは検索範囲の指定であり、検索性能を一律に解決する設定ではありません。

うまく動かないときの確認順

s、投稿タイプ、検索対象カラムだけの最小構成で確認します。post_typeやpost_statusで、対象投稿が最初から外れていないかも見てください。

対応しない列名は除かれます。たとえば[ ‘post_title’, ‘price’ ]なら有効なpost_titleが残るため、タイトル検索です。[ ‘price’ ]のように有効な列が一つもない場合や空配列では、標準の3列へ戻ります。 「間違った列名なら0件になるはず」とは考えないでください。

この3投稿をWordPressで探す場合、[ ‘post_title’, ‘price’ ]はID53、[ ‘price’ ]と空配列はID53・26です。query varsには指定した値が残ることもあるので、それだけで有効な検索対象を判断せず、実際の結果や生成SQLも見ます。post_search_columnsフィルターを使うテーマ・プラグインの影響も切り分けます。

なお、sを外すとsearch_columnsだけでは検索しません。この例なら比較用の3投稿すべてが出ます。検索フォームの未入力を「0件」と扱いたい場合は、空のキーワードでクエリを実行する前に案内を出す分岐が必要です。

タイトルだけを対象にして本文だけの語句が出ないのは正常です。タイトルにある1語でも出ない場合は、投稿タイプ、公開状態、表記、別条件を確認します。

この記事のコードは別のWP_Queryによる独自一覧です。サイト全体の検索フォームやメイン検索クエリを自動で変更するものではありません。フォーム連携では検索語の受け渡しと未入力時の動き、メイン検索の変更ではpre_get_postsの対象条件を別に設計します。

search_columnsと検索対象カラムの公式資料

WP_Queryの公式リファレンスでs、search_columns、対応カラムを確認できます。