foadyousefi / seven-fields
WordPress开发者友好的自定义字段选项页面。
1.1.0
2021-05-03 16:07 UTC
Requires
- php: >=5.3
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并描述所有可能选项。