Document list widget

ASP.NET Core

Overview

Use the ASP.NET Core Document list widget to display a list or table of links to documents, where each document or file can be downloaded. You can choose documents or files from the already uploaded into Sitefinity libraries or upload new ones.

The ASP.NET Core document list widget also has:

• List and table templates
• Detailed template for a single document

PREREQUISITES: You uploaded at least one document or file. For more information, see Upload documents and files.

Place the widget on the page

You can place an Image widget only inside a Section widget.

To do this, perform the following:

1. Inside a column from the Section widget, click Add widget here…
2. Select the Content tab.
3. Click the Document list widget.
   The widget is placed inside the selected column of the Section widget.

Select the documents to display

In this section, you define the list selection. Perform the following:

1. In the Source dropdown box, choose documents from which provider you want to display.
2. Under Selection range you can further specify which documents to display by choosing one of the following:
   • All published documentsThis is selected by default and displays all documents selected in the previous step.
   • From currently opened libraryAll published documents from the currently opened library will be displayed in the list.
   • Selected documentsChoose a specific selection of images by clicking  (Select) and choosing one of the following:
     • Select one or more from the RECENT documents
     • Select one or more from the already uploaded documents
     • Upload new documents
3. Filter the list of documents You can narrow the displayed documents or files, using folders, categories, tags, and dates. Use the following filters:

   • Filter by librarySelect specific library where you want to dislay images from

   • Filter by categorySelect categories from which to display documents.

   • Filter by tagSelect the tags by which to narrow down documents that are displayed.

   • Date publishedSelect one of the predefined time intervals or choose From - to to select a more specific time interval, in which the displayed documents must be created.

     NOTE: You can select more than one filter and narrow down results using combinations of filters, for example by both categories and dates.

List settings

List settings define how documents are listed by the Documents list widget.

1. Under Number of list items, choose one of the following options:
   • Use pagingSitefinity CMS divides the documents into pages. In the input field, specify how many documents per page to display.
   • Show limited numberSitefinity CMS displays only a limited number of documents. In the input field, specify how many documents to display.
2. In Sort items, choose how to sort the list on the frontend. Choose one of the following sorting criteria:
   • Last published
   • Last modified
   • By Title (A-Z)
   • By Title (Z-A)
   • As set in Advanced modeTo sort the list of documents by property that is not defined in the sort dropdown menu, you must add a new sorting expression in the designer’s Advanced mode.
     For example, to sort documents using the Sort extension property of document, navigate to Advanced » Sort expression, add Extension ASC. As a result, in the sort dropdown menu, the As set in Advanced mode option is selected by default.

Single item settings

Single item settings define how individual documents are displayed. Choose one of the following options:

• Auto-generated pageWhen you click a document, it is displayed in an automatically generated page with the same layout as the list page.

• Select existing pageClick  (Select) and select a page from the list of existing pages that has the desired layout. When you click the document, it is displayed in this specific page.

  NOTE: The page where you want the document displayed, must have a Documents list widget added.

Display settings

Choose the following:

• List templateSelect the template you want to use to list documents on the webpage. Select one of the following:
  • DocumentsListOn the webpage, the documents are displayed in a list with their names, file types, and file sizes. Clicking the document title will open the document's detail view. You can download the files by clicking the Download link.
  • DocumentsTable
    The documents are displayed in a table, containing file names, file types, file sizes, and a Download link. Clicking the document title will open the document's detail view. You can download the files by clicking the Download link.
• Single item template
  Select the template you want to use to display document's details on the webpage.
• In Margins, you can choose the margins between the image and the column where it is placed.
  Choose from the predefined values of none, small, medium, or large.

Save your changes.