Brightspot CMS User Guide

Embedding a list module


A list contains a series of items typically related to the main item or related to the visitor’s profile. For example, a blog post can have a list of “related stories” or a list of “reader comments.” Lists can be basic (they never change), advanced (they contain other modules), or dynamic (such as listing the 10 most recent related stories). Lists can contain other lists or any other module.

The following sections describe the various types of lists and how to create them.

Basic lists

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

To embed a basic list:

  1. From the Module list, select List.
  2. In the Title field, enter a title. The title entered here is visible to the visitors to your site.
  3. In the Description field, enter a description. This description is visible to the visitors to your site.
  4. From the Items list, select Basic.
  5. Click add_circle_outline. The content picker appears.
  6. Select one or more assets in the content picker, or create and select a new asset.
  7. Close the content picker. You return to the Edit Module form.
  8. From the Call to Action list, select a call to action.

    Basic list module
    Basic list module with three assets

  9. Expand Enhancement Styles and select your Enhancement Alignment. See Enhancement alignment for more information on enhancement placement.
  10. Click Save & Close

Advanced lists

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

To embed an advanced list:

  1. From the Module list, select List.
  2. In the Title field, enter a title. The title entered here is visible to the visitors to your site.
  3. In the Description field, enter a description. This description is visible to the visitors to your site.
  4. From the Items list, select Advanced.
  5. To add modules to the list, do the following:

    1. Click add_circle_outline. The Add widget appears.
    2. Select one of the modules. You return to the content edit form.
    3. Fill out the module’s form.
    4. Repeat steps a–c to add additional modules.
  6. To add shared modules to the list, do the following:

    1. Click search. The content picker appears.
    2. Select an existing module, or create a new one.
    3. Repeat to add additional shared modules.
    4. Close the content picker. You return to the content edit form.
  7. From the Call to Action list, select a call to action. (See the previous illustration for the appearance of the Title, Description, and Call to Action fields on your published site.)
  8. Expand Enhancement Styles and select your Enhancement Alignment. See Enhancement alignment for more information on enhancement placement.
  9. Click Save & Close

Dynamic lists

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. From the Module list, select List.
  2. In the Title field, enter a title. The title entered here is visible to the visitors to your site.
  3. In the Description field, enter a description. This description is visible to the visitors to your site.
  4. From the Items list, select Dynamic.
  5. Using the following table as a reference, design filters for the dynamic list.
  6. From the Call to Action list, select a call to action. (See the previous illustration for the appearance of the Title, Description, and Call to Action fields on your published site.)
  7. Expand Enhancement Styles and select your Enhancement Alignment. See Enhancement alignment for more information on enhancement placement.
  8. Click Save & Close

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
Types
Content types to include in the dynamic list.
Items Per Page
Number 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.
Time Period
Limits the items to those published within the specified number of days.
Tags
Limits the items to those having the selected tags.
Sort
Sorts the items.
Pinned Items
A 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 Module
Module 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.

See List for complete detail on creating and using list modules in Brightspot.

Previous Topic
Embedding an iframe module
Next Topic
Embedding a media module
Was this topic helpful?
Thanks for your feedback.
The elements that get you up and running in a matter of days, from pre-built content types, to modules, to landing pages.

Content types
Modules
Landing pages
Everything you need to manage and administer content within Brightspot CMS, including plug-and-play integrations.

Dashboards
Publishing
Workflows
Admin configurations
A guide for installing, supporting and administering code on the Brightspot platform, including integrations requiring developer support to use.

Field types
Content modeling
Rich-text elements
Images