Create function to output admin notices

[nalininsbs]

Ticket: https://core.trac.wordpress.org/ticket/57791

Has label needs-dev-note

[github-actions]

Heads up @WordPress/docs-issues-coordinators, we have a new issue open. Time to use 'em labels.

[abhansnuk]

Follow up on the trac ticket.

Costdev's reply:

• plans to focus dev note to introduce extenders to the new wp_admin_notice() and wp_get_admin_notice() functions so that they too can benefit from the reduce the maintenance burden of maintaining HTML for their admin notices
• has asked for the dev note to get a callout in the Field Guide

This conservative search shows that a significant number of plugins can benefit from these two functions right away.

Status:

• no dev note in draft, Colin can write it for next week.
• Highlighted timing need it and to have been reviewed on Monday to include in Field Guide. To be confirmed if this is possible.
• shared link to issue on documentation tracker on Trac Ticket.

[shabnam611]

Keyword: needs-dev-note
Ticket owner: joedolson
Core committer: costdev

There are some work remaining on this ticket which is punted to 6.5 and closing this one for 6.4

This task has not been completed 100% so Colin mentioned to close this trac ticket off for 6.4 and put the remaining task in 6.5. Later in the conversation, Colin offered to write the dev note. So I guess we can use the dev note.

[costdev]

Hey folks! I have the draft of the dev note here: https://make.wordpress.org/core/?p=108856&preview=1&_ppp=706f77a1f6

This has been peer-reviewed by @joedolson too, so handing over to the Documentation team for final review and publishing.

If a blurb is required for the Field Guide, here's one from the dev note:

These functions abstract the HTML markup generation to reduce the maintenance burden, encourage consistency, and enable argument and message filtering for all admin notices.

Let me know if you need anything else from me. Thanks all! 🙂

[nalininsbs]

Thank you.

Dev note
Excerpt added, props added.
Minor text edit on bracket and point.

Published https://make.wordpress.org/core/2023/10/16/introducing-admin-notice-functions-in-wordpress-6-4/

Like the section on Usage in WordPress Core. This would be useful for a number of dev notes.

@abhansnuk are you adding to the Field Guide now too that the post is live?

[abhansnuk]

Thanks @nalininsbs for stepping in and monitoring the flow.

Added to the Field Guide.

[abhansnuk]

Thanks Colin and Joe.

[costdev]

@abhansnuk Thanks! Quick question: The Field Guide screenshot shows this under the Comments heading, but admin notices can appear in any administration area. Maybe "Notices" would be better here, or do you have other thoughts on this?

[codente]

@costdev Thanks! We've moved it to an Admin Notices section in the field guide.