[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]

Attributes

The following are optional attributes that will modify the output.

cache

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.

categories

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

exclude_categories

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

exclude_tags

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

limit

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

order

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

orderby

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

relation

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.

style

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.

tags

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

Comments

    • 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.

      Ashley

  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.

    Carsten

    • 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.

      Ashley

  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?

      Ashley

  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.

    Regards

    • 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.

      Ashley

  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.

      Ashley

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>