【WordPress】Gutenbergで
カスタム投稿に
タクソノミーが表示されない時

Gutenberg使ってますか?
WordPress5.0から採用された新しい管理画面のエディターです。
今回はClassic Editorをやめて、Gutenbergに変更した時に起きた問題を解決した時のメモ。
ちなみにカスタム投稿タイプやタクソノミーをプラグインでなくfunctions.phpで実装している環境下での解決策になります。

カスタム投稿タイプにGutenbergを適用する

デフォルトではカスタム投稿タイプにはGutenbergが適用されません。
functions.phpregister_post_type()のオプションに'show_in_rest' => trueを追記します。

register_post_type('blog', [
  'labels' => [
     'name' => 'ブログ'
     'singular_name' => 'ブログ'
  ],
  'public'       => true,
  'has_archive'  => true,
  'show_in_rest' => true, //追記
  ・・・(他の設定は省略)
]);

これでGutenbergがカスタム投稿タイプのエディタにも適用されます。

カスタム投稿タイプに設定したタクソノミーがない

タクソノミーもそのままでは表示されません。

functions.phpregister_taxonomy()にも'show_in_rest' => trueを追記します。

register_taxonomy(
  //タクソノミースラッグ名
  'blogtypes',
  //カスタム投稿タイプ名
  'blog',
  [
    'public'            => true,
    'hierarchical'      => true,
    'label'             => '記事カテゴリ',
    'show_ui'           => true,
    'query_var'         => true,
    'rewrite'           => true,
    'singular_label'    => '記事カテゴリ',
    'show_in_rest'      => true, //追記
    'show_admin_column' => true
  ]
);

これで「ブログ」カスタム投稿に「記事カテゴリ」タクソノミーが表示されるようになりました。

予約語に気を付ける

ある投稿タイプで上記と同じように設定をしても表示されないことがありました。
小一時間悩んでregister_taxonomy()の公式リファレンスを読むと「予約語」の存在に気づきました。

関数リファレンス/register taxonomy

予約語

https://wpdocs.osdn.jp/%E9%96%A2%E6%95%B0%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9/register_taxonomy#.E4.BA.88.E7.B4.84.E8.AA.9E

タクソノミースラッグ名にtypeという予約語を使ってしまっていたのが原因でした。
旧エディタではなぜか表示されていたので全くの盲点で時間を無駄にした…笑
こういう凡ミスでハマるとググってもぜんぜん解決できない場合が多くて焦るので、ちゃんとリファレンスは読むように気を付けましょう。←
スラッグは多少長くてもわかりやすい一意の名前を付けるようにしましょう。パーマリンクはrewriteオプションで変更できるし。

おわりに

弊社では新しく導入するWordPressではGutenbergを入れるようにしています。
今回のように細かな仕様変更で詰まる場合もありますが、そこはさすがWordPress。ググればヒントが必ず見つかります。
予約語は盲点でしたが・・笑

記事一覧

RELATED

inoue
TIPS

【CSS + JS】テキストの無限ループアニメーション

inoue
TIPS

【Shopify】カートへの遷移を飛ばしてチェックアウトに進むボタンを設置する

inoue
TIPS

【JS】PhotoSwipe v5を使って画像をポップアップ表示する

inoue
TIPS

gulpでjpg・pngからAVIF画像を生成する

inoue
TIPS

【JS】MutationObserverでDOMを監視[PhotoSwipe(v5)+Swiper(v8)連携]

inoue
TIPS

【Google Sheets API】 スプレッドシートのデータをJSONで取得する

NEW POSTS

inoue
TRY

【WordPress】GA4連携の人気記事ランキング機能を自作プラグイン化してみた

inoue
TRY

【netlify】ビルドイメージを更新 [ Ubuntu Xenial 16.04 → Ubuntu Focal 20.04 ]

inoue
TIPS

【PHP】Google Business Profile APIを使ってクチコミを取得する

inoue
TRY

スクリーンショットのAPI「screendot」を使ってみた

inoue
TIPS

【window.matchMedia】メディアクエリでhoverが使えるデバイスを判定

inoue
TIPS

lax.jsの使い方【スクロール連動アニメーションの実装】

ブログ記事一覧
  • HOME
  • TIPS
  • 【WordPress】Gutenbergでカスタム投稿にタクソノミーが表示されない時