Index: src/wp-includes/class-wp-customize-control.php =================================================================== --- src/wp-includes/class-wp-customize-control.php (revision 40556) +++ src/wp-includes/class-wp-customize-control.php (working copy) @@ -77,40 +77,57 @@ public $capability; /** + * Order priority to load the control. + * * @access public * @var int + * @since 3.4.0 */ public $priority = 10; /** + * Section the control belongs to. + * * @access public * @var string + * @since 3.4.0 */ public $section = ''; /** + * Label for the control. + * * @access public * @var string + * @since 3.4.0 */ public $label = ''; /** + * Description for the control. * @access public * @var string + * @since 3.4.0 */ public $description = ''; /** - * @todo: Remove choices + * List of choices for 'radio' or 'select' type controls, where values are the keys, and labels are the values. * * @access public * @var array + * @since 3.4.0 */ public $choices = array(); /** + * List of custom input attributes for control output, where attribute names are the keys and values are the values. + * + * Not used for 'checkbox', 'radio', 'select', 'textarea', or 'dropdown-pages' control types. + * * @access public * @var array + * @since 3.4.0 */ public $input_attrs = array(); Index: src/wp-includes/class-wp-customize-manager.php =================================================================== --- src/wp-includes/class-wp-customize-manager.php (revision 40556) +++ src/wp-includes/class-wp-customize-manager.php (working copy) @@ -2795,8 +2795,25 @@ * @access public * * @param WP_Customize_Setting|string $id Customize Setting object, or ID. - * @param array $args Setting arguments; passed to WP_Customize_Setting - * constructor. + * @param array $args { + * Optional. Array of properties for the new WP_Customize_Setting. Default empty array. + * + * @type string $type Type of the setting. Default 'theme_mod'. + * Default 160. + * @type string $capability Capability required for the setting. Default 'edit_theme_options' + * @type string|array $theme_supports Theme features required to support the panel. Default is none. + * @type string $default Default value for the setting. Default is empty string. + * @type string $transport Options for rendering the live preview of changes in Theme Customizer. + * Using 'refresh' makes the change visible by reloading the whole preview. + * Using 'postMessage' allows a custom JavaScript to handle live changes. + * @link https://developer.wordpress.org/themes/customize-api + * Default is 'refresh' + * @type callable $validate_callback Server-side validation callback for the setting's value. + * @type callable $sanitize_callback Callback to filter a Customize setting value in un-slashed form. + * @type callable $sanitize_js_callback Callback to convert a Customize PHP setting value to a value that is + * JSON serializable. + * @type bool $dirty Whether or not the setting is initially dirty when created. + * } * @return WP_Customize_Setting The instance of the setting that was added. */ public function add_setting( $id, $args = array() ) { @@ -2913,8 +2930,17 @@ * @access public * * @param WP_Customize_Panel|string $id Customize Panel object, or Panel ID. - * @param array $args Optional. Panel arguments. Default empty array. - * + * @param array $args { + * Optional. Array of properties for the new Panel object. Default empty array. + * @type int $priority Priority of the panel, defining the display order of panels and sections. + * Default 160. + * @type string $capability Capability required for the panel. Default `edit_theme_options` + * @type string|array $theme_supports Theme features required to support the panel. + * @type string $title Title of the panel to show in UI. + * @type string $description Description to show in the UI. + * @type string $type Type of the panel. + * @type callable $active_callback Active callback. + * } * @return WP_Customize_Panel The instance of the panel that was added. */ public function add_panel( $id, $args = array() ) { @@ -3002,8 +3028,19 @@ * @access public * * @param WP_Customize_Section|string $id Customize Section object, or Section ID. - * @param array $args Section arguments. - * + * @param array $args { + * Optional. Array of properties for the new Panel object. Default empty array. + * @type int $priority Priority of the panel, defining the display order of panels and sections. + * Default 160. + * @type string $panel Priority of the panel, defining the display order of panels and sections. + * @type string $capability Capability required for the panel. Default 'edit_theme_options' + * @type string|array $theme_supports Theme features required to support the panel. + * @type string $title Title of the panel to show in UI. + * @type string $description Description to show in the UI. + * @type string $type Type of the panel. + * @type callable $active_callback Active callback. + * @type bool $description_hidden Hide the description behind a help icon, instead of . Default false. + * } * @return WP_Customize_Section The instance of the section that was added. */ public function add_section( $id, $args = array() ) { @@ -3078,8 +3115,26 @@ * @access public * * @param WP_Customize_Control|string $id Customize Control object, or ID. - * @param array $args Control arguments; passed to WP_Customize_Control - * constructor. + * @param array $args { + * Optional. Array of properties for the new Control object. Default empty array. + * + * @type array $settings All settings tied to the control. If undefined, defaults to `$setting`. + * IDs in the array correspond to the ID of a registered `WP_Customize_Setting`. + * @type string $setting The primary setting for the control (if there is one). Default is 'default'. + * @type string $capability Capability required to use this control. Normally derived from `$settings`. + * @type int $priority Order priority to load the control. Default 10. + * @type string $section The section this control belongs to. Default empty. + * @type string $label Label for the control. Default empty. + * @type string $description Description for the control. Default empty. + * @type array $choices List of choices for 'radio' or 'select' type controls, where values + * are the keys, and labels are the values. Default empty array. + * @type array $input_attrs List of custom input attributes for control output, where attribute + * names are the keys and values are the values. Default empty array. + * @type bool $allow_addition Show UI for adding new content, currently only used for the + * dropdown-pages control. Default false. + * @type string $type The type of the control. Default 'text'. + * @type callback $active_callback Active callback. + * } * @return WP_Customize_Control The instance of the control that was added. */ public function add_control( $id, $args = array() ) { Index: src/wp-includes/class-wp-customize-setting.php =================================================================== --- src/wp-includes/class-wp-customize-setting.php (revision 40556) +++ src/wp-includes/class-wp-customize-setting.php (working copy) @@ -18,6 +18,7 @@ */ class WP_Customize_Setting { /** + * @since 3.4.0 * @access public * @var WP_Customize_Manager */ @@ -26,12 +27,14 @@ /** * Unique string identifier for the setting. * + * @since 3.4.0 * @access public * @var string */ public $id; /** + * @since 3.4.0 * @access public * @var string */ @@ -40,27 +43,65 @@ /** * Capability required to edit this setting. * - * @var string + * @since 3.4.0 + * @var string|array */ public $capability = 'edit_theme_options'; /** * Feature a theme is required to support to enable this setting. * + * @since 3.4.0 * @access public * @var string */ public $theme_supports = ''; + + /** + * The default value for the setting. + * + * @since 3.4.0 + * @access public + * @var string + */ public $default = ''; + + /** + * Options for rendering the live preview of changes in Theme Customizer. + * + * Set this value to 'postMessage' to enable a custom Javascript handler to render changes to this setting + * as opposed to reloading the whole page. + * + * @link https://developer.wordpress.org/themes/customize-api + * + * @since 3.4.0 + * @access public + * @var string + */ public $transport = 'refresh'; /** - * Server-side sanitization callback for the setting's value. + * Server-side validation callback for the setting's value. * - * @var callback + * @since 3.4.0 + * @var callable */ public $validate_callback = ''; + + /** + * Callback to filter a Customize setting value in un-slashed form. + * + * @since 3.4.0 + * @var callable + */ public $sanitize_callback = ''; + + /** + * Callback to convert a Customize PHP setting value to a value that is JSON serializable. + * + * @since 3.4.0 + * @var string + */ public $sanitize_js_callback = ''; /** Index: src/wp-includes/customize/class-wp-customize-selective-refresh.php =================================================================== --- src/wp-includes/customize/class-wp-customize-selective-refresh.php (revision 40556) +++ src/wp-includes/customize/class-wp-customize-selective-refresh.php (working copy) @@ -91,7 +91,27 @@ * @access public * * @param WP_Customize_Partial|string $id Customize Partial object, or Panel ID. - * @param array $args Optional. Partial arguments. Default empty array. + * @param array $args { + * Optional. Array of properties for the new Partials object. Default empty array. + * + * @type string $type Type of the partial to be created. + * @type string $selector The jQuery selector to find the container element for the partial. + * @type array $settings IDs for settings tied to the partial. + * @type string $primary_setting The ID for the setting that this partial is primarily responsible for + * rendering. If not supplied, it will default to the ID of the first setting. + * @type string $capability Capability required to edit this partial. + * Normally this is empty and the capability is derived from the capabilities + * of the associated `$settings`. + * @type callable $render_callback Render callback. + * Callback is called with one argument, the instance of WP_Customize_Partial. + * The callback can either echo the partial or return the partial as a string, + * or return false if error. + * @type bool $container_inclusive Whether the container element is included in the partial, or if only + * the contents are rendered. + * @type bool $fallback_refresh Whether to refresh the entire preview in case a partial cannot be refreshed. + * A partial render is considered a failure if the render_callback returns + * false. + * } * @return WP_Customize_Partial The instance of the panel that was added. */ public function add_partial( $id, $args = array() ) { Index: src/wp-includes/kses.php =================================================================== --- src/wp-includes/kses.php (revision 40556) +++ src/wp-includes/kses.php (working copy) @@ -549,7 +549,7 @@ $allowed_html = wp_kses_allowed_html( 'post' ); $allowed_protocols = wp_allowed_protocols(); $string = wp_kses_no_null( $string, array( 'slash_zero' => 'keep' ) ); - + // Preserve leading and trailing whitespace. $matches = array(); preg_match('/^\s*/', $string, $matches); @@ -561,7 +561,7 @@ } else { $string = substr( $string, strlen( $lead ), -strlen( $trail ) ); } - + // Parse attribute name and value from input. $split = preg_split( '/\s*=\s*/', $string, 2 ); $name = $split[0]; @@ -598,7 +598,7 @@ $value = ''; $vless = 'y'; } - + // Sanitize attribute by name. wp_kses_attr_check( $name, $value, $string, $vless, $element, $allowed_html ); @@ -633,7 +633,7 @@ * @param string $context Context to judge allowed tags by. Allowed values are 'post', * 'data', 'strip', 'entities', 'explicit', or the name of a filter. */ - return apply_filters( 'wp_kses_allowed_html', $context, 'explicit' ); + return apply_filters( 'wp_kses_allowed_html', $tags, 'explicit' ); } switch ( $context ) { @@ -1061,7 +1061,7 @@ } else { $xhtml_slash = ''; } - + // Split it $attrarr = wp_kses_hair_parse( $attr ); if ( false === $attrarr ) { @@ -1071,7 +1071,7 @@ // Make sure all input is returned by adding front and back matter. array_unshift( $attrarr, $begin . $slash . $elname ); array_push( $attrarr, $xhtml_slash . $end ); - + return $attrarr; }