Skip to content

Set up your marketplace (WCFM setup for Reign)

Reign WCFM Addon overviewPremiumGet Reign WCFM Addon →

Also called: WCFM setup, store list page, vendor shop, vendor dashboard, store manager, sold by, marketplace setup, add a vendor.

Reign WCFM Addon styles and extends WCFM Marketplace. It does not create vendor shops, vendors or pages. If WCFM is not set up, the add-on looks broken. You see no store list, no “Sold by” line, nothing to favourite and no Store tab. This guide covers the WCFM setup the add-on needs.

Needs Notes
Reign theme 8.1.0 or newer The add-on checks the theme version. A pre-release such as 8.1.0-beta.1 counts as 8.1.0.
WooCommerce Must be active.
WCFM - WooCommerce Frontend Manager The base plugin. WCFM Marketplace needs it.
WCFM - WooCommerce Multivendor Marketplace Gives you vendors and vendor shops. The add-on checks that it is active.
WCFM - Membership (free) Optional. WCFM Marketplace needs it to let new sellers sign up on their own.
BuddyPress or BuddyBoss Optional. Needed for the profile tabs and activity entries.

The add-on does not check a WCFM version number. This guide was checked against WooCommerce 11.2.2, WCFM Frontend Manager 6.8.2 and WCFM Marketplace 3.8.4.

A second marketplace plugin pauses the add-on. Deactivate Dokan Lite or WC Vendors before you use WCFM. While paused, an administrator sees a notice that lists each step. Your settings are kept.

The community features need these BuddyPress or BuddyBoss parts.

  • Activity component: needed for entries about new products, reviews and purchases. With it off, the Activity stream card is hidden.
  • Member profiles: needed for the Favourite products tab (on a member’s own profile) and the Store tab (on vendor profiles).

The add-on does not use PeepSo. The favourite heart works without BuddyPress or BuddyBoss.

  1. Install and activate the Reign theme, version 8.1.0 or newer.
  2. Install and activate WooCommerce.
  3. Install and activate WCFM - WooCommerce Frontend Manager.
  4. Install and activate WCFM - WooCommerce Multivendor Marketplace.
  5. Install and activate Reign WCFM Addon.
  6. Go to Reign Settings > License.
  7. Enter your key in the Reign WCFM Addon row.

If another vendor plugin was active, deactivate it first. See what you need.

WCFM opens its setup wizard when you activate it. If you skipped it, open Dashboard and go to /wp-admin/index.php?page=wcfm-setup. You can run it again at any time.

The wizard steps are Introduction, Dashboard Setup, Marketplace Setup, Commission Setup, Withdrawal Setup, Registration Setup, Style, Capability and Ready. WCFM - Membership already being active removes the Registration Setup step. Only the steps below change what the add-on shows.

Marketplace Setup. If WCFM Marketplace is not active yet, this step shows an Install & Setup Multi-vendor Module button. It installs and activates the plugin for you.

Field Recommended Why
Store URL Base store (the default) Vendor shops open at yoursite.com/store/<vendor-name>. Change it only if you want a different word in the address.
Visible Sold By On Shows the “Sold by” line on product pages. After the wizard, check that it is ticked in WCFM settings.
Sold By Template Advanced (the default) Sets how the vendor box looks on the product page.
Sold By Position Below Add to Cart (the default) Where the Sold by line sits on the product page.
Store Name Position At Header (the default) Where the shop name shows on the vendor shop page.
Store Sidebar and Store Sidebar Position Keep the defaults The sidebar on the vendor shop page.
Products per page Your shop’s value Defaults to the WordPress posts-per-page value.
Google Map API Key Your key, if you show maps Needed to show the map on a vendor shop page.

Commission Setup.

Field Recommended Why
Commission For Vendor (the default) Commission is worked out as the vendor’s share.
Commission Mode Percent (the default) The simplest rule to explain to sellers.
Commission Percent 90 (the default) The vendor’s share. Set the number your marketplace pays.

You can add more commission rules later in WCFM settings. Leave Withdrawal Setup on its defaults until you know how you will pay vendors.

Registration Setup. This step installs WCFM - Membership. Click Setup Registration to install it. Without it, WCFM Marketplace cannot sign up new sellers. You can still add vendors yourself.

Page What it shows How to make it
Store Manager The vendor dashboard WCFM creates it on activation, with the shortcode [wc_frontend_manager].
Vendor Registration The seller sign-up form WCFM - Membership creates it, with the shortcode [wcfm_vendor_registration].
Vendor Membership The membership plans WCFM - Membership creates it, with the shortcode [wcfm_vendor_membership].
Store list All vendor shops in a grid WCFM does not create it. Add a page with the shortcode [wcfm_stores].

To create the store list page:

  1. Go to Pages > Add New.
  2. Give it a title such as Stores.
  3. Add a Shortcode block that contains [wcfm_stores].
  4. Click Publish.

The add-on needs no setting for this page. WCFM finds it by the shortcode.

If the Store Manager page is missing or points to the wrong page:

  1. Open the vendor dashboard.
  2. Go to Settings and open the Dashboard Pages section.
  3. Pick the page in the Dashboard field.
  4. Tick Refresh Permalink and save.

If a vendor shop or dashboard page says “page not found”, go to Settings > Permalinks and click Save Changes once. Do the same after you change the Store URL Base.

You need one vendor with a shop and a few products.

  1. Open the vendor dashboard (the Store Manager page) as an administrator.
  2. Open Vendors and click Add New.
  3. Fill in the vendor’s details and save.
  4. Log in as that vendor.
  5. Open Products and click Add New.
  6. Add a title, a price and an image, then publish. A product that is not published shows nowhere.
  7. Add two or three more products, so the shop page has something to show.
  8. Optional: as a customer, buy one product and leave an approved review. The activity stream then has something to show.

Log in first, because hearts show to logged-in members only. Then open each page and look for what the add-on adds.

  1. Open the store list page. You see WCFM’s shop cards, styled by Reign.
  2. Open a vendor shop at /store/<vendor-name>/. You see the banner, the shop name and the products in the Reign layout.
  3. Open a product. You see the “Sold by” line and the favourite heart.
  4. Click the heart. It fills and the message “Saved to favourites” shows.
  5. Open your own profile in BuddyPress or BuddyBoss. You see the Favourite products tab with that product.
  6. Open the vendor’s profile. You see a Store tab with their products.
  7. Open the activity stream. A new product from a vendor appears as a product card. Reviews show once approved. Purchases show only when you turn on Purchases in the settings.

Do each step in the notice. See Fix common problems.

The store list page needs the [wcfm_stores] shortcode, and at least one vendor must exist.

Why do vendor shops or the dashboard say “page not found”?

Section titled “Why do vendor shops or the dashboard say “page not found”?”

Save Settings > Permalinks once.

Why is there no “Sold by” line on products?

Section titled “Why is there no “Sold by” line on products?”

Open the Marketplace settings in the vendor dashboard Settings and tick Visible Sold By.

Log in. Hearts show to logged-in members only. See Fix common problems.

Why is there no Favourite products or Store tab?

Section titled “Why is there no Favourite products or Store tab?”

BuddyPress or BuddyBoss must be active. The Store tab shows only on vendor profiles.

The Activity component must be on. A product must be published, and a review approved.

Install WCFM - Membership.