How to Use the Easy Digital Downloads Control


Features in this article require Block Visibility Pro

Control Overview

Built exclusively for the Easy Digital Downloads plugin, this control allows you to create dynamic block content based on a variety of store-related rules. From the quantity of downloads in a customer’s cart to their total lifetime spend in your store, there is no easier way to personalize the shopping experience. Additional highlights include:

  • 16 conditional visibility rules and counting
  • Full support for products with variable pricing

While eCommerce personalization is not a new concept, the Easy Digital Downloads control in Block Visibility Pro allows you to work seamlessly in the Block Editor with blocks you are already familiar with. There is no external content editor or interface to deal with. If you are looking to increase sales and improve customer engagement while using native Gutenberg blocks for messaging, this is the solution for you!

Usage Examples

There are many applications for the Easy Digital Downloads control. Here are a few examples to get you started.

  • Recommend additional downloads at checkout based on what items the customer has already added to their cart with the Cart Contents rule.
  • Reward loyal customers with a special coupon based on how much they have spent in your store with the Total Spent rule.
  • Recommend new downloads, or entice customers to upgrade based on downloads they have ordered in the past with the Quantity of Products Ordered rule.
  • Display messaging to all customers that have not purchased a product in the last year with the Time Since Order rule.

Configuration

How to Enable

Begin by installing and activating the Easy Digital Downloads plugin. The control will not be available if the plugin is inactive.

Click on any block in the Block Editor and navigate to the Visibility panel. You will notice a vertical ellipsis icon in the Controls Toolbar. See the screenshot below. Click on the ellipsis, and all available visibility controls will appear. Select “Easy Digital Downloads” to add the Easy Digital Downloads control panel to the selected block.

Enabling the Easy Digital Downloads control in Block Visibility Pro.
Enabling the Easy Digital Downloads control in the block settings sidebar (v1.9)

How to Configure

Instructions are always better with examples. Let’s configure the block to be visible if the current customer has spent more than $1000 in your Easy Digital Downloads store and they have completed 2 or more separate orders.

The Easy Digital Downloads control uses rules and rule sets to determine if the block should be visible. A thorough overview of each available rule is provided below.

Steps to Complete

  1. Navigate to the Easy Digital Downloads control settings in the Visibility panel.
  2. Choose “Total Spent” from the rules selector.
  3. Choose “Is greater than” from the condition selector.
  4. Enter 1000 in the value field.
  5. Click on the “Add rule” button to add a second rule.
  6. Choose “Total Orders” from the rules selector.
  7. Choose “Is greater or equal to” from the condition selector.
  8. Enter 2 in the value field.

The resulting configuration should resemble the screenshot below.

Configuring the Easy Digital Downloads control in Block Visibility Pro.
Configuring the Easy Digital Downloads control (v1.9)

How to Disable

If you would like to disable the Easy Digital Downloads control at the block level, simply click on the ellipsis icon in the “Controls” toolbar and deselect it. The control can also be disabled globally in the plugin’s Visibility Control Settings.

Note that if this control is disabled globally or the Easy Digital Downloads plugin is deactivated, any blocks that are actively being hidden by the Easy Digital Downloads control will become visible again.

Rules and Rule Sets

Similar to other controls, rules and rule sets power the Easy Digital Downloads control. A “rule” is simply a conditional. A “rule set” is a collection of rules.

All rules within a rule set must be satisfied for the selected block to be visible. However, you can create multiple rule sets. Only one rule set needs to apply for the block to be visible. 

Within a rule set, you are creating AND conditions between multiple rules. Between two rule sets, you are creating OR conditions.

There are instances when rule errors can occur. This can happen when rule inputs are not completely filled out or if the rule is based on a product that has since been deleted from your store. In these situations, the plugin defaults to showing the block unless other rules apply, which would hide the block.

Adding a rule to the Location control in Block Visibility Pro.
Easy Digital Downloads rules and rule sets in the block settings sidebar (v1.9)

Cart Rules

The Easy Digital Downloads control contains a robust set of cart-based rules which are perfect for providing up-sells, product recommendations, and more. 

Cart Contents

This rule evaluates the contents of your Easy Digital Downloads cart. Is the cart empty or not? Does the cart contain specific products or products with specific categories? 

The available sub-fields are:

  • Is empty
  • Is not empty
  • Contains (Products) – Contains specific products
  • Contains (Categories) – Contains products with specific categories

If Contains (Products) or Contains (Categories) are selected, you will be presented with your choice of condition, and then you will choose the specific products or categories for the rule to evaluate. 

The available conditions are:

  • At least one of the selected – At least one of the selected products or categories is present in the cart.
  • All of the selected – All of the selected products or categories are present in the cart. There could be additional products and categories as well.
  • None of the selected – None of the selected products or categories are present in the cart.

Total Products in Cart

This rule evaluates the total number of products in your Easy Digital Downloads cart. The total includes the number of each product, not just the number of unique products in your cart. 

Example

Assume the cart contained 2 Music Albums and 3 Individual Music Track downloads, the Total Products in Cart would be 5. 

Total Cart Value

This rule evaluates the total value of all products in your Easy Digital Downloads cart.

Quantity of Product in Cart

This rule evaluates the total quantity of specific products in your Easy Digital Downloads cart. You can select multiple products, but the quantity value is evaluated per product and must be satisfied for all products for the rule to pass. 

Example

Assume the cart contained 2 Music Albums and 3 Music Track downloads.

You choose both Music Albums and Music Track in the product selector and set the rule to Is greater than a quantity of 2. In this case the rule would fail and the block would not be shown. There is exactly 2 Music Albums in the cart, not more than 2. 

Instead, if you only chose Music Track in the product selector and set the rule to Is greater than a quantity of 2, the block would be shown. Given this setup, we don’t care how many other products there are, only the number of Music Tracks. 

Quantity of Category in Cart

This rule evaluates the total quantity of products in a specific category in your Easy Digital Downloads cart. You can select multiple categories, but the quantity value is evaluated per category and must be satisfied for all categories for the rule to pass. In other words, the quantity value applies to the number of products in each category, not total products across all categories.

Example

Assume there are 2 Music Albums, 3 Music Tracks, 2 Images and 1 Video download in the cart. The albums and tracks are part of the Music category and the images and video are part of the Media category. 

You choose both Music and Media in the category selector and set the rule to Is greater than a quantity of 4. In this case the rule would fail and the block would not be shown. There are only a total of 3 products (2 Images and 1 Video) in the cart from the category Media, not 4. 

Instead, if you only chose Music in the product selector and set the rule to Is greater than a quantity of 4, the block would be shown. Given this setup, we don’t care how many other products there are, only the number of products from the category of Music. 

Customer History

Customer History rules require the customer to be logged-in to function. If the customer is not logged-in, and such rules are applied to the block, the rules will fail causing the block to be hidden.  

Total Spend

This rule evaluates the total lifetime spend of the logged-in customer in your Easy Digital Downloads store.  

Average Order Value

This rule evaluates the average order value of the logged-in customer in your Easy Digital Downloads store.  

Total Orders

This rule evaluates the total number of orders made by the logged-in customer in your Easy Digital Downloads store. 

Quantity of Products Ordered

This rule evaluates the total quantity of specific products that the current logged-in customer purchased from your Easy Digital Downloads store. You can select multiple products, but the quantity value is evaluated per product and must be satisfied for all products for the rule to pass. 

Example

Assume the customer ordered 2 Music Albums and 3 Music Track downloads.

You choose both Music Albums and Music Track in the product selector and set the rule to Is greater than a quantity of 2. In this case the rule would fail and the block would not be shown. The customer purchase exactly 2 Music Albums, not more than 2. 

Instead, if you only chose Music Track in the product selector and set the rule to Is greater than a quantity of 2, the block would be shown. Given this setup, we don’t care how many other products there are, only the number of Music Tracks. 

Quantity of Category Ordered

This rule evaluates the total quantity of products in a specific category that the current logged-in customer purchased from your Easy Digital Downloads store. You can select multiple categories, but the quantity value is evaluated per category and must be satisfied for all categories for the rule to pass. In other words, the quantity value applies to the number of products in each category. It does not count the total products across all categories.

Example

Assume that the customer purchased 2 Music Albums, 3 Music Tracks, 2 Images and 1 Video download. The albums and tracks are part of the Music category and the images and video are part of the Media category. 

You choose both Music and Media in the category selector and set the rule to Is greater than a quantity of 4. In this case the rule would fail and the block would not be shown. The customer only purchased a total of 3 products (2 Images and 1 Video) from the category Media, not more than 4. 

Instead, if you only chose Music in the product selector and set the rule to Is greater than a quantity of 4, the block would be shown. Given this setup, we don’t care how many other products there are, only the number of products from the category of Music. 

Time Since Order

This rule evaluates the total number of days since the customer’s first, or last, completed order of any product in your Easy Digital Downloads store.

Time Since Product Ordered

This rule evaluates the total number of days since the customer’s first, or last, completed order of a specific product from your Easy Digital Downloads store. You can select multiple products, but the number of days is evaluated per product and must be satisfied for all products for the rule to pass. 

Time Since Category Ordered

This rule evaluates the total number of days since the customer’s first, or last, completed and order of products in a specific category from your Easy Digital Downloads store. You can select multiple categories, but the number of days is evaluated per category and must be satisfied for all categories for the rule to pass.

Date of Order

This rule evaluates when the customer’s first, or last, completed an order of any product in your Easy Digital Downloads store.

Date of Product Ordered

This rule evaluates when the customer’s first, or last, completed an order of a specific product from your Easy Digital Downloads store. You can select multiple products, but the order date is evaluated per product and must be satisfied for all products for the rule to pass. 

Date of Category Ordered

This rule evaluates when the customer’s first, or last, completed an order of products in a specific category from your Easy Digital Downloads store. You can select multiple categories, but the order date is evaluated per category and must be satisfied for all categories for the rule to pass.

Hide When Rules Apply

By default, the block will be visible if the applied rules are satisfied. Simply toggle the “Hide when rules apply” setting to hide the block instead.


Upgrade to Pro today!

Unlock block location controls, eCommerce integrations, advanced block scheduling, and more!