Skip to content
Woodev Plugin Framework

Woodev Plugin Framework

v2.0.3 · WooCommerce plugin framework

Build WooCommerce plugins
that ship.

Woodev gives your plugin a loader, typed settings with a React admin, an API client and a complete shipping toolkit — so you write the carrier logic, not the plumbing.

Get started View on GitHub
Quick start

One file.
A running plugin.

Register your plugin with a literal array. The framework checks requirements, picks the newest copy on the site and boots your main class.

  • PHP 7.4+ WordPress 6.6+
  • HPOS ready
  • Classic + block checkout
Your first plugin
my-carrier.php
<?php
/**
 * Plugin Name: My Carrier for WooCommerce
 */
defined( 'ABSPATH' ) || exit;


require_once __DIR__ . '/woodev/loader.php';


Woodev_Loader::register( __FILE__, [
    'plugin_id'            => 'my-carrier',
    'download_id'          => 1234,
    'plugin_name'          => 'My Carrier',
    'plugin_version'       => '1.0.0',
    'framework_version'    => '2.0.3',
    'backwards_compatible' => '2.0.0',
    'platform'             => 'woocommerce',
    'type'                 => 'shipping',
    'requirements'         => [
        'php'         => '7.4',
        'wordpress'   => '6.6',
        'woocommerce' => '7.0',
    ],
    'supported_features'   => [ 'hpos' ],
    'main_class'           => 'My_Carrier_Plugin',
] );

Shipping toolkit

Rates, box packing, pickup point maps, checkout fields, an orders screen and tracking — for any carrier.

Build a carrier plugin →

Sell on woodev.ru

Build a plugin on Woodev and we put it in front of the shops that already run our plugins.

Partner programme →

Quick install

No Composer, no build step: the framework ships as one folder inside your plugin.

Terminal
curl -LO https://github.com/kalbac/woodev-plugin-framework/releases/download/v2.0.3/woodev-plugin-framework-2.0.3.zip
unzip -q woodev-plugin-framework-2.0.3.zip -d my-plugin/
Or download the latest release →

What you get

Everything a WooCommerce plugin needs

Loader & multi-version

Ship woodev/ inside every plugin. When several plugins bring their own copy, the newest one serves them all.

Read more →

Settings & setup wizard

Declare typed settings and get a React settings page, tabs, cards, connection tests and a first-run wizard.

Read more →

API client

JSON and XML requests, caching, typed exceptions and request logging with secrets redacted.

Read more →

Shipping methods & rates

Courier, pickup and postal bases. You return a rate; caching, limits and failure handling are done.

Read more →

Pickup points & checkout

City fields, pickup point maps and phone masks that work in both the classic and the block checkout.

Read more →

Orders & tracking

An orders screen with export, documents, delivery statuses and buyer emails for every carrier.

Read more →

How it works

Three steps to a working plugin

  1. 01

    Bundle

    Copy the woodev/ folder from the release archive into your plugin. No Composer at runtime.

  2. 02

    Declare

    Register your plugin with one literal array: id, versions, requirements, features.

  3. 03

    Extend

    Extend a base class — WordPress, WooCommerce or shipping — and fill in only what is yours.

Partner programme

You build plugins.
We bring buyers.

Develop WooCommerce plugins on Woodev and sell them on woodev.ru. You keep doing what you do best; the platform takes care of distribution, licences and updates.

Become a partner See the store

  • A store with an audience

    Your plugin is listed on woodev.ru next to the plugins Russian WooCommerce shops already run.

  • Licences and updates included

    Licence keys, the licences page and automatic updates come with the framework. You write none of it.

  • Plays well with others

    Every plugin on the platform shares one framework, so your plugin coexists with the rest on one site.

  • Support from people who ship

    We review, test and help release — the same process our own carrier plugins go through.

Documentation

Jump straight in