【WordPress】特定のカスタムフィールドが空の投稿を一覧に非表示にする方法

WordPressでは、カスタムフィールドを使って投稿に独自の情報（価格・会社名・商品コードなど）を追加できますが、その値が空の投稿を一覧に表示させたくないというニーズはよくあります。

たとえば、価格情報が未入力の商品や、会社名が未設定の投稿などは、表示対象から除外してユーザーに未完成の投稿を見せないようにしたい場合です。

この記事では、指定したカスタムフィールドが空の投稿を一覧表示から除外する方法を紹介します。functions.php にコードを追加するだけで簡単に実装できます。

実装方法 pre_get_posts フィルターを使う
コードの解説
カスタム投稿タイプにも適用したい場合
複数フィールドで判定したい場合
注意点
よくある質問（FAQ）
まとめ

実装方法 pre_get_posts フィルターを使う

以下のコードを functions.php に追加してください。

例：price というカスタムフィールドが空の投稿を非表示にする

function exclude_empty_custom_field_posts($query) {
  if (!is_admin() && $query->is_main_query() && (is_home() || is_archive() || is_search())) {
    $meta_query = array(
      array(
        'key'     => 'price', // カスタムフィールド名
        'value'   => '',
        'compare' => '!=',
      ),
    );
    $query->set('meta_query', $meta_query);
  }
}
add_action('pre_get_posts', 'exclude_empty_custom_field_posts');

コードの解説

!is_admin()：管理画面では処理を適用しない
$query->is_main_query()：メインクエリ（一覧表示の本体）にのみ適用
is_home() || is_archive() || is_search()：トップページ・アーカイブ・検索結果に限定（必要に応じて調整可）
‘compare’ => ‘!=’ と ‘value’ => ”：空でない値を持つ投稿だけを対象とする

カスタム投稿タイプにも適用したい場合

たとえば product というカスタム投稿タイプに限定したい場合は、is_post_type_archive(‘product’) を追加します。

if (!is_admin() && $query->is_main_query() && is_post_type_archive('product')) {
  // カスタム投稿タイプ product 用の処理
}

複数フィールドで判定したい場合

meta_query を配列で拡張すれば、複数のカスタムフィールドを条件に含めることも可能です。

$meta_query = array(
  'relation' => 'AND',
  array(
    'key'     => 'price',
    'value'   => '',
    'compare' => '!=',
  ),
  array(
    'key'     => 'company_name',
    'value'   => '',
    'compare' => '!=',
  ),
);