[wp-trac] [WordPress Trac] #27981: Support descriptions for Customizer Controls

[WordPress Trac]

#27981: Support descriptions for Customizer Controls
-----------------------------+-----------------------------
 Reporter:  danielbachhuber  |       Owner:
     Type:  enhancement      |      Status:  new
 Priority:  normal           |   Milestone:  Future Release
Component:  Appearance       |     Version:
 Severity:  normal           |  Resolution:
 Keywords:  has-patch        |     Focuses:
-----------------------------+-----------------------------
Changes (by celloexpressions):

 * keywords:  needs-patch => has-patch


Comment:

 I do like that not having the description option by default forces less UI
 clutter (at the expense of longer section descriptions), but it's
 definitely time to have a solution for this in core.

 The implementation with [attachment:27981.diff] is pretty straightforward:
 {{{
 $wp_customize->add_control( $setting_id, array(
         'label'       => $label,
         'description' => $description,
         'section'     => $section_id,
         'type'        => $type,
 ) );
 }}}

 I added support for descriptions in all core types/controls except for the
 following:
 - `dropdown-pages`
 - `WP_Customize_Header_Image_Control`
 - `WP_Widget_Area_Customize_Control`
 - `WP_Widget_Form_Customize_Control`

--
Ticket URL: <https://core.trac.wordpress.org/ticket/27981#comment:3>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform