bulk_actions_<screen><\/code>, w kt\u00f3rym zast\u0119pujesz dowolny ekran administratora, do kt\u00f3rego chcesz doda\u0107 swoj\u0105 opcj\u0119. Oto pe\u0142ny przegl\u0105d mo\u017cliwych opcji ekranu:<\/p>\n\nbulk_actions-edit-post<\/code>: Ekran edycji typu posta 'post’<\/li>\nbulk_actions-edit-page<\/code>: Ekran edycji typu posta 'strona’<\/li>\nbulk_actions-edit-<post-type-name><\/code>: Niestandardowy ekran edycji typu postu<\/li>\nbulk_actions-edit-<custom-taxonomy><\/code>: Ekran edycji niestandardowej taksonomii<\/li>\nbulk_actions-edit-comments<\/code>: Ekran listy komentarzy<\/li>\nbulk_actions-plugins<\/code>: Ekran listy wtyczek<\/li>\nbulk_actions-users<\/code>: Ekran listy u\u017cytkownik\u00f3w<\/li>\nbulk_actions-upload<\/code>: Lista biblioteki multimedi\u00f3w (dzia\u0142a tylko w widoku listy, nie w widoku siatki)<\/li>\n<\/ul>\nFiltr jest stosowany do tablicy z parami klucz-warto\u015b\u0107; gdzie klucze s\u0105 unikalnym kluczem do dzia\u0142a\u0144, a warto\u015bci s\u0105 etykietami, kt\u00f3re pojawiaj\u0105 si\u0119 w menu.<\/p>\n
Sp\u00f3jrzmy na przyk\u0142ad. Chc\u0119 utworzy\u0107 akcj\u0119 zbiorcz\u0105 do ustawiania post\u00f3w do opublikowania.<\/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>\nJe\u015bli zapiszesz i od\u015bwie\u017cysz ekran edycji post\u00f3w, powiniene\u015b zobaczy\u0107 swoj\u0105 opcj\u0119 w menu rozwijanym.<\/p>\n
![\"Samouczek:](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-153003-61e50168c2dcc.png\")
<\/a><\/p>\nW tej chwili nasza niestandardowa akcja zbiorcza robi absolutnie zip. To kolejny krok.<\/p>\n
Sprawianie, \u017ce nasze niestandardowe dzia\u0142anie zbiorcze co\u015b robi<\/h2>\n
Aby co\u015b wywo\u0142a\u0107, wybieraj\u0105c nasz\u0105 nowo dodan\u0105 opcj\u0119 w dropwonie, podpinamy si\u0119 pod filtr handle_bulk_actions-<screen><\/code>. Zapoznaj si\u0119 z powy\u017cszym przegl\u0105dem, aby pozna\u0107 mo\u017cliwe warto\u015bci ekranu. Oczywi\u015bcie hak uchwytu powinien by\u0107 tym samym ekranem, co ekran, na kt\u00f3rym dodano akcj\u0119 zbiorcz\u0105 w pierwszym kroku.<\/p>\nW tym filtrze masz trzy mo\u017cliwe argumenty. Pierwszy \u2013 ten, kt\u00f3ry zwracasz \u2013 jest w rzeczywisto\u015bci adresem URL, do kt\u00f3rego WordPress powinien przekierowa\u0107 po zako\u0144czeniu dzia\u0142ania zbiorczego. Drugi argument to nazwa akcji, kt\u00f3ra zosta\u0142a wybrana z listy rozwijanej. Trzecia to tablica wszystkich identyfikator\u00f3w element\u00f3w, kt\u00f3re zosta\u0142y sprawdzone pod k\u0105tem dzia\u0142ania zbiorczego. To s\u0105 elementy, na kt\u00f3re musimy zastosowa\u0107 nasze dzia\u0142anie.<\/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>\nPrzyjrzyjmy si\u0119 krok po kroku, co robi powy\u017cszy kod. Najpierw musimy sprawdzi\u0107, czy wykonana akcja zbiorcza by\u0142a rzeczywi\u015bcie nasz\u0105 niestandardow\u0105 akcj\u0105; change-to-published<\/code>. A potem to od nas zale\u017cy, czy zrobimy, co zechcemy, ze wszystkimi identyfikatorami.<\/p>\nPowy\u017cszy kod zap\u0119tla si\u0119 przez wszystkie identyfikatory post\u00f3w i wykonuje wp_update_post()<\/code>na ka\u017cdym z nich, aby zmieni\u0107 status posta na opublikowany. (Je\u015bli chcesz, aby by\u0142o to wydajne, mo\u017cesz rozwa\u017cy\u0107 aktualizacj\u0119 tylko tych, kt\u00f3re rzeczywi\u015bcie nie zosta\u0142y jeszcze opublikowane).<\/p>\nPo wykonaniu naszej akcji na wybranych elementach, musimy zbudowa\u0107 adres URL, na kt\u00f3ry zostanie przekierowany po zako\u0144czeniu dzia\u0142ania WordPressa. Do podanego adresu URL przekierowania dodajemy niestandardowy argument. Jest to opcjonalne, ale konieczne, je\u015bli chcemy wy\u015bwietli\u0107 powiadomienie administratora. Mo\u017cemy doda\u0107 co tylko zechcesz. Ale w powy\u017cszym przyk\u0142adzie po prostu dodajemy nowy argument zapytania z add_query_arg()<\/code>ustawieniem \u201e changed-to-published<\/code>" do liczby identyfikator\u00f3w post\u00f3w, kt\u00f3rych dotyczy problem. Jest to przydatna informacja do zawiadomienia.<\/p>\nPoka\u017c powiadomienie po wykonaniu niestandardowego dzia\u0142ania zbiorczego<\/h2>\n
Je\u015bli wykonasz teraz nasz\u0105 niestandardow\u0105 akcj\u0119 zbiorcz\u0105, zauwa\u017cysz, \u017ce po zako\u0144czeniu akcji zbiorczej WordPress ponownie za\u0142aduje stron\u0119 z nast\u0119puj\u0105cym adresem URL: \u201ewp-admin\/edit.php?changed-to-published=2″. \u201e2″ to liczba post\u00f3w, w kt\u00f3rych zastosowali\u015bmy nasze dzia\u0142anie. To pozwala nam doda\u0107 niestandardowe powiadomienie administratora, kt\u00f3re jest wyzwalane, je\u015bli ustawiono \u201ezmieniono na opublikowane”.<\/p>\n
W celu wy\u015bwietlenia powiadomie\u0144 administratora mo\u017cemy u\u017cy\u0107 akcji admin_notices<\/code>. Sprawdzamy zmienn\u0105 globaln\u0105 PHP $_REQUEST<\/code>, kt\u00f3ra jest wype\u0142niana warto\u015bciami przes\u0142anymi z formularza, je\u015bli changed-to-published<\/code>istnieje ’ ’. Je\u015bli tak, oznacza to, \u017ce w\u0142a\u015bnie wykonano nasze niestandardowe dzia\u0142anie zbiorcze. Wy\u015bwietlimy wtedy tekst zawieraj\u0105cy liczb\u0119 zastosowanych post\u00f3w.<\/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>\nI to wszystko!<\/p>\n
![\"Samouczek:](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-153003-61e50169c2e34.png\")
<\/a><\/p>\nInne zastosowania niestandardowej akcji zbiorczej<\/h2>\n
Pami\u0119taj, \u017ce w handle_bulk_actions-<screen><\/code>haczyku mo\u017cesz zrobi\u0107 w zasadzie wszystko, co chcesz na wybranych elementach. Mo\u017cesz zaktualizowa\u0107 niestandardow\u0105 meta postu, zmieni\u0107 role u\u017cytkownik\u00f3w, wys\u0142a\u0107 wiadomo\u015b\u0107 e-mail lub opublikowa\u0107 \u017c\u0105danie HTTP do aplikacji innej firmy.<\/p>\nNa przyk\u0142ad; je\u015bli chcesz, aby akcja zbiorcza aktualizowa\u0142a niestandardow\u0105 meta postu, kt\u00f3ra informuje, czy posty s\u0105 weryfikowane, czy nie, u\u017cyj niestandardowej akcji zbiorczej z kluczem \u201e 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>\nPo\u0142\u0105cz powy\u017csze z niestandardow\u0105 kolumn\u0105, kt\u00f3ra pokazuje warto\u015b\u0107 \u201ezweryfikowany” na listach post\u00f3w \u2013 tak jak zrobili\u015bmy to w tym po\u015bcie<\/a>, a staje si\u0119 to bardzo przydatne.<\/p>\n