seravo/wp-custom-bulk-actions

Custom bulk actions for any type of posts in WordPress.

0.1.4 2018-04-01 20:16 UTC

GPLv3

• Onni Hakala

• wordpress
• posts
• custom
• bulk action

README

Custom bulk actions for any type of posts in WordPress.

Currently Wordpress doesn't allow you to add custom bulk actions. See codex. Adding them is super easy with this plugin.

This is based on solution found here, but makes it more easier to use.

Installation

Available for installation via Composer via Packagist or GitHub Plugin Search.

Plugin

This plugin adds a class named Seravo_Custom_Bulk_Action

Class functions

Constructor with post as default post type

new Seravo_Custom_Bulk_Action(array('post_type' => $custom_post));

Add actions. You must define at least menu_text and callback function.

register_bulk_action(array(
'menu_text' => $your_menu_text,
'admin_notice' => $display_text_for_admin,
'action_name' => $optional_action_name,
'callback' => $anonymous_function
));

admin_notice parameter accepts arrays for plural texts too (thanks @cyberwani) For example:

register_bulk_action(array(
'menu_text' => $your_menu_text,
'admin_notice' => 'admin_notice'=>array(
    'single' => '%s Appointment cancelled.',
    'plural' => '%s Appointments cancelled.',
),
'action_name' => $optional_action_name,
'callback' => $anonymous_function
));

Your anonymous callback function needs to have post_ids as parameter:

function($post_ids) {
	//Do something here
};
$post_ids //Array of post IDs selected by user in admin panel

Init functions to wordpress

init();

Example & how to use

Install plugin and define your bulk actions in functions.php.

In this example we're going to update metadata _property_status of custom posts called property

//Define bulk actions for custom-post-type property
$bulk_actions = new Seravo_Custom_Bulk_Action(array('post_type' => 'property'));


//ACTION EXAMPLE 1:

$bulk_actions->register_bulk_action(array(
	'menu_text'=>'Mark as sold (Myyty)',
	'admin_notice'=>'Properties marked as sold',
	'callback' => function($post_ids) {

	//Do something with $post_ids here

	//In this example properties are marked as sold
	foreach ($post_ids as $post_id) {
		update_post_meta($post_id,"_property_status", "sold");
	}
	return true;
}));

//ACTION EXAMPLE 2, non-ascii chars in menutext:
//Defining the action_name is optional but useful if you want to have non-ascii chars in menu_text

$bulk_actions->register_bulk_action(array(
	'menu_text'=>'Mark for sale (Myytäväksi)',
	'admin_notice'=>'Properties marked for sale',
	'action_name'=>'for_sale',
	'callback' => function($post_ids) {

	//Do something with $post_ids here

	//In this example properties are marked for sale
	foreach ($post_ids as $post_id) {
		update_post_meta($post_id,"_property_status", "sale");
	}
	return true;
}));

//Finally init actions
$bulk_actions->init();