Admin Pages

An admin page adds a page of its own to the WordPress admin menu and shows one or more Views on it, whatever post type or source each reads. The Views stay fully interactive there: tables, boards and feedback lists edit, move and add items exactly as their layouts allow.

The Admin pages screen

Admin pages lists every admin page with its name, menu title, the number of Views on it and its status, Active or Disabled. Its search and page are part of the address. Create admin page, here or on View’s Start screen, asks for a name and creates an empty page; before the first one, the screen says there are no admin pages yet and offers the same button.

The admin page editor

The editor works like the View editor: the center previews the page with its Views as tabs, shown once it has more than one, and the inspector on the right has a tab for each View on the page. A page without Views says so and offers Add View.

• Add View adds a View to the page. The new entry starts with the first saved View; choose another in View.
• Each entry has arrows to move it backward or forward, Name, which replaces the View’s own name on its tab ("Leave empty to use the selected View name."), View, the View to show, and Remove View.

The toolbar starts with the settings button, which switches the inspector to Admin page settings, and Delete admin page, which removes the page after you confirm; the Views on it are kept. Discard returns the page to its saved state and Save stores it; both stay disabled until you change something. Until then your changes stay in the editor’s tab, and closing or reloading the page asks first.

Admin page settings

General

• Name names the page in the admin pages list and in the editor.
• Menu title is the label of the menu item and the heading of the page.
• Menu position "Controls where the page appears in the WordPress admin menu." Lower numbers sit higher. WordPress places Dashboard at 2, Posts at 5, Media at 10, Pages at 20, Comments at 25, Appearance at 60, Plugins at 65, Users at 70, Tools at 75 and Settings at 80. The default, 0, puts the page at the top of the menu.
• Dashicon chooses the menu icon from WordPress’s Dashicons; the default is the generic admin icon.
• Enable admin page: "A disabled admin page stays saved but is not registered in WordPress."

Conditions

“Choose when this admin page is registered in WordPress.” When the conditions do not match the current user, the page has no menu item and cannot be opened. See Conditions.

In wp-admin

An admin page is a top-level menu page that only administrators, users with manage_options, can open. It shows the menu title as its heading and its Views as tabs when there is more than one, each with its layouts as tabs of its own:

• A View or layout whose conditions exclude the user is left out.
• Default post screen layouts are left out.
• The page remembers the View last selected in this browser, and the address of the page records the selected View and layout, so a reload returns to them.

Admin pages exist only in wp-admin; to show a View elsewhere, use its shortcode.