hook<\/a> “admin_menu”.<\/p>\n\n\n\nEliminiamo il codice iniziale e lo sostituiamo con questo:<\/p>\n\n\n\n
\/\/ Adding menu\nfunction my_add_menu_items() {\n \n\tglobal $supporthost_sample_page;\n \n\t\/\/ add settings page\n\t$supporthost_sample_page = add_menu_page(__('SupportHost List Table', 'supporthost-admin-table'), __('SupportHost List Table', 'supporthost-admin-table'), 'manage_options', 'supporthost_list_table', 'supporthost_list_init');\n \n\tadd_action(\"load-$supporthost_sample_page\", \"supporthost_sample_screen_options\");\n}\nadd_action('admin_menu', 'my_add_menu_items');\n\n\/\/ add screen options\nfunction supporthost_sample_screen_options() {\n \n\tglobal $supporthost_sample_page;\n global $table;\n \n\t$screen = get_current_screen();\n \n\t\/\/ get out of here if we are not on our settings page\n\tif(!is_object($screen) || $screen->id != $supporthost_sample_page)\n\t\treturn;\n \n\t$args = array(\n\t\t'label' => __('Elements per page', 'supporthost-admin-table'),\n\t\t'default' => 2,\n\t\t'option' => 'elements_per_page'\n\t);\n\tadd_screen_option( 'per_page', $args );\n\n $table = new Supporthost_List_Table();\n\n}<\/pre>\n\n\n\nNella prima funzione aggiungiamo un hook per caricare le impostazioni di schermata.<\/p>\n\n\n\n
Nella seconda funzione impostiamo $table come variabile globale, in questo modo WordPress prende la lista delle colonne e ci permette di decidere quali colonne mostrare o nascondere dalle impostazioni schermata.<\/p>\n\n\n\n
Inoltre aggiungiamo un’opzione chiamata elements_per_page che di permette di decidere quanti elementi visualizzare per pagina.<\/p>\n\n\n\n
Se hai provato sicuramente hai notato che se cambi il numero di elementi per pagina, questi non cambiano.<\/p>\n\n\n\n
Dobbiamo infatti andare a modificare una riga nel nostro metodo prepare_items():<\/p>\n\n\n\n
$per_page = 3;<\/pre>\n\n\n\nDiventa:<\/p>\n\n\n\n
$per_page = $this->get_items_per_page('elements_per_page', 10);<\/pre>\n\n\n\nIn questo modo diciamo a WordPress di prendere il valore ‘elements_per_page’ dalla tabella usermeta, infatti quando modifichiamo il numero di elementi per pagina WordPress salva il valore nel database, stessa cosa con la selezione delle colonne che vogliamo mostrare o nascondere.<\/p>\n\n\n\n
Il valore 10 che passiamo come secondo parametro \u00e8 il numero di default, se l’utente non ha deciso quanti elementi mostrare dalle impostazioni schermata. Questo valore \u00e8 opzionale, se non lo specifichiamo WordPress lo imposta a 20 di default.<\/p>\n\n\n\n
Avrai anche notato che se nascondi una colonna e ricarichi la pagina, tutte le colonne vengono mostrate.<\/p>\n\n\n\n
Come nel caso del numero di elementi per pagina, le preferenze relativa alle colonne nascoste vengono salvate nel database nella colonna usermeta.<\/p>\n\n\n\n
Modifichiamo la riga:<\/p>\n\n\n\n
$hidden = array();<\/pre>\n\n\n\nCon questo if\/else statement:<\/p>\n\n\n\n
$hidden = ( is_array(get_user_meta( get_current_user_id(), 'managetoplevel_page_supporthost_list_tablecolumnshidden', true)) ) ? get_user_meta( get_current_user_id(), 'managetoplevel_page_supporthost_list_tablecolumnshidden', true) : array();<\/pre>\n\n\n\nIn questo modo se l’utente ha deciso di nascondere alcune colonne le nascondiamo, altrimenti passiamo un array vuoto senza nascondere nessuna colonna.<\/p>\n\n\n\n
A questo punto vogliamo poter cercare tra gli elementi che abbiamo nel database.<\/p>\n\n\n\n
Per poter ricercare tra i vari elementi ci serve un form per la ricerca, e alcune modifiche al nostro codice per permettere una ricerca all’interno del database.<\/p>\n\n\n\n
Come prima cosa dobbiamo aggiungere il form alla nostra tabella, aggiungendo questa riga:<\/p>\n\n\n\n
$table->search_box('search', 'search_id');<\/pre>\n\n\n\nIn questo modo:<\/p>\n\n\n\n
\/\/ Plugin menu callback function\nfunction supporthost_list_init()\n{\n \/\/ Creating an instance\n $table = new Supporthost_List_Table();\n\n echo '<div class=\"wrap\"><h2>SupportHost Admin Table<\/h2>';\n echo '<form method=\"post\">';\n \/\/ Prepare table\n $table->prepare_items();\n \/\/ Search form\n $table->search_box('search', 'search_id');\n \/\/ Display table\n $table->display();\n echo '<\/div><\/form>';\n}<\/pre>\n\n\n\nAdesso andiamo a modificare il nostro metodo prepare_items() in modo da prendere il parametro $_POST[‘s’] e fare una ricerca nel database, in questo modo:<\/p>\n\n\n\n
\/\/data\n if ( isset($_POST['s']) ) {\n $this->table_data = $this->get_table_data($_POST['s']);\n } else {\n $this->table_data = $this->get_table_data();\n }<\/pre>\n\n\n\nQuindi il metodo completo diventa:<\/p>\n\n\n\n
\/\/ Bind table with columns, data and all\n function prepare_items()\n {\n \/\/data\n if ( isset($_POST['s']) ) {\n $this->table_data = $this->get_table_data($_POST['s']);\n } else {\n $this->table_data = $this->get_table_data();\n }\n\n $columns = $this->get_columns();\n $hidden = ( is_array(get_user_meta( get_current_user_id(), 'managetoplevel_page_supporthost_list_tablecolumnshidden', true)) ) ? get_user_meta( get_current_user_id(), 'managetoplevel_page_supporthost_list_tablecolumnshidden', true) : array();\n $sortable = $this->get_sortable_columns();\n $primary = 'name';\n $this->_column_headers = array($columns, $hidden, $sortable, $primary);\n\n usort($this->table_data, array(&$this, 'usort_reorder'));\n\n \/* pagination *\/\n $per_page = $this->get_items_per_page('elements_per_page', 10);\n $current_page = $this->get_pagenum();\n $total_items = count($this->table_data);\n\n $this->table_data = array_slice($this->table_data, (($current_page - 1) * $per_page), $per_page);\n\n $this->set_pagination_args(array(\n 'total_items' => $total_items, \/\/ total number of items\n 'per_page' => $per_page, \/\/ items to show on a page\n 'total_pages' => ceil( $total_items \/ $per_page ) \/\/ use ceil to round up\n ));\n \n $this->items = $this->table_data;\n }<\/pre>\n\n\n\nDobbiamo poi modificare il metodo get_table_data() in modo da eseguire una ricerca nel database:<\/p>\n\n\n\n
\/\/ Get table data\n private function get_table_data( $search = '' ) {\n global $wpdb;\n\n $table = $wpdb->prefix . 'supporthost_custom_table';\n\n if ( !empty($search) ) {\n return $wpdb->get_results(\n \"SELECT * from {$table} WHERE name Like '%{$search}%' OR description Like '%{$search}%' OR status Like '%{$search}%'\",\n ARRAY_A\n );\n } else {\n return $wpdb->get_results(\n \"SELECT * from {$table}\",\n ARRAY_A\n );\n }\n }<\/pre>\n\n\n\nAdesso la ricerca funziona, cercando nei campi “name”, “description” e “status”.<\/p>\n\n\n\n
Action links<\/h2>\n\n\n\n Hai presente quando passi col mouse sopra una riga e appaiono dei link che ti permettono di eseguire varie azioni, come ad esempio visualizzare il post\/pagina o spostarlo nel cestino?<\/p>\n\n\n\n
Vediamo come usare la classe WP List Table per aggiungere questi action links.<\/p>\n\n\n\nSemplicemente aggiungendo questo metodo alla nostra classe possiamo aggiungere degli action links:<\/p>\n\n\n\n
\/\/ Adding action links to column\n function column_name($item)\n {\n $actions = array(\n 'edit' => sprintf('<a href=\"?page=%s&action=%s&element=%s\">' . __('Edit', 'supporthost-admin-table') . '<\/a>', $_REQUEST['page'], 'edit', $item['ID']),\n 'delete' => sprintf('<a href=\"?page=%s&action=%s&element=%s\">' . __('Delete', 'supporthost-admin-table') . '<\/a>', $_REQUEST['page'], 'delete', $item['ID']),\n );\n\n return sprintf('%1$s %2$s', $item['name'], $this->row_actions($actions));\n }<\/pre>\n\n\n\nIl nome della funzione deve essere creato in questo formato: column_{column_identifier}<\/strong>. <\/p>\n\n\n\nAll’interno di questa funzione creiamo un array di link, in questo caso un link per la modifica e uno per eliminare l’elemento.<\/p>\n\n\n\n
$item[\u2018ID\u2019]<\/strong> e $item[\u2018name\u2019]<\/strong>, ID e “name” sono gli identificativi delle nostre colonne come li abbiamo definiti nel metodo get_columns().<\/p>\n\n\n\nIn questo modo aggiungiamo soltanto i link alle funzionalit\u00e0. Se vuoi che questi link funzionino correttamente devi creare le funzionalit\u00e0.<\/p>\n\n\n\n
Abbiamo quasi finito, ci mancano soltanto le azioni di gruppo, vediamo come fare.<\/p>\n\n\n\n
Aggiungere le azioni di gruppo<\/h2>\n\n\n\n Le azioni di gruppo sono quelle azioni che possiamo applicare a diversi elementi dopo averli selezionati:<\/p>\n\n\n\nPer aggiungere queste azioni non dobbiamo fare altro che aggiungere un metodo alla nostra classe:<\/p>\n\n\n\n
\/\/ To show bulk action dropdown\n function get_bulk_actions()\n {\n $actions = array(\n 'delete_all' => __('Delete', 'supporthost-admin-table'),\n 'draft_all' => __('Move to Draft', 'supporthost-admin-table')\n );\n return $actions;\n }<\/pre>\n\n\n\nIn pratica ritorniamo un array con le azioni. L’indice dell’array \u00e8 l’azione mentre il valore dell’array \u00e8 il nome che vediamo nel dropdown.<\/p>\n\n\n\n
Anche qui ho usato la funzione __() per poter poi tradurre queste stringhe.<\/p>\n\n\n\n
Come per gli action links, anche qui abbiamo aggiunto soltanto l’azione, non abbiamo creato la funzione per eseguire l’azione che andiamo a selezionare, infatti se selezioniamo una di queste azioni non succeder\u00e0 niente.<\/p>\n\n\n\n
Conclusioni<\/h2>\n\n\n\n In questo tutorial su WP_List_Table abbiamo visto come usare la classe WP List Table per creare una tabella nell’area admin prendendo i dati da una tabella custom.<\/p>\n\n\n\n
Per facilit\u00e0 ho aggiunto il file su GitHub, puoi trovare il codice completo di questo tutorial qui<\/a>.<\/p>\n\n\n\nEcco il risultato finito:<\/p>\n\n\n\nQuesta classe pu\u00f2 essere usata per creare delle tabelle nell’area admin di WordPress usando delle classi gi\u00e0 esistenti in WordPress, senza dover reinventare la ruota.<\/p>\n\n\n\n
La guida ti \u00e8 stata utile? Ci sono stati dei passaggi non chiari? Hai dei dubbi? Fammelo sapere in un commento!<\/p>\n","protected":false},"excerpt":{"rendered":"
In questi giorni stavo scrivendo un plugin e cercando in giro ho notato che non ci sono tutorial aggiornati e completi per la classe WP_List_Table di WordPress. Dal momento che mi sono dovuto studiare la classe per fare il plugin, ho pensato di scrivere un tutorial per WP List Table in modo da spiegarla meglio […]<\/p>\n","protected":false},"author":1,"featured_media":63836,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[33],"tags":[],"class_list":["post-27951","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-wordpress"],"acf":[],"_links":{"self":[{"href":"https:\/\/supporthost.com\/it\/wp-json\/wp\/v2\/posts\/27951","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/supporthost.com\/it\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/supporthost.com\/it\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/supporthost.com\/it\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/supporthost.com\/it\/wp-json\/wp\/v2\/comments?post=27951"}],"version-history":[{"count":5,"href":"https:\/\/supporthost.com\/it\/wp-json\/wp\/v2\/posts\/27951\/revisions"}],"predecessor-version":[{"id":105527,"href":"https:\/\/supporthost.com\/it\/wp-json\/wp\/v2\/posts\/27951\/revisions\/105527"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/supporthost.com\/it\/wp-json\/wp\/v2\/media\/63836"}],"wp:attachment":[{"href":"https:\/\/supporthost.com\/it\/wp-json\/wp\/v2\/media?parent=27951"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/supporthost.com\/it\/wp-json\/wp\/v2\/categories?post=27951"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/supporthost.com\/it\/wp-json\/wp\/v2\/tags?post=27951"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
![\"Wp](\"https:\/\/supporthost.com\/it\/wp-content\/uploads\/sites\/2\/2022\/08\/wp-list-table-tutorial-risultato-finale-1024x558.png\")