Skip to main content
Version: 1.x

Install Marketplace Pro Beta

warning

All features of the Marketplace Pro v1 Beta have been ported to the next version, Marketplace v4. Please upgrade to Marketplace v4 rather than following this old guide.

This guide will help you install Marketplace Pro Beta.

This process will be familiar if you have ever instaled a Composer package from a GitHub repository, or loaded a custom plugin into your Craft project, per the Craft docs.

Who should use Marketplace Pro​

Marketplace Lite pairs with Craft Commerce Lite’s single line item orders. If you are using Craft Commerce Pro, and your user interface limits customers to single line item orders (ex. a “Buy now” button with no cart), it will work equally well for you. Marketplace Lite also includes support for Craft Commerce Pro and orders with multiple line items, when all line items have the same payee.

Marketplace Pro is intended to pair with Craft Commerce Pro, when your marketplace needs to allow customers to purchase from two or more different payees in a single order. The pro version also supports custom fee logic via an event, ex. rather than defining one fee through the control panel, you can dynamically calculate your platform’s fee based on other details, like the payee, product, whether any discounts are in place, etc.

Update your composer.json​

Make the following changes to your composer.json file, to allow you to install Marketplace Pro Beta.

  • Set the minimum-stability to "dev".
  • Set prefer-stable to false, because you’d prefer this version of Marketplace to the current stable release. (?)
  • Add the repository config.
{
  "minimum-stability": "dev",
  "prefer-stable": true,
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/kennethormandy/craft-marketplace"
    }
  ]
}

Then, in your terminal, require the current Marketplace Pro Beta:

composer require kennethormandy/craft-marketplace:dev-main#f2d5f4eafa4793cf831cc45a65661ae415d9096e

Add an environment variable​

Add the following environment variable in all your environments, to enable the Marketplace Pro Beta features:

MARKETPLACE_PRO_BETA=true

Continue with the installation process​

If you already had Marketplace installed, then you are done: you are now running Marketplace Pro Beta.

If you are installing Marketplace for the first time in your project, you can now install the plugins through the Craft CMS dashboard, or using the command line:

# Install OAuth Client plugin
./craft install/plugin oauthclient

# Install Marketplace plugin
./craft install/plugin marketplace

From there, you’ll want to complete the Configure sections of the getting started guide, get Stripe Connect set up.