Como adicionar menus e submenus no painel de administração do WordPress

Publicados: 2024-09-06

Se você concluiu o menu padrão do painel de administração do WordPress ou gostaria de personalizá-lo de acordo com sua preferência

A navegação no painel de administração do WordPress pode ser facilitada personalizando-o com seus menus e submenus.

Nesta postagem, orientaremos você nas etapas para adicionar menus e submenus usando trechos de código simples.

Se você deseja organizar as configurações do plugin ou criar opções personalizadas, adicionar menus pode tornar sua área de administração do WordPress mais personalizada e fácil de usar. Mas primeiro, vamos esclarecer alguns princípios básicos.


Índice
O que são menus e submenus?
Como adicionar um menu personalizado
Como adicionar um submenu
Adicionando submenus aos menus padrão do WordPress
Conclusão

O que são menus e submenus?

Menus são os principais itens que você geralmente nota na barra lateral de administração do WordPress, como “Postagens”, “Páginas” e “Configurações”.

No entanto, os submenus são opções listadas no menu principal. Por exemplo, em “Postagens”, você encontrará submenus como “Todas as postagens” e “Adicionar novo”. Resumindo, os submenus são opções listadas em um menu principal.


Como adicionar um menu personalizado

Agora você deve estar se perguntando como adicionar um menu personalizado no painel de administração do WordPress.

Bem, não é tão complicado, basta usar a função add_menu_page() .

Aqui está um método passo a passo simples que você pode seguir:

1. Abra o arquivo functions.php do seu tema:

Você pode encontrar esse arquivo acessando o painel do WordPress, navegando até “Aparência”> “Editor de arquivo de tema” e selecionando o arquivo functions.php .

2. Adicione o seguinte código:

function custom_plugin_menu() {

add_menu_page(

'My Custom Plugin', // Page title

'My Plugin', // Menu title

'manage_options', // Capability required

'my-plugin', // Menu slug (unique identifier)

'my_plugin_page', // Callback function to display page content

'', // Icon URL (leave empty for default icon)

6 // Position on the menu (optional)

);

}

add_action('admin_menu', 'custom_plugin_menu');

// Callback function to display the menu page content

function my_plugin_page() {

echo '<h1>Welcome to My Plugin Page!</h1>';

}

3. Salve suas alterações:

Após adicionar o código, salve o arquivo functions.php . Seu novo menu “Meu Plugin” agora deve aparecer na barra lateral de administração do WordPress.


WPOven Dedicated Hosting

Como adicionar um submenu

Se você deseja adicionar submenus de segundo nível ao menu de administração do WordPress em seu novo menu personalizado, use a função add_submenu_page() . Veja como:

1. Adicione o código do submenu em functions.php :

função custom_plugin_submenu() {

// Adicionando o menu de nível superior primeiro

add_menu_page(

'Meu plug-in personalizado',

'Meu plug-in',

'gerenciar_opções',

'meu-plugin',

'minha_página_de_plugin'

);

//Adicionando submenus

add_submenu_page(

'my-plugin', // Slug pai

'Adicionar Produto', // Título da página

'Adicionar Produto', // Título do submenu

'manage_options', // Capacidade necessária

'adicionar produto', // slug do submenu

'add_product_page' // Função de retorno de chamada

);

add_submenu_page(

'meu-plugin',

'Sobre nós',

'Sobre nós',

'gerenciar_opções',

'sobre nós',

'sobre_nós_página'

);

}

add_action('admin_menu', 'custom_plugin_submenu');

// Função de retorno de chamada para o submenu 'Adicionar Produto'

função add_product_page() {

echo '<h1>Adicione seu produto aqui!</h1>';

}

// Função de retorno de chamada para o submenu 'Sobre nós'

função about_us_page() {

echo '<h1>Sobre nosso plugin</h1>';

}

2. Salve o arquivo:

Seus submenus “Adicionar produto” e “Sobre nós” agora aparecerão no menu “Meu plug-in” no painel de administração.

Pontos-chave a serem lembrados

Menu Slug : Este é um identificador exclusivo para o seu menu. Deve estar em letras minúsculas e pode incluir travessões ou sublinhados.

Capacidade: controla quem pode ver o menu. Por exemplo, 'manage_options' geralmente é para usuários administradores e eles só podem vê-lo.

Posição: determina onde o menu aparece na lista. É opcional, mas ajuda a organizar os menus.

Título da página : aparece na barra de título do navegador quando você abre o menu ou submenu.

Título do menu : Este é o texto que aparece na barra lateral.

Função de retorno de chamada : Esta função é executada quando o menu ou submenu é clicado, exibindo seu conteúdo.

O exemplo acima é para os menus personalizados que criamos. Mas e os menus existentes no administrador do WordPress?

Como você pode criar um submenu de segunda camada para o menu de administração padrão do WordPress? Veja como:


Adicionando submenus aos menus padrão do WordPress

Anteriormente, falamos sobre como adicionar submenus aos menus personalizados no WordPress. Agora, vamos ver como você pode adicionar submenus aos menus padrão existentes no WordPress (como Painel, Postagens, Páginas, etc.).

O WordPress fornece funções específicas para adicionar submenus a estes menus padrão:

add_dashboard_page : Adiciona um submenu no menu “Dashboard”.

add_posts_page : Adiciona um submenu no menu “Postagens”.

add_media_page : Adiciona um submenu no menu “Mídia”.

add_links_page : Adiciona um submenu no menu “Links”.

add_pages_page : Adiciona um submenu no menu “Páginas”.

add_comments_page : Adiciona um submenu no menu “Comentários”.

add_theme_page : Adiciona um submenu no menu “Temas”.

add_plugins_page : Adiciona um submenu no menu “Plugins”.

add_users_page : Adiciona um submenu no menu “Usuários”.

add_management_page : Adiciona um submenu no menu “Ferramentas”.

add_options_page : Adiciona um submenu no menu “Configurações”.

Todas essas funções funcionam de forma semelhante. Vamos entender melhor com um exemplo simples: adicionar um submenu no menu “Configurações” usando add_options_page() .

Exemplo: Adicionando um Submenu em Configurações

Para adicionar um submenu em “ Configurações ”, você pode usar a função add_options_page() . Aqui está uma análise simples da função:

$page_title : O título da página quando você a abre.

$menu_title : O nome que aparece na barra lateral em “Configurações”.

$capability : Quem pode ver este submenu (apenas administradores).

$menu_slug : Um ID exclusivo para este submenu.

$function : Uma função que exibirá o conteúdo quando o submenu for clicado.

Por exemplo, use esta função como abaixo:

add_options_page('My Plugin', 'My Plugin', 'manage_options', 'my-plugin', 'WPOven_plugin_render_options_page');

– Este código adiciona um submenu chamado “ Meu Plugin ” no menu “Configurações”.

– Só será visível para usuários com capacidade ' manage_options ' (geralmente administradores).

– Ao clicar, executará a função WPOven _plugin_render_options_page para exibir o conteúdo da página.

É assim que você pode adicionar submenus aos menus padrão do WordPress, facilitando o acesso às configurações personalizadas ou às páginas que deseja adicionar!


Leia: Como reordenar itens do menu Admin no WordPress?


Conclusão

Adicionar menus e submenus personalizados no WordPress é uma ótima maneira de personalizar seu administrador conforme sua conveniência.

E a melhor parte é que você pode implementar e executar esse recurso de maneira simples com algumas linhas de código. Isso o ajudará a criar um back-end mais organizado e acessível para você ou seus clientes.

Seguindo essas etapas minuciosamente, você terá um painel de administração personalizado rapidamente. Se você tiver alguma dúvida ou feedback sobre esta postagem, mencione na seção de comentários abaixo.