Topics

List


In This Guide

Creating a basic list

Basic lists are lists whose content does not change. These lists provide links to other items in your Brightspot project.

To create a basic list:

  1. In the content edit page, open or create the item to which you want to add a basic list.
  2. Toward the right of the widget, select more_horiz > Overrides. The Overrides widget appears.
  3. Expand Layout Overrides. Drop-down lists AboveAside, and Below appear for the module’s position.
  4. From one of the drop-down lists, select Replace.
  5. Click add_circle_outline, and select List. A form appears.
  6. In the Title field, enter a title.
  7. In the Description field, enter a description using the rich-text editor.
  8. From the Items list, select Basic. A form appears.
  9. Click add_circle_outline. A selection field appears.
  10. Click the selection field. The content picker appears.
  11. Select one or more items in the content picker, or create and select a new item.
  12. Close the content picker. You return to the List form, which looks similar to the following:
    Basic list edit form.png
  13. From the Call to Action list, select a call to action.
  14. Close the form and finish creating or editing the asset.

Creating an advanced list

Advanced lists are lists of modules, which means you can build a list that includes a promo, a gallery, and even other lists.

To create an advanced list:

  1. In the content edit page, open or create the item to which you want to add an advanced list.
  2. Toward the right of the widget, select more_horiz > Overrides. The Overrides widget appears.
  3. Expand Layout Overrides. Drop-down lists AboveAside, and Below appear for the module's position.
  4. From one of the drop-down lists, select Replace.
  5. Click add_circle_outline, and select List. A List form appears.
  6. In the Title field, enter a title.
  7. In the Description field, enter a description using the rich-text editor.
  8. From the Items list, select Advanced.
  9. Click add_circle_outline, and select a module. The corresponding form appears.
  10. Fill out the module's form.
  11. Repeat steps 8–9 to add additional items to the advanced list.
  12. From the Call to Action list, select a call to action. Your form looks similar to the following:
    Advanced list completed.png
  13. Close the form and finish creating or editing the item.

The previous image is an example of building an advanced list containing a media asset, a promo asset, and a contact form.


Creating a dynamic list

Dynamic lists are lists whose content satisfies various criteria. Examples of dynamic lists are reader comments and related articles, both of which can continually change.

When you create a dynamic list, you are actually defining search criteria. Every time a visitor loads a web page with a dynamic list, Brightspot searches for content matching the search criteria, and then populates the list accordingly.

To create a dynamic list:

  1. In the content edit page, open or create the item to which you want to add a dynamic list.
  2. Toward the right of the widget, select more_horiz > Overrides. The Overrides widget appears.
  3. Expand Layout Overrides. Drop-down lists AboveAside, and Below appear for the module’s position.
  4. From one of the drop-down lists, select Replace.
  5. Click add_circle_outline, and select List. A form appears.
  6. In the Title field, enter a title.
  7. In the Description field, enter a description using the rich-text editor.
  8. From the Items list, select Dynamic. A form appears.
  9. Using the following table as a reference, design filters for the dynamic list.
  10. From the Call to Action list, select a call to action. Your form looks similar to the following:
    Dynamic list edit form.png
  11. Click Publish.

Referring to the previous image, when a visitor loads a page with this dynamic list, Brightspot populates the list with 10 articles, sorted from newest to oldest, satisfying the following criteria:

  • Tagged as a recipe.
  • Published within the last 30 days.

Dynamic list fields

The following table describes the fields you can use to design filtering criteria for a dynamic list. Your version of Brightspot may have different fields.

Fields for configuring a dynamic list

Field
Description
TypesContent types to include in the dynamic list.
Items Per PageNumber of items displayed in each page of results. If the dynamic list has more items than this value, Brightspot displays next and previous links so the visitor can page through the results.
Member Affinity TypeLimits the items to those associated with the selected affinity.
Time PeriodLimits the items to those published within the specified number of days.
Tags
Limits the items to those having the selected tags.
SortSorts the items.
Pinned ItemsA list of items that always appears first in the dynamic list. These items do not need to satisfy the other filtering requirements. For example, if a pinned item is 60 days old, and the Time Period is 30 days, Brightspot includes the pinned item anyway.
No Results ModuleModule to display if no items satisfy the filtering criteria.
Hierarchy
(various)Limits the items to those appearing in the selected content hierarchy. For example, if under Sections you selected Wedding Cakes, then Brightspot limits the items in the dynamic list to those published under your site’s section Wedding Cakes.
Classification
(various)Limits the items to those associated with the selected classifications. For example, if under Author you selected Immanuel Kant, then Brightspot limits the items in the dynamic list to those published by Immanuel Kant.