[ddownload_list] Delightful Downloads

You can output a list of downloads using the [ddownload_list] shortcode. Optional attributes can be supplied to customise the output. To output all published downloads, sorted by title in ascending order: [ddownload_list]


The following are optional attributes that will modify the output.


Cache the results. The amount of time the results are cached for can be set in the Settings screen under the Advanced tab. Default: true.


Show only downloads within specified categories. Comma separated list of category slugs. Default: blank.


Exclude downloads within specified categories. Comma separated list of category slugs. Default: blank.


Exclude downloads within specified tags. Comma separated list of tag slugs. Default: blank.


Limit the number of downloads to display. Set to 0 to show all results. Default: 0.


The order in which results are displayed. Set to either ASC or DESC. Default: ASC.


The option in which results should be sorted by. The available options are title, date, count (Download count), filesize, random. Default: title.


When using both categories and tags together this attribute specifies the relationship between the two. The options are AND (Must be in all), OR (Must be in at least one). Default: AND.


The output style that should be used to display the list of downloads. The default options are title, title_date, title_downloads, title_filesize. Custom list styles can also be added, as detailed here.


Show only downloads within specified tags. Comma separated list of tag slugs. Default: blank.


    • Hi Dean,

      Delightful Downloads only allows one file to be downloaded. If you need multiples files attached to a single download you would need to compress them together.


  1. Hi Ashley, the Option orderby=”downloads” doesn’t work as described in the Manual above, but orderby=”count” seem to make the thing?!

    What i miss in the whole thing is a “File-Description” Attribute for List and Single-Download.


    • You are correct, I’ve updated the documentation. As for the File Description, I plan on enabling the editor in a future release which will allow you to do just that.


  2. Can you please explain HOW to add attributes that modify the output?
    I have tried [ddownload_list exclude_categories=”Shirts”]

    But it still lists all shirts.

    Please add examples to show newbies like me how to use your awesome features :)

    • The shortcode should work as it is displayed in your comment. Please can you confirm that you are using a category slug and not a category title?


  3. Hi Rich,

    No matter what categories (slug) I do enter, even if it dosen’t existing, the following command will still display ALL my documents.

    [ddownload_list categories=”47″]

    So as if the categories filter is not working as expected. Could you please check ? I can provide credentials inbox to you if need be.


    • Hi Guy,

      Can you confirm you are using the correct slug? In the example above it looks like you are using a category ID. A slug will be the URL friendly version of the category title, which can be found on the Categories screen.


  4. Hey there, I am using the category shortcode
    [ddownload_list categories='literature']
    however it only lists 1 item NOT from that category. Any suggestions? I have 3 files in the literature category.

  5. I have this little problem: after I delete a download , when I go back to the site , the information does not get updated. I can still see the deleted download, but if I click it, it says invalid download.

    can you please help me with this ?

    • Adrian,

      The data is cached. If you go to Setting > Advanced and set the cache duration to 0, once you refresh the page the list should update. It’s always best to leave the cache turned on though, so you may want to re-enable it.


  6. Just wanted to say: Everything is working fine. Great / simple to use plugin. I actually bought a plugin to do this sort of thing ($45 a year) and was very unhappy with it. I’m a former programmer – and just wanted to say you are doing this without reinventing the wheel – and that is great.

    Many of the features I needed with previously bought plugin were sold separately as Add-Ons.

Leave a Reply

Your email address will never be published.

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>