Page Index Element

Display a list of links that is automatically populated based on rules you provide.

Prerequisites

This tutorial assumes you already know the following:

Overview

What Are Page Index Elements?

Page Index elements are used to display lists of links based on rules you give it. You can have as many/few rules per page index element as you want.

Some possible uses:

  • Creating a list of recently created pages for your department.
  • Creating a list of all pages owned by your department for internal use.
  • Creating a list of all downloadable forms that have been tagged with a certain keyword.

The uses are certainly not limited to the above.

For a real-life example, if I create a CommonSpot tutorial page and tag it with the keywords "tutorial" and "elements" it will automatically show up in the Elements section without me having to go in an create a link.

What Do They Look Like?

By default, page index elements just display a list of links with no other information:

A page index element using the default layout

By changing the element's layout, you can show other things like the page's author, creation date, description, or whether or not it's new.

Here's a the same page index, showing each page's description as well:

Page index element showing page descriptions

We have also created some custom layouts to display even more information for certain types of pages.

This page index element is using a news layout to show what kind of news item it is, and which department published it:

Page index element with the news render handler

Insert the Page Index Element

  1. Decide which container you would like to put the element in.
  2. Add a new page index element, located at the bottom of the Hyperlink Elements section.
  3. Define the new page index element.

Some Examples

Since there are so many options to choose from and ways of using page index elements, we thought it best to just show you some step-by-step examples.

Display a List of All Department Pages

It's sometimes useful to have an overview of all pages in your department, grouped by subsite (folder).

Create Your Filter

This filter can be created in both the Standard and Advanced tabs, but assumes you are using Standard.

  1. Select your department's root subsite from the drop-down menu next to Subsite.
    • Human Services' root subsite would be "/government/departments/human-services/"
  2. Make sure Include Child Subsites is checked.
  3. If you would like to see pages that are set to be published in the future, uncheck Exclude Pages with Publication Date in the Future in the Other section.
  4. If you would like to see pages that have expired, check the box next to Show Expired Pages.
  5. Under Categorization, Sorting, & Description Options set the Categorization to Subsite.
  6. Click OK.

You now have a list of all pages in your department's section of the site, grouped by subsite. Each time a page is added it will show up here.

This is great, but sometimes it's nice to see more detail about each page before clicking on it.

Display Page Descriptions

Let's add page descriptions to each link so we know what each page is for.

  1. Click on the element's edit icon in the upper-left corner of the element. It is probably yellow at this point.
  2. Click on the Layout button.
  3. Click on Title and description.
  4. Click Finish.

Now the links are much more usable.

Creating a List of Profiles

Small profile renderhandler

Create a list of short profiles, each linking back to the full profile page.

Create Your Filter

This filter will be best created in the Advanced tab.

  1. The first rule gets all pages in your Profiles folder.
    1. Field: Subsite
    2. Operator: Equals
    3. Value: Your Profiles folder
  2. Change the -Select- drop-down menu to be AND to bring up another rule option.
  3. The second rule returns only "Contact Info and Biographies" pages.
    1. Field: Global.Content Type
    2. Operator: Equals
    3. Value: Contact Info and Biographies
  4. Change the -Select- drop-down menu to be AND to bring up another rule option.
  5. Optional: The third rule limits profiles to your department/organization (use this if there are profiles from several departments in one folder).
    1. Field: Global.Department
    2. Operator: Contains
    3. Value: Your department (click on the little gray circle with lines)

You now have a list of links to your department's profiles, but it would be more useful if it displayed more information for each link.

Apply a Layout

The Profile List layout shows the person's name, title, phone number, and links back to the original profile page for more contact options.

  1. Select Profile List from the list of available layouts for this element.

You now have a formatted list of profiles on your page that will be updated automatically when profile elements/pages are changed, added, or deleted.

Show the 3 Latest News Articles for Your Department 

Page index element with the news render handler

Since each news item is created in your News folder, it's relatively easy to pull a list of the news items.

Create Your Filter

This filter will be easier to create in the Advanced Tab.

  1. The first rule will get all pages in your News folder.
    1. Field: Select Subsite from the drop-down menu.
    2. Operator: Equals
    3. Value: Your News folder.
    4. This will return all pages in this folder, even if they are not news pages (like the index page), so we need to add another rule.
  2. Change the -Select- drop-down menu to be AND to bring up another rule option.
  3. This second rule will limit the above results to pages tagged with the News and Announcements category.
    1. Field: Global.Content Type
    2. Operator: Equals.
    3. Value: News and Announcements
  4. We only want the latest 3 news items, so we should sort the results by publication date.
    • Down near the bottom, under Categorization, Sorting, & Description Options, set Sort Order to Publication (Release) date, Ascending.
  5. Click OK.

Now you should have a list of each page in your News folder that has been tagged as News and Announcements, sorted by publication date.

This is nice, but the list will be huge after a while because it will keep adding links as you add new pages.

Limit the Results to 3

  1. Click on the Edit Element icon in the upper-left corner of the element (probably yellow at this point).
  2. Click on the Layout button.
  3. Check the box next to Results Limit and limit the results to the first 3 items.
  4. Click Finish.

Now you have the news 3 news items. If you add a new news page, it will show up at the top of the list automatically.

The list is there, but it's a little boring. Let's liven it up a bit.

Apply a Layout

The News: Department List layout shows the news item's tag line and what kind of news item it is.

  1. Select News: Department List from the list of available layouts for this element.

You now have a formatted list of news items on your page that will be updated automatically as you add more content to the site. It's a bit of work upfront, but these things will save you lots of time in the long run!

Was this page helpful?      



Comments are helpful!
500 character limit

Feedback is anonymous.