wp_admin_notice( string $message, array $args = array() )

Parameters

$messagestring

The message to output.

$argsarrayoptional

An array of arguments for the admin notice. Default empty array.Default: array()

• $typestringdefault: empty string

  Optional. The type of admin notice. For example, 'error', 'success', 'warning', 'info'.

• $dismissiblebooldefault: false

  Optional. Whether the admin notice is dismissible.

• $idstringdefault: empty string

  Optional. The value of the admin notice's ID attribute.

• $additional_classesstring[]default: empty array

  Optional. A string array of class names.

• $attributesstring[]default: empty array

  Optional. Additional attributes for the notice div.

• $paragraph_wrapbooldefault: true

  Optional. Whether to wrap the message in paragraph tags.

Hooks fired · 1

One hook fires while wp_admin_notice() runs, in this order:

1. 1
   do_action( wp_admin_notice )actionline 9198 (+9 into the body)

   Fires before an admin notice is output.

Uses · 3

• do_action()Calls the callback functions that have been added to an action hook.
• wp_kses_post()Sanitizes content for allowed HTML tags for post content.
• wp_get_admin_notice()Creates and returns the markup for an admin notice.

Used by · 44

• Bulk_Upgrader_Skin::after()Performs an action following a bulk update.
• Custom_Background::admin_page()Displays the custom background page.
• Custom_Image_Header::step_1()Displays first step of custom header image page.
• WP_Customize_Theme_Control::content_template()Render a JS template for theme display.
• WP_MS_Themes_List_Table::column_autoupdates()Handles the auto-updates column output.
• WP_MS_Themes_List_Table::column_description()Handles the description column output.
• WP_Plugin_Dependencies::display_admin_notice_for_circular_dependencies()Displays an admin notice if circular dependencies are installed.
• WP_Plugin_Dependencies::display_admin_notice_for_unmet_dependencies()Displays an admin notice if dependencies are not installed.
• WP_Plugin_Install_List_Table::display_rows()Generates the list table rows.
• WP_Plugin_Install_List_Table::no_items()
• WP_Plugins_List_Table::single_row()
• WP_Posts_List_Table::inline_edit()Outputs the hidden row displayed when inline editing

Source

View on Trac ↗View on GitHub ↗

9189function wp_admin_notice( $message, $args = array() ) {9190	/**9191	 * Fires before an admin notice is output.9192	 *9193	 * @since 6.4.09194	 *9195	 * @param string $message The message for the admin notice.9196	 * @param array  $args    The arguments for the admin notice.9197	 */9198	do_action( 'wp_admin_notice', $message, $args );9199 9200	echo wp_kses_post( wp_get_admin_notice( $message, $args ) );9201}

History

Introduced in 6.4.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.0.4 tag, from src/wp-includes/functions.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.