Admin Shell Integration #

New in v1.2.0

Extensions can add new top-level sections to the Admin Shell Column 1 and new views to any section’s Column 2 using two filters provided by Core.

Adding a Top-Level Section (Column 1) #

Use the dmsilm_admin_shell_sections filter to register a new section:

add_filter( 'dmsilm_admin_shell_sections', function( $sections ) {
$sections[] = array(
'slug'       => 'my-extension',
'label'      => 'My Extension',
'icon'       => 'dashicons-admin-plugins',
'full_width' => false,
'order'      => 50,
);
return $sections;
} );

Parameters:

Adding Views to a Section (Column 2) #

Use the dmsilm_admin_shell_pages filter to register views within a section. Include the section key in each page array to specify which section the view belongs to:

add_filter( 'dmsilm_admin_shell_pages', function( $pages ) {
$pages[] = array(
'section'    => 'my-extension',
'slug'       => 'overview',
'label'      => 'Overview',
'callback'   => array( 'My_Extension_Overview_Handler', 'render' ),
'priority'   => 100,
'capability' => 'manage_options',
'source'     => 'extension',
);
$pages[] = array(
'section'    => 'my-extension',
'slug'       => 'config',
'label'      => 'Configuration',
'callback'   => array( 'My_Extension_Config_Handler', 'render' ),
'priority'   => 101,
'capability' => 'manage_options',
'source'     => 'extension',
);
return $pages;
} );

Parameters:

Handler Callable Requirements #

The callable provided in callback must be loadable before the shell calls it. A typical pattern is a public static method:

class My_Extension_Overview_Handler {
public static function render() {
echo '<div class="wrap">';
echo '<h1>My Extension Overview</h1>';
// your content here
echo '</div>';
}
}

The callback value can be any PHP callable: a static class method array, an instance method array, a closure, or a global function name. The shell calls it with no arguments.

Full-Width Sections #

If your section has no sub-views, set 'full_width' => true when registering it. Core will apply the dmsilm-shell-wrap--full-width CSS class, hiding Column 2 and giving Column 3 the full available width.

Building URLs Programmatically #

Use DMSILM_Admin_Shell_Router::build_url( $section, $view ) to generate correct admin shell URLs from your extension code:

$url = DMSILM_Admin_Shell_Router::build_url( 'my-extension', 'overview' );

This is safer than constructing the URL string manually, as it will remain correct if Core’s URL structure changes.

Related Topics #

• [The Three Columns](#)
• [Navigating the Admin](#)
• [Settings Tab Integration](#)