📌  相关文章
📜  wp_customize_image_control - PHP (1)

📅  最后修改于: 2023-12-03 14:48:34.465000             🧑  作者: Mango

wp_customize_image_control - PHP

wp_customize_image_control 是 WordPress Theme Customizer 中的一种控件（control），可以用来为自定义主题提供一个图片上传功能，让用户可以轻松地自定义主题中的图片。

使用方法

使用 wp_customize_image_control 之前，需要先在 functions.php 文件中注册一个新的控件类型。注册方法如下：

function custom_customize_register($wp_customize) {
   $wp_customize->register_control_type( 'WP_Customize_Image_Control' );
}
add_action( 'customize_register', 'custom_customize_register' );

然后就可以在自定义主题中使用 wp_customize_image_control 了。示例代码如下：

$wp_customize->add_setting( 'background_image', array(
    'default' => '',
    'sanitize_callback' => 'esc_url_raw',
) );
$wp_customize->add_control( new WP_Customize_Image_Control( $wp_customize, 'background_image', array(
    'label' => __( 'Background Image', 'custom' ),
    'description' => __( 'Upload an image to set as the background', 'custom' ),
    'section' => 'background_image',
    'settings' => 'background_image',
) ) );
参数说明

wp_customize_image_control 接受三个参数：

  1. $wp_customize：必选，WP_Customize_Manager 实例对象；

  2. $id：必选，控件的 ID；

  3. $args：可选，控件用到的其它参数，包含以下几个：

    • label：控件的标签；
    • description：控件下方的描述文字；
    • section：所属的区域 ID；
    • settings：关联的设置项 ID。
参考文献