bulk_actions_<screen><\/code>, donde reemplaza con la pantalla de administraci\u00f3n a la que desea que se agregue su opci\u00f3n. Aqu\u00ed hay una descripci\u00f3n completa de las posibles opciones para la pantalla:<\/p>\n\nbulk_actions-edit-post<\/code>: Pantalla de edici\u00f3n de tipo de publicaci\u00f3n ‘publicaci\u00f3n’<\/li>\nbulk_actions-edit-page<\/code>: Pantalla de edici\u00f3n de tipo de publicaci\u00f3n ‘p\u00e1gina’<\/li>\nbulk_actions-edit-<post-type-name><\/code>: Pantalla de edici\u00f3n de tipo de publicaci\u00f3n personalizada<\/li>\nbulk_actions-edit-<custom-taxonomy><\/code>: Pantalla de edici\u00f3n de taxonom\u00eda personalizada<\/li>\nbulk_actions-edit-comments<\/code>: pantalla de lista de comentarios<\/li>\nbulk_actions-plugins<\/code>: Pantalla de lista de complementos<\/li>\nbulk_actions-users<\/code>: pantalla de lista de usuarios<\/li>\nbulk_actions-upload<\/code>: Lista de la biblioteca de medios (solo funciona en la vista de lista, no en la vista de cuadr\u00edcula)<\/li>\n<\/ul>\nEl filtro se aplica a una matriz con pares clave-valor; donde las claves son una clave \u00fanica para las acciones y los valores son la etiqueta que aparece en el men\u00fa desplegable.<\/p>\n
Veamos un ejemplo. Quiero crear una acci\u00f3n masiva para configurar las publicaciones como publicadas.<\/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 guarda y actualiza la pantalla de edici\u00f3n de publicaciones, deber\u00eda ver su opci\u00f3n en el men\u00fa desplegable.<\/p>\n
![\"Tutorial:](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-153003-61e50168c2dcc.png\")
<\/a><\/p>\nA partir de ahora, nuestra acci\u00f3n masiva personalizada est\u00e1 funcionando absolutamente. Ese es el siguiente paso.<\/p>\n
Hacer que nuestra acci\u00f3n masiva personalizada haga algo<\/h2>\n
Para activar algo al elegir nuestra opci\u00f3n reci\u00e9n agregada en el dropwon, nos conectamos al filtro handle_bulk_actions-<screen><\/code>. Consulte la descripci\u00f3n general anterior para conocer los posibles valores de pantalla. Obviamente, su gancho de control debe ser la misma pantalla que la pantalla en la que agreg\u00f3 la acci\u00f3n masiva en el primer paso.<\/p>\nTienes tres argumentos posibles en este filtro. El primero, el que devuelve, es en realidad una URL a la que WordPress deber\u00eda redirigir despu\u00e9s de que haya terminado con su acci\u00f3n masiva. El segundo argumento es el nombre de la acci\u00f3n que se eligi\u00f3 en el men\u00fa desplegable. Y el tercero es una matriz de todos los ID de elementos que se verificaron para la acci\u00f3n masiva. Estos son los elementos sobre los que debemos aplicar nuestra acci\u00f3n.<\/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>\nVeamos lo que hace el c\u00f3digo anterior paso a paso. Primero, debemos verificar si la acci\u00f3n masiva realizada fue realmente nuestra acci\u00f3n personalizada; change-to-published<\/code>. Y luego depende de nosotros hacer lo que queramos con todas las identificaciones.<\/p>\nEl c\u00f3digo anterior recorre todas las ID de publicaci\u00f3n y act\u00faa wp_update_post()<\/code>en cada una para cambiar su estado de publicaci\u00f3n a publicado. (Si desea que esto sea eficiente, puede considerar actualizar solo aquellos que a\u00fan no est\u00e1n publicados).<\/p>\nUna vez que hayamos terminado de realizar nuestra acci\u00f3n en los elementos seleccionados, debemos crear una URL para redirigir despu\u00e9s de que WordPress haya terminado. Agregamos un argumento personalizado a la URL de redireccionamiento proporcionada. Esto es opcional pero necesario si queremos mostrar un aviso de administrador. Podemos agregar lo que quieras. Pero en el ejemplo anterior, simplemente estamos agregando un nuevo argumento de consulta con add_query_arg()<\/code>la configuraci\u00f3n ‘ changed-to-published<\/code>‘ para la cantidad de ID de publicaci\u00f3n que se vieron afectadas. Esta es informaci\u00f3n \u00fatil para un aviso.<\/p>\nMostrar un aviso despu\u00e9s de que se haya realizado nuestra acci\u00f3n masiva personalizada<\/h2>\n
Si realiza nuestra acci\u00f3n masiva personalizada ahora, notar\u00e1 que despu\u00e9s de que WordPress haya completado la acci\u00f3n masiva, vuelve a cargar la p\u00e1gina con lo siguiente en la URL: "wp-admin\/edit.php?changed-to-published=2". "2" es el n\u00famero de publicaciones en las que aplicamos nuestra acci\u00f3n. Esto nos permite agregar un aviso de administrador personalizado que se activa si se establece ‘cambiado a publicado’.<\/p>\n
Para mostrar los avisos de administraci\u00f3n, podemos usar la acci\u00f3n admin_notices<\/code>. Verificamos la variable global de PHP $_REQUEST<\/code>, que se completa con los valores enviados del formulario si ‘ changed-to-published<\/code>‘ existe. Si es as\u00ed, eso significa que nuestra acci\u00f3n masiva personalizada acaba de realizarse. Luego mostraremos un texto que incluye el n\u00famero de publicaciones aplicadas.<\/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>\n\u00a1Y eso es!<\/p>\n
![\"Tutorial:](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-153003-61e50169c2e34.png\")
<\/a><\/p>\nOtros usos de la acci\u00f3n masiva personalizada<\/h2>\n
Tenga en cuenta que en el handle_bulk_actions-<screen><\/code>gancho puede hacer b\u00e1sicamente lo que quiera con los elementos seleccionados. Puede actualizar la meta de publicaci\u00f3n personalizada, cambiar los roles de los usuarios, enviar un correo electr\u00f3nico o publicar una solicitud HTTP en alguna aplicaci\u00f3n de terceros.<\/p>\nPor ejemplo; si desea una acci\u00f3n masiva para actualizar una meta de publicaci\u00f3n personalizada que informe si las publicaciones est\u00e1n verificadas o no, use una acci\u00f3n masiva personalizada con la tecla ‘ 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>\nCombine lo anterior con una columna personalizada que muestre el valor de ‘verificado’ en las listas de publicaciones, como hicimos en esta publicaci\u00f3n<\/a>, y se vuelve muy \u00fatil.<\/p>\n