えっ!?まだスマホで見にくいんですか?スマホ最適化リノバスなら標準仕様です。ウェブ制作会社にお困りなら今すぐチェック

WP_Queryパラメータ(カスタムフィールド編)

前回ご紹介しました「WP_Queryパラメータ(カテゴリ編)」に続いて今回もWP_Queryのパラメータのご紹介をしたいと思います。

今回はカスタムフィールドのパラメータです。

カスタムフィールドとは、投稿の編集画面をカスタマイズできるとっても便利な機能です!
このカスタムフィールドで設定した値を元にWP_Queryで表示を絞りこむことができるのです!

今回はWP_Queryのパラメータのご紹介になるので、カスタムフィールドについてはまた後日記事にして紹介させていただきます。

カスタムフィールドのパラメータ

下の画像のようにカスタムフィールドの設定を行っていたとします。

カスタムフィールドの設定画面

単一のカスタムフィールド

「原産国(meta_key)」「イギリス(meta_value)」の犬だけを表示する例です。

出力結果
  • meta_key (文字列)カスタムフィールドのキーを指定します。
  • meta_value (文字列) カスタムフィールドの値(文字列として比較します)。
  • meta_value_num (数値) カスタムフィールドの値(数値として比較します)。
  • meta_compare (文字列) ‘meta_value’のテスト演算子。
    使える値は ‘!=’, ‘>’, ‘>=’, ‘<', '<=', 'LIKE', 'NOT LIKE', 'IN', 'NOT IN', 'BETWEEN', 'NOT BETWEEN', 'NOT EXISTS', 'REGEXP', 'NOT REGEXP', 'RLIKE' です。デフォルトは '=' です。

複数のカスタムフィールド

今度は「原産国(meta_key)」「イギリス(meta_value)」かつ「体重(meta_key)」「24 kg(meta_value)」以上という条件で表示します。

出力結果

配列を入れ子にしてより複雑な指定をすることもできます。

「原産国(meta_key)」「イギリス(meta_value)」の「体高(meta_key)」「53 cm(meta_value)」以上、かつ「原産国(meta_key)」「日本(meta_value)」といった条件でも出力することができます。

出力結果
  • meta_query (配列) カスタムフィールドの複雑なパラメータを指定します。
  • relation (文字列) meta_queryの中に2つ以上の配列を入れたときの論理的な関係。使える値は ‘AND’ と ‘OR’ です(デフォルト: ‘AND’)。ひとつだけ配列を入れるときは使わないでください。
  • key (文字列) カスタムフィールドのキーを指定します。
  • value (文字列|配列) – カスタムフィールドの値を指定します。
    配列を指定できるのは compare が ‘IN’, ‘NOT IN’, ‘BETWEEN’ または ‘NOT BETWEEN’ の場合です。
    WordPress 3.9 以上で compare に ‘EXISTS’ または ‘NOT EXISTS’ を指定する場合は value を省略できます。
  • compare (文字列) テスト演算子を指定します。使える値は ‘=’, ‘!=’, ‘>’, ‘>=’, ‘<', '<=', 'LIKE', 'NOT LIKE', 'IN', 'NOT IN', 'BETWEEN', 'NOT BETWEEN', 'EXISTS' および 'NOT EXISTS' です。デフォルトは '=' です。
  • type (文字列) カスタムフィールドの値のタイプを指定します。
    使える値は ‘NUMERIC’, ‘BINARY’, ‘CHAR’, ‘DATE’, ‘DATETIME’, ‘DECIMAL’, ‘SIGNED’, ‘TIME’, ‘UNSIGNED’ です。デフォルトは ‘CHAR’ です。’DECIMAL’ と ‘NUMERIC’ には有効桁数と小数点以下の桁数を指定できます。

meta_queryは検索条件の配列をパラメータにします。配列を組み合わせることで複雑な条件にも対応できて優れものですね!
配列アレルギーの私にはなかなか使いこなすまでが大変ですが、どんどんチャレンジしてみたいなと思います。

今回ご紹介したmeta_queryとは切っても切れないカスタムフィールド。次回はこちらについてご紹介できればと思います!

えっ!?まだスマホで見にくいんですか?スマホ最適化リノバスなら標準仕様です。ウェブ制作会社にお困りなら今すぐチェック