WEB制作のための情報サイト / unazuki Library
カスタムタクソノミーを追加します。
register_taxonomy($taxonomy,$object_type,$args);| 引数 | 必須/任意 | 引数に指定するもの |
|---|---|---|
| 第１引数 $taxonomy | 必須 | カスタムタクソノミーの名前を指定（文字列）※32文字まで、小文字英数字、アンダースコア、ダッシュ |
| 第２引数 $object_type | 必須 | 紐づけるオブジェクトのスラッグを文字列、あるいはその配列で指定（カスタム投稿タイプを指定してタクソノミーを紐づけることができます。） |
| 第３引数 $args | 任意 | カスタムタクソノミーの仕様を文字列か配列で指定主なパラメーターは以下の通りです。 description タクソノミーの説明文（文字列）public カスタム投稿タイプを一般に公開するかどうか（真偽値）show_in_rest REST APIにタクソノミーを含めるかどうか（真偽値）hierarchical 階層化するかどうか（真偽値）query_var クエリパラメーターを使えるようにする（真偽値/文字列）show_admin_column 管理画面の投稿一覧にタクソノミーを表示するかどうか（真偽値）すべてのパラメーターの詳細は下記より参照ください（英語） https://developer.wordpress.org/reference/functions/register_taxonomy/ 初期値： []（空の配列） |
戻り値（返す値）：登録に成功したカスタムタクソノミーオブジェクト（失敗の場合はエラーオブジェクト）
【引数とは】
テンプレートタグ（=関数）を実行する際に、引数を渡すことができるテンプレートタグがあります。引数は、関数の中で使われるので、渡す引数の値によって実行結果が変わってきます。何を処理したいのか、どのようなデータを取得したいのかによって渡す引数が変わります。
【引数について】
下記のコード例では、カスタム投稿タイプ「seminar」にカスタムタクソノミー「分野」を追加しています。
function tax_register_field_seminar() {
$args = [
'label' => '分野',
'labels' => [
'singular_name' => '分野',
'edit_item' => '分野を編集',
'add_new_item' => '新規分野を追加'
],
'show_admin_column' => true,
'hierarchical' => true,
'query_var' => true,
'show_in_rest' => true
];
register_taxonomy('field', 'seminar', $args);
}
add_action('init', 'tax_register_field_seminar');※当サイトでは初期値とデフォルト値の言葉の定義を区別せず、原則統一して初期値を採用しています。
