class WP_Customize_Image_Control {}

User Contributed Notes

1. Skip to note 4 content

   Ross Wintle 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 13You must log in to vote on the helpfulness of this note

   Note that this control stores the URL of the image. If you want to store the ID of the image’s attachment then use WP_Customize_Media_Control.
2. Skip to note 5 content

   Chetan Satasiya 8 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 5You must log in to vote on the helpfulness of this note

   This class is used with the Theme Customization API to render the custom image control on the Theme Customizer in WordPress 3.4 or newer.

   $wp_customize->add_control(
          new WP_Customize_Image_Control(
              $wp_customize,
              'logo',
              array(
                  'label'      => __( 'Upload a logo', 'theme_name' ),
                  'section'    => 'your_section_id',
                  'settings'   => 'your_setting_id',
                  'context'    => 'your_setting_context' 
              )
          )
      );
3. Skip to note 6 content

   Mehedi Foysal 3 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   $wp_customize->add_setting( 'logo', array(
   	'capability'        => 'edit_theme_options',
   	'default'           => '',
   	'sanitize_callback' => 'ic_sanitize_image',
   ) );
   $wp_customize->add_control( new WP_Customize_Image_Control( $wp_customize, 'logo',
   	array(
   		'label'    => __( 'Logo', 'text-domain' ),
   		'section'  => 'general',
   		'settings' => 'logo',
   	)
   ) );

   Callback function

   /**
    * Validation: image
    * Control: text, WP_Customize_Image_Control
    *
    * @uses    wp_check_filetype()        https://developer.wordpress.org/reference/functions/wp_check_filetype/
    * @uses    in_array()                http://php.net/manual/en/function.in-array.php
    */
   function ic_sanitize_image( $file, $setting ) {
   
   	$mimes = array(
   		'jpg|jpeg|jpe' => 'image/jpeg',
   		'gif'          => 'image/gif',
   		'png'          => 'image/png',
   		'bmp'          => 'image/bmp',
   		'tif|tiff'     => 'image/tiff',
   		'ico'          => 'image/x-icon'
   	);
   
   	//check file type from file name
   	$file_ext = wp_check_filetype( $file, $mimes );
   
   	//if file has a valid mime type return it, otherwise return default
   	return ( $file_ext['ext'] ? $file : $setting->default );
   }