2024年06月13日

WP関数:register_taxonomy()


この関数の説明

WP関数の register_taxonomy() は、タクソノミ(分類)を設定する関数です。

・投稿に設定した場合、カテゴリ、タグ以外の分類名を新設する事ができます

・固定ページに設定した場合、新規の分類名を設定する事ができます

・カスタム投稿に設定した場合、新規の分類名を設定する事ができます。

※この関数はアクションフック:after_setup_themeで実行してください。

 


関数

register_taxonomy( $taxonomy, $object_type, $args )

 


パラメータ

$taxonomy文字列必須

タクソノミーの名前(分類名)を指定します。

半角英字とアンダースコアで32文字以内。

 

$object_type(文字列 | 配列必須

分類名をどの要素に設定するのかを指定します。

'post':投稿に追加します

'page':固定ページに新設します

'カスタム投稿名':カスタム投稿に新設します

 

$args(配列 | 文字列) (オプション)

タクソノミー(分類)名の仕様を設定します。

キー タイプ 解説
'label' 文字列 タクソノミーの表示名を指定します。
'hierarchical' 真偽値 false(デフォルト)でタグの様に階層を持たないタクソノミになります。

true でカテゴリの様に階層を持つタクソノミーになります。

■その他のキーは関数リファレンス/register taxonomyを参照してください。

 


戻り値

設定されたタクソノミー(分類)がターゲット要素の下に表示されます。

 


事例

利用例はregister_post_type()を参照してください。

 


アクションフック&関数
  • admin_init
  • admin_menu
  • after_setup_theme
  • customize_register
  • manage_pages_custom_column
  • manage_posts_custom_column
  • pre_get_posts
  • save_post
  • widgets_init
  • wp_enqueue_scripts
  • wp_head
  • add_editor_style()
  • add_post_type_support()
  • add_theme_support()
  • do_action()
  • get_post()
  • get_theme_mod()
  • register_nav_menu()
  • register_post_type()
  • register_sidebar()
  • register_taxonomy()
  • register_widget()
  • remove_action()
  • remove_editor_styles()
  • remove_theme_support()
  • set_post_thumbnail_size()
  • set_query_var()
  • show_admin_bar()
  • unregister_nav_menu()
  • unregister_widget()
  • wp_enqueue_script()
  • wp_enqueue_style()