ToolbarMenus final class

Minn\Front\ToolbarMenus · public/minn/src/Minn/Front/ToolbarMenus.php · 339 lines

The nodes WordPress puts on the toolbar itself, as the reference adds them on the front end for whoever is signed in (probe admin-bar): the account menu, the WordPress menu, the site menu with its appearance group, the site editor and customizer links, updates, comments, new content, the edit link for what the page shows, the shortlink, the secondary groups, and the search box. Each is one admin_bar_menu callback, so plugins can unhook any of them by name.

Uses 3

I18n\Gettext Runtime\Runtime Support\Escape

Constants and properties

const	`MENUS` = array ( 0 => array ( 0 => 'wp_admin_bar_my_account_menu', 1 => 0, ), 1 => array ( 0 => 'wp_admin_bar_my_account_item', 1 => 9991, ), 2 => array ( 0 => 'wp_admin_bar_recovery_mode_menu', 1 => 9992, ), 3 => array ( 0 => 'wp_admin_bar_search_menu', 1 => 9999, ), 4 => array ( 0 => 'wp_admin_bar_sidebar_toggle', 1 => 0, ), 5 => array ( 0 => 'wp_admin_bar_wp_menu', 1 => 10, ), 6 => array ( 0 => 'wp_admin_bar_my_sites_menu', 1 => 20, ), 7 => array ( 0 => 'wp_admin_bar_site_menu', 1 => 30, ), 8 => array ( 0 => 'wp_admin_bar_edit_site_menu', 1 => 40, ), 9 => array ( 0 => 'wp_admin_bar_customize_menu', 1 => 40, ), 10 => array ( 0 => 'wp_admin_bar_updates_menu', 1 => 50, ), 11 => array ( 0 => 'wp_admin_bar_command_palette_menu', 1 => 55, ), 12 => array ( 0 => 'wp_admin_bar_comments_menu', 1 => 60, ), 13 => array ( 0 => 'wp_admin_bar_new_content_menu', 1 => 70, ), 14 => array ( 0 => 'wp_admin_bar_edit_menu', 1 => 80, ), 15 => array ( 0 => 'wp_admin_bar_add_secondary_groups', 1 => 200, ), )	WordPress's menus as add_menus hooks them: the callback, its priority.
private	`ICON` = `'<span class="ab-icon" aria-hidden="true"></span>'`

Public

static	`myAccountItem(WP_Admin_Bar $bar): void`#	"Howdy" with the user's name and small avatar, at the right of the bar.
static	`myAccountMenu(WP_Admin_Bar $bar): void`#	The account menu: the user's card (larger avatar, name, login when it differs, the profile link) and Log Out.
static	`sidebarToggle(WP_Admin_Bar $bar): void`#	The menu button wp-admin's narrow screens show; the front end has none.
static	`wpMenu(WP_Admin_Bar $bar): void`#	The WordPress logo's menu: About and Get Involved for a reader, then the wordpress.org links beside them.
static	`siteMenu(WP_Admin_Bar $bar): void`#	The site's name (with its icon when it has one), then the dashboard, appearance and plugins below it.
static	`appearanceMenu(WP_Admin_Bar $bar): void`#	The appearance group under the site's name: themes, then what the theme supports for those who may edit it.
static	`editSiteMenu(WP_Admin_Bar $bar): void`#	Edit Site under a block theme, opening the template this page was built from when there is one.
static	`customizeMenu(WP_Admin_Bar $bar): void`#	Customize, for a theme the customizer serves (a block theme only once something registers with it).
static	`updatesMenu(WP_Admin_Bar $bar): void`#	The count of updates waiting, when there are any.
static	`commentsMenu(WP_Admin_Bar $bar): void`#	The comments awaiting moderation, for those who edit posts.
static	`newContentMenu(WP_Admin_Bar $bar): void`#	New: a post, media, a link, a page, each other type shown on the bar, and a user, as far as the user may create them.
static	`editMenu(WP_Admin_Bar $bar): void`#	Edit, for the post, term or user the page shows, when the user may edit it.
static	`shortlinkMenu(WP_Admin_Bar $bar): void`#	The page's shortlink, with a box to copy it from.
static	`secondaryGroups(WP_Admin_Bar $bar): void`#	The groups for the bar's right side and the logo menu's outside links.
static	`recoveryModeMenu(WP_Admin_Bar $bar): void`#	The way out of recovery mode, while the site is in it.
static	`searchMenu(WP_Admin_Bar $bar): void`#	The search box, on the front end.

Internals 4

Private and protected methods: how the class does its work. Not a contract; they change whenever the code is tidied.

private	`profileUrl(int $userId): string\|false`#	The profile link for the signed-in user, or false when they cannot read.
private	`creatable(): array`#	`@return array<string, array{0: string, 1: string}> the admin page => [the label, the node id], for what the user may create`
private	`editPost(object $post): array`#	`@return array{0: ?string, 1: ?string} the edit label and link for a post, or nulls`
private	`editTerm(object $term): array`#	`@return array{0: ?string, 1: ?string} the edit label and link for a term, or nulls`