README

wp-admin-utility 以插件形式安装，提供API以快速设置自定义文章类型和选项页面。与其他文章类型构建器提供用于创建文章类型的行政界面不同，此实用工具通过声明性语法读取静态配置文件来创建文章类型。

安装

composer require dwalkr/wp-admin-utility

基本用法

使用PageCreator单例来解析配置文件。它通过名为adminutility-pagecreator-init的自定义钩子提供。钩子在after_setup_theme触发，所以请确保在事件之前添加您的回调（插件可以使用plugins_loaded，而主题可以直接将代码放在functions.php中。）

使用addPostType方法创建文章类型，使用addSettingsPage创建选项页面。

<?php

add_action('adminutility-pagecreator-init', function($pageCreator){
  $pageCreator->addPostType('/path/to/config.yml');
});

配置格式

配置文件可以是yaml、json或php格式。当将PHP文件传递给PageCreator时，该文件应返回配置为关联数组。

直接数组/对象配置

您可以直接传递包含配置的数组或PHP对象而不是文件的路径，而不是让PageCreator解析配置文件。使用FROM_ARRAY和FROM_OBJECT常量告诉PageCreator如何处理第一个方法参数。

<?php

$config = [
  'active' => true,
  'name' => 'specials',
  'public' => true
  //...
];
$pageCreator->addPostType($config, \dwalkr\WPAdminUtility\PageCreator::FROM_ARRAY);

配置API

几乎所有可以传递给register_post_type函数的选项都可以添加到文章类型的顶层配置中。

要了解如何设置具有自定义字段的元框，请参阅文章类型示例。

要了解如何设置设置页面，请参阅设置页面示例。

向现有文章类型添加自定义元框

要向现有文章类型添加自定义字段和元框，只需添加一个具有匹配现有文章类型的name属性的配置文件。如果文章类型已被注册，则忽略顶层配置的其余部分，并且只添加metaboxes。

dwalkr / wp-admin-utility

维护者

详细信息