Set Up Content Collections

Now that you've seen what you can do with content collections, let's take a look at how to set one up. The process is simple because you don't have to change anything about your content channels or calendars, or how they're structured. You'll want to think strategically about your collections, to ensure you've got the right content in the right places. For instance, you might have a content collection for resources, or a collection of all of your messages, devotionals, and blogs. You can have as many content collections as you need, and you can use the same content in more than one collection.

We'll start by navigating to Admin Tools > CMS Configuration > Content Collections. As pictured below, we'll be looking at an example content collection called "Resource Library".

  1. Name / Description - Provide a meaningful name and a strong description. When you're setting up the Content Collection View block, only the name of the content collection will be visible.
  2. Key - The key needs to be unique across all content collections. Typically, you'll want to provide a key that easily identifies the content collection without being too long.
  3. Enable Trending - People using the Content Collection View block can choose to sort the search results according to what is trending. For instance, content channel items with the most views will be at the top of results. See the Trending section below for details on how this is calculated. Rock uses Interactions to track views, so the Content Channel Item View block(s) you're using need to have Log Item Interaction enabled under Visitor Settings.
  4. Enable Personalization - You can choose to look at Segments, Request Filters or both, to find content channel items that match the person or their visit. You can bring matching items to the top of the results list by adjusting the block settings for the Content Collection View block.
  5. Trending Window - This is simply the number of days to look back for trending data. This helps keep your trending data fresh and relevant.
  6. Trending Item Count - In this example, only the top 10 trending items will be marked as trending. There needs to be a cutoff, otherwise every item would be considered trending if they were viewed at least once.
  7. Trending Gravity - This applies to items that are new or more recent. Because these items haven't been around long enough to score lots of views, you can choose to give them more weight. The result of this would be that a new item could be considered trending even if it has fewer views than other older items.
  8. Rebuild Index - Click this button to re-index the items in your collection. This ensures all the items in your collection are accounted for and can be searched. The Index Content Collections system job will do this for you automatically overnight, but you may want to manually rebuild the index to capture changes made during the day.

The items above define the framework of your content collection overall. Next, we need to add actual content to the content collection. Pictured below you can see we've added two content channels and a calendar to the content collection. Keep in mind that we didn't need to change anything with the content channel or the calendar. Your existing configuration will work as-is.

  1. Rebuild Index - Click this button to re-index the items in your collection. This is the same button as described in the prior screenshot above. Remember that the Index Content Collections system job will automatically rebuild the index every night.
  2. Content Sources - Here we're looking at content sources. In the next screenshot below, we'll show you what it looks like when we toggle over to the Search Filters view.
  3. Add Item - From here you can choose to add a new calendar or content channel to the content collection.
  4. Sources - This is a listing of all the content sources included in your collection. In the remaining points below, we'll go into the options you have for each source.
  5. Item Count - This is simply a count of how many items (content channel items, event items) each source has. Here we can see there are 19 content channel items under the Messages content channel.
  6. Move Source - The order of the content sources influences the order in which items will appear in the Content Collection View block. For instance, if we had Search on Load enabled in the Content Collection View block for this example content collection, then event items from the Public calen
  7. Edit Content Source - For calendars and content channels you can click this to indicate which item attributes should be added to the index. In other words, you can select which attributes to use as filters on the Content Collection View block. For calendars, you can additionally choose how many future occurrences to show.
  8. Delete Source - This one's pretty obvious.

When you're adding a source you have a few options available to you. Primarily, you can select which attributes you want to use as filters on the Content Collection View block.

  1. Attributes to Include - Simply check the box next to any attributes you want to have available as filters on the 
  2. Custom Values - This is an advanced setting that lets you do things like create custom filters.

We're not done with this page yet. If you toggle over to the Search Filters view, you'll be able to see what we can use as filters when searching for content from the Content Collection View block.

  1. Search Filters - Here are your overall search filters, which apply more to the content collection as a whole. Generally, the Full Text Search and Year options will always be available.
  2. Attribute Filters - This is where the filters that come from item attributes are listed. This is controlled by the selections made under the Content Sources tab (see prior screenshot above).
  3. Edit Filter - Click here to enable or disable each search filter. For some search filters, such as the Year filter in this example, you have additional options. First, you can change the name of the filter. Then you can decide how the selectable options for that filter will appear on the Content Collection View block (either pills or dropdown). Lastly, you can choose a filter mode (either single-select or multi-select).