README

输出不同类型字段的WordPress设置字段函数。

字段类型

文本

名称： Kuuak\WordPressSettingFields\Fields::text

参数

用法示例

add_action( 'admin_init', function() {
  add_settings_field(
    'my-setting-id',
    __('My setting', 'my-setting-domain'),
    'Kuuak\WordPressSettingFields\Fields::text',
    'setting-page-id',
    'setting-section-id',
    [
      'label_for' => 'my-setting-id',
      'name'      => 'my-setting-name',
      'value'     => 'Value',
      'help'      => 'This is a text to help the user to understand the setting',
      'attrs'     => [
        'class' => 'large-text'
      ],
    ]
  );
} );

下拉菜单

名称： Kuuak\WordPressSettingFields\Fields::dropdown

参数

用法示例

add_action( 'admin_init', function() {
  add_settings_field(
    'my-setting-id',
    __('My setting', 'my-setting-domain'),
    'Kuuak\WordPressSettingFields\Fields::dropdown',
    'setting-page-id',
    'setting-section-id',
    [
      'label_for' => 'my-setting-id',
      'name'      => 'my-setting-name',
      'selected'  => 'Value',
      'options'   => [
        [ 'value' => 'opt-1', 'title' => 'Option 1' ],
        [ 'value' => 'opt-2', 'title' => 'Option 2' ],
        [ 'value' => 'opt-3', 'title' => 'Option 3' ],
      ],
    ]
  );
} );

开关（切换）

名称： Kuuak\WordPressSettingFields\Fields::switch

参数

用法示例

add_action( 'admin_init', function() {
  add_settings_field(
    'my-setting-id',
    __('My setting', 'my-setting-domain'),
    'Kuuak\WordPressSettingFields\Fields::switch',
    'setting-page-id',
    'setting-section-id',
    [
      'label_for' => 'my-setting-id',
      'name'      => 'my-setting-name',
      'checked'   => true,
    ]
  );
} );

文章类型（下拉菜单）

名称： Kuuak\WordPressSettingFields\Fields::post_type_dropdown

参数

用法示例

add_action( 'admin_init', function() {
  add_settings_field(
    'my-setting-id',
    __('My setting', 'my-setting-domain'),
    'Kuuak\WordPressSettingFields\Fields::post_type_dropdown',
    'setting-page-id',
    'setting-section-id',
    [
      'label_for'   => 'my-setting-id',
      'name'        => 'my-setting-name',
      'selected'    => 254,
      'query_args'  => [
        'post_type'   => ['my-custome-post-type'],
        'orderby'     => 'title',
        'order'       => 'ASC',
      ],
       'attrs'     => [
        'class' => 'large-text'
      ],
    ]
  );
} );

分类法（下拉菜单）

名称： Kuuak\WordPressSettingFields\Fields::taxonomy_dropdown

参数

_关于额外接受的参数，请参考 WP_Term_Query::_construct() 方法。

用法示例

add_action( 'admin_init', function() {
  add_settings_field(
    'my-setting-id',
    __('My setting', 'my-setting-domain'),
    'Kuuak\WordPressSettingFields\Fields::taxonomy_dropdown',
    'setting-page-id',
    'setting-section-id',
    [
      'label_for'   => 'my-setting-id',
      'name'        => 'my-setting-name',
      'taxonomy'    => 'category',
      'selected'    => 254,
    ]
  );
} );

页面（下拉菜单）

名称： Kuuak\WordPressSettingFields\Fields::pages_dropdown

参数

有关额外参数，请参阅 get_pages() 方法。

用法示例

add_action( 'admin_init', function() {
  add_settings_field(
    'my-setting-id',
    __('My setting', 'my-setting-domain'),
    'Kuuak\WordPressSettingFields\Fields::pages_dropdown',
    'setting-page-id',
    'setting-section-id',
    [
      'label_for'   => 'my-setting-id',
      'name'        => 'my-setting-name',
      'selected'    => 25,
    ]
  );
} );

按钮

名称： Kuuak\WordPressSettingFields\Fields::button

参数

用法示例

add_action( 'admin_init', function() {
  add_settings_field(
    'my-setting-id',
    __('My setting', 'my-setting-domain'),
    'Kuuak\WordPressSettingFields\Fields::button',
    'setting-page-id',
    'setting-section-id',
    [
      'label_for' => 'my-setting-id',
      'name'      => 'my-setting-name',
      'label'     => 'Register now',
    ]
  );
} );

变更日志

[1.1.2] - 2023-07-14

• 修复 post_type_dropdown 选择问题

[1.1.1] - 2023-07-14

• 修复下拉菜单占位符问题
• 改进 post_type_dropdown 属性以包括 attrs

[1.1.0] - 2023-07-13

• 添加 post_type_dropdown 字段 #4
• 添加开关的优雅UI样式 #2
• 修复下拉菜单选中属性 #5
• 修复README描述 #1
• 修复多下拉菜单中Select2未初始化的问题

[1.0.0] - 2023-06-15

• 初始发布