Gretyl's Portal

Heretto Help

Heretto Portal Search Configurations

Heretto Portal Search Configurations

You can configure certain aspects of Heretto Portal search behavior by adding settings to your main portal sitemap.

Setting

Description

Configuration

Index each reused topic in search results

By default, when a topic is reused in a sitemap, only its first instance in the sitemap hierarchy is indexed and only one result is returned in portal search results. When you click that search result, you are taken to the first instance of the topic.

With this setting, when a topic is reused in a sitemap three times, it is indexed three times and three results are returned in search results. When you click each search result, you are taken to a different place in your help site.

Configure by adding this setting to your main portal sitemap as presented in the example: <data name="content-api-search-indexing" value="each-topicref"/>

Example:

<sitemap>
    <title>(...)</title>
    <sitemeta>
        <data name="content-api-search-indexing" value="each-topicref"/>
    </sitemeta>
	(...)
</sitemap>

Index each chunk in search results

By default, when you use the chunk attribute, the chunked page gets returned in search results. For example, if you set chunk="to-content" on a parent topic with two child topics, they are returned as a single result in search results, where the title visible in search results is the title of the parent topic.

With this setting, when a search query matches two out of three chunked topics, those two topics are returned in search results. For example, when you set chunk="to-content" on a parent topic with two child topics and both child topics meet search criteria, they both show in search results as separate topics under their own titles.

Configure by adding this setting to your main portal sitemap as presented in the example: <data name="content-api-search-chunk" value="each-chunk"/>

Example:

<sitemap>
    <title>(...)</title>
    <sitemeta>
        <data name="content-api-search-chunk" value="each-chunk"/>
    </sitemeta>
	(...)
</sitemap>