Desenvolvimento de Plugins do Zero: Adicionando Menus e Submenus no Painel Administrativo

O WordPress é uma plataforma poderosa e flexível que permite aos usuários expandir suas funcionalidades através do uso de plugins. Desenvolver um plugin do zero pode parecer uma tarefa intimidadora, mas com um pouco de conhecimento de PHP e a API do WordPress, é possível criar ferramentas personalizadas que se integram perfeitamente ao painel administrativo do WordPress. Uma das funcionalidades mais comuns ao desenvolver plugins é a adição de menus e submenus no painel administrativo, que permitem aos usuários interagir com as novas funcionalidades oferecidas pelo seu plugin.

Entendendo a Estrutura de Menus no WordPress

Antes de começarmos a adicionar menus e submenus, é importante entender como o WordPress organiza esses elementos. O painel administrativo do WordPress é dividido em várias seções, cada uma com seus próprios menus e submenus. Essas seções incluem posts, mídia, páginas, comentários, aparência, plugins, usuários, ferramentas e configurações.

Os menus são as opções principais que aparecem na barra lateral do painel administrativo, e os submenus são as opções adicionais que se desdobram a partir de um menu principal. Ao desenvolver um plugin, você pode optar por adicionar seu próprio menu principal ou inserir submenus em menus existentes.

Adicionando um Menu Principal

Para adicionar um novo menu principal ao painel administrativo, você usará a função add_menu_page(). Esta função aceita vários parâmetros que definem o título da página, o título do menu, as capacidades necessárias para acessar o menu, o slug do menu, a função de callback que renderiza o conteúdo da página, o ícone do menu e a posição do menu na barra lateral.

function meu_plugin_adicionar_menu() {
    add_menu_page(
        'Título da Página do Plugin', // Título da página
        'Meu Plugin', // Título do menu
        'manage_options', // Capacidade necessária
        'meu-plugin-slug', // Slug do menu
        'meu_plugin_renderizar_pagina', // Função de callback
        'dashicons-admin-generic', // Ícone do menu
        6 // Posição do menu
    );
}
add_action('admin_menu', 'meu_plugin_adicionar_menu');

A função de callback meu_plugin_renderizar_pagina() é onde você colocará o HTML e o PHP necessários para exibir o conteúdo da página do seu menu. Aqui está um exemplo simples de como essa função pode ser estruturada:

function meu_plugin_renderizar_pagina() {
    ?>
    

        
Configurações do Meu Plugin
        

            
            
        
    
    

function meu_plugin_adicionar_submenu() {
    add_submenu_page(
        'options-general.php', // Slug do menu principal
        'Configurações do Submenu do Plugin', // Título da página
        'Submenu do Plugin', // Título do menu
        'manage_options', // Capacidade necessária
        'meu-plugin-submenu-slug', // Slug do submenu
        'meu_plugin_renderizar_subpagina' // Função de callback
    );
}
add_action('admin_menu', 'meu_plugin_adicionar_submenu');