L'interfaccia admin di WordPress è lo spazio di lavoro principale per gli utenti del tuo plugin. Personalizzare l'admin per adattarlo al flusso di lavoro del tuo plugin lo rende più intuitivo ed efficiente. L'admin di WordPress offre ampi hook per la personalizzazione: dai widget della dashboard ai menu della barra admin fino alle colonne personalizzate delle tabelle di elenco.
Questa guida copre come personalizzare l'admin di WordPress per le esigenze specifiche del tuo plugin.
Widget della Dashboard
Aggiungi widget della dashboard con wp_add_dashboard_widget(). Ogni widget ha un ID, un nome visualizzato e una funzione callback che renderizza il contenuto del widget. Registra i tuoi widget durante l'action hook wp_dashboard_setup. I widget della dashboard possono visualizzare dati specifici del plugin, attività recenti, statistiche o azioni rapide.
Usa i widget della dashboard per mostrare agli utenti informazioni rilevanti a colpo d'occhio: riepiloghi delle prenotazioni per un plugin di prenotazioni, numeri di vendita per un plugin e-commerce o elementi di moderazione in attesa per un plugin community.
Personalizzazione della Barra Admin
La barra admin fornisce la navigazione a livello di sito. Aggiungi menu con $wp_admin_bar->add_node(). Ogni nodo ha un ID, un titolo, un genitore, un href e requisiti di capability. Aggiungi menu di primo livello e sotto-menu figli. Targetizza ruoli utente specifici con il parametro capability.
Rimuovi gli elementi superflui della barra admin per ruoli specifici usando remove_node(). Pulisci la barra admin per gli utenti non amministratori per ridurre il disordine.
Colonne Personalizzate delle Tabelle di Elenco
Personalizza le colonne nelle tabelle di elenco dei post type con il filtro manage_{posttype}_posts_columns. Aggiungi nuove colonne per valori di campi personalizzati, metadati dei post o valori calcolati. Popola le colonne con l'action manage_{posttype}_posts_custom_column. Rendi le colonne ordinabili con il filtro manage_edit-{posttype}_sortable_columns.
Questo è essenziale per i custom post type. Aggiungi colonne per stato della prenotazione, livello di membership o stato del pagamento così gli utenti possono scansionare e filtrare i contenuti in modo efficiente.
Notifiche Admin
Visualizza le notifiche admin con l'action hook admin_notices. WordPress fornisce quattro classi di notifica: notice-success (verde), notice-warning (giallo), notice-error (rosso) e notice-info (blu). Rendi le notifiche chiudibili aggiungendo la classe is-dismissible. Mostra le notifiche solo sulle pagine pertinenti: controlla la schermata corrente con get_current_screen().
Usa le notifiche admin per avvisi di scadenza della licenza, notifiche di aggiornamento, promemoria di configurazione e messaggi di completamento import/export.
CSS e JavaScript Admin
Accoda CSS e JavaScript specifici dell'admin con admin_enqueue_scripts. Controlla la schermata corrente con get_current_screen() per caricare gli asset solo sulle pagine del tuo plugin. Metti un prefisso a tutte le classi CSS e le funzioni JavaScript per evitare conflitti con altri plugin.
Usa le classi CSS admin integrate di WordPress per la coerenza. La classe .wrap avvolge il contenuto della tua pagina admin. La classe .notice visualizza le notifiche WordPress standard.
Il punto fondamentale
Personalizzare l'interfaccia admin di WordPress rende il tuo plugin nativo di WordPress. Usa i widget della dashboard per informazioni a colpo d'occhio, i menu della barra admin per la navigazione rapida, le colonne personalizzate per una gestione efficiente dei contenuti, le notifiche admin per messaggi importanti e CSS corretto per un aspetto curato. Un'interfaccia admin ben integrata riduce la curva di apprendimento per i tuoi utenti e rende il tuo plugin più professionale.
