Docs: Correct documentation for customize_controls_head hook and _customizer_mobile_viewport_meta() function.

SergeyBiryukov · SergeyBiryukov · commit 7b27f3f00a33 · 2020-07-10T11:34:41.000Z
Follow-up to [48412]. See #47369. git-svn-id: https://develop.svn.wordpress.org/trunk@48420 602fd350-edb4-49c9-b593-d223f7449a82
diff --git a/src/wp-admin/customize.php b/src/wp-admin/customize.php
@@ -170,7 +170,7 @@
 do_action( 'customize_controls_print_scripts' );
 
 /**
- * Fires when Customizer control scripts are printed.
+ * Fires in head section of Customizer controls.
  *
  * @since 5.5.0
  */
diff --git a/src/wp-admin/includes/misc.php b/src/wp-admin/includes/misc.php
@@ -1027,21 +1027,26 @@ function wp_admin_viewport_meta() {
 	 * @param string $viewport_meta The viewport meta.
 	 */
 	$viewport_meta = apply_filters( 'admin_viewport_meta', 'width=device-width,initial-scale=1.0' );
+
 	if ( empty( $viewport_meta ) ) {
 		return;
 	}
+
 	echo '<meta name="viewport" content="' . esc_attr( $viewport_meta ) . '">';
 }
 
 /**
- * Viewport meta for mobile in customize.
+ * Adds viewport meta for mobile in Customizer.
  *
  * Hooked to the {@see 'admin_viewport_meta'} filter.
  *
  * @since 5.5.0
+ *
+ * @param string $viewport_meta The viewport meta.
+ * @return string Filtered viewport meta.
  */
-function _customizer_mobile_viewport_meta( $content ) {
-	return trim( $content, ',' ) . ',minimum-scale=0.5,maximum-scale=1.2';
+function _customizer_mobile_viewport_meta( $viewport_meta ) {
+	return trim( $viewport_meta, ',' ) . ',minimum-scale=0.5,maximum-scale=1.2';
 }
 
 /**

Original file line number	Diff line number	Diff line change
`@@ -170,7 +170,7 @@`
`170`	`170`	`do_action( 'customize_controls_print_scripts' );`
`171`	`171`
`172`	`172`	`/**`
`173`		`- * Fires when Customizer control scripts are printed.`
	`173`	`+ * Fires in head section of Customizer controls.`
`174`	`174`	`*`
`175`	`175`	`* @since 5.5.0`
`176`	`176`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -1027,21 +1027,26 @@ function wp_admin_viewport_meta() {`
`1027`	`1027`	`* @param string $viewport_meta The viewport meta.`
`1028`	`1028`	`*/`
`1029`	`1029`	`$viewport_meta = apply_filters( 'admin_viewport_meta', 'width=device-width,initial-scale=1.0' );`
	`1030`	`+`
`1030`	`1031`	`if ( empty( $viewport_meta ) ) {`
`1031`	`1032`	`return;`
`1032`	`1033`	`}`
	`1034`	`+`
`1033`	`1035`	`echo '<meta name="viewport" content="' . esc_attr( $viewport_meta ) . '">';`
`1034`	`1036`	`}`
`1035`	`1037`
`1036`	`1038`	`/**`
`1037`		`- * Viewport meta for mobile in customize.`
	`1039`	`+ * Adds viewport meta for mobile in Customizer.`
`1038`	`1040`	`*`
`1039`	`1041`	`* Hooked to the {@see 'admin_viewport_meta'} filter.`
`1040`	`1042`	`*`
`1041`	`1043`	`* @since 5.5.0`
	`1044`	`+ *`
	`1045`	`+ * @param string $viewport_meta The viewport meta.`
	`1046`	`+ * @return string Filtered viewport meta.`
`1042`	`1047`	`*/`
`1043`		`-function _customizer_mobile_viewport_meta( $content ) {`
`1044`		`- return trim( $content, ',' ) . ',minimum-scale=0.5,maximum-scale=1.2';`
	`1048`	`+function _customizer_mobile_viewport_meta( $viewport_meta ) {`
	`1049`	`+ return trim( $viewport_meta, ',' ) . ',minimum-scale=0.5,maximum-scale=1.2';`
`1045`	`1050`	`}`
`1046`	`1051`
`1047`	`1052`	`/**`