Como adicionar menus e submenus no painel de administração do WordPress
Publicados: 2024-09-06Se 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.
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.
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:
1 |
add_options_page ( $ page_title , $ menu_title , $ capability , $ menu_slug , $ function ) ; |
– $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
para exibir o conteúdo da página.WPOven
_plugin_render_options_page
É 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.
Rahul Kumar é um entusiasta da web e estrategista de conteúdo especializado em WordPress e hospedagem na web. Com anos de experiência e o compromisso de se manter atualizado com as tendências do setor, ele cria estratégias online eficazes que direcionam o tráfego, aumentam o engajamento e aumentam as conversões. A atenção de Rahul aos detalhes e a capacidade de criar conteúdo atraente fazem dele um recurso valioso para qualquer marca que busca melhorar sua presença online.