Skip to content

EP Affiliate

EP Affiliate is a full affiliate programme for PageMotor. Recruit partners, track every referral via first-party cookie, calculate tiered commissions, process payouts, and give affiliates their own self-service portal with stats, marketing creatives, and a leaderboard.

Published by ElmsPark Studio.

An affiliate is a partner who sends visitors to your site via a unique referral link. When those visitors convert (make a purchase, place a booking, take any action you decide counts), the affiliate earns a commission.

What you get:

  • Affiliate applications with an optional auto-approval toggle, honeypot anti-spam, CSRF protection, and GDPR consent logging on signup.
  • Referral tracking via a ?ref=CODE URL parameter stored in a first-party cookie. Choose first-touch or last-touch attribution.
  • Commission tiers as percentage or flat rate, with a configurable hold period before auto-approval for payout.
  • Recurring commissions on subscription renewals (optional).
  • Payout management with a minimum payout threshold so you are not cutting £2 payments.
  • Self-service portal with stats, marketing creatives, leaderboard, and magic-link access for affiliates who lose their password.
  • Coupon codes tied to affiliates, so a discount code also attributes the referral.
  • Marketing creatives library: upload banners, landing page links, and any asset you want affiliates to share.
  • Email notifications via EP Email (welcome, approval, admin alerts on new applications).
  • Fraud detection module that flags suspicious referral patterns.
  • Six-language i18n: de, es, fr, it, nl, pt.
  • PageMotor 0.8.2b or later
  • EP Suite 1.9 or later
  • EP Email (required for notifications)
  1. ep-affiliate.zip comes with an EP Suite licence — ElmsPark supplies it directly (see EP Suite plugins); after install it updates through your site’s Updates screen.
  2. Sign in to your PageMotor admin at yourdomain.com/admin/.
  3. Go to Plugins, then Manage Plugins.
  4. Upload the zip.
  5. Activate in your Theme. Database tables are created on first load.

Open Plugin Settings → EP Affiliate and work through the sections top to bottom.

  • Programme name. Shown to affiliates in emails and the portal.
  • Terms URL. Link to your affiliate terms of service. Required for GDPR consent on signup.
  • Registration open. Toggle accepting new applications.
  • Auto-approve. If on, new applications become active immediately. If off, you approve each one manually from the Affiliates tab.
  • Portal page slug. The page on your site that hosts [ep-affiliate-portal]. Used for magic links sent to affiliates.
  • Default rate. Percentage (e.g. 10) or flat amount (e.g. 5.00).
  • Commission type. Percentage of sale, or flat per conversion.
  • Cookie duration. 7 to 365 days. How long after clicking a referral link a visitor is still attributed to the affiliate.
  • Attribution model.
    • First-touch: the first affiliate who ever referred the visitor wins the commission.
    • Last-touch: the most recent affiliate wins.
  • Hold period. 0 to 60 days. Commissions sit in “pending” status during hold, then auto-approve for payout. Gives you time to catch refunds before paying.
  • Minimum payout threshold. Commissions accrue until the affiliate’s unpaid balance hits this amount.

If your site sells subscriptions (via EP Ecommerce Subscriptions or similar), enable this so the affiliate earns commission on every renewal, not just the first sale.

Lists every affiliate. Approve or reject pending applications, view each affiliate’s stats, edit their commission tier, or flag them as fraudulent.

Create tiers with custom commission rates. Assign affiliates to tiers as they grow. Common pattern: default 10%, silver 15%, gold 20%.

Shows every affiliate whose payable balance (commissions that have passed the hold period) is over the minimum threshold, with any amount still on hold beside it. Mark payouts as paid once you have sent the money via your preferred method (the plugin does not process payments directly, it tracks what is owed).

Upload banners (PNG, JPG, WebP), or add link-only creatives (landing page URLs with pre-tracked parameters). Affiliates see these in their portal and can copy the code or download the asset.

Coupon codes that tie to a specific affiliate. When a visitor applies the code at checkout, the sale is attributed to that affiliate even if they did not click a referral link. Useful for influencers who promote via codes rather than links.

Place these on any page to expose affiliate features to the public.

ShortcodePurpose
[ep-affiliate-apply]Application form for new affiliates. Place on a public page like /become-an-affiliate/.
[ep-affiliate-portal]Full self-service dashboard. The page containing this shortcode is what the Portal page slug setting points to.
[ep-affiliate-link]Generate an affiliate referral link. For use inside the portal or in docs.
[ep-affiliate-stats]Display summary statistics (clicks, conversions, commission this month).
[ep-affiliate-creatives]Browse and copy marketing creatives.
[ep-affiliate-leaderboard]Public or portal-only leaderboard of top affiliates. Good for motivation.
  1. Affiliate shares a link like https://yoursite.com/?ref=ALICE123.
  2. Visitor clicks. The plugin reads ?ref= and sets a first-party cookie with the code. Cookie life matches the Cookie duration setting.
  3. Visitor browses. The ref parameter no longer needs to be in the URL, the cookie carries the attribution.
  4. Visitor converts (sale, booking, signup — whatever your code reports to EP Affiliate). Commission is logged against Alice’s account.
  5. Commission enters hold for the configured hold period. During hold you can refund a sale and the commission is voided.
  6. After hold, commission auto-approves. It sits in the affiliate’s unpaid balance until their balance crosses the minimum payout threshold.
  7. When you are ready to pay, go to Payouts, click Mark as paid, and send the money via your preferred method.

The fraud module watches for common affiliate scams:

  • Self-referral: an affiliate trying to claim commission on their own purchases.
  • Referral bombing: one IP generating many clicks with different affiliate codes.
  • Cookie stuffing: embedding referral codes in hidden iframes.

Flagged referrals are held for manual review rather than auto-approved. Review them in the Affiliates tab.

  • The application form includes GDPR consent that logs into EP GDPR’s consent table if EP GDPR is installed.
  • A Terms URL is required so applicants are consenting to something specific.
  • Affiliate data is per-user in your database. If an affiliate invokes their GDPR right-to-deletion, the corresponding rows are removed through EP GDPR’s workflow.

“Applications are not sending the admin email”

Section titled ““Applications are not sending the admin email””

Check that EP Email is installed and activated, with a working sending method (SMTP or a service such as Mailgun) and a From address. Admin emails go to the Admin Email set under Notifications in EP Affiliate; if that is blank they go to the Default Recipient set in EP Email, and if neither is set no admin email is sent. Both admin notifications also have their own on/off switch under Notifications.

Three things to check:

  1. Are first-party cookies blocked? Some browsers (Safari Private) block everything. Not much you can do.
  2. Is the ?ref=CODE making it to the page? If your infrastructure strips query strings (some caching layers do), attribution never happens.
  3. Is your site served over HTTPS? Mixed-content cookies can fail silently in some browsers.

The plugin only calculates commission when your other plugin (ecommerce, bookings, whatever) reports a conversion to EP Affiliate. Check that your conversion source is calling the commission API.

“Affiliate cannot log into the portal”

Section titled ““Affiliate cannot log into the portal””

Send them a magic link from the Affiliates tab. This bypasses any forgotten credentials.

“A fraudulent affiliate is signing up repeatedly”

Section titled ““A fraudulent affiliate is signing up repeatedly””

Turn off Registration open temporarily. Review the Affiliates list, mark the bad account as fraudulent (this blocks future signups from the same email and IP).

For a quick question about this plugin, EP Support inside your admin is the fastest option. The chat widget sits on every EP plugin settings page and knows which one you’re on, with starter questions and links preloaded for that exact screen.

For anything bigger — a bug report, a feature request, or a “how do I…” that needs a real reply — open a ticket at help.elmspark.com. A real person, helped by AI, writes the reply. Usually within a few hours. Tickets don’t disappear into the void. Corrections land quickly.

A recommended update.

  • Admin pages no longer fill the error log. Each admin page load wrote a warning to the site’s error log. That has stopped, and the site address that emailed sign-in links use is now saved on your next visit to the admin.
  • Changing this plugin’s settings over the API now needs an admin token. Producer tokens and AI apps connected through a producer account can still read the settings. Saving from the Admin screen works exactly as before.

A security update. Please install it.

  • Self-referral check is stricter. A sale with no customer email, or made while the affiliate is signed in, no longer earns that affiliate commission.
  • Sign-in links and applications are limited. Portal sign-in links can be requested a few times an hour per visitor and per address, and the application form a few times an hour, so neither can be used to flood an inbox.
  • Clicks are counted by the visitor’s real connection. Forwarding headers a visitor can set themselves are no longer trusted, so repeat clicks cannot be faked.
  • A payout can only be made once. Two payout requests for the same affiliate at the same moment no longer pay twice.

A security update. Please install it.

  • Form leads only earn commission if you choose that. With a flat commission, every form a referred visitor sent paid the full amount, as often as the form allowed. A new setting, Pay for Leads, controls this and is off by default. If you pay affiliates for leads, tick it after updating.
  • Refunded sales lose their commission. When a shop order is refunded, its commission is now taken back before it can be approved or paid. Before, the hold period only delayed paying it.
  • Changes to payout details are reported. If an affiliate’s email address or payout details are changed in the portal, the address the account had before gets an email about it. Sign-in links in emails now use your site’s own address.
  • Works with EP CRM. An approved affiliate now appears on that person’s record in EP CRM, so you can see at a glance who is a partner. Nothing changes if you do not use EP CRM.
  • Payouts now respect your hold period. Only commissions that have cleared the hold period are paid.
  • A flagged commission waits. A commission with an open fraud flag is not approved, and so not paid, until you resolve the flag.
  • Refunding an approved commission takes it off the balance. Before, only a commission still inside the hold period came off, so a refunded one could stay payable.
  • Paying affiliates from your AI assistant now needs a confirmation step. Without it, you are told what would be paid and nothing moves.
  • A payout is always the whole payable balance. Part payments are gone, because they left the balance and the commissions out of step.
  • “No hold” now means no hold. That setting was being read as the 14-day default.
  • Commissions are approved on time. Approval used to wait for someone to open the admin. It now also runs hourly when EP Cron is active, and before every payout is worked out.
  • The Payouts screen shows what can be paid, with any held amount beside it.
  • A commission that has been paid out can no longer be marked refunded here, and a refunded or rejected one can no longer be approved again. Both used to leave the balance wrong.
  • Affiliates can ask for a trade. A new Request a trade tab in the affiliate portal lets them ask for creatives for a trade you don’t cover yet, with an optional private note on who or where they’d target.
  • One shared list, with +1s. Every affiliate sees the same list of requests and can +1 the ones they want, once each, and take it back. The most-wanted trades rise to the top.
  • No duplicates. Before saving, the portal looks for a match, ignoring case, plurals, accents and small typos. A trade you already cover shows its creatives; one already asked for gets a +1 instead.
  • Trades you cover are listed as already available, taken from your creatives’ campaign names. Campaigns that aren’t trades, such as a launch film, can be left off.
  • A Trade Requests section in the admin, most +1s first, with who asked and their note. Mark a request done (everyone who +1’d it gets a portal notification), decline it or reopen it.
  • Three new API actions: list-trade-requests, update-trade-request and set-not-trades.
  • Portal tabs now wrap whole words onto a second row when space is tight, instead of breaking a word in half.
  • Point affiliates to your sharing guide. A new Sharing Guide URL setting, beside Portal Page Slug, takes the address of a page that shows affiliates how to share your creatives. When it’s set, the portal’s Creatives tab links to it from its opening line. Leave it blank and nothing changes.
  • Find a trade’s creatives in one tap. Above the creatives in the affiliate portal there is now a search box and a button for each campaign, such as Cafés or Florists, with how many pieces each holds. Tap one to see only that trade, or type a word like “vertical” or “card”. Accents don’t matter, so “cafe” finds Cafés.
  • The buttons wrap onto extra lines on a phone, and they only appear when there are at least two campaigns to choose between.
  • Every portal tab shows on a phone. On a narrow screen the tabs (Dashboard, Reports, Payouts, Creatives, Profile) now wrap onto a second line instead of running off the edge, so affiliates can find Creatives and Profile without knowing to swipe.
  • A Creatives tab in the affiliate portal. Banners, links, email swipes, social posts and videos you add under Creatives now appear in each affiliate’s portal, next to Dashboard and Payouts. The tab only shows once there is something in it.
  • Videos affiliates can share. A video creative shows a player in the portal, a Download the video button for posting it natively on Instagram, TikTok or LinkedIn, a ready caption, and an optional link to watch it, such as YouTube. With no video file, a YouTube link plays in the portal instead.
  • Every affiliate’s own link, already in the copy. Write {link} in a creative’s caption or text and each affiliate sees their own referral link there; {code} gives their code. They can copy it and post it as it stands.
  • Copy buttons on creatives work, and the link on banners and text links now includes the slash before ?ref=.
  • Two new API actions, list-creatives and save-creative, let your own code or your AI assistant add and change creatives.
  • Change an affiliate’s referral code. Open an affiliate in the admin and edit the new Referral Code field, for example to give them a short code like “sam”. Codes are letters, numbers, hyphens or underscores, and two affiliates can’t share one. Links already shared with the old code stop counting, so change it before they share their link. Their clicks, sales and balance stay with them.
  • A new API action, rename-referral-code, does the same from your own code or your AI assistant, and returns the new link.
  • The filter tabs in the admin work. Clicking Pending, Active or Suspended above the affiliate list (and the tabs for payouts, creatives, fraud and analytics) now filters the list instead of reloading the settings page.
  • Every email’s wording is yours to change. A new Emails section in the settings holds the subject and message of each email the plugin sends: application received, approved, the portal sign-in link, a new commission, moving up a step, a payout, and the new-application notice to you. Leave a box empty to keep the wording shown.
  • Clearer, friendlier emails out of the box. The approval email shows the affiliate’s link in a box they can copy, says what counts and what they earn, and has a proper button to their portal. Every email ends with a sign-off you can set, for example “The PageMotor team”.
  • Your colours. Set the button colour and the colour of the referral link box to match your site.
  • The referral link in emails is now complete, with the slash before ?ref=.
  • Pairs with EP Email’s branded layout: choose its Default template and add your logo and footer there, and every email arrives in that layout.
  • A sign-in box for any page. Put [ep-affiliate-login] beside your apply form, or anywhere else, so existing affiliates can sign in without hunting for the portal page. It asks for their email and sends the usual sign-in link, which always opens your portal page. An affiliate who is already signed in sees a button to their portal instead. Its wording can be changed like the rest of the plugin’s text.
  • Stripe payouts work for affiliates in other countries. Before connecting Stripe, an affiliate picks the country their bank account is in: the US, Canada, the UK, Switzerland or any country in the European Economic Area. Stripe pays across all of these from your own Stripe account, converting the currency on the way.
  • Stripe payouts now work for affiliates in the US and Canada. Stripe asks for more set-up for accounts in those countries, and the plugin now requests it, so their accounts no longer fail to create.
  • Portal buttons keep their white text on themes whose link colour would otherwise override it.
  • Using a restricted Stripe key instead of your secret key? Give it Write access to Accounts, Account Links and Login Links (under Connect) and to Transfers.
  • Pay affiliates through Stripe. Switch on Stripe under Payouts and add your Stripe secret key (stored encrypted). Affiliates then see “Get paid with Stripe” in their portal: Stripe asks them for their identity and bank details, so you never hold them. From then on the Generate Payout button, and the bulk payout run, pay a Stripe-connected affiliate straight away: one transfer from your Stripe balance, and Stripe pays it on to their bank. If Stripe refuses a transfer, nothing is paid and their balance is put back as it was.
  • Affiliates can see their Stripe payouts. A connected affiliate gets a “View your Stripe payouts” button that opens their own Stripe dashboard.
  • Your AI assistant can now pay an affiliate through Stripe.
  • Stripe payouts need Stripe Connect switched on in your Stripe Dashboard. Payouts are sent in your Stripe account’s own currency, so set the Currency setting to match it. For now, affiliates paid through Stripe need to be in the same country as your Stripe account.
  • The tier progress bar in the affiliate portal shows the right figure. When the next tier asks only for commission earned, the bar now shows how far the affiliate really is. Before, it counted the missing click target as already met, so an affiliate a few per cent of the way showed over half way.
  • The bar says “commission”, not “revenue”. The amount to the next tier is commission earned, and the wording now says so.
  • The next tier’s name is easier to read. It now uses the normal text colour; the tier’s own colour stays on the bar.
  • Renewals now earn commission. A subscription renewal comes in from the payment provider with no visitor attached, and the plugin used to look only at the visitor’s referral cookie, so renewals passed in by EP Ecommerce Subscriptions were never credited. It now credits the affiliate the renewal belongs to (with Recurring Commissions switched on).
  • Your own site code can credit an affiliate. New API and MCP actions: record a sale by referral code or affiliate id (each sale counted once when you pass your own id for it, such as a Stripe invoice id), approve an affiliate, list affiliates, and list, add, change or delete commission tiers. Until now these were admin-screen jobs only.
  • A quiet option for imports. Recording sales or approving affiliates through the API with quiet set sends no emails, so moving existing affiliates across or loading example data never emails anyone.
  • Affiliates no longer receive your visitors’ and customers’ personal data. The affiliate portal’s reports quietly sent more than the tables show: each referred visitor’s IP address and browser details, each customer’s email address, and your private notes on payouts. None of it appeared on screen, but an affiliate could read it with the browser’s developer tools. The portal now sends only what it displays: dates, landing pages, amounts, commissions and statuses. Nothing changes in your own admin screens.
  • The affiliate application form now submits. In a visitor’s browser, every application was refused with “Invalid security token. Please reload the page.” The form now sends its security token correctly, so applications save and the confirmation shows.
  • Works on a site whose admin has never been opened. The plugin’s database tables were only created when an admin page loaded, so on a site installed and switched on remotely, applications and referral clicks failed until someone visited the admin. The tables are now created the first time they are needed.
  • Affiliate applications now save. Submitting the affiliate application form on current PageMotor versions showed an error, and the applicant was told nothing. Applications now save and the applicant sees the confirmation.
  • Affiliate emails now send. Application received, approval, welcome, login link, payout, commission, tier upgrade and fraud alert emails were not being sent. They now go out through EP Email, using the sending service you set there.
  • New Admin Email setting. Under Notifications, choose where new-application and fraud-alert emails go. Leave it blank to use the Default Recipient set in EP Email.
  • Settings language menu. The language menu in this plugin’s settings now lists only the languages it is actually translated into, plus English, so you can no longer pick a language that changes nothing.
  • Danish. Adds a Danish translation.
  • Section status. Each settings section shows whether that feature is switched on. On a site that also runs an older EP plugin, the section shows its plain title instead.
  • Fixes a doubled cache-busting tag on its two front-end stylesheets and its scripts. On PageMotor 0.11 and later the page asked for each file with two version tags on the end of its address (?v=…?v=…), because the core had started adding its own tag and the plugin was still adding one too. The files loaded correctly, so nothing was visibly broken; the addresses were just malformed and every cache saw a longer key than it needed. The plugin now leaves the tag to the core on 0.11 and later, and still adds its own on older cores, where nothing else would.
  • No change to what these files do.
  • Fixes a crash on the affiliate application form when an older EP plugin is installed on the same site. Submitting the form returned an internal error and nothing was saved or sent. EP plugins share one common code library, and whichever copy loads first is the one every EP plugin on that site uses, so a single out-of-date plugin could leave this one calling a spam check its copy did not have. The check now carries its own fallback and no longer depends on another plugin being up to date.
  • No change on a site where this never happened: the same spam check runs, and nothing else changed.
  • Blocks a spam bot that was getting past the form honeypot. The scraper changed its network address on every single request, so blocking by address never caught it, but it always sent a malformed browser identifier that no real browser sends. Forms now reject anything carrying that signature, with the same silent response a caught bot already got.
  • It was not theoretical. One client site had taken 57 fake signups before this went in, and the same bot had hit 17 sites.