register_taxonomy

パラメータ

• $taxonomy
  タクソノミー名を指定（32文字以内）。
• $object_type
  紐づけするオブジェクト（データ）タイプまたはその配列を指定。
• $args
  タクソノミーの属性情報を連想配列で指定（省略時はarray()）。

  キー	型	内容
  'labels'	string[]	タクソノミーのラベルを格納した連想配列を指定（省略時はarray()）
  'description'	string	タクソノミーの説明を指定（省略時は''）
  'public'	bool	管理者またはフロントエンドユーザーが使用できる場合はtrueを指定（省略時はtrue）。
  'publicly_queryable'	bool	[4.5.0]クエリー可能な場合はtrueを指定（省略時は'public'の値を継承）
  'hierarchical'	bool	「カテゴリー」のように階層構造の場合はtrueを指定（省略時はfalse）
  'show_ui'	bool	[4.4.0]管理画面の編集用UIを表示する場合はtrueを指定（省略時は'public'の値を継承）
  'show_in_menu'	bool	管理画面に編集用UIのメニューを表示する場合は'show_ui'の値と共にtrueを指定（省略時は'show_ui'の値を継承）
  'show_in_nav_menus'	bool	ナビゲーションメニューに表示する場合はtrueを指定（省略時は'public'の値を継承）
  'show_tagcloud'	bool	タグクラウドウィジェットに含める場合はtrueを指定（省略時は'show_ui'の値を継承）
  'show_in_quick_edit'	bool	[4.2.0]クイック編集パネルに編集用UIを含める場合はtrueを指定（省略時は'show_ui'の値を継承）
  'show_admin_column'	bool	投稿一覧のカラムに表示する場合はtrueを指定（省略時はfalse）
  'meta_box_cb'	bool|callable	メタボックス表示用のコールバック関数を指定
  'meta_box_sanitize_cb'	callable	[5.1.0]メタボックスから保存されるデータをサニタイズするためのコールバック関数を指定
  'capabilities'	string[]	タクソノミーのケイパビリティ（権限）を指定
  'rewrite'	bool|array	リライト設定を指定（省略時はtrue）
  'query_var'	bool|string	URLクエリーのキー名を指定
  'update_count_callback'	callable	カウントが更新された時に呼び出されるコールバック関数を指定
  'show_in_rest'	bool	[4.7.0]REST APIに含める場合はtrueを指定
  'rest_base'	string	[4.7.0]REST APIルートのベースURLを指定
  'rest_controller_class'	string	[4.7.0]REST API コントローラのクラス名を指定（省略時は'WP_REST_Terms_Controller'）
  'default_term'	string|array	[5.5.0]デフォルトのターム値を指定
  'sort'	bool	wp_set_object_terms関数で指定した順にソートする場合はtrueを指定
  'args'	array	wp_get_object_terms関数の第3パラメータに内部で適用される内容を指定
  '_builtin'	bool	標準で組み込まれる場合はtrueを指定（省略時はfalse）

返り値

注意

本関数はinitアクションより前に使用してはならない。

'labels'に指定する連想配列は、バージョンアップにより何度か拡張されており、最新はget_taxonomy_labels関数を参照すること。

'public'の内容は、'publicly_queryable'、'show_ui'、'show_in_nav_menus'キーが省略された場合のデフォルト値となる。'show_ui'の内容は、'show_in_menu'、'show_tagcloud'、'show_in_quick_edit'キーが省略された場合のデフォルト値となる。

'meta_box_cb'の内容が省略された場合は、'hierarchical'の内容により「カテゴリー」か「投稿タグ」のコールバック関数が適用される。メタボックスを表示しない場合は、明示的にfalseを指定する。

ブロックエディターでこのタクソノミーを使用する場合、'show_in_rest'にtrueを指定しなければならない。

'query_var'の内容が文字列の場合、それがURLクエリーのキー名となる。省略時は、本関数の第1パラメータ$taxonomyが適用される。falseの場合はこのタクソノミーのURLクエリーが無効となる。

'capabilities'の内容として指定する連想配列は次の通り。

'rewrite'の内容としてtrueを指定した場合は、パラメータ$taxonomyをスラッグとしてリライト設定を行う。falseを指定した場合はリライト設定を行わない。詳細なリライト設定を行う場合は次に示す連想配列を指定する。

[5.5.0]'default_term'の内容には、タームの名前か、次に示す連想配列を指定する。

使用例

• タクソノミー'people'を登録する

  function register_taxonomy_people() {
  	register_taxonomy(
  		'people',
  		'post',
  		array(
  			'labels'            => array(
  				'name'          => __( 'People' ),
  			),
  			'rewrite'           => array( 'slug' => 'person' ),
  			'hierarchical'      => true,
  			'query_var'         => 'person',
  			'public'            => true,
  			'show_ui'           => true,
  			'show_admin_column' => true,
  		)
  	);
  }
  
  add_action( 'init', 'register_taxonomy_people' );
  

フィルター

アクション

do_action( 'registered_taxonomy', $taxonomy, $object_type, $args );

do_action( "registered_taxonomy_{$taxonomy}", $taxonomy, $object_type, $args );

ソースファイル