bulk_actions_<screen><\/code>, que vous remplacez par l’\u00e9cran d’administration auquel vous souhaitez ajouter votre option. Voici un aper\u00e7u complet des options possibles pour l’\u00e9cran\u00a0:<\/p>\n\nbulk_actions-edit-post<\/code>: \u00e9cran d’\u00e9dition de type de message "post"<\/li>\nbulk_actions-edit-page<\/code>\u00a0: \u00e9cran d’\u00e9dition de type de message "page"<\/li>\nbulk_actions-edit-<post-type-name><\/code>: \u00c9cran d’\u00e9dition de type de message personnalis\u00e9<\/li>\nbulk_actions-edit-<custom-taxonomy><\/code>: \u00e9cran d’\u00e9dition de taxonomie personnalis\u00e9e<\/li>\nbulk_actions-edit-comments<\/code>: \u00c9cran de la liste des commentaires<\/li>\nbulk_actions-plugins<\/code>: \u00c9cran de la liste des plugins<\/li>\nbulk_actions-users<\/code>: \u00e9cran de la liste des utilisateurs<\/li>\nbulk_actions-upload<\/code>\u00a0: Liste de la biblioth\u00e8que multim\u00e9dia (fonctionne uniquement en mode liste, pas en mode grille)<\/li>\n<\/ul>\nLe filtre est appliqu\u00e9 sur un tableau avec des paires cl\u00e9-valeur\u00a0; o\u00f9 les cl\u00e9s sont une cl\u00e9 unique pour les actions et les valeurs sont l’\u00e9tiquette qui appara\u00eet dans la liste d\u00e9roulante.<\/p>\n
Prenons un exemple. Je souhaite cr\u00e9er une action group\u00e9e pour d\u00e9finir les articles comme publi\u00e9s.<\/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>\nSi vous enregistrez et actualisez l’\u00e9cran d’\u00e9dition des messages, vous devriez voir votre option dans la liste d\u00e9roulante.<\/p>\n
![\"Tutoriel](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-153003-61e50168c2dcc.png\")
<\/a><\/p>\n\u00c0 l’heure actuelle, notre action group\u00e9e personnalis\u00e9e se d\u00e9roule parfaitement. C’est la prochaine \u00e9tape.<\/p>\n
Faire en sorte que notre action group\u00e9e personnalis\u00e9e fasse quelque chose<\/h2>\n
Afin de d\u00e9clencher quelque chose lors du choix de notre option nouvellement ajout\u00e9e dans le dropwon, nous nous accrochons au filtre handle_bulk_actions-<screen><\/code>. Reportez-vous \u00e0 l’aper\u00e7u ci-dessus pour les valeurs d’\u00e9cran possibles. \u00c9videmment, votre crochet de poign\u00e9e doit \u00eatre le m\u00eame \u00e9cran que l’\u00e9cran dans lequel vous avez ajout\u00e9 l’action en bloc lors de la premi\u00e8re \u00e9tape.<\/p>\nVous avez trois arguments possibles dans ce filtre. Le premier – celui que vous renvoyez – est en fait une URL vers laquelle WordPress doit rediriger apr\u00e8s avoir termin\u00e9 votre action group\u00e9e. Le deuxi\u00e8me argument est le nom de l’action qui a \u00e9t\u00e9 choisie dans la liste d\u00e9roulante. Et le troisi\u00e8me est un tableau de tous les ID d’\u00e9l\u00e9ments qui ont \u00e9t\u00e9 v\u00e9rifi\u00e9s pour l’action en bloc. Ce sont les \u00e9l\u00e9ments sur lesquels nous devons appliquer notre action.<\/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>\nRegardons ce que fait le code ci-dessus \u00e9tape par \u00e9tape. Nous devons d’abord v\u00e9rifier si l’action group\u00e9e effectu\u00e9e \u00e9tait bien notre action personnalis\u00e9e\u00a0; change-to-published<\/code>. Et puis c’est \u00e0 nous de faire ce qu’on veut avec tous les identifiants.<\/p>\nLe code ci-dessus parcourt tous les identifiants de publication et s’ex\u00e9cute wp_update_post()<\/code>sur chacun afin de changer leur statut de publication en publi\u00e9. (Si vous voulez que cela soit efficace, vous voudrez peut-\u00eatre envisager de ne mettre \u00e0 jour que ceux qui ne sont pas encore publi\u00e9s).<\/p>\nUne fois que nous avons termin\u00e9 notre action sur les \u00e9l\u00e9ments s\u00e9lectionn\u00e9s, nous devons cr\u00e9er une URL vers laquelle rediriger une fois WordPress termin\u00e9. Nous ajoutons un argument personnalis\u00e9 \u00e0 l’URL de redirection fournie. Ceci est facultatif mais n\u00e9cessaire si nous voulons afficher un avis d’administration. Nous pouvons ajouter tout ce que vous voulez. Mais dans l’exemple ci-dessus, nous ajoutons simplement un nouvel argument de requ\u00eate avec add_query_arg()<\/code>le param\u00e8tre ‘ changed-to-published<\/code>‘ au nombre d’ID de publication qui ont \u00e9t\u00e9 affect\u00e9s. Il s’agit d’informations utiles pour un avis.<\/p>\nAfficher un avis une fois notre action group\u00e9e personnalis\u00e9e termin\u00e9e<\/h2>\n
Si vous effectuez notre action group\u00e9e personnalis\u00e9e maintenant, vous remarquerez qu’une fois que WordPress a termin\u00e9 l’action group\u00e9e, il recharge la page avec l’URL suivante\u00a0: "wp-admin\/edit.php?changed-to-published=2". \u00ab\u00a02\u00a0\u00bb est le nombre de messages sur lesquels nous avons appliqu\u00e9 notre action. Cela nous permet d’ajouter un avis d’administration personnalis\u00e9 qui se d\u00e9clenche si \u00abmodifi\u00e9 en publi\u00e9\u00a0\u00bb est d\u00e9fini.<\/p>\n
Afin d’afficher les avis d’administration, nous pouvons utiliser l’action admin_notices<\/code>. Nous v\u00e9rifions la variable globale de PHP, $_REQUEST<\/code>, qui est remplie avec les valeurs soumises par le formulaire si ‘ changed-to-published<\/code>‘ existe. Si c’est le cas, cela signifie que notre action group\u00e9e personnalis\u00e9e vient d’\u00eatre effectu\u00e9e. Nous afficherons alors du texte incluant le nombre de posts appliqu\u00e9s.<\/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>\nEt c’est tout!<\/p>\n
![\"Tutoriel](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-153003-61e50169c2e34.png\")
<\/a><\/p>\nAutres utilisations de l’action group\u00e9e personnalis\u00e9e<\/h2>\n
Gardez \u00e0 l’esprit que dans le handle_bulk_actions-<screen><\/code>crochet, vous pouvez faire pratiquement tout ce que vous voulez sur les \u00e9l\u00e9ments s\u00e9lectionn\u00e9s. Vous pouvez mettre \u00e0 jour la m\u00e9ta de publication personnalis\u00e9e, modifier les r\u00f4les des utilisateurs, envoyer un e-mail ou publier une requ\u00eate HTTP \u00e0 une application tierce.<\/p>\nPar exemple; si vous vouliez une action group\u00e9e pour mettre \u00e0 jour une m\u00e9ta de publication personnalis\u00e9e qui indique si les publications sont v\u00e9rifi\u00e9es ou non, en utilisant une action group\u00e9e personnalis\u00e9e avec la cl\u00e9 ‘ mark-as-verified<\/code>‘\u00a0:<\/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>\nCombinez ce qui pr\u00e9c\u00e8de avec une colonne personnalis\u00e9e qui affiche la valeur de "v\u00e9rifi\u00e9" dans les listes de messages – comme nous l’avons fait dans ce post<\/a>, et cela devient tr\u00e8s utile.<\/p>\n