Setting up Conditional Gateways

Once the  Conditional Gateways extension is installed and activated, a new meta box will be added to the New Downloads and Edit Downloads pages entitled "Conditional Gateways". The Conditional Gateways meta box can be found at the bottom of the right of the page above the featured image, by default, and looks like this:

The meta box will list all of the currently active gateways on your Easy Digital Downloads install. By default, all gateways are allowed for every product. To restrict a download to a specific gateway or gateways, simply check them and hit save!

Configuring Conditional Gateways

Beyond the per-download configuration already discussed, the Conditional Gateway extension requires very little configuration. At present, it only supports a single option which can be found under Downloads > Settings > Extensions.

This option allows you to configure the error message shown in any case where a user may add a combination of products to their cart which results in no gateways being available.

How Conditional Gateways works

By default, Easy Digital Downloads allows you to implement an unlimited number of gateways on your site. For the purposes of this documentation, we are going to assume that you have two active gateways,  WePay and Stripe. Now let's assume that you are an author and are selling ebooks through your website, along with other digital goods. The WePay Terms of Service explicitly disallows selling ebooks through their gateway so, for your ebooks, you would want to disable the WePay gateway.

Now, if a use adds an ebook and another digital product to their cart, the system will run through each product in the cart and tally up the allowed gateways for each product. Since the non-ebook product allows both WePay and Stripe, but the ebook only allows Stripe, the EDD checkout page will only list Stripe. If, however, you have configured all non-ebook products to ONLY allow payment through WePay, and a user has added the previously mentioned products to the cart, Conditional Gateways will run through the products in the cart and determine that there is no active gateway capable of processing all products in the cart. If this happens, the cart will display a notification to the user prompting them to remove an item from the cart and disable the checkout button until a valid gateway is found.