使用WordPress Dashicons 自定义文章类型

如果你正在开发一个WordPress主题并想使用自定义文章类型，你很可能需要自定义图标，以便在管理面板中区分不同类型的文章。使用 WordPress Dashicons，可以轻松地在管理面板中使用高质量的矢量图标来代表你的自定义文章类型。

什么是Dashicons？

Dashicons是由WordPress团队设计的一组矢量图标。在WordPress管理面板中，你可以看到这些图标用于按钮、面板和菜单项。

这些图标都是完美的矢量素材，可以无限放大而不失去质量。这使得它们适用于各种分辨率和设备屏幕大小。

如何使用Dashicons来自定义文章类型？

如果你想在WordPress管理面板中使用Dashicons来表示自定义文章类型，有几个步骤。以下步骤应该让你很好地进行：

步骤 1：注册自定义文章类型

在使用Dashicons之前，你需要先注册自定义文章类型。使用以下代码可以注册一个名为 “books” 的自定义文章类型（此示例仅用于说明目的）：

function create_post_type() {
  register_post_type( 'books',
    array(
      'labels' => array(
        'name' => __( 'Books' ),
        'singular_name' => __( 'Book' )
      ),
      'public' => true,
      'has_archive' => true,
      'supports' => array( 'title', 'editor', 'thumbnail' ),
    )
  );
}
add_action( 'init', 'create_post_type' );

步骤 2：查找Dashicons类

Dashicons以 dashicons- 作为前缀，在WordPress管理面板中可以用作类。

你可以在 WordPress官方文档 或者通过搜索“Dashicons”来查看所有Dashicons。

步骤 3：将Dashicons类添加到自定义文章类型

在上一步中，你找到了一个与你自定义文章类型相匹配的Dashicon类的名称。现在，你需要将该类添加到自定义文章类型。

使用以下代码来添加dashicons类到自定义文章类型：

function cptui_register_my_cpts_books() {

	$labels = [
		"name" => __( "Books", "custom-post-type-ui" ),
		"singular_name" => __( "Book", "custom-post-type-ui" ),
		"menu_name" => __( "Books", "custom-post-type-ui" ),
	];

	$args = [
		"label" => __( "Books", "custom-post-type-ui" ),
		"labels" => $labels,
		"description" => "",
		"public" => true,
		"show_ui" => true,
		"show_in_rest" => false,
		"rest_base" => "",
		"has_archive" => true,
		"show_in_menu" => true,
    "menu_icon" => "dashicons-book",
		"exclude_from_search" => false,
		"capability_type" => "post",
		"map_meta_cap" => true,
		"hierarchical" => false,
		"rewrite" => [ "slug" => "books", "with_front" => true ],
		"query_var" => true,
		"supports" => [ "title", "editor", "thumbnail", "excerpt", "custom-fields" ],
	];

	register_post_type( "books", $args );
}

add_action( 'init', 'cptui_register_my_cpts_books' );

注意，这里 menu_icon 需要使用dashicon类的名称。

步骤 4：在管理面板中查看您的自定义文章类型

现在你可以在管理面板中看到你刚刚创建的自定义文章类型和Dashicon图标了。

结论

使用Dashicons为你的自定义文章类型添加图标不仅可以提高管理面板的可读性，还可以为你的网站提供更加专业的外观。

请注意，Dashicons仅仅是一组图标，仅适用于WordPress管理面板的图标。如果你想在你的WordPress网站中使用一般的图标，你需要使用另一组图标。