Description
ShareCrew gives your WooCommerce creators a link and, if you want, a
discount code, credits the orders they send, and shares a percentage of each
order’s profit — not its revenue — with them. Maturation, refunds,
statements and payout files are handled for you.
Requires WooCommerce 8.5 or newer, active (order attribution). WooCommerce
10.3 or newer is recommended so the Costs card can read WooCommerce’s own
Cost of Goods Sold field directly; on an older WooCommerce, ShareCrew still
works from a product cost meta key, a category margin, or a global margin
you set.
How a creator gets credited
ShareCrew reads several signals and picks the strongest one, in this order:
- A typed code — a real WooCommerce coupon the creator owns. Most
short-form video traffic never clicks anything; a viewer types the code
they saw, so the code is the primary signal, not a fallback. - The referral link (
/go/{handle}), which sets a first-party cookie
on a dedicated, never-cached redirect, or a?cr=URL parameter picked
up by a small client-side script when the landing page itself was served
from cache. - WooCommerce’s own order-attribution data, when neither of the above is
present. - A repeat-customer lock: for a number of days you choose, a customer’s
later orders are credited to the creator who first brought them, even
with no code or cookie on the later order. - A manual assignment you make yourself on the order.
Exactly one creator is credited per order, and every commission row records
which of these signals won.
Codes are optional. With links only switched on, ShareCrew creates no
coupons, no audience discount exists, and every screen, email and the public
program summary speak only of the link; orders are credited by the link,
WooCommerce’s attribution data and the repeat-customer lock. Switching codes
off expires the creators’ coupons without deleting them, and switching back
restores them.
Who pays for a code’s discount
A setting decides who carries the discount a creator’s code gives:
- The store (the default): the code gives the program’s discount, and the
share is worked out on the profit after it, so the store and the creator
each carry part of it. - The creator: each creator picks their own code’s discount, a whole
percent inside a range you set, and pays for it out of their share. The
share is worked out as if the code had not been used, then the discount
comes off it — never below zero, and never carried to another order. Your
margin on the order is the same with or without the code. Orders credited
by link carry no code and keep the full share.
Changing who pays, or the range, re-applies the rules to every live creator
coupon at once.
What “profit” means, and what your store must provide
A commission can be based on profit, on plain revenue, or on a
fixed amount per order. The basis applies to the whole program; the rate
comes from the creator’s tier and can be overridden per creator, product or
category.
In profit mode, ShareCrew builds a breakdown for the order: the price paid,
minus your product cost, an estimated share of shipping and packaging, an
estimated payment-gateway fee, and the cost of any gift item — and shares
your chosen percentage of what is left. It reads your product cost from
WooCommerce’s own Cost of Goods Sold field where that WooCommerce feature is
active, or from a cost custom field, a per-category margin, or a global
margin you set — in that order, and it always shows which one supplied a
given line.
An unknown cost is never treated as zero. A line whose cost ShareCrew
cannot find puts that commission on hold, naming the product, unless you
have explicitly opted to assume a stated default margin instead. A
commission is also held (and capped) if the computed amount would exceed a
safety ceiling you set as a percentage of the order’s revenue — this is a
guard against a data error, not a normal outcome. The Settings screen states
plainly how many of your products have a cost ShareCrew can read, because a
profit-share program computed on missing cost data quietly overpays on
exactly the orders that lost you money.
Payouts: files and store credit — it does not move money
ShareCrew does not connect to PayPal, Stripe, your bank, or any payment
processor, and it never will move money on your behalf in this version.
What it does:
- Builds a payout run from every creator’s approved, matured commissions.
- Exports a PayPal CSV file (ready to upload to PayPal’s own mass-payout
tool) and a bank-transfer CSV file (holder, IBAN, BIC, amount), each
with a numbered statement per creator. - Issues WooCommerce store credit directly, as a coupon restricted to
the creator’s own account, with an optional bonus percentage for choosing
credit over cash. - Records what was paid on a numbered, sequential statement per creator,
carrying your self-billing text for your bookkeeper.
You upload the CSV file to PayPal or your bank yourself, and mark the run
paid once you have; a payout run and marking it paid are always two separate
actions, both recorded with who did it.
The cache requirement, stated plainly
The referral cookie is set only on the /go/ redirect, and that response
must never be served from cache. A full-page cache or CDN that caches
/go/ — or strips its Set-Cookie header — will serve the first visitor’s
cookie to everyone after them, silently. ShareCrew’s Settings screen names
the exact path to exclude for Cloudflare, LiteSpeed and nginx, and a daily
health check fetches your own /go/_probe URL to confirm the exclusion is
still in place, naming the caching layer and the fix when it is not. Codes
are unaffected by this: a typed code is credited whether or not the cookie
ever gets set.
Privacy and consent
- The click log stores a salted, one-way hash of the visitor’s IP and
browser string, the referring host, the landing path, a coarse country
and device class — never the IP or user-agent string itself — and it is
pruned after the retention period you set. - Tracking mode is a setting you choose during setup, honestly:
“Always” sets the referral cookie unconditionally; “Only with consent”
waits for a marketing-category consent signal before setting it; “Code
only” never sets a cookie at all and relies on typed codes and manual
attribution. ShareCrew does not decide your legal posture for you. - “Only with consent” is the default. It reads the WP Consent API
(wp_has_consent( 'marketing' )), which consent plugins such as Complianz
or CookieYes provide. Without such a plugin, a link click never sets the
cookie: codes and the repeat-customer lock credit orders as usual, and a
link is credited only when WooCommerce’s own order attribution recorded
the visit. - A creator’s own data can be exported and erased through WordPress’s
built-in Tools → Export/Erase Personal Data screens. Erasure replaces the
creator’s name, handle, platforms, application text, tax profile and
payout details with a placeholder; commission and payout amounts are kept
as your accounting record, the same way WooCommerce keeps order records
after a customer erasure. - ShareCrew’s own database holds no customer name, email or address — a
creator’s own account pages never show a customer’s identity, only an
order number and date. - The free ShareCrew plugin has no backend of its own: it calls no ShareCrew-hosted or
third-party service, and it makes no requests to any outside service.
Everything it computes runs on your site, against your own WooCommerce
data. The one HTTP request it makes at all is a daily fetch of your own
site’s own/go/_probeURL — a same-origin check of your own cache
layer, described above, never a call to WP Shelf or anyone else. Creator
avatars in the portal and on the opt-in leaderboard come from WordPress’s
own avatar setting, which by default the visitor’s browser loads from
Gravatar.
What it does not do
ShareCrew is not an affiliate network, an influencer CRM, a content-approval
tool, a customer refer-a-friend scheme, or a payment processor. It does not
move money to a creator directly; it prepares the files and the store-credit
coupon, and a person carries out the transfer. It does not decide your
tracking-consent posture, generate a legal terms page for you (it offers a
starting-point terms skeleton, clearly labelled as not legal advice), or
handle any tax filing or withholding. It flags a code whose recent use looks
unusual — an unexplained spike in uses, or referrals from a known coupon-site
domain — for you to review; a flag is information for a human, never an
automatic block or void.
When a creator leaves
When a creator leaves the program — archived by you, leaving on their own,
or erased through WordPress’s privacy tools — a negative balance (refunds that
arrived after they were paid) is written off with a recorded ledger row, so
nobody is asked to pay money back. The exception is a creator you archive as
removed for fraud: their balance is kept as it is, and approving them
again later clears that mark.
Status
ShareCrew runs on a live WooCommerce store. Its money rules are covered by
an append-only ledger with checked invariants, twenty-nine profit-share
fixtures verified to the cent, and a property test over randomised order,
refund and payout sequences. Questions and reports are welcome in the
support forum.
ShareCrew Pro
The separately installed ShareCrew Pro add-on enables new creator product requests: creators choose eligible products within your allowances, and you approve every request. New requests need a connected ShareCrew Pro software license. Visit Gifts → View Pro access for your account’s eligible access and installation steps; this candidate does not announce a live offer or price.
Existing gift requests, their approval or recovery, creator history, commission calculations, refunds, maturation, statements and payouts remain available without Pro. The free plugin does not contact a license service. Only the optional Pro add-on connects to WP Shelf to verify its product-scoped software access and deliver updates. No AI credits are required.
Installation
- Install and activate the plugin. WooCommerce 8.5 or newer must already
be active. - Open WP Shelf → ShareCrew in wp-admin and work through the
getting-started checklist, starting with Tracking mode — this is a
legal-posture choice, not a default to leave alone. - On the Costs card, check how many of your products have a cost
ShareCrew can read, and set a category or global margin for the rest, or
choose revenue-share mode instead. - On the Attribution card, exclude
/go/from your cache and CDN
rules, using the exact pattern the screen prints for your setup. - Publish a page with the ShareCrew apply-form block or the
[sharecrew_apply] shortcode, then approve applications under
Applications. Approval issues the creator’s coupon code (unless you
run links only) and referral link. - On the Payouts card, choose which payout methods you offer and your
payout schedule and minimum.
FAQ
How do creators find an older post’s sharing link?
Open Creator → Posts in My Account. Search by the original title or URL,
or use Previous posts, then open Sharing link in that post’s row. Select the
existing URL manually or use Copy. No new registration is needed. If the
link is no longer active, contact the store; a failed check offers Retry
sharing links. Sharing controls are unavailable while the creator is paused.
My translation plugin only translates some of ShareCrew’s strings
Some translation plugins capture a string only when it is displayed on a
page view. Many ShareCrew strings appear only in emails sent from scheduled
jobs, so such a plugin never sees them. Hook
do_action( ‘sharecrew_warm_strings’ ) on wp_footer on one page of your
site: it renders every portal and email string invisibly, so they can be
captured and translated. Third-party strings can be added through the
sharecrew_warm_strings_extra filter.
Link clicks are not being credited
If Tracking mode is “Only with consent” (the default), the cookie is set
only once a WP Consent API plugin reports marketing consent; with no such
plugin installed, it is never set. If that is not the cause, your page cache
may be caching the /go/ redirect or stripping its cookie.
Exclude paths starting with /go/ (or your configured link base) from every
cache layer — Cloudflare cache and Set-Cookie transform rules, LiteSpeed’s Do
Not Cache URIs, nginx proxy_cache / fastcgi_cache. ShareCrew’s health
check tests this daily and names the layer and the fix. Creator codes are
credited regardless of your cache configuration.
Why is a commission on hold?
Almost always one of two reasons, and both are named on the commission:
ShareCrew could not find a cost for a line on the order (check the Settings
→ Costs card for which products are missing a cost, or opt into an assumed
default margin), or the computed amount exceeded the safety ceiling you set
as a percentage of order revenue, which holds and caps the row so a data
error surfaces instead of paying out silently. A held commission can be
released once the underlying cost or setting is corrected.
Does ShareCrew pay tax on a creator’s behalf?
No. ShareCrew records what each creator was paid on a numbered statement
per payout, which carries your self-billing text for your bookkeeper. It
does not calculate, withhold, remit or file any tax, and it does not tell
you whether a creator is a business or an employee. Take tax advice for your
own program.
Screenshots







Changelog
0.15.0
- Retire an older pending referral when a fresh permitted referral link is accepted, so later pages cannot revive the previous handle.
- Consume later-page referral recovery once per page even when the browser refuses to remove the saved pending value.
- Load an installed WP Consent API before referral recovery so returning visitors with prior marketing consent do not wait for another consent change.
- Wait for a dynamic consent manager to establish the visitor’s consent type before recovering a referral.
- Use the site’s public React factory for JSX while retaining the existing WordPress minimum.
- Download the submitted commission scenario with its assumptions, cost sources, rate alternatives, holds and refund limits.
0.14.4
- Keep a newer visible referral cookie when recovering a saved handle after consent, unless replacement is explicitly enabled. Check again when the request returns, and do not write a cookie if marketing consent was revoked meanwhile.
- Treat an existing cookie as present without decoding its value, so malformed percent text cannot interrupt the fallback script.
0.14.3
- Recover a saved referral when marketing consent is granted after navigating away from its landing page. Consent mode still waits for marketing consent before sending a referral request or setting its cookie.
0.14.2
- Product cost review caps all variation lookups, including missing or unpublished children, and reports partial scope when the budget is reached.
0.14.1
- Validate every submitted comparison rate before removing duplicates, including direct calculator calls. Normalized form results and financial calculations are unchanged.
0.14.0
- Compare up to four submitted profit-share rates using one resolved product-cost snapshot and the production commission/refund engine, without changing program settings.
0.13.1
- Keep primary button labels readable on hover with the corrected shared stylesheet.
0.13.0
- Preview a proposed profit share for one published product or variation using current cost sources, explicit overhead assumptions and the real commission/refund engine. No order, coupon, financial record or setting is created.
- Inspect missing-cost holds, zero-cost inputs, creator-funded discounts, program guards and an illustrative amount-only refund before choosing a rate.
0.12.0
- Review current product costs in a permission-checked, searchable list of measured, assumed, missing and unusable inputs, including variations.
- Refresh reads current inputs without recomputing historical commissions or releasing held funds. Failed reads withhold the review and offer Retry.
- Treat whitespace-only cost metadata as unset; explicit zero remains a measured cost.
0.11.2
- Site Health → Info now has a WP Shelf section showing which installed shelf plugin supplies the shared admin code and stylesheet, each copy’s revision and each plugin’s version, for support. Ledger and payout behavior is unchanged.
- Payouts Due shows the correct next maturation date on stores with more than 1,000 pending commissions, read with one indexed query instead of loading pending rows.
- Creator earnings CSV downloads carry plain money values (“€41.28”, not “€41.28”), so spreadsheets can sum the columns.
0.11.1
- Guard line-feed and full-width formula prefixes in creator/commission text while keeping ordinary money numeric.
- Commission CSV downloads complete their checked ledger reads before attaching a file. A failed read offers an explicit filtered retry instead of a partial financial export.
- Preserve literal quotes and backslashes in commission exports while retaining chunked reads and bounded temporary storage.
0.11.0
- Creator CSV downloads preserve literal backslashes and quoted names with standard doubled-quote escaping, without relying on PHP’s deprecated default escape.
- Creators lists and CSV exports refuse unavailable reads instead of showing false empty/zero results. Native Retry preserves list filters; CSV appends the approved balance currency.
- Tier eligibility uses saved commission basis in the store currency only; failed basis reads stop the affected decision instead of becoming zero. New tier/bonus audit facts include their basis currency.
- Creator lifetime figures now name saved commission basis, gross recorded commissions, marked-paid status and recorded cost accurately; failed reads withhold the full grid and offer Retry.
- Name saved commission basis and recorded costs directly; replace the incomplete ROI card with recorded program cost and explain held entries, refunds and payment limits.
- Add canonical recorded-metric API fields with explicit scope; retain deprecated legacy field aliases for compatibility.
- Keep unavailable Overview reads distinct from zero earnings or empty review queues, with an explicit native Retry and API 503 refusal.
- Preserve an early report read failure even when a later successful query clears the database error.
0.10.0
- Keep configured product/category gift restrictions in effect when a category is empty or deleted; only unconfigured lists allow the fallback catalogue. Existing request review remains available.
- New creator gift requests are supplied by the separately licensed ShareCrew Pro add-on.
- Existing gift requests, history, refunds, commission processing and payouts remain available in the free plugin.
0.9.0
- Find one exact Order ID across your Earnings history, including its refund rows, with the same status/period filters and CSV.
- Keep the order filter through pages and Retry; distinguish invalid input and no matching earnings. Summary totals remain across your history.
0.8.0
- Prepare the complete creator Earnings CSV before downloading; failed ledger reads give Retry instead of an empty or truncated file.
- Keep large and filtered downloads in temporary storage with bounded row and date caches.
0.7.0
- Recover Earnings list and totals read failures without showing false empty or zero figures; stale page links reach the last matching page.
- Reach older payout statements through native 25-row history pages, including while paused.
- Failed history reads offer Retry instead of reporting no recorded payouts.
- Keep the newest statement preview consistent while browsing earlier history.
0.6.0
- Recover an existing registered post’s sharing link from Posts history, including older and searched posts, without registering it again.
- Reopened registration confirmations use the same active-link checks and are hidden while the creator is paused.
- Open Sharing link to select an active URL without JavaScript, or use Copy with confirmed clipboard feedback and a manual fallback. Archived or missing links are not offered; a failed check gives Retry. Paused creators keep read-only history without sharing controls. Theme overrides need posts template 1.6.0.
0.5.0
- Find your registered posts by title or original URL across the full history, with native 25-row search and matching counts.
- Keep literal percent signs and underscores, search and page context through metrics updates and Retry; paused creators can search read-only. Theme overrides need posts template 1.5.0.
- Preserve literal backslashes, percent sequences, ampersands and plus signs through Posts and Campaign navigation and metrics returns. Theme overrides need links template 1.7.2.
0.4.0
- Long unbroken registered-post titles wrap inside the creator portal instead of widening a phone screen.
- Browse all your registered posts in 25-row pages, including content older than the newest 200. Failed list reads show Retry instead of an empty history; metrics forms keep your page. Theme overrides need posts template 1.4.0.
0.3.0
- Search your own active and archived campaigns by name, link or destination while retaining bounded native pagination.
- Campaign click totals and charts now agree on today and the previous 29 UTC calendar days. Failed statistics show Unavailable with Retry while campaign actions remain available.
0.2.0
- Browse active and archived links 25 at a time, with your main link first and clear retry feedback if the list cannot be read.
- Separate active campaign links from archived history, with clear status, dates and preserved historical stats.
- Hide share and repeated archive controls on archived rows; explain that old destinations still open without new click tracking.
- Return unconfirmed archive forms to the portal with guidance to check Active and Archived before retrying.
0.1.9
- Keep campaign link previews tied to the current destination and name, with explicit retry feedback and wrapping for long URLs.
- Make new Unicode campaign links routable, preserve complete encoded characters when shortening slugs, and align preview collision choices with creation.
- Keep unpublished and private post titles out of creator previews and automatically named campaign links.
0.1.8
- Fix: report successful copying only after the browser confirms it; select text for manual copying when clipboard access fails.
0.1.7
- Let approved creators rename their campaign labels without changing referral links, destinations or earnings.
- Refuse stale edits and record confirmed changes in the audit trail; uncertain saves require checking the current label.
0.1.6
- Keep editor blocks available on supported older WordPress versions.
- Show creators which payout method, tax-profile or balance requirements need attention using the same eligibility rules as merchant payout runs.
- Keep currencies separate, distinguish unavailable readiness from an empty balance, and link to local recovery steps without promising or sending payment.
0.1.5
- Refuse stale payout exports and settlement attempts before reporting success or downloading a file.
- Protect payout and audit transactions against failed commits, nested failures and database reconnects; ambiguous outcomes require review.
- Keep paid store credit available when another settlement attempt or notification fails.
- Initialize payout emails without warnings on the minimum supported WooCommerce version.
0.1.4
- Keep payout dates, creator post dates and reapplication notices aligned with the store calendar while retaining UTC timestamp storage.
- Schedule daily work by local calendar time across daylight-saving and timezone changes, recover interrupted schedule migration, and serialize overlapping daily callbacks with durable completion receipts.
0.1.3
- Fixed: archived creator links no longer record new visits. Referral cookies respect Codes only mode and expire at the exact attribution boundary.
- Fixed: interrupted checkout attribution can repair order metadata and finish commission and customer-lock work before marking the receipt complete. Retries preserve completed work and prevent overlapping hook processing.
0.1.2
- Changing the link base in Settings now takes effect on the next page load.
Before, links on the new base answered “not found” until permalinks were
saved again. - Links on a previous link base keep working: they redirect to the same
creator’s link on the new base, so links already shared or printed as QR
codes do not break. - Changed: saving on a ShareCrew admin screen now shows that it is working, then moves keyboard focus to the result, so you — and a screen reader — know at once whether the save worked. A failed save says so in a message you can dismiss, next to the form, instead of a paragraph above it.
0.1.1
- A refused request (a user without permission to manage ShareCrew) now
answers 403 Forbidden instead of a server error. - The creator detail screen’s main link follows your link base setting
instead of always showing /go/. - Settings help text now matches what the plugin does: in Codes only mode a
customer lock still credits an order and WooCommerce’s order attribution
is not read, and a payout run includes every commission payable when the
run is created.
0.1.0
- First release. Attribution resolves a code, a
referral link and cookie, WooCommerce’s own order-attribution data, a
repeat-customer lock, or a manual assignment, in that order, and freezes
the reason onto each commission row. - The profit-share engine computes a per-order breakdown from WooCommerce’s
Cost of Goods Sold, a cost custom field, a category margin or a global
margin, with shipping, packaging and payment-fee estimates, and shares a
percentage of profit or of revenue, or pays a fixed amount per order: one
basis for the program, with the rate set by tier and overridable per
creator, product or category. - An unknown cost holds the commission rather than assuming zero; a safety
ceiling on the computed amount holds and caps rather than paying an amount
a data error produced. - Commission and payout rows are append-only: a correction is a new row, and
a paid row is never edited. - Creator codes are real WooCommerce coupons the plugin owns and can rotate
in one click. - Payout runs export a PayPal CSV, a bank-transfer CSV, or issue WooCommerce
store credit with an optional bonus, and record a numbered statement per
creator; marking a run paid is always a separate action from creating it. - Creators progress through tiers based on trailing profit generated, with
per-creator, per-product and per-category rate overrides. - Gift orders: an approved gift request creates a real, paid WooCommerce
order with its own cost counted against the creator’s tiers. - Per-post links let a creator track a specific piece of content, with
self-reported view and engagement figures, clearly labelled as
self-reported. - A daily leak monitor flags a code whose recent use looks unusual — a spike
in uses with no click behind them, or referrals from a known coupon-site
domain — for a human to review; nothing is voided automatically. - Nineteen transactional emails cover the creator’s and the merchant’s side
of the program, from application through payout. - A WordPress privacy exporter and eraser cover a creator’s own data;
commission and payout amounts are kept as accounting records after
erasure, the way WooCommerce keeps order records. - The merchant console adds an Overview with program ROI, Creators,
Applications, a Commissions screen with a per-order breakdown drawer, and
Settings, under the shared WP Shelf admin menu. - A public application form and a program-summary block/shortcode let
visitors apply and read the program’s terms without an account. - Links-only mode: no codes and no audience discount, with every surface
speaking only of the link; switching back restores the creators’ coupons. - Creator-funded discounts: each creator picks their code’s discount inside
a range you set and pays it from their share, never below zero. - A negative balance is written off when a creator leaves, except for a
creator removed for fraud; re-approval clears that mark. - Compatible with WooCommerce’s High-Performance Order Storage and
block-based checkout.
