Creare un menu personalizzato nel pannello admin di WordPress

In questo tutorial vedrai come creare un menu personalizzato nel pannello admin di WordPress, questo tutorial può avere moltissime applicazioni, per esempio potrebbe tornare molto utile per fornire ad un cliente informazioni aggiuntive sul tema realizzato o istruzioni su come poterlo utilizzare al meglio, oppure per comunicare direttamente con utenti registrati al proprio blog, etc.

Creare un menu personalizzato nel pannello admin non è un procedimento così complicato, per farlo è necessario utilizzare alcune funzioni PHP appositamente create, WordPress ne ha diverse ma quelle che interessano questo tutorial sono sostanzialmente add_menu_page() e add_submenu_page().

La prima permette di creare un menu di primo livello nell pannello admin, questa funzione acetta tra le sue parentesi 7 possibili argomenti, di cui 4 obbligatori, ovvero:

• $page_title: Questo valore viene visualizzato nei tag titolo della pagina quando questa viene aperta
• $menu_title: Il nome del menu che comparirà nella barra admin.
• $capability: Ovvero chi può accedere al menu, lasciando vuota questo argomento la voce del menu scomparirà dalla lista e verrà selezionata per l’apertura direttamente la voce successiva che ha invece questo argomento specificato.
• $menu_slug: ovvero un nome che deve essere unico per ogni menu e che servirà per essere richiamato
• $function: Questo valore ci tornerà utile per creare una funzione che ci permette di modificare il contenuto della pagine di ogni voce del menu.

La seconda funzione add_submenu_page() accetta invece al suo interno 6 agromenti, di cui 3 obbligatori:

• $parent_slug: ovvero il menu di appartenenza in questo caso dovrà essere il menu personalizzato.
• $menu_title: il nome del menu che compare nella barra admin di WordPress.
• $capability,$menu_slug,$function: Hanno esattamente la stessa funzione vista sopra.

Creare il primo menu personalizzato

Per creare il proprio menu è necessario andare ad agire sul file function.php, per iniziare crea una nuova funzione con un nome a piacere, per esempio:

function menu_personalizzato () {
 
}

Ora bisogna riempire la funzione menu_personalizzato() con le funzioni di WordPress citate sopra quindi:

function menu_personalizzato() {  
    add_menu_page('Menu', 'Titolo Menu', '',  
        'Menu_personalizzato', 'contenuto_menu');  
 
 
    add_submenu_page('Menu_personalizzato',  
        'Voce menu uno', 'Voce menu 1 ', 'manage_options',  
        'nome_pagina_voce_menu', 'contenuto_voce_menu');  
 
 
}

Ora il menu personalizzato è creato e nel pannello admin di WP in fondo a tutte le voci vedrai…un bel niente…questo perchè per richiamare la funzione menu_personalizzato() bisogna aggiungere un’altra azione sempre nel file function.php, ovvero:

add_action("admin_menu", "menu_personalizzato");

Ed il risultato sarà questo:

Riempire le pagine del menu

Infine non rimane che riempire le pagine del menu_personalizzato() creato con qualsiasi contenuto tu voglia, per farlo bisogna creare, sempre nel file function.php, due nuove funzioni con il nome dell’argomento $function, in questa maniera:

function contenuto_menu() {  
?>  
    <div class="contenitore">  
         <h2>Titolo pagina principale menu</h2>  
      <p>Inserisci qui il tuo contenuto per popolare le pagine del tuo menu personalizzato</p>
    </div>  
<?php  
}  
 
function contenuto_voce_menu() {  
?>  
    <div class="contenitore">  
        <h2>Titolo Voce menu</h2>  
        <p>Inserisci qui il tuo contenuto per popolare le pagine del tuo menu personalizzato</p>
    </div>  
<?php  
}

Ora il menu è creato, funzionante e consultabile tramite il pannello admin di WordPress, potrai aggiungere nuove sotto pagine creando nuove funzioni add_submenu_page() all’interno della funzione principale, e riempire il tutto con qualsiasi cosa pendi possa essere utile ai tuoi fini.

Condividi questo articolo:

• Tweet

Info sull' autore:

Nato a Bologna, mi occupo della realizzazione grafica e dello sviluppo front-end di siti web e sono il fondatore di questo blog. Se vuoi segnalare qualche problema o hai qualche richiesta particolare invia una mail tramite il modulo contatti.
Leggi gli altri articoli di Francesco