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.

Embedding basic lists

Basic lists are lists whose containing assets do not change. These lists provide links to other assets in your Brightspot project.



To embed a basic list:

  1. From the rich-text editor's toolbar, select image > List.
  2. From the List list, do one of the following:
    • Select an existing list. Skip to step 15.
    • Select Create New.
  3. In the Internal Name field, enter an internal name. Brightspot uses this name in selection fields.
  4. In the Title field, enter a title. The title entered here is visible to the visitors to your site.
  5. In the Description field, enter a description. This description is visible to the visitors to your site.
  6. From the Items list, select Basic.
  7. Click add_circle_outline.
  8. Select one or more assets from the content picker, or create and select a new asset.
  9. Close the content picker.
  10. From the Call to Action list, select a call to action.
  11. In the Call To Action Button Text, enter text appearing on the call-to-action button. This text is visible to the visitors to your site.
  12. Click Publish.
  13. Click Back.
  14. From the List list, select the list you just created.
  15. Apply an alignment to the list by doing the following:
    1. Expand Page List Enhancement Styles.
    2. From the Preset list, select one of the following:



      • None—Brightspot aligns the module within the body text using your theme's settings.
      • Custom—Under Choose enhancement alignment, select an alignment. See Enhancement alignment for more information on enhancement placement.
  16. Click Save & Close.

The following illustration shows how Brightspot renders a basic list module.

Basic list module
Basic list module with three assets

Embedding advanced lists

Advanced lists are lists of shared 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 rich-text editor's toolbar, select image > List.
  2. From the List list, do one of the following:

    • Select an existing list. Skip to step 12.
    • Select Create New.
  3. In the Internal Name field, enter an internal name. Brightspot uses this name in selection fields.
  4. In the Title field, enter a title. The title entered here is visible to the visitors to your site.
  5. From the Items list, select Advanced.
  6. Click add_circle_outline, and select one of the available modules.
    • If you select Ad, select on of the available ads.
    • If you select HTML Embed or Iframe Embed, select one of the available modules, or select Create New to create a new module.
    • If you select Promo, complete the form for the promo.
  7. From the Call to Action list, select a call to action.
  8. In the Call To Action Button Text, enter text appearing on the call-to-action button. This text is visible to the visitors to your site.
  9. Click Publish.
  10. Click Back.
  11. Apply an alignment to the list by doing the following:

    1. Expand Page List Enhancement Styles.
    2. From the Preset list, select one of the following:



      • None—Brightspot aligns the module within the body text using your theme's settings.
      • Custom—Under Choose enhancement alignment, select an alignment. See Enhancement alignment for more information on enhancement placement.
  12. Click Save & Close.

Embedding dynamic lists

Dynamic lists contain assets that satisfy 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 and filter criteria. Every time a visitor loads a web page with a dynamic list, Brightspot searches for assets matching the search criteria, and then populates the list accordingly.



To create a dynamic list:
  1. From the rich-text editor's toolbar, select image > List.
  2. From the List list, do one of the following:



    • Select an existing list. Skip to step 12.
    • Select Create New.
  3. In the Internal Name field, enter an internal name. Brightspot uses this name in selection fields.
  4. In the Title field, enter a title. The title entered here is visible to the visitors to your site.
  5. In the Description field, enter a description. This description is visible to the visitors to your site.
  6. From the Items list, select Dynamic.
  7. Using the following table as a reference, configure a dynamic list.
  8. From the Call to Action list, select a call to action.
  9. In the Call To Action Button Text, enter text appearing on the call-to-action button. This text is visible to the visitors to your site.
  10. Click Publish.
  11. Click Back.
  12. Apply an alignment to the list by doing the following:



    1. Expand Page List Enhancement Styles.
    2. From the Preset list, select one of the following:



      • None—Brightspot aligns the module within the body text using your theme's settings.
      • Custom—Under Choose enhancement alignment, select an alignment. See Enhancement alignment for more information on enhancement placement.
  13. Click Save & Close.

The following table describes the fields you can use to design filtering criteria for a dynamic list.

Field
Description
Main
Types
Content types to include in the dynamic list.
SortSorts the assets.
Items Per Page
Number of assets displayed in each page of results. If the dynamic list has more assets than this value, Brightspot displays next and previous links so the visitor can page through the results.
Filtering
Applies filters to include or exclude assets from the list. For details, see Understanding dynamic list filters.
Pinned Items
A list of assets that always appears first in the dynamic list. These assets do not need to satisfy the other filtering requirements. For example, if a pinned asset is 60 days old, and the Time Period is 30 days, Brightspot includes the pinned asset anyway.
Advanced
Disable Dynamic De-Duplication?If toggled off, ensures assets in the list appear nowhere before the list itself on the rendered page. If toggled on, assets in the list may appear before the list itself on the rendered page. For example, you have a dynamic list in the above layout block, and an embedded dynamic list in the rich-text editor; this toggle determines if the same asset can appear in both lists.
Allow Non PermalinkedIf toggled on, assets without a permalink may be included in the list.
SitesLimits included assets to those published on certain sites.
LocalesLimits included assets to those published in certain locales.
Sponsored ContentLimits included assets depending if they are sponsored content.

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