WooCommerce Priority Processing

A WordPress plugin that adds a priority processing and express shipping option to WooCommerce checkout, allowing customers to pay an additional fee for faster order handling.

Current version: 1.7.1

Features

• Priority Processing Option: Add a checkbox at checkout for priority processing
• Configurable Fee: Set custom fee amounts with automatic cart updates
• Flexible Display: Customizable labels, descriptions, and section titles
• Admin Integration: Settings panel integrated with WooCommerce settings
• Order Management: Visual indicators for priority orders in admin
• Motivational Messages: Randomly rotated upsell messages on the cart page and product pages, with optional minimum order thresholds
• Customer Account Badge: Confirmation badge shown on the order view page in My Account for orders with priority processing
• Modern Compatibility: Supports both classic and block-based checkout
• HPOS Ready: Compatible with WooCommerce High-Performance Order Storage
• Server-side Access Control: Feature status, user permissions, and minimum order amount are enforced for classic AJAX, Store API, fees, and order creation
• Scheduled Statistics: Daily WooCommerce statistics refresh with transient caching

Requirements

• WordPress 6.9+
• WooCommerce 9.0+ (tested up to 10.8)
• PHP 8.1+

Installation

1. Upload the plugin files to /wp-content/plugins/woocommerce-priority-processing/
2. Activate the plugin through the WordPress admin
3. Go to WooCommerce > Priority Processing to configure settings

Configuration

Navigate to WooCommerce > Priority Processing to customize:

Basic Settings

• Enable/Disable: Toggle the priority processing feature
• Fee Amount: Set the additional charge (e.g., 5.00)
• Section Title: Customize the checkout section heading

Display Options

• Checkbox Label: Text shown next to the checkbox
• Description: Help text displayed below the option
• Fee Label: How the fee appears in cart/order totals

Motivational Messages

• Cart Page Message: Enable/disable an upsell message shown under the products table on the cart page
• Product Page Message: Enable/disable an upsell message shown under the "Add to cart" button on single product pages
• Display Mode: Show each message always, or only once the cart subtotal reaches a configurable minimum
• Message Lists: Enter one message per line for each location; a random one is picked on every page load, so you can add several variants
• Ships with example English messages, translated to Bulgarian out of the box

Customer Account Badge

• Enable/Disable: Toggle a confirmation badge on the order details view in My Account
• Badge Label & Message: Fully editable text
• Shown only on orders with priority processing, when customers revisit the order later (the checkout thank-you page already shows its own confirmation message)

How It Works

For Customers

1. During checkout, customers see the priority processing option
2. When selected, the fee is immediately added to their order total
3. Order proceeds with priority status for faster handling

For Store Owners

• Priority orders are marked with ⚡ lightning bolt indicators
• Easy identification in order lists and individual order pages
• All settings managed through familiar WooCommerce interface

Technical Features

• AJAX Updates: Smooth checkout experience without page reloads
• Session Management: Reliable state handling across checkout process
• Security: Proper nonce verification and data sanitization
• Compatibility: Works with popular themes and checkout customizations
• Performance: Lightweight implementation with minimal overhead

Local Testing

Unit Tests

The PHPUnit suite covers settings sanitization, permissions, checkout state, fees, shipping metadata, account messages, order operations, statistics, and REST API permissions.

PHPUnit 13 requires PHP 8.4.1 or newer for development. This does not change the plugin's PHP 8.1 runtime requirement.

composer install
composer test

WordPress and WooCommerce Integration Test

Docker, Node.js 18+ and npm are required. wp-env creates an isolated local site using PHP 8.4 and installs the latest WordPress and WooCommerce releases.

npm install
npm run env:start
npm run test:integration

The integration smoke test verifies:

• WooCommerce and Priority Processing activation
• Plugin service initialization
• Daily statistics cron scheduling
• Priority fee creation in a real WooCommerce cart
• WooCommerce order creation and CRUD persistence
• Priority and express-service order metadata
• Priority-order queries through the WooCommerce storage API, including HPOS-compatible access
• Cleanup of the temporary order, session state, and modified options

Open the local site at http://localhost:8888 and sign in with admin / password.

npm run env:stop   # Stop the containers and preserve their data.
npm run env:clean  # Reset the development database and environment.

For a complete local check, run both suites:

composer test
npm run test:integration

Admin Features

• Visual Indicators: Priority orders clearly marked with ⚡ symbol
• Order Integration: Priority status shown in order details
• Settings Integration: Native WooCommerce settings interface
• Fallback Support: Separate admin page if needed

License

Licensed under the Apache License 2.0. See LICENSE for details.

Author

Created by OpenWPClub.com