Changeset 56177 for trunk/src/wp-includes/class-wp-customize-manager.php

Timestamp:

07/09/2023 08:15:03 PM (2 years ago)

Author:

audrasjb

Message:

Docs: Replace multiple single line comments with multi-line comments.

This changeset updates various comments as per WordPress PHP Inline Documentation Standards.
See ​https://developer.wordpress.org/coding-standards/inline-documentation-standards/php/#5-inline-comments.

Follow-up to [56174], [56175], [56176].

Props costdev, audrasjb.
See #58459.

File:

• trunk/src/wp-includes/class-wp-customize-manager.php (modified) (6 diffs)

trunk/src/wp-includes/class-wp-customize-manager.php

@@ -272 +272 @@
         }
 
-        // The theme and messenger_channel should be supplied via $args,
-        // but they are also looked at in the $_REQUEST global here for back-compat.
+        /*
+         * The theme and messenger_channel should be supplied via $args,
+         * but they are also looked at in the $_REQUEST global here for back-compat.
+         */
         if ( ! isset( $args['theme'] ) ) {
             if ( isset( $_REQUEST['customize_theme'] ) ) {
@@ -566 +568 @@
             add_action( 'after_setup_theme', array( $this, 'after_setup_theme' ) );
         } else {
-            // If the requested theme is not the active theme and the user doesn't have
-            // the switch_themes cap, bail.
+            /*
+             * If the requested theme is not the active theme and the user doesn't have
+             * the switch_themes cap, bail.
+             */
             if ( ! current_user_can( 'switch_themes' ) ) {
                 $this->wp_die( -1, __( 'Sorry, you are not allowed to edit theme options on this site.' ) );
@@ -906 +910 @@
     public function wp_loaded() {
 
-        // Unconditionally register core types for panels, sections, and controls
-        // in case plugin unhooks all customize_register actions.
+        /*
+         * Unconditionally register core types for panels, sections, and controls
+         * in case plugin unhooks all customize_register actions.
+         */
         $this->register_panel_type( 'WP_Customize_Panel' );
         $this->register_panel_type( 'WP_Customize_Themes_Panel' );
@@ -5270 +5276 @@
         );
 
-        // Input type: checkbox.
-        // With custom value.
+        // Input type: checkbox, with custom value.
         $this->add_control(
             'display_header_text',
@@ -5294 +5299 @@
         );
 
-        // Input type: color.
-        // With sanitize_callback.
+        // Input type: color, with sanitize_callback.
         $this->add_setting(
             'background_color',
@@ -5603 +5607 @@
         );
 
-        // If the theme is using the default background callback, we can update
-        // the background CSS using postMessage.
+        /*
+         * If the theme is using the default background callback, we can update
+         * the background CSS using postMessage.
+         */
         if ( get_theme_support( 'custom-background', 'wp-head-callback' ) === '_custom_background_cb' ) {
             foreach ( array( 'color', 'image', 'preset', 'position_x', 'position_y', 'size', 'repeat', 'attachment' ) as $prop ) {