Document list widget

Use the Next.js 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 Next.js 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.

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.

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 documents
     This is selected by default and displays all documents selected in the previous step.
   • From currently opened library
     All published documents from the currently opened library will be displayed in the list.
   • Selected documents
     Choose 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 library
     Select specific library where you want to dislay images from
   • Filter by category
     Select categories from which to display documents.
   • Filter by tag
     Select the tags by which to narrow down documents that are displayed.
     
   • Date published
     Select 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 define how documents are listed by the Documents list widget.

1. Under Number of list items, choose one of the following options:
   • Use paging
     Sitefinity CMS divides the documents into pages. In the input field, specify how many documents per page to display.
   • Show limited number
     Sitefinity 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 mode
     To 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 define how individual documents are displayed. Choose one of the following options:

• Auto-generated page
  When you click a document, it is displayed in an automatically generated page with the same layout as the list page.
• Select existing page
  Click  (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.

Choose the following:

• List template
  Select the template you want to use to list documents on the webpage. Select one of the following:
  • DocumentsList
    On 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.