Una volta realizzato un plugin per WordPress o WooCommerce, spesso si ha la necessità di permettere all’utente di gestire alcuni dettagli e caratteristiche implementate nel plugin.
Ad esempio, un plugin che gestisce l’invio di email automatiche, avrà bisogno di un pannello per impostare le credenziali SMTP o per abilitare e disabilitare gli orari di invio.
Un plugin che gestisce l’importazione automatica di prodotti WooCommerce da una fonte esterna (ad esempio da un gestionale aziendale) avrà bisogno di un pannello per visualizzare eventuali prodotti non importati e risottometterli manualmente.
Le funzioni da considerare per l’aggiunta di un pannello del genere sono principalmente add_action(‘admin_menu’), add_menu_page() e register_setting().
Creazione di una voce di menu nel wp-admin
La creazione della voce di menu è un’operazione relativamente semplice, basta passare ad “admin_menu” il nome della funzione di callback.
add_action('admin_menu', 'droswavosw_create_menu');
Pannello di tipo “Report” per mostrare dei dati
Qui costruiamo una voce di menu che si limiterà a mostrare dell’HTML, senza interagire col datase, mentre nel prossimo paragrafo vedremo come renderla dinamica inserendo un form di raccolta dati.
La funzione di callback, in questa parte del tutorial, aggiungerà una voce all’interno del menu con add_menu_page() indicando la solita funzione di callback che costruisce i dati della pagina.
function droswavosw_create_menu() {
add_menu_page('Panel', 'Panel', 'administrator', __FILE__, 'droswavosw_settings_page' , plugins_url('/images/icon.png', __FILE__) );
}
La funzione di callback è la seguente:
function droswavosw_settings_page() { ?>
<div class="wrap">
<h1>Cover page</h1>
<h2>Titolo 2</h2>
<p>Testo</p>
</div>
}
A questo punto abbiamo un menu, e una sotto-voce di menu con una funzione che stampa 3 tag HTML; naturalmente, potrebbe creare un collegamento col DB e mostrare dei dati, oppure potrebbe mostrare i campi di form per salvare informazioni di configurazione come faremo nel prossimo paragrafo.
Pannello di tipo “Configurazione” per salvare informazioni
L’admin_menu è lo stesso quindi andremo solo a modificare la funzione droswavosw_create_menu() per aggiungere una sotto-voce di menu e ad indicare la funzione di registrazione/salvataggio dei dati del form.
function droswavosw_create_menu() {
//#[..] vedi codice da paragrafo precedente
add_submenu_page(__FILE__, 'Panel form', 'Panel form', 'administrator', 'Panel form', 'droswavosw_pnl_form_settings_page');
add_action( 'admin_init', 'register_pnl_form_droswavosw_settings' );
}
function register_pnl_form_droswavosw_settings() {
register_setting( 'droswavosw_pnl_form_settings_page', 'campo_di_test' );
}
function droswavosw_pnl_form_settings_page() {?>
<div class="wrap">
<h1>Panel form</h1>
</div>
<form method="post" action="options.php">
<?php settings_fields( 'droswavosw_pnl_form_settings_page' ); ?>
<?php do_settings_sections( 'droswavosw_pnl_form_settings_page' ); ?>
<table class="form-table admin_shop_table">
<tr valign="top">
<td><textarea type="text" name="campo_di_test"><?php echo get_option('campo_di_test')?></textarea></td>
</tr>
</table>
<?php submit_button(); ?>
</form><?php
}
?>
Questa pagina è quindi adatta a costruire un form per salvare nel DB di WordPress alcune informazioni, ad esempio le configurazioni di un plugin che realizziamo.
Questo per spiegare le basi, qui invece ho creato un plugin che utilizzo sempre come base nei progetti in cui lavoro; il plugin è leggermente più complesso rispetto al tutorial, perché permette di configurare i campi del form all’interno di un array per impostare sezioni e tipologie di campi (text, textarea, select, checkbox).


