bulk_actions_<screen><\/code>, in cui lo sostituisci con qualsiasi schermata di amministrazione a cui desideri aggiungere la tua opzione. Ecco una panoramica completa delle possibili opzioni per lo schermo:<\/p>\n\nbulk_actions-edit-post<\/code>: Schermata di modifica ‘post’ del tipo di post<\/li>\nbulk_actions-edit-page<\/code>: Schermata di modifica della "pagina" del tipo di post<\/li>\nbulk_actions-edit-<post-type-name><\/code>: Schermata di modifica del tipo di post personalizzato<\/li>\nbulk_actions-edit-<custom-taxonomy><\/code>: Schermata di modifica della tassonomia personalizzata<\/li>\nbulk_actions-edit-comments<\/code>: Schermata dell’elenco dei commenti<\/li>\nbulk_actions-plugins<\/code>: schermata dell’elenco dei plugin<\/li>\nbulk_actions-users<\/code>: schermata dell’elenco utenti<\/li>\nbulk_actions-upload<\/code>: Elenco della libreria multimediale (funziona solo nella visualizzazione elenco, non nella visualizzazione griglia)<\/li>\n<\/ul>\nIl filtro viene applicato a un array con coppie chiave-valore; dove le chiavi sono una chiave univoca per le azioni e i valori sono l’etichetta che appare nel menu a discesa.<\/p>\n
Diamo un’occhiata a un esempio. Voglio creare un’azione collettiva per impostare i post da pubblicare.<\/p>\n
add_filter('bulk_actions-edit-post', function($bulk_actions) {\n $bulk_actions['change-to-published'] = __('Change to published', 'txtdomain');\n return $bulk_actions;\n});<\/code><\/pre>\nSe salvi e aggiorni la schermata di modifica dei post, dovresti vedere la tua opzione nel menu a discesa.<\/p>\n
![\"Tutorial:](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-153003-61e50168c2dcc.png\")
<\/a><\/p>\nA partire da ora la nostra azione in blocco personalizzata sta facendo assolutamente zip. Questo \u00e8 il prossimo passo.<\/p>\n
Fare in modo che la nostra azione collettiva personalizzata faccia qualcosa<\/h2>\n
Per attivare qualcosa quando scegliamo la nostra nuova opzione aggiunta nel dropwon, ci colleghiamo al filtro handle_bulk_actions-<screen><\/code>. Fare riferimento alla panoramica sopra per i possibili valori dello schermo. Ovviamente il tuo handle hook dovrebbe essere la stessa schermata in cui hai aggiunto l’azione in blocco nel primo passaggio.<\/p>\nHai tre possibili argomenti in questo filtro. Il primo, quello che restituisci, \u00e8 in realt\u00e0 un URL a cui WordPress dovrebbe reindirizzare al termine dell’azione collettiva. Il secondo argomento \u00e8 il nome dell’azione che \u00e8 stata scelta nel menu a discesa. E il terzo \u00e8 un array di tutti gli ID elemento che sono stati controllati per l’azione in blocco. Questi sono gli elementi su cui dobbiamo applicare la nostra azione.<\/p>\n
add_filter('handle_bulk_actions-edit-post', function($redirect_url, $action, $post_ids) {\n if ($action == 'change-to-published') {\n foreach ($post_ids as $post_id) {\n wp_update_post([\n 'ID' => $post_id,\n 'post_status' => 'publish'\n ]);\n }\n $redirect_url = add_query_arg('changed-to-published', count($post_ids), $redirect_url);\n }\n return $redirect_url;\n}, 10, 3);<\/code><\/pre>\nDiamo un’occhiata a cosa fa il codice sopra passo dopo passo. Per prima cosa dobbiamo verificare se l’azione in blocco eseguita \u00e8 stata effettivamente la nostra azione personalizzata; change-to-published<\/code>. E poi sta a noi fare quello che vogliamo con tutti gli ID.<\/p>\nIl codice sopra scorre tutti gli ID post e funziona wp_update_post()<\/code>su ciascuno per modificare lo stato del post in pubblicato. (Se vuoi che questo sia efficiente potresti prendere in considerazione l’aggiornamento solo di quelli che in effetti non sono gi\u00e0 stati pubblicati).<\/p>\nDopo aver terminato di eseguire la nostra azione sugli elementi selezionati, dobbiamo creare un URL a cui reindirizzare al termine di WordPress. Aggiungiamo un argomento personalizzato all’URL di reindirizzamento fornito. Questo \u00e8 facoltativo ma necessario se vogliamo mostrare un avviso di amministratore. Possiamo aggiungere tutto quello che vuoi. Ma nell’esempio sopra stiamo semplicemente aggiungendo una nuova query arg con add_query_arg()<\/code>l’impostazione ‘ changed-to-published<\/code>‘ al numero di ID post interessati. Questa \u00e8 un’informazione utile per un avviso.<\/p>\nMostra un avviso al termine della nostra azione collettiva personalizzata<\/h2>\n
Se esegui ora la nostra azione in blocco personalizzata, noterai che dopo che WordPress ha completato l’azione in blocco, ricarica la pagina con quanto segue nell’URL: "wp-admin\/edit.php?changed-to-published=2". "2" \u00e8 il numero di post su cui abbiamo applicato la nostra azione. Ci\u00f2 ci consente di aggiungere un avviso dell’amministratore personalizzato che si attiva se \u00e8 impostato "modificato in pubblicato".<\/p>\n
Per mostrare gli avvisi dell’amministratore, possiamo utilizzare l’azione admin_notices<\/code>. Controlliamo la variabile globale di PHP, $_REQUEST<\/code>, che \u00e8 popolata con i valori inviati dal modulo se ‘ changed-to-published<\/code>‘ esiste. In tal caso, significa che la nostra azione collettiva personalizzata \u00e8 stata appena eseguita. Visualizzeremo quindi del testo incluso il numero di post applicati.<\/p>\nadd_action('admin_notices', function() {\n if (!empty($_REQUEST['changed-to-published'])) {\n $num_changed = (int) $_REQUEST['changed-to-published'];\n printf('<div id=\"message\" class=\"updated notice is-dismissable\"><p>'. __('Published %d posts.', 'txtdomain'). '<\/p><\/div>', $num_changed);\n }\n});<\/code><\/pre>\nE questo \u00e8 tutto!<\/p>\n
![\"Tutorial:](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-153003-61e50169c2e34.png\")
<\/a><\/p>\nAltri usi dell’azione collettiva personalizzata<\/h2>\n
Tieni presente che nel handle_bulk_actions-<screen><\/code>gancio puoi fare praticamente tutto ci\u00f2 che vuoi sugli elementi selezionati. Puoi aggiornare il meta post personalizzato, modificare i ruoli sugli utenti, inviare un’e-mail o pubblicare una richiesta HTTP su qualche app di terze parti.<\/p>\nPer esempio; se desideri un’azione in blocco per aggiornare un meta post personalizzato che informa se i post sono verificati o meno, utilizzando un’azione in blocco personalizzata con la chiave ‘ mark-as-verified<\/code>‘:<\/p>\nadd_filter('handle_bulk_actions-edit-post', function($redirect_url, $action, $post_ids) {\n if ($action == 'mark-as-verified') {\n foreach ($post_ids as $post_id) {\n update_post_meta($post_id, 'verified', '1');\n }\n $redirect_url = add_query_arg('mark-as-verified', count($post_ids), $redirect_url);\n }\n return $redirect_url;\n}, 10, 3);<\/code><\/pre>\nCombina quanto sopra con una colonna personalizzata che mostra il valore di "verificato" negli elenchi di post, come abbiamo fatto in questo post<\/a>, e diventa molto utile.<\/p>\n