Skip to main content
Easy Digital Downloads Documentation
Documentation, Reference Materials, and Tutorials for Easy Digital Downloads

Purchase Collection Shortcode

The [purchase_collection] shortcode allows you to make a unique category-based collection of products to be sold as a package.  Here are some examples:

  • You sell a plugin that has some suggested add-ons. Put them all in a category and use [purchase_collection] to show them all on one page. The customer can add them all to their cart with one click.
  • You have a collection of documents or mp3s all grouped by category. You could make a page and show all the items in one category and the customer can add them all to their cart with one click.
  • You have a collection of photos organized by category. You could make a page of just the photos from one category and the customer could add them all to their cart with one click.

Input

This shortcode has some required input and some optional input.

Required
  • taxonomy: EDD comes with two built-in taxonomies, download_category and download_tag, you may use either of these.
  • terms: These are the actual category terms you want to use. You may use more than one, comma separated.

Here’s an example with only the required input:

[purchase_collection taxonomy='download_category' terms='California Photos']
Optional
  • text: This is the text that will appear on the button. It defaults to ‘Purchase All Items’
  • style: This refers to the Buy button style. It defaults to button. Your choices for this option are in the Style Settings document.
  • color: This refers to the color of the Buy button. It defaults to blue. Your choices for this option are in the Style Settings document.

Here’s an example with all variables possible:

[purchase_collection taxonomy='download_category' terms='California Photos' text='Buy All California Pictures' style='button' color='red' class='buy-all-button']

Output

The above shortcode outputs a button that looks like this:

You can override the CSS to make it look like anything of course, but that’s the default.

NOTE: the shortcode doesn’t render any product info or description of the products other than the button label. ┬áTo use this properly please make sure you have a good description of what will happen when people click the button.