register_taxonomy( string $taxonomy, array|string $object_type, array|string $args = array() )

使用示例

• 示例1

  如果希望分类面板在区块编辑器的侧栏上可见，则应将show_in_rest设置为true。

• 示例2

  注意不要为slug、query_var或$taxonomy name使用保留字。请参阅WP_Query以获取它们的列表。

  这包括“author”之类的词。如果试图使用“author”作为分类法覆盖自定义分类法的默认slug或query_var以匹配这些单词，它们将无法正常工作。

  可以正常管理（显示一个菜单，分类项可以被创建和关联等）。但前端将无法正常工作。例如，一个网址`https://example.org/author/name`，可能不会显示任何结果（如果它正在寻找文章作者，而不是你的分类法）。但是，在重写匹配过程中，它似乎首先尝试了这两种结果，但实际查询时却没有过滤这两种结果。最终的结果是查询是空的，并且匹配所有的结果，WordPress显示你的主页（甚至不是`archive.php`）。

  从WordPress 4.9.5开始，当您意外使用其中一个单词时，没有警告。

• 示例3

  请注意，分类名称 – 上面的$taxonomy参数 – 应仅包括字符a-z0-9_。当您注册一个具有大写字母的分类法时，它可能会起作用。但是在WP中，分类法slug在sanitize_key()中的不同地方运行，例如在AJAX标签搜索期间，这将导致微妙的破坏。

• 示例4

  为一个文章类型注册两个分类法

  本例为名为“book”的文章类型注册了两种分类法：genres 和 writers

  注意：您可以在主题的functions.php模板文件中定义自定义分类：

  /**
   * Create two taxonomies, genres and writers for the post type "book".
   *
   * @see register_post_type() for registering custom post types.
   */
  function wpdocs_create_book_taxonomies() {
  	// Add new taxonomy, make it hierarchical (like categories)
  	$labels = array(
  		'name'              => _x( 'Genres', 'taxonomy general name', 'textdomain' ),
  		'singular_name'     => _x( 'Genre', 'taxonomy singular name', 'textdomain' ),
  		'search_items'      => __( 'Search Genres', 'textdomain' ),
  		'all_items'         => __( 'All Genres', 'textdomain' ),
  		'parent_item'       => __( 'Parent Genre', 'textdomain' ),
  		'parent_item_colon' => __( 'Parent Genre:', 'textdomain' ),
  		'edit_item'         => __( 'Edit Genre', 'textdomain' ),
  		'update_item'       => __( 'Update Genre', 'textdomain' ),
  		'add_new_item'      => __( 'Add New Genre', 'textdomain' ),
  		'new_item_name'     => __( 'New Genre Name', 'textdomain' ),
  		'menu_name'         => __( 'Genre', 'textdomain' ),
  	);
  
  	$args = array(
  		'hierarchical'      => true,
  		'labels'            => $labels,
  		'show_ui'           => true,
  		'show_admin_column' => true,
  		'query_var'         => true,
  		'rewrite'           => array( 'slug' => 'genre' ),
  	);
  
  	register_taxonomy( 'genre', array( 'book' ), $args );
  
  	unset( $args );
  	unset( $labels );
  
  	// Add new taxonomy, NOT hierarchical (like tags)
  	$labels = array(
  		'name'                       => _x( 'Writers', 'taxonomy general name', 'textdomain' ),
  		'singular_name'              => _x( 'Writer', 'taxonomy singular name', 'textdomain' ),
  		'search_items'               => __( 'Search Writers', 'textdomain' ),
  		'popular_items'              => __( 'Popular Writers', 'textdomain' ),
  		'all_items'                  => __( 'All Writers', 'textdomain' ),
  		'parent_item'                => null,
  		'parent_item_colon'          => null,
  		'edit_item'                  => __( 'Edit Writer', 'textdomain' ),
  		'update_item'                => __( 'Update Writer', 'textdomain' ),
  		'add_new_item'               => __( 'Add New Writer', 'textdomain' ),
  		'new_item_name'              => __( 'New Writer Name', 'textdomain' ),
  		'separate_items_with_commas' => __( 'Separate writers with commas', 'textdomain' ),
  		'add_or_remove_items'        => __( 'Add or remove writers', 'textdomain' ),
  		'choose_from_most_used'      => __( 'Choose from the most used writers', 'textdomain' ),
  		'not_found'                  => __( 'No writers found.', 'textdomain' ),
  		'menu_name'                  => __( 'Writers', 'textdomain' ),
  	);
  
  	$args = array(
  		'hierarchical'          => false,
  		'labels'                => $labels,
  		'show_ui'               => true,
  		'show_admin_column'     => true,
  		'update_count_callback' => '_update_post_term_count',
  		'query_var'             => true,
  		'rewrite'               => array( 'slug' => 'writer' ),
  	);
  
  	register_taxonomy( 'writer', 'book', $args );
  }
  // hook into the init action and call create_book_taxonomies when it fires
  add_action( 'init', 'wpdocs_create_book_taxonomies', 0 );
  

• 示例5

  私有分类示例

  如果您不希望您的分类法公开，可以使用public和rewrite参数来抑制它。它可以由你的插件或主题在内部使用，但不会生成自己的url。

  /**
   * Register a private 'Genre' taxonomy for post type 'book'.
   *
   * @see register_post_type() for registering post types.
   */
  function wpdocs_register_private_taxonomy() {
   	$args = array(
  		'label'        => __( 'Genre', 'textdomain' ),
  		'public'       => false,
  		'rewrite'      => false,
  		'hierarchical' => true
  	);
  	
  	register_taxonomy( 'genre', 'book', $args );
  }
  add_action( 'init', 'wpdocs_register_private_taxonomy', 0 );
  

• 示例6

  注意：古腾堡编辑器不支持“meta_box_cb”参数

• 示例7

  In order to have a taxonomy appear in the URL hierarchy of the relevant CPT, you can rewrite the taxonomy slug to contain the CPT’s slug. But you must register the CPT after registering the taxonomy, otherwise the rewrite will not work, i.e. in this case, book CPT must be registered after genre taxonomy.

  为了在相关CPT的URL层次结构中显示分类法，可以重写分类法slug以包含CPT的slug但是您必须在注册分类后注册CPT，否则重写将不起作用，即在这种情况下，book CPT必须在 genre 分类后注册。

  /**
   * Register a 'genre' taxonomy for post type 'book', with a rewrite to match book CPT slug.
   *
   * @see register_post_type for registering post types.
   */
  function wpdocs_create_book_tax_rewrite() {
      register_taxonomy( 'genre', 'book', array(
          'rewrite'      => array( 'slug' => 'books/genre' )
      ) );
  }
  add_action( 'init', 'wpdocs_create_book_tax_rewrite', 0 );

• 示例8

  注意`register_taxonomy`的两个未记录的配置参数（`$args`数组键）。`sort`和`args`。把`sort`设置为`true`将使WordPress保留term被添加到对象的顺序。设置`args`可以让你指定一个配置参数数组，当这些参数存在时，在使用`wp_get_object_terms`函数查询指定分类法中的term时，它们将覆盖`$args`数组中的相应参数。这使得term的显示顺序与它们在编辑器中定义的顺序一致。

• 示例9

  声明：如果要确保自定义分类法的行为类似于标签，则必须添加选项'update_count_callback' => '_update_post_term_count'，至少从4.6.1版开始，甚至更早
  简单地将分类声明为非分级，其行为与标签完全相同。

• 示例10

  如果您想使用动态功能从前端显示和管理分类，请使用如下数组附加“capabilities”键。

  /**
   * Register a 'genre' taxonomy for post type 'book'.
   *
   * Register custom capabilities for taxonomies.
   *
   * @see register_post_type for registering post types.
   */
  function wpdocs_create_book_tax() {
      register_taxonomy( 'genre', 'book', array(
          'label'        => __( 'Genre', 'textdomain' ),
          'rewrite'      => array( 'slug' => 'genre' ),
          'hierarchical' => true,
  		'capabilities' => array(
  			// $taxonomy['slug'] = genre;
  			'manage_terms'	=>	'manage_'.$taxonomy['slug'],
  			'edit_terms'	=>	'edit_'.$taxonomy['slug'],
  			'delete_terms'	=>	'delete'.$taxonomy['slug'],
  			'assign_terms'	=>	'assign_'.$taxonomy['slug'],
  		),
      ) );
  }
  add_action( 'init', 'wpdocs_create_book_tax', 0 );
  

• 示例11

  用于注册自定义分类法（将 hierarchical 设置为 true），并希望所有标签选项都已设置，并且Gutenberg编辑器已就绪（show_in_rest => true）。这是代码。

  function register_custom_taxonomy() {
  
  	$labels = array(
  		'name'              => _x( 'Genres', 'taxonomy general name', 'textdomain' ),
  		'singular_name'     => _x( 'Genre', 'taxonomy singular name', 'textdomain' ),
  		'search_items'      => __( 'Search Genres', 'textdomain' ),
  		'all_items'         => __( 'All Genres', 'textdomain' ),
  		'view_item'         => __( 'View Genre', 'textdomain' ),
  		'parent_item'       => __( 'Parent Genre', 'textdomain' ),
  		'parent_item_colon' => __( 'Parent Genre:', 'textdomain' ),
  		'edit_item'         => __( 'Edit Genre', 'textdomain' ),
  		'update_item'       => __( 'Update Genre', 'textdomain' ),
  		'add_new_item'      => __( 'Add New Genre', 'textdomain' ),
  		'new_item_name'     => __( 'New Genre Name', 'textdomain' ),
  		'not_found'         => __( 'No Genres Found', 'textdomain' ),
  		'back_to_items'     => __( 'Back to Genres', 'textdomain' ),
  		'menu_name'         => __( 'Genre', 'textdomain' ),
  	);
  
  	$args = array(
  		'labels'            => $labels,
  		'hierarchical'      => true,
  		'public'            => true,
  		'show_ui'           => true,
  		'show_admin_column' => true,
  		'query_var'         => true,
  		'rewrite'           => array( 'slug' => 'genre' ),
  		'show_in_rest'      => true,
  	);
  
  
  	register_taxonomy( 'genre', 'book', $args );
  
  }

• 示例12

  在数组中为特定文章类型注册多个分类。

  function add_post_taxonomy() {
  
    $taxArray = array(
      array(
        "taxName" => 'tax中文名1',
        "taxNameEn" =>'taxSlu1'
      ),
      array(
        "taxName" => 'tax中文名2',
        "taxNameEn" =>'taxSlu2'
      ),
    );
  
    foreach ($taxArray as $tax) {
      $labels = array(
        "name" => __( "", "" ),
        "singular_name" => __( $tax['taxName'], "" ),
        "menu_name" => __( $tax['taxName'], "" ),
        "all_items" => __( "所有", "" ),
        "edit_item" => __( "編輯", "" ),
        "view_item" => __( "檢視", "" ),
        "update_item" => __( "更新", "" ),
        "add_new_item" => __( "新增", "" ),
        "new_item_name" => __( "新增", "" ),
        "search_items" => __( "搜尋", "" ),
      );
  
      $args = array(
        "label" => __( $tax['taxName'], "" ),
        "labels" => $labels,
        "public" => true,
        "hierarchical" => true,
        "label" => $tax['taxName'],
        "show_ui" => true,
        "show_in_menu" => true,
        "show_in_nav_menus" => true,
        "show_admin_column" => true,
        "query_var" => true,
        "rewrite" => array( 'slug' => $tax['taxNameEn'], 'with_front' => true, ),
        "show_admin_column" => true,
        "show_in_rest" => false,
        "rest_base" => $tax['taxNameEn'],
        "show_in_quick_edit" => true,
      );
      register_taxonomy( $tax['taxNameEn'], 'post', $args );
    }
    
  }
  add_action( 'init', 'add_post_taxonomy' );
  

• 示例13

  基本示例

  /**
   * Register a 'genre' taxonomy for post type 'book'.
   *
   * @see register_post_type for registering post types.
   */
  function wpdocs_create_book_tax() {
  	register_taxonomy( 'genre', 'book', array(
  		'label'        => __( 'Genre', 'textdomain' ),
  		'rewrite'      => array( 'slug' => 'genre' ),
  		'hierarchical' => true,
  	) );
  }
  add_action( 'init', 'wpdocs_create_book_tax', 0 );
  

  注意：如果要确保自定义分类法的行为类似于标签，则必须添加选项'update_count_callback' => '_update_post_term_count'。不这样做将导致同时添加的多个逗号分隔的项目保存为单个值，而不是单独的值。当使用get_the_term_list()和其他分类项显示函数时，这可能会导致过度的压力。