Index: src/wp-includes/class-wp-customize-manager.php =================================================================== --- src/wp-includes/class-wp-customize-manager.php (revision 53052) +++ src/wp-includes/class-wp-customize-manager.php (working copy) @@ -407,7 +407,7 @@ } /** - * Return true if it's an Ajax request. + * Returns true if it's an Ajax request. * * @since 3.4.0 * @since 4.2.0 Added `$action` param. @@ -476,7 +476,7 @@ } /** - * Return the Ajax wp_die() handler if it's a customized request. + * Returns the Ajax wp_die() handler if it's a customized request. * * @since 3.4.0 * @deprecated 4.7.0 @@ -494,9 +494,9 @@ } /** - * Start preview and customize theme. + * Starts preview and customize theme. * - * Check if customize query variable exist. Init filters to filter the active theme. + * Checks if customize query variable exist. Init filters to filter the active theme. * * @since 3.4.0 * @@ -597,7 +597,7 @@ } /** - * Establish the loaded changeset. + * Establishes the loaded changeset. * * This method runs right at after_setup_theme and applies the 'customize_changeset_branching' filter to determine * whether concurrent changesets are allowed. Then if the Customizer is not initialized with a `changeset_uuid` param, @@ -697,7 +697,7 @@ } /** - * Stop previewing the selected theme. + * Stops previewing the selected theme. * * Removes filters to change the active theme. * @@ -802,7 +802,7 @@ } /** - * Get the changeset UUID. + * Gets the changeset UUID. * * @since 4.7.0 * @@ -818,7 +818,7 @@ } /** - * Get the theme being customized. + * Gets the theme being customized. * * @since 3.4.0 * @@ -832,7 +832,7 @@ } /** - * Get the registered settings. + * Gets the registered settings. * * @since 3.4.0 * @@ -843,7 +843,7 @@ } /** - * Get the registered controls. + * Gets the registered controls. * * @since 3.4.0 * @@ -854,7 +854,7 @@ } /** - * Get the registered containers. + * Gets the registered containers. * * @since 4.0.0 * @@ -865,7 +865,7 @@ } /** - * Get the registered sections. + * Gets the registered sections. * * @since 3.4.0 * @@ -876,7 +876,7 @@ } /** - * Get the registered panels. + * Gets the registered panels. * * @since 4.0.0 * @@ -898,7 +898,7 @@ } /** - * Register styles/scripts and initialize the preview of each setting + * Registers styles/scripts and initialize the preview of each setting * * @since 3.4.0 */ @@ -966,7 +966,7 @@ } /** - * Find the changeset post ID for a given changeset UUID. + * Finds the changeset post ID for a given changeset UUID. * * @since 4.7.0 * @@ -1004,7 +1004,7 @@ } /** - * Get changeset posts. + * Gets changeset posts. * * @since 4.9.0 * @@ -1077,7 +1077,7 @@ } /** - * Get the changeset post ID for the loaded changeset. + * Gets the changeset post ID for the loaded changeset. * * @since 4.7.0 * @@ -1098,7 +1098,7 @@ } /** - * Get the data stored in a changeset post. + * Gets the data stored in a changeset post. * * @since 4.7.0 * @@ -1132,7 +1132,7 @@ } /** - * Get changeset data. + * Gets changeset data. * * @since 4.7.0 * @since 4.9.0 This will return the changeset's data with a user's autosave revision merged on top, if one exists and $autosaved is true. @@ -1179,7 +1179,7 @@ protected $pending_starter_content_settings_ids = array(); /** - * Import theme starter content into the customized state. + * Imports theme starter content into the customized state. * * @since 4.7.0 * @@ -1632,9 +1632,9 @@ } /** - * Prepare starter content attachments. + * Prepares starter content attachments. * - * Ensure that the attachments are valid and that they have slugs and file name/path. + * Ensures that the attachments are valid and that they have slugs and file name/path. * * @since 4.7.0 * @@ -1694,7 +1694,7 @@ } /** - * Save starter content changeset. + * Saves starter content changeset. * * @since 4.7.0 */ @@ -1716,7 +1716,7 @@ } /** - * Get dirty pre-sanitized setting values in the current customized state. + * Gets dirty pre-sanitized setting values in the current customized state. * * The returned array consists of a merge of three sources: * 1. If the theme is not currently active, then the base array is any stashed @@ -1836,7 +1836,7 @@ } /** - * Override a setting's value in the current customized state. + * Overrides a setting's value in the current customized state. * * The name "post_value" is a carry-over from when the customized state was * exclusively sourced from `$_POST['customized']`. @@ -1882,7 +1882,7 @@ } /** - * Print JavaScript settings. + * Prints JavaScript settings. * * @since 3.4.0 */ @@ -1957,7 +1957,7 @@ } /** - * Add customize state query params to a given URL if preview is allowed. + * Adds customize state query params to a given URL if preview is allowed. * * @since 4.7.0 * @@ -2001,7 +2001,7 @@ } /** - * Prevent sending a 404 status when returning the response for the customize + * Prevents sending a 404 status when returning the response for the customize * preview, since it causes the jQuery Ajax to fail. Send 200 instead. * * @since 4.0.0 @@ -2012,7 +2012,7 @@ } /** - * Print base element for preview frame. + * Prints base element for preview frame. * * @since 3.4.0 * @deprecated 4.7.0 @@ -2022,7 +2022,7 @@ } /** - * Print a workaround to handle HTML5 tags in IE < 9. + * Prints a workaround to handle HTML5 tags in IE < 9. * * @since 3.4.0 * @deprecated 4.7.0 Customizer no longer supports IE8, so all supported browsers recognize HTML5. @@ -2032,7 +2032,7 @@ } /** - * Print CSS for loading indicators for the Customizer preview. + * Prints CSS for loading indicators for the Customizer preview. * * @since 4.2.0 */ @@ -2061,7 +2061,7 @@ } /** - * Remove customize_messenger_channel query parameter from the preview window when it is not in an iframe. + * Removes customize_messenger_channel query parameter from the preview window when it is not in an iframe. * * This ensures that the admin bar will be shown. It also ensures that link navigation will * work as expected since the parent frame is not being sent the URL to navigate to. @@ -2098,7 +2098,7 @@ } /** - * Print JavaScript settings for preview frame. + * Prints JavaScript settings for preview frame. * * @since 3.4.0 */ @@ -2253,7 +2253,7 @@ } /** - * Retrieve the template name of the previewed theme. + * Retrieves the template name of the previewed theme. * * @since 3.4.0 * @@ -2264,7 +2264,7 @@ } /** - * Retrieve the stylesheet name of the previewed theme. + * Retrieves the stylesheet name of the previewed theme. * * @since 3.4.0 * @@ -2275,7 +2275,7 @@ } /** - * Retrieve the template root of the previewed theme. + * Retrieves the template root of the previewed theme. * * @since 3.4.0 * @@ -2286,7 +2286,7 @@ } /** - * Retrieve the stylesheet root of the previewed theme. + * Retrieves the stylesheet root of the previewed theme. * * @since 3.4.0 * @@ -2408,7 +2408,7 @@ } /** - * Handle customize_save WP Ajax request to save/update a changeset. + * Handles customize_save WP Ajax request to save/update a changeset. * * @since 3.4.0 * @since 4.7.0 The semantics of this method have changed to update a changeset, optionally to also change the status and other attributes. @@ -2604,7 +2604,7 @@ } /** - * Save the post for the loaded changeset. + * Saves the post for the loaded changeset. * * @since 4.7.0 * @@ -2722,7 +2722,7 @@ $this->add_dynamic_settings( array_keys( $post_values ) ); // Ensure settings get created even if they lack an input value. /* - * Get list of IDs for settings that have values different from what is currently + * Gets list of IDs for settings that have values different from what is currently * saved in the changeset. By skipping any values that are already the same, the * subset of changed settings can be passed into validate_setting_values to prevent * an underprivileged modifying a single setting for which they have the capability @@ -2992,7 +2992,7 @@ } /** - * Preserve the initial JSON post_content passed to save into the post. + * Preserves the initial JSON post_content passed to save into the post. * * This is needed to prevent KSES and other {@see 'content_save_pre'} filters * from corrupting JSON data. @@ -3037,7 +3037,7 @@ } /** - * Trash or delete a changeset post. + * Trashes or deletes a changeset post. * * The following re-formulates the logic from `wp_trash_post()` as done in * `wp_publish_post()`. The reason for bypassing `wp_trash_post()` is that it @@ -3116,7 +3116,7 @@ } /** - * Handle request to trash a changeset. + * Handles request to trash a changeset. * * @since 4.9.0 */ @@ -3201,7 +3201,7 @@ } /** - * Re-map 'edit_post' meta cap for a customize_changeset post to be the same as 'customize' maps. + * Re-maps 'edit_post' meta cap for a customize_changeset post to be the same as 'customize' maps. * * There is essentially a "meta meta" cap in play here, where 'edit_post' meta cap maps to * the 'customize' meta cap which then maps to 'edit_theme_options'. This is currently @@ -3295,7 +3295,7 @@ } /** - * Get lock user data. + * Gets lock user data. * * @since 4.9.0 * @@ -3318,7 +3318,7 @@ } /** - * Check locked changeset with heartbeat API. + * Checks locked changeset with heartbeat API. * * @since 4.9.0 * @@ -3427,7 +3427,7 @@ } /** - * Publish changeset values. + * Publishes changeset values. * * This will the values contained in a changeset, even changesets that do not * correspond to current manager instance. This is called by @@ -3617,7 +3617,7 @@ } /** - * Update stashed theme mod settings. + * Updates stashed theme mod settings. * * @since 4.7.0 * @@ -3654,7 +3654,7 @@ } /** - * Refresh nonces for the current preview. + * Refreshes nonces for the current preview. * * @since 4.2.0 */ @@ -3667,7 +3667,7 @@ } /** - * Delete a given auto-draft changeset or the autosave revision for a given changeset or delete changeset lock. + * Deletes a given auto-draft changeset or the autosave revision for a given changeset or delete changeset lock. * * @since 4.9.0 */ @@ -3735,7 +3735,7 @@ } /** - * Add a customize setting. + * Adds a customize setting. * * @since 3.4.0 * @since 4.5.0 Return added WP_Customize_Setting instance. @@ -3769,7 +3769,7 @@ } /** - * Register any dynamically-created settings, such as those from $_POST['customized'] + * Registers any dynamically-created settings, such as those from $_POST['customized'] * that have no corresponding setting created. * * This is a mechanism to "wake up" settings that have been dynamically created @@ -3830,7 +3830,7 @@ } /** - * Retrieve a customize setting. + * Retrieves a customize setting. * * @since 3.4.0 * @@ -3844,7 +3844,7 @@ } /** - * Remove a customize setting. + * Removes a customize setting. * * Note that removing the setting doesn't destroy the WP_Customize_Setting instance or remove its filters. * @@ -3857,7 +3857,7 @@ } /** - * Add a customize panel. + * Adds a customize panel. * * @since 4.0.0 * @since 4.5.0 Return added WP_Customize_Panel instance. @@ -3882,7 +3882,7 @@ } /** - * Retrieve a customize panel. + * Retrieves a customize panel. * * @since 4.0.0 * @@ -3896,7 +3896,7 @@ } /** - * Remove a customize panel. + * Removes a customize panel. * * Note that removing the panel doesn't destroy the WP_Customize_Panel instance or remove its filters. * @@ -3926,7 +3926,7 @@ } /** - * Register a customize panel type. + * Registers a customize panel type. * * Registered types are eligible to be rendered via JS and created dynamically. * @@ -3941,7 +3941,7 @@ } /** - * Render JS templates for all registered panel types. + * Renders JS templates for all registered panel types. * * @since 4.3.0 */ @@ -3953,7 +3953,7 @@ } /** - * Add a customize section. + * Adds a customize section. * * @since 3.4.0 * @since 4.5.0 Return added WP_Customize_Section instance. @@ -3978,7 +3978,7 @@ } /** - * Retrieve a customize section. + * Retrieves a customize section. * * @since 3.4.0 * @@ -3992,7 +3992,7 @@ } /** - * Remove a customize section. + * Removes a customize section. * * Note that removing the section doesn't destroy the WP_Customize_Section instance or remove its filters. * @@ -4005,7 +4005,7 @@ } /** - * Register a customize section type. + * Registers a customize section type. * * Registered types are eligible to be rendered via JS and created dynamically. * @@ -4020,7 +4020,7 @@ } /** - * Render JS templates for all registered section types. + * Renders JS templates for all registered section types. * * @since 4.3.0 */ @@ -4032,7 +4032,7 @@ } /** - * Add a customize control. + * Adds a customize control. * * @since 3.4.0 * @since 4.5.0 Return added WP_Customize_Control instance. @@ -4057,7 +4057,7 @@ } /** - * Retrieve a customize control. + * Retrieves a customize control. * * @since 3.4.0 * @@ -4071,7 +4071,7 @@ } /** - * Remove a customize control. + * Removes a customize control. * * Note that removing the control doesn't destroy the WP_Customize_Control instance or remove its filters. * @@ -4084,7 +4084,7 @@ } /** - * Register a customize control type. + * Registers a customize control type. * * Registered types are eligible to be rendered via JS and created dynamically. * @@ -4098,7 +4098,7 @@ } /** - * Render JS templates for all registered control types. + * Renders JS templates for all registered control types. * * @since 4.1.0 */ @@ -4388,7 +4388,7 @@ } /** - * Prepare panels, sections, and controls. + * Prepares panels, sections, and controls. * * For each, check if required related components exist, * whether the user has the necessary capabilities, @@ -4522,7 +4522,7 @@ } /** - * Determine whether the user agent is iOS. + * Determines whether the user agent is iOS. * * @since 4.4.0 * @@ -4533,7 +4533,7 @@ } /** - * Get the template string for the Customizer pane document title. + * Gets the template string for the Customizer pane document title. * * @since 4.4.0 * @@ -4552,7 +4552,7 @@ } /** - * Set the initial URL to be previewed. + * Sets the initial URL to be previewed. * * URL is validated. * @@ -4566,7 +4566,7 @@ } /** - * Get the initial URL to be previewed. + * Gets the initial URL to be previewed. * * @since 4.4.0 * @@ -4596,7 +4596,7 @@ } /** - * Get URLs allowed to be previewed. + * Gets URLs allowed to be previewed. * * If the front end and the admin are served from the same domain, load the * preview over ssl if the Customizer is being loaded over ssl. This avoids @@ -4629,7 +4629,7 @@ } /** - * Get messenger channel. + * Gets messenger channel. * * @since 4.7.0 * @@ -4640,7 +4640,7 @@ } /** - * Set URL to link the user to when closing the Customizer. + * Sets URL to link the user to when closing the Customizer. * * URL is validated. * @@ -4656,7 +4656,7 @@ } /** - * Get URL to link the user to when closing the Customizer. + * Gets URL to link the user to when closing the Customizer. * * @since 4.4.0 * @@ -4699,7 +4699,7 @@ } /** - * Set the autofocused constructs. + * Sets the autofocused constructs. * * @since 4.4.0 * @@ -4716,7 +4716,7 @@ } /** - * Get the autofocused constructs. + * Gets the autofocused constructs. * * @since 4.4.0 * @@ -4733,7 +4733,7 @@ } /** - * Get nonces for the Customizer. + * Gets nonces for the Customizer. * * @since 4.5.0 * @@ -4764,7 +4764,7 @@ } /** - * Print JavaScript settings for parent window. + * Prints JavaScript settings for parent window. * * @since 4.4.0 */ @@ -5014,7 +5014,7 @@ } /** - * Register some default controls. + * Registers some default controls. * * @since 3.4.0 */ @@ -5732,7 +5732,7 @@ } /** - * Return whether there are published pages. + * Returns whether there are published pages. * * Used as active callback for static front page section and controls. * @@ -5754,7 +5754,7 @@ } /** - * Add settings from the POST data that were not added with code, e.g. dynamically-created settings for Widgets + * Adds settings from the POST data that were not added with code, e.g. dynamically-created settings for Widgets * * @since 4.2.0 * @@ -5766,7 +5766,7 @@ } /** - * Load themes into the theme browsing/installation UI. + * Loads themes into the theme browsing/installation UI. * * @since 4.9.0 */ @@ -6001,7 +6001,7 @@ } /** - * Export header video settings to facilitate selective refresh. + * Exports header video settings to facilitate selective refresh. * * @since 4.7.0 *