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.

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 Examples of Module Placement.

  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 an 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 Examples of Module Placement.

  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.

  9. From the Call to Action list, select a call to action.

    Your List form looks similar to the following:

    ../../../../_images/list-advanced-form.png
  10. 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:

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 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 Examples of Module Placement.

  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 criteria from the Types, Member Affinity Type, and other selection fields. For example, selecting Article from Types and Recipes from Tags retrieves articles tagged as recipes.

  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.

    Your form looks similar to the following:

    ../../../../_images/list-dynamic-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 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 Examples of Module Placement.

  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 networking account.
      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 Promos.

    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.