Improve project discoverability, tap into relevant feedback, and cross-promote at scale by connecting EngagementHQ to your OpenCities website.

With the EngagementHQ x OpenCities connector, you can:

  • Link to EngagementHQ projects on your OpenCities homepage

  • Automatically surface EngagementHQ projects in OpenCities search results

  • Surface location-based projects in My Area

  • Highlight projects in navigation using Top Tasks

  • Suggest relevant projects while residents browse related content using content labels

By linking your OpenCities account, you permit EngagementHQ to surface publicly visible projects within OpenCities search results. This article will cover:

The ability to manage EngagementHQ projects in the OpenCities CMS is available to OpenCities customers who hold the OpenCities Site Manager, System Administrator and Developer roles by following the instructions below.

Configure the connection in your EngagementHQ environment

To configure the connection, you'll need access to your EngagementHQ and OpenCities admin; we recommend opening both in separate tabs before you start.

  1. In your EngagementHQ admin, go to Marketplace and select OpenCities.

  2. Select Edit Settings in the top right of the page; then, you'll need to populate the App ID, API key, Admin URL, and Folder path fields with information from your OpenCities admin.

  3. Switch over to your OpenCities admin and go to More > API Management.

  4. Copy and paste the App ID and API Key into the corresponding fields in EngagementHQ.

  5. Copy and paste your admin URL (the URL you use to log into your OpenCities admin site) into the corresponding field in EngagementHQ.

  6. Select your EngagementHQ parent folder in the site tree to find the Folder path. Select the folder path below the title to expand the internal link, and then copy and paste it into the corresponding field in your EngagementHQ admin.

  7. Once all the fields in your EngagementHQ settings are filled, select Save.

Now that the Connector has been enabled in your EngagementHQ admin, publicly visible projects will start syncing and displaying on your OpenCities site over the next 24 hours.

How to use the connector

Once the EngagementHQ x OpenCities Connector has been enabled, the OC EngagementHQ Project content type will be available on your OpenCities site.

Additionally, a parent folder for EngagementHQ projects will be created in your site tree. All projects synced over from EngagementHQ will be produced as OC

EngagementHQ Project child pages under the parent folder.

You can now configure how your projects will display on your OpenCities site and add metadata to make the project easier to find, including:

  • Adding keywords to improve search results

  • Adding content labels to show projects in dynamic content lists

  • Adding locations to show projects on maps, including My Area

Display EngagementHQ projects in site search

To allow residents to find projects using your internal site search, you'll need to enable the content type in the Site Search Settings.

  1. Go to More > Site Management > your site > Settings > Site Search.

  2. Under Select which content types are included in site search, check the box for OC EngagementHQ Project.

  3. If you have previously checked Yes to Include the same content types in the predictive search, then your OC EngagementHQ Project pages will automatically surface in your predictive search. If not, ensure the content type is checked under Select which content types are included in the predictive search.

  4. Select Save Settings and Save.

By default, OC EngagementHQ Project pages will be hidden from external search engines so they won't index duplicate results.

Display EngagementHQ projects on your homepage

You can configure projects on your homepage, including how they are filtered and sorted and display.

  1. Go to More > Site Management > your site > Settings > Community Engagement, and expand the Manage the content that appears on the site listing accordion menu.

  2. Under Select content types, ensure the OC EngagementHQ Project content type is selected, and choose how your projects are sorted and ordered on the homepage

  3. You can also use the Homepage listing call-to-action link URL field to add a call-to-action button linking back to your EngagementHQ site to your homepage listing.

  4. Select Save Settings and Save.

You can also pin or hide each project page on your homepage.

Now, you need to configure your homepage to display your projects. There are two ways you can do this.

List projects in a homepage tab

  1. In your site tree, right-click on your homepage tab folder and create a new OC Tab Widget page.

  2. Add a Page name and Tab Label, then select OC Homepage Consultation Listing from the Template Name dropdown menu.

  3. You can Preview what will appear on the listing, but you'll need to Publish the page to see it live on your homepage.

List projects in a homepage row

To list projects in a homepage row, you'll need to edit your theme; for this, you'll need the OC Site Designer role.

  1. Go to More > Themes Management > your theme > Layout.

  2. Select Add row, then drag and drop the Consultation list into your new row.

  3. Select the Maximum number of items to display on your homepage list, and choose if you want to show them in Rows or a Carousel.

  4. Select Apply, then Preview your theme.

  5. Publish your theme when you're ready. Remember, if you Publish a theme that's in use on your site, your changes will be live immediately.

Display EngagementHQ projects on maps

You can configure maps to display OC EngagementHQ Project pages, including listing them on your My Area map so residents can check out what consultations are around them.

To do this, you'll need to edit maps and layers, for which you'll need the OC Map Manager role.

  1. Go to More > Maps > Layers.

  2. Select Create layer, or select an existing layer to edit it.

  3. Fill out all the fields for your layer, ensuring you specify OC EngagementHQ Project under Content types to include.

  4. Save your layer, then go to Maps.

  5. Select your map from the list and go to the Layers tab.

  6. Select Add a shared layer, locate your EngagementHQ layer in the list and select Add to map.

  7. Preview and Save your map.

Remember that OC EngagementHQ Project pages must have the Latitude Longitude field populated in OpenCities before they display on a map.

FAQs

If I change my EngagementHQ project, will the updates flow through to OpenCities?


Yes, any updates to EngagementHQ projects will be visible in OpenCities. You will have to wait for the project to sync for the changes to be visible on OpenCities. Content will only synchronize in one direction, from EngagementHQ to OpenCities.

If I make updates in OpenCities, will that change anything in EngagementHQ?


No, any updates to OpenCities will not change EngagementHQ projects. Content will only synchronize in one direction, from EngagementHQ to OpenCities.

What updates can I make to the project in OpenCities?
When projects sync across from EngagementHQ, they will be created as OC EngagementHQ Project pages. In order to keep content consistent across both platforms, some fields will be locked in OpenCities; here is what you can and cannot edit:

  • Page name: unlocked

  • Project Title: locked

  • Project Description: locked

  • Project Image: unlocked

    Note: this content will not sync from EngagementHQ; you will need to add it manually.

  • Project URL: locked

  • Latitude Longitude: unlocked

    Note: this content will not sync from EngagementHQ; you will need to add it manually for the project to display on maps.

  • Choose how this content will display on homepage listings: unlocked

  • Additional Information section: unlocked

  • Project Dates: unlocked

    Note: this content will not yet sync from EngagementHQ; you will need to add it manually for the project to display on the homepage listing.

How frequently does the sync run?
The sync is set to run every 4 hours.

Can I manually sync projects?
You cannot manually sync projects from OpenCities. The only way to force a sync is to go to the connection settings in your EngagementHQ environment and select Save. This will manually start an immediate sync. Please note that if there are many updates to sync across, it could take some time before they are all visible on your OpenCities site.

Can any user configure the connector?
No, only users with the OC Site Manager, OC System Administrator, or OC Developer roles in OpenCities. Users who have access the marketplace pages on EngagementHQ include Site Administrator or Hub Administrator roles.

Will all EngagementHQ projects be displayed in OpenCities, including Protected, Hidden, Static, Published, and Archived?
Project visibility will be respected in the sync (public, private, paneled);

Content that will be synced:

  • Published project pages with public or panelled visibility

Content that will not be synced:

  • Project pages in draft

  • Project pages with private visibility or password protection

  • Static pages, such as privacy policies, terms and conditions, or hub pages

Will EngagementHQ projects be indexed on search engines for OpenCities sites and EngagementHQ sites?


By default, each project page in OpenCities will be hidden from external search engines, so they don't cannibalize EngagementHQ search engine results.

If you move the folder in OpenCities, does it stop the connector from working?


If you move the folder in OpenCities, the connector will stop working. If you must use a new folder, please create it in its correct location and update your connector configuration details in EngagementHQ with the new folder name. Once you have updated your configuration and pages have been synced to the new folder, you can copy any manually entered details over from the older pages and delete or archive the old directory.

If you rename the folder in OpenCities, will the connector stop working?


If you rename the folder in OpenCities, the connector will stop working. If you must rename your folder, please create a new folder and update your connector configuration details in EngagementHQ with the new folder name. Once you have updated the configuration and pages have been synced to the new folder, you can copy any manually entered details over from the old pages and delete or archive the old directory.

Does the participation type need to be set to "Anyone"?


No, participation type impacts which users can contribute to tools within a project. It does not impact whether or not a project will be synced. Once a project is published and public, it will be synced and displayed.

Can I connect my EngagementHQ site to multiple OpenCities sites?


No, you cannot connect EngagementHQ to multiple OpenCities sites. Only one EngagementHQ site can be connected to one OpenCities site.

What's the number next to the Page name?


This is a page's unique identifier to ensure it can be created in OpenCities without any errors. This number will not display in OpenCities.

How is the Project Description populated in OpenCities?


The Project Description will be populated with the first 400 characters of the EngagementHQ project summary.

Why are my projects not appearing on my homepage?


Dates are not synced. To ensure the projects display on the homepage, please update the Project Dates to be ongoing or have a closing date in the future.

What if my organization uses the OpenCities Community Engagement module as well?


If your city or council uses the OpenCities Community Engagement module, your Community Engagement Site Management settings will also display options for the content types in that module. You can also choose whether you want to display both OC Consultation and OC EngagementHQ Project pages in your listings.

Helpful Resources

OpenCities Configuration Guide

Display EngagementHQ projects on OpenCities Homepage


Did this answer your question?