Huffer

Affiliate commission reporting for WooCommerce, with SKU-prefix based affiliate mapping and optional material/printing cost deductions before commissions.

Features

• Adds a WooCommerce report that aggregates order items by affiliate SKU prefix, company meta, or fuzzy product name match (before the cutoff date).
• Deducts shipping, tax, optional order fees, printing cost per item, and optional material costs when calculating net and commission.
• Admin tabs for settings, affiliates, material costs, and a date-range report ready for printing.
• Built-in GitHub-powered updates from emkowale/huffer via the WordPress updates screen.

Requirements

• WordPress 6.0+ and WooCommerce 7.0+ (tested with newer versions).
• PHP 8.0+.

Installation

1. Download the latest release ZIP from https://github.com/emkowale/huffer/releases (or use the zip built by release.sh).
2. In WordPress Admin go to Plugins -> Add New -> Upload Plugin, choose the ZIP, and activate.
3. Existing sites can also rely on the built-in update checker; WordPress will offer updates when new releases are tagged on GitHub.

Usage

• Settings: set printing cost per item and whether to include/prorate order fees as expenses.
• Affiliates: define name, SKU prefix, commission percent, and active flag. The SKU prefix is matched against product SKUs; company name meta is also honored.
• Material Costs: record vendor and vendor SKU costs to deduct per item (looked up from quality meta).
• Report: pick a start/end date to view quantities, gross, net, and commission per affiliate; print-friendly layout included.

Development

• Repo: https://github.com/emkowale/huffer
• Main file: huffer.php
• Release helper: ./release.sh {major|minor|patch} (bumps version, regenerates CHANGELOG.md, tags, pushes, builds ZIP, and optionally publishes a GitHub release). Requires git, php, zip, and optionally gh.