Squad Affiliate Sample Data

Locale-specific reference data used by the Squad Affiliate plugin to generate realistic test data for an affiliate program — affiliate names and companies, commission tiers, creative slot sizes, referral sources, payout methods and so on.

The plugin downloads this repository on demand, only after an administrator explicitly consents, and reads the JSON locally afterwards. No site, user, or affiliate data is ever sent here. Declining costs you nothing: the importer falls back to a small built-in dictionary and still produces a usable data set.

This data describes fictional people and companies. It exists so that a developer can see what a populated affiliate dashboard looks like — commission tiers with real rates, referrals spread over months, payouts in several states — without hand-entering fifty rows.

Structure

One directory per resource, then one per locale:

<resource>/<locale>/<file>.json

affiliates/
├── en_US/
│   ├── first_names.json
│   ├── last_names.json
│   ├── companies.json
│   ├── email_domains.json
│   ├── websites.json
│   └── bios.json
├── en_GB/ , bn_BD/ , de_DE/ , es_ES/
groups/        commission tiers and rates
creatives/     banner slot sizes, names, alt text
links/         campaign slugs for branded /go/ links
coupons/       code patterns and descriptions
referrals/     order sources, product names, amount bands, status weights
visits/        referrer URLs, landing paths, user agents
payouts/       payout methods and note templates
manifest.json  schema version, resource list, locale coverage

Locale fallback

A locale directory only needs the files that actually differ. Anything missing falls back to en_US, resource by resource and file by file, so adding a locale means translating names and companies — not duplicating every amount band and status weight.

manifest.json records which resources each locale actually provides, so the plugin can report coverage without probing for files.

Adding a locale

1. mkdir affiliates/<locale> and add the files that genuinely differ — usually first_names.json, last_names.json, companies.json.
2. Add the locale to manifest.json, listing only the resources you supplied.
3. Keep every list at 20+ entries. Shorter lists make generated data repeat visibly, which defeats the point.

Names should be plausible for the locale and clearly fictional. Do not use the names of real public figures, and do not copy a list from a source whose licence does not permit redistribution.

Schema

Every file is a JSON object, never a bare array, so a file can gain fields without breaking readers. Weighted lists use { "value": …, "weight": 0.4 } with weights summing to roughly 1.0; the plugin normalises them regardless.

License

GPL-2.0-or-later — see LICENSE.