カスタム投稿タイプでオリジナル投稿を作る（プラグインなし）

WordPressのデフォルトでは投稿や固定ページという投稿タイプが用意されており、これらを使用して記事を作成することができます。

カスタム投稿タイプは、このデフォルトで存在する投稿タイプとは別に新たに自分で作成した投稿のことを指します。

作成方法はプラグインを使用する方法もありますが、この記事ではプラグインを使わないでカスタム投稿を作る方法をメモしていきます。

コードに慣れている、プラグインはあまり使いたくない場合は自作していきましょう。
またプラグインは機能が決まっているため、思う通りのカスタム投稿タイプがプラグインでは作れない場合も自作する必要があります。

カスタム投稿タイプを作るコード

カスタム投稿を作成するだけならそんなに難しくはありません。functions.php に以下コードを記述すると管理メニューに「カスタム投稿」が追加され、記事を作成することができます。

add_action('init', 'create_post_type_01');
function create_post_type_01() {
  $args = [
    'label' => 'カスタム投稿',
    'public' => true,
    'has_archive' => true,  
  ];
  register_post_type('custom_post_name',$args);
}

コードを追加したのに投稿タイプが表示されない場合、パーマリンク設定画面で「変更を保存」ボタンをクリックし、リロードして表示されるか確認してみてください。

register_post_type() のコードを追加していけば、複数のカスタム投稿タイプを登録することもできます。

add_action('init', 'create_post_type');
function create_post_type() {
  $args1 = [
    'label' => 'カスタム投稿1',
  ];
  register_post_type('custom_post_name_one',$args1);

  $args2 = [
    'label' => 'カスタム投稿2',
  ];
  register_post_type('custom_post_name_two',$args2);
}

register_post_type() というコードでカスタム投稿が登録されます。

register_post_type('投稿タイプ名',  オプション設定配列（ここでは$args）);

登録したカスタム投稿タイプを使えるように add_action() を使用します。

add_action('init', '関数名');

投稿タイプ名で使えない名称もあり

カスタム投稿タイプ名を設定しますが、一部使えない名称があるため注意が必要です。すでにWordPressで使われている投稿タイプやWordPressの機能に干渉する名前は使用できません。

WordPressで投稿の種類というと投稿と固定ページが思い浮かびますが、投稿タイプはその他にも存在します。これらと同じ名称が使用できないので、このような投稿タイプがあることは覚えておきましょう。意図せず同じ名前をつけてしまった、という場合に覚えておくと対処しやすいです。

他にもWordPressの機能に干渉する名前もあるので、投稿タイプ名に使用しないようにします。

• action
• author
• order
• theme

この他、「wp_」 から始まる名前も使わない方がいいようです。今後WordPressの開発が進むにつれて投稿タイプ名に使用される可能性が高いためです。

「post_〇〇」や「theme_〇〇」といった名前なら問題ありません。

カスタム投稿タイプ作成コードの詳細

上述したコードは簡易的なものでしたが、カスタム投稿を作る際にはさまざまな機能を設定することができます。より柔軟にカスタマイズできるよう、設定コードの紹介とそれぞれどういった設定をしているのか詳細を記していきます。

// カスタム投稿タイプの追加
add_action('init', 'create_post_type');
function create_post_type() {
  // 投稿画面に表示するテキストを指定。初期値は「投稿」
  $labels = [
    'name' => '投稿タイプ名',
    'all_items' => 'すべての投稿を表すテキスト',
    'add_new_item' => '新規追加を表すテキスト',
    'edit_item' => '編集を表すテキスト',
  ];
  // 投稿タイプで追加・編集できる要素を指定。初期値はtitleとeditor。
  $supports = [
    'title',
    'editor',
    'thumbnail',
    'author',
    'custom-fields',
    'comments',
    'revisions',
    'page-attributes',
  ];
  $args = [
    'labels' => $labels,
    'public'  => true,
    'hierarchical'  => false,
    'has_archive'   => true,
    'supports'      => $supports,
    'menu_position' => 5,
    'taxonomies'    => array('new_category','new_tag'),
    'show_in_rest' => true,
    'rewrite'   => array( 'slug' => 'custom-slug' ),
  ];
  register_post_type('custom_post_name',$args);
}

基本の設定項目

$args の部分はカスタム投稿タイプを登録する際に必要になります。初期値で問題ない項目は省略しても大丈夫です。

    $args = [
      'labels' => $labels,
      'public'  => true,
      'hierarchical'  => false,
      'has_archive'   => true,
      'supports'      => $supports,
      'menu_position' => 5,
      'taxonomies'    => array('new_category','new_tag'),
      'show_in_rest' => true,
      'rewrite'   => array( 'slug' => 'custom-slug' ),
    ];

$labels や $supports は、別でまとめて設定している内容が入ります。私は配列で設定するものは先にまとめます。その方が見やすく変更しやすいというのと、複数投稿タイプを作成するときも使い回しがしやすいことが理由です。

ラベル設定【label, labels】

「label」や「labels」は 編集画面で表示されるテキストを設定する項目です。カスタム投稿名だけ設定すれば良いなら「label」で設定すればOK。編集画面でよりわかりやすい名称にしたい場合は複数のラベル設定ができる「labels」で設定します。

'label' => 'カスタム投稿',

'labels' => [
  'name' => 'カスタム投稿',
  // その他いろいろ設定可能
],

labels で設定できる内容は多くありますが、全てを設定せずとも投稿操作がしやすいように必要なところにラベルをつけていきましょう。

公開設定【public】

「public」は、管理画面からの編集や投稿を公開するかの設定で、デフォルトは管理画面やフロンドエンドで利用できないようになっています。なので通常の投稿のように利用する場合は 'public' => true, の記述が必須です。

「public」が false のときに利用する内容として、サイト側では使用しないものの管理画面上では登録して表示させたいデータ（例えばお問い合せや顧客管理など）を作成したいときがあげられます。

show_ui => true とすることで管理画面上では投稿の追加や編集、そしてその内容が閲覧できます。

add_action('init', 'create_post_type_02');
function create_post_type_02() {
  $args = [
    'label' => '管理画面のみで使用',
    'show_ui' => true,
  ];
  register_post_type('custom_post_name02',$args);
}

編集画面の機能設定【supports】

「supports」は投稿に使用する項目を設定します。初期値は title と editor です。
'supports' の記述がなければ title と editor のみ、'supports' があれば設定しているものが表示されるようになります。

title のみ、本文のみにしたいという場合は一方だけを記述します。この場合も配列で書くようにしてください。（配列で指定しないとエラーになる）

'supports'      => array('title'),
//  以下の書き方でもOK
'supports'      => ['title'],

全て設定していると新規投稿画面は以下のようになります。

メニューの表示位置【menu_position】

「menu_position」で管理メニューの任意の箇所に項目を表示させることができます。 初期値は「コメントの下」ですが、別の場所にしたい場合はこのパラメーターを使用して変更しましょう。

値は数字で設定します。デフォルトのメニューは以下の数値で設定されているので、表示させたい箇所の数字を設定してください。

一覧ページと詳細ページを表示する

カスタム投稿タイプを作成したら、一覧・詳細ページを表示させるためのファイルも追加する必要があります。

カスタム投稿タイプ、投稿タイプのテンプレートファイルを作成したら、ちゃんとページが表示されるか確認してみましょう。

カスタム投稿用のテンプレートファイルを作成

WordPressでは各ページに使用されるテンプレートファイルが、ファイル名で決められています。

「post_type_name」には投稿タイプ名に付けた名前が入ります。投稿タイプ名が product なら「archive-product.php」となります。

投稿タイプごとにデザインや表示方法を分けたい場合は、投稿タイプ名を追加したファイルを作ります。同じ表示でよければ archive.php や single.php があればOK。

これらのテンプレートファイルがない場合、index.php が使用されますので、うまく表示されない場合は、まずファイルが作成されているか確認してみてください。

「ページが見つかりません」（404）になってしまう

ページが表示されない場合、パーマリンク設定やコードの記述ミスがないか確認しましょう。

初めてカスタム投稿のページにアクセスした際に「ページが見つかりません」の状態になったら、まずは管理画面の【設定 > パーマリンク】で設定内容は変更せずとも「変更を保存」だけをクリックしてみてください。これだけで表示されることもあります。

カスタム投稿にカテゴリーやタグを追加（カスタムタクソノミー）

カスタム投稿タイプでは taxonomies の設定でカテゴリーやタグを追加することができます。投稿に使われているカテゴリーやタグを使用する場合は以下のように記述します。

'taxonomies' => array('category', 'post_tag')

投稿のカテゴリーやタグ以外を使用したい場合は、カスタムタクソノミーを作って指定します。

カスタムタクソノミーの作り方はこちら。
カスタムタクソノミーとは？WordPressでオリジナルの投稿分類を作る

【参照】register_post_type() | Function | WordPress Developer Resources