Changeset 56570 for trunk/src/wp-includes/functions.php

Timestamp:

09/14/2023 12:52:45 AM (3 years ago)

Author:

joedolson

Message:

Administration: Use wp_admin_notice() in /wp-admin/.

Add usages of wp_admin_notice() and wp_get_admin_notice() on .notice-[type] in the root level of /wp-admin/. Ongoing task to implement new function across core.

Props costdev, joedolson.
See #57791.

File:

• trunk/src/wp-includes/functions.php (modified) (1 diff)

trunk/src/wp-includes/functions.php

@@ -8319 +8319 @@
  * @since 5.1.0
  * @since 5.2.0 Added the `$before` and `$after` parameters.
+ * @since 6.4.0 Added the `$echo` parameter.
  *
  * @param string $before Markup to output before the annotation. Default `<p class="description">`.
  * @param string $after  Markup to output after the annotation. Default `</p>`.
- */
-function wp_update_php_annotation( $before = '<p class="description">', $after = '</p>' ) {
+ * @param bool   $echo   Markup should echo if true. Default `true`.
+ *
+ * @return string|void
+ */
+function wp_update_php_annotation( $before = '<p class="description">', $after = '</p>', $echo = true ) {
         $annotation = wp_get_update_php_annotation();
 
         if ( $annotation ) {
-                echo $before . $annotation . $after;
+                if ( $echo ) {
+                        echo $before . $annotation . $after;
+                } else {
+                        return $before . $annotation . $after;
+                }
         }
 }