Download list widget

Use this widget to display a list or table of links to documents and files, where each document or file can be downloaded. You can choose documents or files from the already uploaded or upload new.

After you have dragged the Download list widget on your page you must configure it to display documents and files.

To do this, click Edit button in the upper-right corner of the widget.

In the Download list window that appears, configure the following:

Selecting the documents and files to display

On Documents & Files tab you select which documents and files to display in the list.

NOTE: If you are using multiple site management and the Libraries module uses data sources from more than one site, you must first choose the source from which you want to display documents.
For more information, see Multisite: Manage multiple sites.

Perform the following:

  1. Select one of the following:
    • All published documents and files
      All documents and files that are uploaded and published will be displayed in the list.
    • From selected library…
      The Download list displays documents and files only from a certain library.
      1. To select a library, click Choose.
        The Choose library window appears.
      2. Select the library, whose documents and files you want to display, and click Done selecting.
      3. For more information, see Sitefinity CMS overview.
    • Upload new…
      To upload a new document or file, click Upload and perform procedure Sitefinity CMS overview » Step 5 to Step 10.
  2. Under Narrow the selection you can further specify which documents or files to display by choosing one of the following:
    • All published documents from selected library
      This is selected by default and displays all documents and files selected in the previous step.
    • Selection of documents
      You can narrow the displayed documents or files, using categories, tags, and dates.
      Select one or more of the following:
      • by Categories…
        Click the Select button to select the categories from which you want to display documents and files and click Done.
      • by Tags…
        Click Select button to select the tags, so that documents and files tagged with those particular tags will be displayed and click Done.
      • by Dates…
        Click Select button.
        Select one of the predefined time intervals, so that documents and files uploaded during that interval will be displayed or choose Custom range… and use the From and To input fields to select a time interval. When finished click Done.
  3. In Sort documents and files, select a sorting criterion for the list of documents and files.

Choosing how to display the documents and files

On Settings tab you select the way the list of documents and files is displayed.
  1. In Select type radio button group, choose one of the following:
     List In Fine tune the selected type the Display icons radio button group appears.

    Select the size of the icons that you want to be displayed in the list or select No icons.

    On the webpage, the documents and files are displayed in a list with their names, file types, and file sizes.
    If you have added description of the document or file, it is displayed as tooltip text when you hover over the name of the document or file.
    You can download the files by clicking their names.

    NOTE: You can edit the way the widget displays the download list, by clicking Edit Thumbnail list template. For more information, see Create and edit widget templates.

     Table In Fine tune the selected type the Display icons checkbox appears.
    Select the checkbox, if you want to display document and file icons in the table next to the Download link.

    The documents and files are displayed in a table, containing file names, file types, file sizes, date of upload of files, and a Download link.
    You can download the files by clicking the Download link.

    NOTE: You can edit the way the widget displays the download list, by clicking Edit Thumbnail list template. For more information, see Create and edit widget templates.

    List+Detail page In Fine tune the selected type the Position of the Download link on the Detail page checkbox groups appears.
    Select one of the following:
    • Bellow the description
      On the details page the link for the download of the document or file appears bellow the file name and the description (if you have added a file description).
    • Above the description
      On the details page the link for the download of the document or file appears bellow the file name and above the description (if you have added a file description).

    The documents and files are displayed in a list. The list contains the file names.
    If you have added description of the document or file, it is displayed as tooltip text when you hover over the name of the document or file.

    NOTE: You can edit the way the widget displays the download list, by clicking Edit Thumbnail list template. For more information, see  Create and edit widget templates.

    When you click the name of a document or file, a page with details opens.
    On the details page, the system displays the name of the file. The link for downloading the file, which is displayed where you have selected above. Bellow the Download link, the file type and file size are displayed.

    NOTE: You can edit the way the widget displays the detailed page, by clicking Edit Detail page template. For more information, see Create and edit widget templates.

    Table+Detail page In Fine tune the selected type the Display icons in the table checkbox appears, which you select if you want to display document and file icons in the table next to the Download link, and Position of the Downloaded link on the Detail page checkbox group appears, where you select one of the following:
    • Bellow the description
      On the details page the link for the download of the document or file appears bellow the file name and the description (if you have added a file description).
    • Above the description
      On the details page the link for the download of the document or file appears bellow the file name and above the description (if you have added a file description).

    The documents and files are displayed in a table, containing file names, file types, file sizes, date of upload of files, and a Download link.
    If you have added description of the document or file, it is displayed as tooltip text when you hover over the name of the document or file.

    NOTE: You can edit the way the widget displays the download list, by clicking Edit Thumbnail list template. For more information, see  Create and edit widget templates.

    When you click the name of a document or file, a page with details opens.
    On the details page, the system displays the name of the file. The link for downloading the file, which is displayed where you have selected above. Bellow the Download link, the file type and file size are displayed.

    NOTE: You can edit the way the widget displays the detailed page, by clicking Edit Detail page template. For more information, see Create and edit widget templates.

    For more information about adding details to a document or file, see Sitefinity CMS overview » Step 7.

  2. In Fine tune the selected type, perform the following:
    • If you select Use paging radio button, the system divides the list of documents and files into pages.
      In the input field you specify how many documents or files per page you want to display.
    • If you select Use limit radio button, the system displays only a limited number of the documents and files.
      In the input field, you specify how many documents or files you want to display.
    • If you select No limit and paging radio button, the system displays all the documents and files that you have selected in Documents & Files tab.

Filtering and sorting documents and files

You can filter and sort the documents and files, which the widget displays, using both the default and the Overview: Custom fields of the documents or files.
  1. To filter or sort the documents and files, click Advanced button in the lower-right corner of the window.
    The advanced editing mode opens.
  2. In MasterViewName input field, check which view the widget uses.
  3. Click ControlDefinition » Views buttons.
  4. Choose for which view, you want to apply filtering or sorting by selecting the view that the widget uses.
  5. Filter or sort the documents and files in the following way:
    • To filter the documents and files, in FilterExpression input field, enter the desired filtering expression.
      You can use both default and custom fields. The field supports AND and OR Boolean operators.
      For example, enter Visible = true AND Status = Live
      For more information, see Filter expressions for content items.
    • To sort the documents and files, in SortExpression input field, enter the desired sorting expression.
      You can use both default and custom fields. The field supports operators ASC for ascending and DESC for descending.
      For example, enter PublicationDate DESC

NOTE: To see all custom and default fields, perform procedure Create custom fields » Step 1 and Step 2.

For more information about advanced configuration options, see Advanced configuration of widgets.

When you are finished, click Save.
The Download list window closes and the Download list widget is configured to display links to the documents you have selected.

Was this article helpful?

Next article

Events widget