Easy Digital Downloads

Andrew Munro

<p>EDD Blocks adds a “Downloads” block to the new WordPress editor, also known as Gutenberg.</p>
<p>The Downloads block allows you to display a grid of Downloads on your site similar to the [downloads] shortcode already provided by Easy Digital Downloads. The Downloads block provides a visual representation of your downloads, allowing you to see a real-time preview of your downloads as you configure the various settings.</p>
<p>As well as being able to display downloads, a grid of Download Categories or Download Tags can be shown.</p>
<h3>Requirements</h3>
<ul>
<li>The latest version of the Gutenberg plugin OR WordPress 5.0 or greater</li>
<li><a href="https://wordpress.org/plugins/easy-digital-downloads/" title="Easy Digital Downloads" rel="ugc">Easy Digital Downloads</a>.</li>
</ul>
<h3>Features</h3>
<h4>Display a grid of Downloads</h4>
<ol>
<li>Set how many downloads should show per page</li>
<li>Set how many columns of downloads should show</li>
<li>Show or hide the buy button</li>
<li>Show or hide the price</li>
<li>Show or hide thumbnail images</li>
<li>Show or hide the excerpt</li>
<li>Show or hide the full content</li>
<li>Show or hide the pagination</li>
<li>Order downloads by “Date Created”, “Earnings”, “ID”, “Price”, “Random”, “Sales”, “Slug” or “Title”</li>
<li>Order downloads in an “Ascending” or “Descending” order</li>
<li>Show downloads from a specific category</li>
</ol>
<h4>Display a grid of Download Categories</h4>
<ol>
<li>Set how many columns of download categories should show</li>
<li>Show or hide download category thumbnail images</li>
<li>Show or hide download category names</li>
<li>Show or hide download category descriptions</li>
<li>Show or hide download category counts</li>
<li>Show or hide empty download categories</li>
<li>Order download categories by “Count”, “ID”, “Name” or “Slug”</li>
<li>Order download categories in an “Ascending” or “Descending” order</li>
</ol>
<h4>Display a grid of Download Tags</h4>
<ol>
<li>Set how many columns of download tags should show</li>
<li>Show or hide download tag thumbnail images</li>
<li>Show or hide download tag names</li>
<li>Show or hide download tag descriptions</li>
<li>Show or hide download tag counts</li>
<li>Show or hide empty download tags</li>
<li>Order download tags by “Count”, “ID”, “Name” or “Slug”</li>
<li>Order download tags in an “Ascending” or “Descending” order</li>
</ol>
<h4>Shortcodes</h4>
<p>Gutenberg also provides a shortcode block so we’ve added a [download_categories] and [download_tags] shortcode. Each shortcode shares the same attributes, mimicking the options of the Downloads block:</p>
<p><strong>thumbnails</strong></p>
<p>true (default) | false</p>
<p>Whether or not to show the thumbnail image.</p>
<p><strong>title</strong></p>
<p>true (default) | false</p>
<p>Whether or not to show the category or tag name.</p>
<p><strong>description</strong></p>
<p>true (default) | false</p>
<p>Whether or not to show the category or tag description.</p>
<p><strong>show_empty</strong></p>
<p>true | false (default)</p>
<p>Whether or not to show empty terms.</p>
<p><strong>columns</strong></p>
<p>1 | 2 | 3 (default) | 4 | 5 | 6</p>
<p>The number of columns.</p>
<p><strong>count</strong></p>
<p>true (default) | false</p>
<p>Whether or not to show the number of downloads in each term.</p>
<p><strong>orderby</strong></p>
<p>count (default) | id | name | slug</p>
<p>What to order the terms by.</p>
<p><strong>order</strong></p>
<p>ASC | DESC (default)</p>
<p>In which order to display the terms.</p>
<p><strong>Shortcode examples</strong></p>
<p>[download_categories count=”false” orderby=”name” order=”ASC” title=”false” columns=”4″]</p>
<p>[download_tags orderby=”id” order=”DESC” columns=”2″]</p>


Easy Digital Downloads – Blocks

EDD Blocks adds a "Downloads" block to the new WordPress editor, also known as Gutenberg.

<h4>Featured Downloads is now part of EDD Core</h4>
<p>As of Easy Digital Downloads 3.5.1, the Featured Downloads addon is included in Easy Digital Downloads. You no longer need this addon to use the Featured Downloads feature.</p>
<h4>About this Addon</h4>
<p>This plugin requires <a href="https://wordpress.org/extend/plugins/easy-digital-downloads/" title="Easy Digital Downloads" rel="ugc">Easy Digital Downloads</a>. It’s aimed at developers/clients who need to show a list of featured downloads.</p>
<ol>
<li>Provides a template tag so finely-tuned placement of featured downloads in your theme is possible.</li>
<li>Provides a shortcode which will simply list all the featured downloads, without the need to enter any IDs.</li>
<li>Provides a simple interface for managing featured downloads in the WordPress admin. A “feature download” checkbox will be added to each download edit/publish screen as well as the quick edit boxes. At a glance you’ll also be able to see which downloads have been featured on your website from the main download listing.</li>
</ol>
<h4>Shortcode Usage</h4>
<p>Add the “featured” attribute to the existing [downloads] shortcode provided by Easy Digital Downloads:</p>
<pre><code>[downloads featured="yes"]
</code></pre>
<h4>Template Tag Usage</h4>
<p>The following code can be used to show the featured downloads anywhere in your theme:</p>
<pre><code>echo do_shortcode( '[downloads featured="yes"]' );
</code></pre>
<p>You can include any other attributes supported by the <a href="https://docs.easydigitaldownloads.com/article/224-downloads" rel="nofollow ugc">[downloads] shortcode</a>.</p>
<h4>Building your own Query</h4>
<p>To build your own query using <a href="https://codex.wordpress.org/Class_Reference/WP_Query" title="WP_Query" rel="nofollow ugc">WP_Query</a> you can use the <code>meta_key</code> parameter with a value of <code>edd_feature_download</code>. The following example builds a simple unordered list with all the featured downloads.</p>
<pre><code><?php

$args = array(
    'post_type' => 'download',
    'meta_key'  => 'edd_feature_download',
);

$featured_downloads = new WP_Query( $args );

if( $featured_downloads->have_posts() ) : ?>

    <ul>
        <?php while( $featured_downloads->have_posts() ) : $featured_downloads->the_post(); ?>
        <li>
           <a href="<?php the_permalink(); ?>" title="<?php the_title(); ?>">
                <?php the_title(); ?>
           </a>
        </li>
        <?php endwhile; ?>
    </ul>

<?php endif; wp_reset_postdata(); ?>
</code></pre>


Easy Digital Downloads – Blocks vs Easy Digital Downloads Featured Downloads