WordPress5 カスタム投稿タイプ、カスタムタクソノミー（カテゴリ・タグ）をgutenbergに対応する

プラグインなしのカスタム投稿タイプやカテゴリ、タグをWordPress 5の標準エディタgutenbergで使うための方法です。

あまりにもかんたんです。1～2か所設定を変更するだけです。

かんたんに超高速WordPressでサイトを作る、KUSANAGIが使える低価格クラウド・VPS・レンタルサーバ

テーマやプラグインのカスタム投稿タイプやカテゴリ、タグで、WordPress 5の新しいエディタgutenbergで使えないときがあります。

カスタムのカテゴリやタグのことをカスタムタクソノミーといいます。

カテゴリやタグは、データ上はタクソノミーという同じ種類で管理しています。

カスタム投稿タイプの編集画面がgutenbergで開けない。
gutenbergの編集画面でカスタムカテゴリ・タグが設定のメニューが出ない。

など焦る人もいるでしょう。

Custom Post Tpye UIプラグインを使っているときは、プラグインの設定を変更するだけで対応できます。

-> Custom Post Type UIをgutenbergに対応させる

対応させる作業はとてもかんたんです。数秒で終わります。ただし、.phpファイルを編集します。作業をするときはバックアップを取ってからしましょう。

カスタムタクソノミー

register_taxonomy()を使っているソースコードを検索機能を使って探します。

コードを表示閉じる

function register_my_taxes_category_test() {
	$labels = array(
		"name" => __( "test category", "origin_theme" ),
		"singular_name" => __( "test category", "origin_theme" ),
	);

	$args = array(
		"label" => __( "test category", "origin_theme" ),
		"labels" => $labels,
		"public" => true,
		"publicly_queryable" => true,
		"hierarchical" => true,
		"show_ui" => true,
		"show_in_menu" => true,
		"show_in_nav_menus" => true,
		"query_var" => true,
		"rewrite" => array( 'slug' => 'category_test', 'with_front' => true, ),
		"show_admin_column" => true,
		"show_in_rest" => true,
		"rest_base" => "category_group",
		"rest_controller_class" => "WP_REST_Terms_Controller",
		"show_in_quick_edit" => false,
		);
	register_taxonomy( "category_test", array( "post" ), $args );
}
add_action( 'init', 'register_my_taxes_category_test' );

タクソノミーをつくるときに設定する項目（show_in_rest）がfalseになっていませんか？

または未設定ではないですか？

これをtrueにするだけです。未設定の場合は『"show_in_rest" => true,』を追加してください。たったこれだけです。

カスタム投稿タイプ

カスタム投稿タイプは、register_post_type()を使っているソースコードを検索機能を使って探します。

コードを表示閉じる

function register_my_cpts_test() {
	$labels = array(
		"name" => __( "test", "origin_theme" ),
		"singular_name" => __( "test", "origin_theme" ),
		"menu_name" => __( "test", "origin_theme" ),
	);

	$args = array(
		"label" => __( "test", "origin_theme" ),
		"labels" => $labels,
		"description" => "",
		"public" => true,
		"publicly_queryable" => true,
		"show_ui" => true,
		"delete_with_user" => false,
		"show_in_rest" => true,
		"rest_base" => "",
		"rest_controller_class" => "WP_REST_Posts_Controller",
		"has_archive" => false,
		"show_in_menu" => true,
		"show_in_nav_menus" => true,
		"exclude_from_search" => false,
		"capability_type" => "post",
		"map_meta_cap" => true,
		"hierarchical" => false,
		"rewrite" => array( "slug" => "test", "with_front" => true ),
		"query_var" => true,
		"supports" => array( "title", "editor", "thumbnail" ),
		"taxonomies" => array( "category", "post_tag" ),
	);

	register_post_type( "test", $args );
}
add_action( 'init', 'register_my_cpts_test' );

タクソノミーと同じように『"show_in_rest" => true』を設定します。

それともうひとつ、設定項目のsupportsを見てください。"editor"は入ってますか？

これがないとgutenbergでカスタム投稿タイプが使えません。supportsが未設定のときはデフォルトで"editor"が設定されるのでそのままでいいです。

たったこれだけです。

ちなみに、Classic Editorプラグインを使って旧エディタと併用するとき、新旧エディタ両方とも使えます。

gutenbergでカスタム投稿タイプ・タクソノミー（カテゴリ・タグ）を使うには

REST APIを有効化

REST API (Representational State Transfer API)

URLを指定すると常に同じ結果を返すAPI。

URLはユニークで、決まった処理のリクエストになるので、シンプルでわかりやすいのが特長。

処理を受けるサーバーも、URLを見れば何をすれば分かるのでシンプルで実装しやすい。

結果は、HTML, XML, JSONなどで返す。