• Stars
    star
    112
  • Rank 312,240 (Top 7 %)
  • Language
    PHP
  • Created over 5 years ago
  • Updated about 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

๐Ÿšˆ Easily process large batches of data in WordPress. Provide the data, setup the processing procedure, run the batch processor from the admin dashboard. Profit.

WP Batch Processing

WP Batch Processing is WordPress plugin for creating batches of data and processing the data items one by one. It allows you to define a batch and to process the queued batch items one by one. There is also option to resume/continue later in case your internet connection goes down.

Example

Installation

There are two ways to install this library:

  1. Install this library as a plugin. It doesn't require anything from below or,

  2. Install it as a composer package (read the notes bellow)

composer require gdarko/wp-batch-processing
WP_Batch_Processor::boot();

Note: The boot() method should be called only if you install the plugin via composer somewhere in your plugin or theme.

Note: If using composer, the library will attempt to find its path, however if you see messed up screen it means that it was unable to find the stylesheet/JS files and you will need to define them manually before boot() method.

// Manually define the path constants to eliminate
// possible errors when resolving the paths and also
// include trailing slash at the end.

if ( ! defined('WP_BP_PATH')) {
    define('WP_BP_PATH', '/path/to/wp-content/plugins/your-plugin/libraries/wp-batch-processing/');
}

if ( ! defined('WP_BP_URL')) {
    define('WP_BP_URL', 'https://site.com/wp-content/plugins/your-plugin/libraries/wp-batch-processing/');
}

WP_Batch_Processor::boot();

How it works

To define a batch you just need to extend the class WP_Batch and later register it. Follow the examples below to learn how.

The class provides the following attributes and methods

  • $id - Identifies the batch (must be unique),
  • $title - Shown in the admin area,
  • setup() - Method that you use it to fed your data with WP_Batch_Item instances,
  • process(WP_Batch_Item $item) - Method that will be used to process each next item in the batch
if ( class_exists( 'WP_Batch' ) ) {

	/**
	 * Class MY_Example_Batch
	 */
	class MY_Example_Batch extends WP_Batch {

		/**
		 * Unique identifier of each batch
		 * @var string
		 */
		public $id = 'email_post_authors';

		/**
		 * Describe the batch
		 * @var string
		 */
		public $title = 'Email Post Authors';

		/**
		 * To setup the batch data use the push() method to add WP_Batch_Item instances to the queue.
		 *
		 * Note: If the operation of obtaining data is expensive, cache it to avoid slowdowns.
		 *
		 * @return void
		 */
		public function setup() {

			$users = get_users( array(
				'number' => '40',
				'role'   => 'author',
			) );

			foreach ( $users as $user ) {
				$this->push( new WP_Batch_Item( $user->ID, array( 'author_id' => $user->ID ) ) );
			}
		}

		/**
		 * Handles processing of batch item. One at a time.
		 *
		 * In order to work it correctly you must return values as follows:
		 *
		 * - TRUE - If the item was processed successfully.
		 * - WP_Error instance - If there was an error. Add message to display it in the admin area.
		 *
		 * @param WP_Batch_Item $item
		 *
		 * @return bool|\WP_Error
		 */
		public function process( $item ) {

			// Retrieve the custom data
			$author_id = $item->get_value( 'author_id' );

			// Return WP_Error if the item processing failed (In our case we simply skip author with user id 5)
			if ( $author_id == 5 ) {
				return new WP_Error( 302, "Author skipped" );
			}

			// Do the expensive processing here.
			// ...

			// Return true if the item processing is successful.
			return true;
		}
		
		/**
		 * Called when specific process is finished (all items were processed).
		 * This method can be overriden in the process class.
		 * @return void
		 */
		public function finish() {
			// Do something after process is finished.
			// You have $this->items, etc.
		}
	}
}

After creating the class, class instance needs to be registered in order to be available in the batches list in the admin area.

/**
 * Initialize the batches.
 */
function wp_batch_processing_init() {
    $batch = new MY_Example_Batch();
    WP_Batch_Processor::get_instance()->register( $batch );
}
add_action( 'wp_batch_processing_init', 'wp_batch_processing_init', 15, 1 );

That's it.

Filters and Actions

Set delay between processing items. Default is 0 (no delay)

function wp_bp_my_custom_delay($delay) {
   return 2; // in seconds
}
add_filter('wp_batch_processing_delay', 'wp_bp_my_custom_delay', 10, 1);

Example use cases

The tool can be used in many different ways. For example

  • Importing data
  • Downloading data
  • Emailing
  • Database modifications

Contribute

If you notice a bug or you want to propose improvements feel free to create a pull request!

License

The plugin is licensed under GPL v2

Copyright (C) 2021 Darko Gjorgjijoski (https://darkog.com)

This file is part of WP Batch Processing

WP Batch Processing is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.

WP Batch Processing is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with WP Batch Processing. If not, see <https://www.gnu.org/licenses/>.

More Repositories

1

laravel-vue-starter

Latest Laravel 11 and Vue 3 boilerplate using Tailwind 3, Sanctum, Fortify, Pinia, the new Vue3 Composition API
Vue
85
star
2

digital-license-manager

Extendable License Manager for WordPress and WooCommerce ๐Ÿ”‘
PHP
23
star
3

wp-vimeo-videos

๐Ÿ“บ WordPress plugin that integrates with Vimeo and allows uploading videos through WordPress Admin interface. Also includes shortcode for embedding the videos.
PHP
12
star
4

ip-location-block

IP Location Block for WordPress. Supports different ip geolocation services.
PHP
9
star
5

twitter-bootstrap-grid

Easily generate valid Bootstrap grid using PHP loops
PHP
4
star
6

woocommerce-direct-debit-payment

Integrates Woocommerce with the SEPA Direct Debit payment in offline mode to get IBAN and BIC codes
PHP
3
star
7

Hangman

A simple version of the popular game Hangman (ะ‘ะตัะธะปะบะฐ) in C#
C#
2
star
8

ssh-snake

Multithreaded Bruteforce ssh scanner written in C. Experimental and for Ethical testing purposes only!
C
2
star
9

wp-mkd-air-quality

Macedonia Air Quality charts and map for WordPress
JavaScript
2
star
10

wp-extended-archives-widget

Extends the original WordPress widget with ability to choose post type, limit, type by time etc.
PHP
1
star
11

habitat

Debian based bunch of shell scripts for managing websites in Apache and multiple PHP versions. Your new development environment.
Shell
1
star
12

books-library

Example of simple WordPress plugin that was demonstrated in my WordCamp Skopje 2019 presentation/speech on WordPress Plugin Development
PHP
1
star