README

贡献者: prettyboymp, kevinlangleyjr, jeffstieler, markparolisi, banderon
标签: post, meta
至少需要: 3.5
测试到: 4.2.2
稳定标签: 1.9.2
许可证: GPLv2 或更高版本
许可证URI: https://gnu.ac.cn/licenses/gpl-2.0.html

描述

创建一个组（元框），然后向其中添加字段。

安装

作为标准插件

请参阅 安装插件。

作为主题或插件依赖项

将插件拖放到包含的主题或插件中后，请添加以下内容

if( ! class_exists( 'Voce_Meta_API' ) ) {
	require_once( $path_to_voce_post_meta . '/voce-post-meta.php' );
}

用法

示例

<?php
add_action('init', function(){
	add_metadata_group( 'demo_meta', 'Page Options', array(
		'capability' => 'edit_posts'
	));
	add_metadata_field( 'demo_meta', 'demo_key', 'Title', 'text', array(
		'description' => 'Descriptive string. Example: <code>Description</code>'
	) );
	add_post_type_support( 'page', 'demo_meta' );
});
?>

输入类型

默认情况下，Voce Post Meta 支持以下输入类型

文本输入

• text - 一行文本输入字段。
• textarea - 基本的多行文本字段。
• numeric - 与文本字段相同，但在保存时将其验证为数字。
• wp_editor - 使用完整的 WordPress 帖子内容编辑器，适用于更复杂的编辑场景。

选择

• dropdown - 下拉选择字段。
• radio - 单选按钮选择字段。
• checkbox - 复选框输入字段，用于开/关切换。

dropdown 和 radio 字段期望一个 options 参数传递给选项数组。选项应该是一个 $value => $label 对的数组。

对于 checkbox 字段，此字段是可选的；使用它将在同一字段下允许多个复选框，并将值保存为数组。

此外，对于使用 options 参数的 radio 字段和 checkbox 字段，还有一个 item_container 参数可用于指定用于包装单个项的 HTML 标签。当前允许的唯一值是 div（默认）和 span。

其他

• hidden 一个隐藏的输入字段，用于在用户控制之外保存元数据。

标准字段选项

这些都是所有默认字段接受的 可选 参数，并且任何扩展字段都应处理这些参数。

<?php
array(
	'description' => '', // A short description of the expected value displayed with the field.
	'default_value' => '', // The value to be shown and used when not set.
	
	// Override options
	'capability' => '', // User permission level that must be met to edit the field. Defaults to edit_posts
	'display_callbacks' => array(), // An array of valid callable functions to render the field display.
	'sanitize_callbacks' => array() // An array of callable functions to sanitize the field value on save.
);
?>

变更日志

请参阅完整的变更日志 https://github.com/voceconnect/voce-post-meta/releases