foadyousefi/seven-fields

WordPress开发者友好的自定义字段选项页面。

1.1.0 2021-05-03 16:07 UTC

This package is auto-updated.

Last update: 2024-09-29 04:31:34 UTC


README

关于

为了我的一些需要设置的项目,我搜索找到了一个库来帮我完成这项工作。我找到了Carbon Fields,它很棒,相对容易使用,最重要的是,可以通过composer安装。

但它有其局限性。没有任何字段类型有描述(至少在我使用的时候是这样)。另外,从数据库中检索选项值的功能是在init动作之后加载的,但如果我需要在init之前访问数据怎么办?嗯,我需要编写自己的函数。另外,字段类型也比较有限。

因此,我决定自己编写,完成后,我想为什么不开源它,让其他人也能从中受益。

支持的字段类型

  • 复选框
  • 标题
  • 原始HTML
  • 多选
  • 选择
  • 文本框
  • 密码
  • 文本区域

稍后还将添加更多字段,但在此之前,不要犹豫,通过创建新的问题来要求功能或更多字段。

如何使用?

1- 在您的插件或主题目录中,运行composer require foadyousefi/seven-fields

2- 在您的functions.php文件或插件中编写

use SevenFields\Fields\Fields;
use SevenFields\Container\Container;

add_action( 'admin_menu', 'setting_pages_init' );
function setting_pages_init() {
    Container::make( 'Menu title', 'menu-slug' )
    ->add_fields( 'add_fields_to_the_page' );
}

function add_fields_to_the_page() {
    Fields::add('header', null, 'This is header' );
    Fields::add('text', 'example_text_field', 'This is text field', 'And this is description' );
    Fields::add('password', 'example_password_field', 'This is password field', 'And this is description' );
    Fields::add( 'checkbox', 'example_checkbox', 'Checkbox label', 'And description' );
    Fields::add( 'textarea', 'example_text_area', 'Textarea example',  'And description. <be />New line in description with <b>bold</b> text.' );

  }

如何读取选项?

要从数据库中读取选项,您可以使用WordPress的get_option()函数,通过传递选项名称和可选默认值。如下所示

get_option( 'example_text_field', 'lorem ipsum' )

我将尝试更新README并描述所有可能选项。