README

贡献者：banderon, kevinlangleyjr
标签：主题，定制器，图片，媒体，库，下拉列表，文本区域
至少需要：3.5.0
测试到：3.6
稳定标签：1.2.1
许可：GPLv2或更高版本
许可URI：https://gnu.ac.cn/licenses/gpl-2.0.html

描述

添加了几个主题定制器控制。

• 一个使用媒体库的图片选择器，可以保存图片源（如WordPress当前所做）或图片ID
• 下拉列表
• 文本区域
• 文章选择UI

安装

作为标准插件

请参阅插件安装。

使用

使用图片保存图片源示例

<?php
add_action( 'customize_register', function( $wp_customize ) {
	$wp_customize->add_section( 'new_section' , array(
		'title'    => 'New Section',
		'priority' => 30,
	) );

	$id = 'new_image';
	$wp_customize->add_setting( $id );
	$wp_customize->add_control( new Voce_Customize_Image_Control( $wp_customize, $id, array(
		'label'    => 'My New Image',
		'settings' => $id,
		'section'  => 'new_section',
	) ) );
} );
?>

使用图片保存图片ID示例

<?php
add_action( 'customize_register', function( $wp_customize ) {
	$wp_customize->add_section( 'new_section' , array(
		'title'    => 'New Section',
		'priority' => 30,
	) );

	$id = 'new_image';
	$wp_customize->add_setting( $id );
	$wp_customize->add_control( new Voce_Customize_Image_Control( $wp_customize, $id, array(
		'label'         => 'My New Image',
		'settings'      => $id,
		'section'       => 'new_section',
		'output_format' => 'id',
	) ) );
} );
?>

使用下拉列表和文本区域示例

<?php
add_action( 'customize_register', function( $wp_customize ) {
	$wp_customize->add_section( 'new_section' , array(
		'title'    => 'New Section',
		'priority' => 30,
	) );

	$id1 = 'new_dropdown';
	$opts = array(
		'val1' => 'Value 1',
		'val2' => 'Value 2',
		'val3' => 'Value 3',
		'val4' => 'Value 4',
	);
	$wp_customize->add_setting( $id1 );
	$wp_customize->add_control( new Voce_Customize_Dropdown_Control( $wp_customize, $id1, array(
		'label'         => 'My New Dropdown',
		'settings'      => $id1,
		'section'       => 'new_section',
		'options'       => $opts,
	) ) );

	$id2 = 'new_textarea';
	$wp_customize->add_setting( $id2 );
	$wp_customize->add_control( new Voce_Customize_Textarea_Control( $wp_customize, $id2, array(
		'label'         => 'My New Textarea',
		'settings'      => $id2,
		'section'       => 'new_section',
	) ) );
} );
?>

选项

图片控制：output_format - 指定是否保存图片的src（默认）或图片的id

下拉列表控制：options - 用于填充下拉列表的数组

1.2.1
在包含的控件周围添加了validate_file()检查。

1.2
更好的自动加载处理，以允许单元测试和分析使用插件作为依赖项的主题的代码覆盖率。

1.1.1
修复了使用多个文章选择UI控件时的保存问题。

1.1
添加文章选择UI控件。

1.0
初始版本。