Xgenious/ docs

Growth & Revenue Plugins

These ten plugins help you acquire users, increase order value, retain clients, and understand what is working. They are independent; activate only what you will configure and support.

Affiliate Marketing

What Affiliate Marketing does

Turns your users into a sales channel.

  • ?aff= links set a cookie or session attribution.
  • First-touch or last-touch attribution.
  • Conversions on signup, login, and hire.
  • Admin approval before payout.
  • Wallet credit on approval.
  • Affiliate dashboard panel.

Affiliate Marketing setup

  1. Activate affiliate-marketing.
  2. Open Admin → Affiliate Marketing.
  3. Set the commission rate and attribution window.
  4. Choose first-touch or last-touch.
  5. Choose which events convert.
  6. Save.
  7. Make a test signup through an affiliate link.

Affiliate Marketing data

  • affiliates - affiliate records and balances.
  • affiliate_conversions - each tracked conversion.
  • Permission: affiliate-manage.

Affiliate Marketing limits

  • Social OAuth signups do not carry a referral code.
  • Cookie blocking reduces attribution.
  • Approve conversions manually at first; automate only after the numbers are stable.

Coupons

What Coupons does

Scoped discounts across the marketplace.

  • Percent or fixed amount.
  • Scopes: project, job, offer, hourly, promotion, subscription, connect.
  • Caps, minimum order value, date window, usage limit.
  • Instant quote at /coupons/apply.
  • Checkout field.
  • Admin usage page.

Coupons setup

  1. Activate coupons.
  2. Open Admin → Coupons.
  3. Create a coupon.
  4. Choose the scope and discount type.
  5. Set the minimum, cap, and dates.
  6. Set per-user and total usage limits.
  7. Save and test each checkout type.

Coupons data

  • coupons - definitions.
  • coupon_redemptions - per-order usage.
  • Permission: coupons-manage.

Coupons limits

  • A coupon applies to the price filter, not to tax.
  • Stacking depends on the scope; test combinations.
  • A retried payment must not double-consume a coupon. The ledger is two-phase for that reason.

Email Marketing

What Email Marketing does

Syncs users and buyers to an external email platform.

Providers: Mailchimp, ActiveCampaign, ConvertKit, MailerLite, Brevo, GetResponse, Constant Contact, Klaviyo, Aweber, SendGrid.

Email Marketing setup

  1. Activate email-marketing.
  2. Open Admin → Email Marketing.
  3. Choose a provider.
  4. Enter the API key.
  5. Map the list and tags for signup and purchase.
  6. Send a test contact.
  7. Enable sync.

Email Marketing data

No plugin tables. State lives in the provider.

Email Marketing limits

  • Provider downtime pauses sync; the site keeps working.
  • Duplicate contacts depend on the provider's merge rules.
  • Consent and unsubscribe law are your responsibility.

Referrals

What Referrals does

Rewards users for bringing other users.

  • Referral link with a tamper-evident code.
  • Signup bonus.
  • Order commission.
  • Qualify on email verification.
  • Dashboard panel.

Referrals setup

  1. Activate referrals.
  2. Open the referral settings.
  3. Set the signup bonus.
  4. Set the order commission.
  5. Choose the qualifying event.
  6. Test a signup and an order through a referral link.

Referrals data

  • Pluggable store, SQLite by default.
  • CLI for configuration and inspection.

Referrals limits

  • Social OAuth signups are not attributed.
  • Rewards must be funded; decide whether they come from margin or a marketing budget.
  • Fraud controls are basic. Watch for self-referral and disposable email.

Subscription Offers

What Subscription Offers does

Lets freelancers sell recurring services.

  • Monthly or annual plans.
  • Client subscriptions.
  • Invoices per period.
  • Deliverables.
  • Commission per offer.

Subscription Offers setup

  1. Activate subscription-offers.
  2. Set the commission rate.
  3. Confirm the invoice settings.
  4. Let a freelancer create an offer.
  5. Buy it as a test client.
  6. Check activation, invoice, and expiry.

Subscription Offers data

  • subscription_offers
  • subscription_offer_plans
  • client_subscriptions
  • subscription_invoices
  • subscription_deliverables
  • Permission: subscription-offers-manage.

Subscription Offers limits

  • This is separate from marketplace-wide plans.
  • Expiry runs on cron.daily; the scheduler must be active.
  • Refund handling follows the order, not the subscription period.

Reports

What Reports does

Operational and financial reporting.

  • Overview.
  • Freelancers.
  • Clients.
  • Jobs.
  • Projects.
  • Orders.
  • Earnings.
  • Withdrawals.
  • Subscriptions.

Reports setup

  1. Activate reports.
  2. Grant reports-view.
  3. Open Admin → Reports.
  4. Choose a date preset.
  5. Add filters.
  6. Export.

Reports data

No plugin tables. Reads core models through a service layer.

Reports limits

  • Large ranges are slow.
  • Reports are live, not snapshots.
  • Export in smaller periods if a request times out.

Currency Switcher

What Currency Switcher does

Displays prices in a user's chosen currency.

  • Admin CRUD for currencies and rates.
  • Per-user switch.
  • Conversion by conversion_rate.

Currency Switcher setup

  1. Activate currency-switcher.
  2. Add currencies and rates.
  3. Set the default.
  4. Test a switch on the frontend.
  5. Confirm the gateway charges a supported currency.

Currency Switcher data

  • selected_currency_lists.
  • Permission: currency-switcher-manage.

Currency Switcher limits

  • Display conversion only. The gateway still charges in its supported currency.
  • Stale rates produce wrong display prices. Update on a schedule.
  • Rounding differences can appear between display and charge.

SEO Tools

What SEO Tools does

Controls how the site appears in search.

  • Per-URL rules: exact, prefix, regex.
  • Templates per page type.
  • Meta title, description, keywords.
  • Open Graph and canonical.
  • Robots and noindex.
  • JSON-LD.

SEO Tools setup

  1. Activate seo-tools.
  2. Open Admin → SEO Tools.
  3. Set the global templates.
  4. Add rules for important URLs.
  5. Set noindex where needed.
  6. Check the page source on three page types.
  7. Submit the sitemap once.

SEO Tools data

  • seo_tools_rules.
  • Permission: seo-tools-manage.

SEO Tools limits

  • Rules are evaluated in order; a specific rule beats a template.
  • A noindex left on hides the page from search.
  • Structured data must match the visible page, or search engines may ignore it.
  • It does not write content or build backlinks.

Webhooks

What Webhooks does

Sends signed events to external systems.

  • 60+ events across users, jobs, projects, proposals, orders, wallet, subscriptions, commissions.
  • HMAC signature.
  • SSRF guard.
  • Five retries with backoff.
  • Delivery log.
  • Every-minute scheduler sweep.

Webhooks setup

  1. Activate webhooks.
  2. Open Admin → Webhooks.
  3. Add an endpoint URL and secret.
  4. Choose events.
  5. Send a test.
  6. Confirm the receiver verifies the signature.
  7. Check the delivery log.

Webhooks data

  • webhooks_endpoints
  • webhooks_deliveries
  • Permission: webhooks-manage.

Defaults: timeout 10 seconds, attempts 5, backoff 1, 5, 30, 120, 360 minutes, batch 25, private targets blocked.

Webhooks limits

  • The scheduler must run every minute.
  • Private and link-local addresses are blocked.
  • A 4xx response is not retried except 408 and 429.
  • Payloads are snapshots; re-query the API if you need current state.

Announcements

What Announcements does

Shows a site-wide bar or popup.

  • Bar or popup.
  • Schedule window.
  • Audience targeting.
  • Dismissal stored per browser.
  • Rendered at body_end.

Announcements setup

  1. Activate announcements.
  2. Open Admin → Announcements.
  3. Create an announcement.
  4. Choose bar or popup.
  5. Write the message.
  6. Set the audience and dates.
  7. Publish.
  8. Check mobile.

Announcements data

  • announcements_announcements.
  • Permission: announcements-manage.

Announcements limits

  • A user who dismisses an announcement does not see it again until you publish a new version.
  • Popups can hurt conversion if overused.
  • It is not a cookie consent tool.

Choosing a growth stack

StageActivate
New marketplaceCoupons, Announcements, SEO Tools, Reports
First 1,000 usersAdd Referrals, Email Marketing
Growing supplyAdd Affiliate Marketing, Subscription Offers
Scaling operationsAdd Webhooks, Currency Switcher

Measurement

Before activating a growth plugin, decide the metric:

  • Affiliate: attributed signups and paid conversions.
  • Coupons: incremental orders, not just discounted orders.
  • Email: list growth and revenue per campaign.
  • Referrals: qualified signups, not raw clicks.
  • Subscription Offers: recurring revenue and churn.
  • SEO: impressions, clicks, and indexed pages.
  • Webhooks: delivery success rate.

If you cannot measure it, you cannot tell whether it worked.

Last updated: October 21, 2026

Still stuck?
Our support team is ready to help you get set up.
Get support