WP_Query 用語custom post type

WordPress には、標準で投稿や固定ページがあります。custom post type は、それとは別に「イベント」「商品」「制作実績」「求人」など、サイト固有の情報を専用の投稿タイプとして管理したい時に使います。

初心者が最初に押さえるべきなのは、custom post type はカテゴリーではないという点です。カテゴリーは投稿を分類するためのものです。custom post type は、投稿そのものの種類を分けるための仕組みです。

custom post type は何を指す言葉か

custom post type は、WordPress に追加できる独自の投稿タイプです。通常投稿の post や固定ページの page と同じように、WordPress の投稿データとして扱われます。

たとえば、ブログ記事は通常投稿、イベント情報は event、商品情報は product、制作実績は work のように分けると、管理画面でもテンプレートでも扱いやすくなります。

custom post type を使うと、情報の種類ごとに管理画面やURL、テンプレート、一覧表示を分けられます。通常投稿にすべてを詰め込まず、サイト構造へ役割を持たせる方法です。

一方で、何でも custom post type にすればよいわけではありません。単なる分類で足りるものは taxonomy、値の追加で足りるものは custom field で管理するほうが自然な場合もあります。

taxonomy や custom field との違い

custom post type と混同しやすいのが taxonomy と custom field です。custom post type は投稿の種類、taxonomy は分類、custom field は追加情報です。

たとえば、イベント情報を event という custom post type にし、ジャンルは taxonomy、開催日や会場は custom field にします。コンテンツ、分類、追加項目を別の役割として持たせる例です。

この3つを混同すると、サイト構造が分かりにくくなります。商品をカテゴリーで無理に分けるより、商品を custom post type にし、商品カテゴリーを taxonomy にするほうが自然な場合があります。

一方で、ブログ記事の中で「ニュース」「コラム」「お知らせ」を分けたいだけなら、通常投稿のカテゴリーで足りることもあります。管理や表示をどこまで分けたいかで判断します。

Builder での扱い

WP Query Builder では、custom post type は post_type の選択肢として扱う想定です。ユーザーが「イベント」や「商品」を選ぶと、内部では post_type => ‘event’ や post_type => ‘product’ のようにコード化します。

管理画面ラベルとコード上の投稿タイプ名は、「イベント（event）」のように並べて表示します。画面上の名称と post_type に入る値を取り違えないためです。

custom post type と taxonomy、custom field を組み合わせる場合もあります。Builder では、まず投稿タイプを選び、その投稿タイプに紐づく taxonomy や custom field を選ぶ流れにすると、条件を組み立てやすくなります。

使いどころ・避けどころと実践確認

商品、事例、イベントなど、通常投稿と異なる構造や管理目的を持つコンテンツを説明する時に使います。

見た目やカテゴリーだけが違う記事を分けるために、理由なく投稿タイプを増やすのは避けます。

表示ラベルではなく登録時の投稿タイプキーを post_type へ渡し、公開状態とアーカイブ設定も別に確認します。

投稿タイプを分ける判断は見た目ではなく、管理・権限・URL・入力項目を通常投稿と分ける必要があるかで行います。

get_post_types() の登録値、対象投稿の post_type と post_status、最小クエリで取得できた投稿IDを同時に記録します。

実践記事で確認WP_Queryのpost_type指定方法

post・page・any・独自キーの違いを、実際の $args へ置くところまで確認できます。

記事を読む →

WordPressの仕様で確認するポイント

公式資料では、register_post_type() のリファレンスで custom post type の登録方法を確認できます。WP_Query のリファレンスでは、登録した投稿タイプを post_type で取得する方法を確認できます。

また、Plugin Handbook の custom post types に関する資料では、custom post type をどのように登録し、どう扱うかの考え方を確認できます。

custom post type は、通常投稿や固定ページとは別に、独自の投稿タイプを追加する仕組みです。イベント、商品、制作実績など、通常投稿とは分けて管理したい情報に向いています。

迷った時は、それがコンテンツの種類なのか、分類なのか、追加情報なのかを先に分けます。種類なら custom post type、分類なら taxonomy、追加情報なら custom field を検討します。