Skip to content
AdvocateLoop Docs

WordPress & WooCommerce Plugin Overview

The AdvocateLoop plugin is a single WordPress plugin with two parts: a base WordPress integration that adds the referral widget and shortcodes to any WordPress site, and an optional WooCommerce extension that adds automatic discount application and conversion tracking on top of it.

Both parts live in the same plugin. Activating the plugin gives you the WordPress side automatically. The WooCommerce side activates on its own if WooCommerce is also installed and active — no separate plugin or addon to install.

Which parts apply to you

WordPress only

If your site uses WordPress but not WooCommerce (a brochure site, blog, lead-capture site, custom checkout, or any non-WC e-commerce solution), you’ll use:

  • The referral widget to let visitors claim discounts or sign up as advocates
  • Shortcodes to place the widget on pages and posts

You’ll record conversions by adding a small JavaScript snippet to your thank-you page (see the JavaScript Quick Start), or by sending events directly to the AdvocateLoop API (see Send events with the API).

WordPress + WooCommerce

If you run a WooCommerce store, the WooCommerce extension handles checkout for you, with no code:

  • Referred customers get their discount automatically in the cart and at checkout
  • Their purchases are recorded in your dashboard, with the advocate credited
  • Refunds keep your referral numbers accurate

In this section

WordPress

  • Installation & Setup — Install the plugin, connect your brand, verify everything’s working
  • Settings Reference — Every plugin setting explained, plus a guide to what’s controlled in the WP admin vs. the AdvocateLoop dashboard
  • Shortcodes — All shortcodes the plugin registers, with placement notes and examples

WooCommerce

  • What Happens on Your Store — What a referred customer experiences, and where the activity shows up in your dashboard
  • Discounts & Coupons — Configure the referral discount: type, minimum purchase, caps, and stacking
  • Troubleshooting — Pre-launch validation checklist, common issues with fixes, and how to use debug mode

Already using WooCommerce?

If you want the fastest path to a working install, start with the WooCommerce Quick Start. It walks you through install → connect → first test in about ten minutes. The pages in this section go deeper into specific topics once you have the basics in place.