Lists

A list module 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 static (they never change) or dynamic (such as listing the 10 most recent related stories). Lists can contain other lists or any other module.

You can create a list module at any level of the Content Hierarchy. All assets you create inherit the list module from the nearest available level in the content hierarchy.

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.

  1. Under Module Placement, scroll down to the module’s placement (Above, Aside, or Below). For an illustration of these positions, see the diagram in Modules.

  2. From the list box, select Add After. For an explanation of the possible selections for module placement, see Module Placement.

  3. From the Add drop-down list, select List. A List form appears.

  4. In the Title field, enter a title.

  5. In the Description field, enter a description. For an explanation of the buttons on this field’s toolbar, see Rich Text Editor.

  6. From the Items list select Basic.

  7. Click Add Item. A Selection Field appears.

  8. Click the selection field. The Content Picker appears.

  9. Click the item in the content picker, or create a new item.

  10. Close the content picker. You return to the List form, which looks similar to the following:

    ../../../../_images/list-basic-form.png
  11. Repeat steps 7–10 to add additional items to the list.

  12. Click Publish.

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.

  1. Under Module Placement, scroll down to the module’s placement (Above, Aside, or Below). For an illustration of these positions, see the diagram in Modules.

  2. From the list box, select Add After. For an explanation of the possible selections for module placement, see Module Placement.

  3. From the Add list, select List. A List form appears.

  4. In the Title field, enter a title.

  5. In the Description field, enter a description. For an explanation of the buttons on this field’s toolbar, see Rich Text Editor.

  6. From the Items list select Advanced.

  7. From the Add list, select a module. The corresponding form appears.

  8. Fill out the module form.

    Your List form looks similar to the following:

    ../../../../_images/list-advanced-form.png
  9. Click Publish.

The previous image is an example of building an advanced list with the following modules: promo, gallery, rich text.

For information about creating different types of modules, see the following:

Downloads

A download list shows the downloads a visitor requested.

  1. Under Module Placement, scroll down to the module’s placement (Above, Aside, or Below). For an illustration of these positions, see the diagram in Modules.

  2. From the list box, select Add After. For an explanation of the possible selections for module placement, see Module Placement.

  3. From the Add drop-down list, select List. A List form appears.

  4. In the Title field, enter a title.

  5. In the Description field, enter a description. For an explanation of the buttons on this field’s toolbar, see Rich Text Editor.

  6. From the Items list select Downloads.

  7. In the Items Per Page field, enter the number of downloads to display per page.

  8. From the Sort list, select the sort direction.

    Your List form looks similar to the following:

    ../../../../_images/downloads-form.png
  9. Click Publish.

Dynamic Lists

Dynamic lists are lists whose content satisfies various criteria. Examples of dynamic lists are reader comments (which continually change), lists of related articles, and playlists of trending videos.

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 the database to find the content matching the search criteria, and then populates the list accordingly.

  1. Under Module Placement, scroll down to the module’s placement (Above, Aside, or Below). For an illustration of these positions, see the diagram in Modules.

  2. From the list box, select Add After. For an explanation of the possible selections for module placement, see Module Placement.

  3. From the Add drop-down list, select List. A List form appears.

  4. In the Title field, enter a title.

  5. In the Description field, enter a description. For an explanation of the buttons on this field’s toolbar, see Rich Text Editor.

  6. From the Items list select Dynamic. A form appears.

  7. Add selection criteria from the Types, Time Period, and other selection fields. For example, selecting Article from Types and Dickens from Authors retrieves articles written by Charles Dickens.

  8. In the Items Per Page field, type the number of items to include in each page list.

  9. From the Sort list, select the list’s sort order.

  10. In the Pinned Items field, define an item that always appears at the beginning of the dynamic list. For details about creating pinned items, see Promos.

  11. In the No Results Module field, select a module to display if no items match your selection criteria from step 6.

    Your form looks similar to the following:

    ../../../../_images/list-dynamic-form.png
  12. Click Publish.

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

  • Published within the last 30 days.
  • Published within the section Hubble.

Dynamic Social Feed

Dynamic social feeds pull postings from social networks into a list. You can also add a promo to this list.

  1. Under Module Placement, scroll down to the module’s placement (Above, Aside, or Below). For an illustration of these positions, see the diagram in Modules.

  2. From the list box, select Add After. For an explanation of the possible selections for module placement, see Module Placement.

  3. From the Add drop-down list, select List. A List form appears.

  4. In the Title field, enter a title.

  5. In the Description field, enter a description. For an explanation of the buttons on this field’s toolbar, see Rich Text Editor.

  6. From the Items list select Dynamic Social Feed. A form appears.

  7. Under the Main tab, do the following:

    1. In the Max Posts field, enter the maximum number of posts to retrieve from the social networks.
    2. Under Feed Providers, do the following:
      1. Click the control for a provider, such as Add Facebook.
      2. Click Account, and from the Content Picker select a social network.
      3. (Facebook feeds only) In the Page Name field, enter a page name.
    3. Under Pinned Items, click Add Promo and create a promo. For details, see Creating a Promo Module.

    Your List form looks similar to the following:

    ../../../../_images/list-dynamic-social-form.png
  8. Depending on your current theme, there is an Overrides tab with additional fields you can use to further define the module.

  9. Click Publish.

Playlist Videos

A video playlist is a list of videos pertaining to a similar topic.

  1. Under Module Placement, scroll down to the module’s placement (Above, Aside, or Below). For an illustration of these positions, see the diagram in Modules.

  2. From the list box, select Add After. For an explanation of the possible selections for module placement, see Module Placement.

  3. From the Add drop-down list, select List. A List form appears.

  4. In the Title field, enter a title.

  5. In the Description field, enter a description. For an explanation of the buttons on this field’s toolbar, see Rich Text Editor.

  6. From the Items list select Playlist Videos. A form appears.

  7. From Playlist, click the selection field, and from the content picker select or create a playlist.

  8. In the Items Per Page field, enter the number of items to appear in each page of the playlist.

  9. Depending on your current theme, there is an Overrides tab with additional fields you can use to further define the module.

    Your form looks similar to the following:

    ../../../../_images/list-playlist-video-form.png
  10. Click Publish.

The previous image is an example of a video playlist that displays 10 videos per page.