Admin menu pages in Wordpress - Step-by-Step Execution

Concept Flow - Admin menu pages

Plugin loads

↓

Hook into admin_menu

↓

Call add_menu_page()

↓

WordPress adds menu item

↓

User clicks menu

↓

Callback function runs

↓

Admin page content displays

This flow shows how WordPress plugins add admin menu pages by hooking into admin_menu, registering the menu, and displaying content when clicked.

Execution Sample

Wordpress

<?php
add_action('admin_menu', function() {
  add_menu_page('My Page', 'My Menu', 'manage_options', 'my_page_slug', function() {
    echo '<h1>Welcome to My Admin Page</h1>';
  });
});

This code adds a new admin menu page with a title and content shown when the menu is clicked.

Execution Table

Step	Action	Function Called	Result	Notes
1	Plugin loads	add_action('admin_menu', callback)	Callback registered	Hook set for admin menu setup
2	WordPress triggers admin_menu	callback()	add_menu_page() called	Menu item registered in admin sidebar
3	User clicks menu item	callback for page content	Page content displayed	Echoes <h1>Welcome to My Admin Page</h1>
4	User navigates away	No action	Page hidden	Admin menu remains visible

💡 Execution stops when user leaves the admin page or closes admin area.

Variable Tracker

Variable	Start	After Hook	After add_menu_page	After Click
callback	undefined	function registered	function ready	function executed
menu_item	none	none	menu item added	menu item active

Key Moments - 2 Insights

Why doesn't the admin menu page show up immediately after calling add_menu_page?

Because add_menu_page only registers the menu during the admin_menu hook. The menu appears when WordPress builds the admin sidebar after the hook runs, as shown in step 2 of the execution_table.

What happens if the callback function for the page content is missing?

The menu item will appear but clicking it shows a blank page or error because no content is output. Step 3 in the execution_table shows the callback runs to display content.

Visual Quiz - 3 Questions

Look at the execution_table, what happens at step 2?

A The plugin loads

B The admin menu item is registered

C The page content is displayed

D The user clicks the menu

💡 Hint

Refer to the 'Result' column in step 2 of execution_table

At which step does the page content get shown to the user?

A Step 3

B Step 2

C Step 1

D Step 4

💡 Hint

Check the 'Result' column for when content is displayed in execution_table

If the callback function is not defined, what changes in the execution_table?

A Step 2 will fail to register menu

B Step 1 will not run

C Step 3 will show no page content

D Step 4 will show an error

💡 Hint

Look at step 3 where the callback outputs content in execution_table

Concept Snapshot

WordPress admin menu pages:
- Use add_action('admin_menu', callback) to hook menu setup
- Call add_menu_page(title, menu_title, capability, slug, callback) inside callback
- WordPress adds menu item after hook runs
- Callback outputs page content when menu clicked
- Menu visible in admin sidebar for authorized users

Full Transcript

This visual execution shows how WordPress plugins add admin menu pages. First, the plugin registers a callback on the admin_menu hook. When WordPress runs this hook, it calls the callback which uses add_menu_page to register a new menu item. The menu item appears in the admin sidebar. When the user clicks this menu, WordPress runs the callback function that outputs the page content, such as a heading. The menu remains visible while the user is in the admin area. If the callback is missing, the menu shows but no content appears. This step-by-step trace helps beginners see how admin menu pages are added and displayed in WordPress.