Welcome to the OpenCities help centre. Search for what you're after, or browse the categories.
Can't find what you're looking for? Submit a support ticket and we'll be in touch.


About the Related content module

avatar of OpenCities Product Team

OpenCities Product Team

Last updated

Using the Related Content module, you can direct your community to relevant pages which reflect their current browsing.

The Related Content module automatically adds content lists of relevant pages to the bottom of individual pages. The module is set by content type, and you can filter the lists by content label, content type, and location in the site tree, so you can target specific pages.

Before you can do this, however, you need to turn on the Related Content module.

Turn on the Related content module

This task can be undertaken by users with the following roles: OC Site Manager and OC System Administrator.

The Related Content module must be turned on and configured for each site you wish to use it on.

The related content module settings

Here's how to do it:

  1. Go to More > Site Management > your site > Settings > Related Content
  2. Check the option Turn on for this website.
  3. Choose your Site-wide setting option, either Show on pages by default or Hide on pages by default.
  4. Select Save Settings.

The Site-wide setting mentioned here applies only once you have set up the Related content module for each content type; it does not enable and display related content on its own. We recommend choosing Hide on pages by default for a cleaner browsing experience.

What can I do with Related Content?

There are many lists you can automate using the Related Content module, and here is just one example. Using related content on your OC Event content type, you can set up automated lists, that are filtered by content labels, to show other events targeted towards the same audience or located at the same venue. 

A related content list on a families and kids event page, showing other similar events

As you can see in this example, Point Russell has set this family-oriented event to show other events with the same content label. To do this, they have set the related content for their events to show a list based on certain content types and labels. Their filter settings have been set to show other OC Event pages with the 'Has any content label from current page' content labels setting, they've set it to show 3 items and included content from the whole site tree. Using this particular content label setting creates a content list that is partially specific, and they have further specified this by only listing the OC Event content type. So this event will show other events that have any of these labels: 'kids & families', 'pets' or 'festivals'.

To specify your list even further, you would select the 'Has all content labels from current page' setting when filtering by content labels. This is useful when you want to set Related Content lists for OC Project pages, for example, when you want to show other projects in the area. To make this list, you would filter your Projects Related Content list by OC Projects, all the content labels from the current page, 3 items to display, and include content from the whole site tree. For each project page that you want to include you would ensure that the project has all of the labels that are on the original project page. This could include labels referring to the type of project or the location of the project. 

Please note that you can only set up one related content list for each content type. In the above examples, Point Russell has set up the Events content type to show other similar events and the Venues content type to show other events at the particular venue.

Next steps:

  1. Set up the Related content module for each content type
  2. Or, build a content list on individual pages (separate from the Related Content module)
  3. Looking for a bit more inspiration? See our article on ideas for using content lists.
Was this article helpful?
0 out of 0 found this helpful