X Delivery — WooCommerce Plugin

WordPress plugin that integrates the X delivery service into WooCommerce stores. Supports parcel-locker delivery, courier delivery, and express delivery — with temperature regimes, dynamic locker sizing, multi-warehouse pricing, and admin-editable price overrides.

Built for a Turiba University internship project. Client-facing plugin, private repo.

Status

Under active development. See docs/STRUCTURE.md for the locked architecture and build phases.

Currently running against a mock X API adapter — the plugin is fully functional today with fixture data. Real X API credentials will be swapped in at Phase 15 once the client provides them.

Requirements

• PHP 8.0+
• WordPress 6.0+
• WooCommerce 8.0+
• MySQL 5.7+ / MariaDB 10.3+

Quick start (development)

git clone git@github.com:viru170/x-delivery-plugin.git wp-content/plugins/x-delivery
cd wp-content/plugins/x-delivery
composer install

Then activate X Delivery from the WordPress admin plugins screen.

Documentation

• docs/STRUCTURE.md — Locked architecture
• docs/INSTALL.md — Installation guide (spec §4.1)
• docs/DEVELOPER.md — Developer reference (spec §4.2)
• docs/API_CONTRACT.md — Expected X API shape
• docs/STATE_MACHINE.md — Reservation lifecycle
• docs/CSS_CLASSES.md — Frontend BEM class inventory

License

Proprietary — internship project for Turiba University client.