Use Khoros (Lithium) As a Content Source

This article explains how to index the ideas, blogs, reviews, groups, and other content types on your Khoros-powered brand community.

PREREQUISITES.

• Admin user in SearchUnify.
• A non-empty Khoros (Lithium) community
• Event Subscription for MessageMove, MessageDelete, MessageCreate, and other objects depending upon your community. A subscription enables SearchUnify to crawl articles that are updated or move across boards. Write to support@khoros.com to subscribe.

PERMISSIONS.

SearchUnify respects board-level access. It shows results to users if the parent board is accessible to the user in the Khoros community. Content permissions are adhered to as long as the search client is installed in a Khoros community. For search clients installed on platforms other than Khoros, search is limited to open boards.

Establish a Connection

1. Navigate to Content Sources.

   

2. Click Add New Content Source.

   

3. Find Khoros from the search box and click Add.

   

4. Give your content source a name.

   

5. Enter the web address of your brand community in Client URL.

   

6. From the Language dropdown, select the primary language of your community.

   

7. Select an Authentication Method.

   RELATED. Which Authentication Method to Select for Lithium?

   

8. Click Connect.

   

Set Up Crawl Frequency

The first crawl is always manual and is performed after configuring the content source. For now, keep the frequency to its default value Never and click Set and move to the next section.

Archived and spam messages are deleted each hour.

Select Fields for Indexing

You can index your entire community data, or only a subset of it. The platform supports all the eight Khoros (Lithium) interaction styles out-of-the-box: blog, forum, group, idea, qanda, review, tkb, contest.

Support for Group Hubs, nested categories (Category_nested and Category_flat), and a native-filter Topics with No Result (renamed to Replied) was introduced in Colubridae '21. If your Khoros content source has been set up after that, you will see those fields in all Khoros objects. However, if the content source was configured before C'21, then a way to view those fields is to create a new Khoros content source from scratch.

Admins can set up Group Hubs in Boards. As for Replied, it works when it has been crawled in Search Clients > Edit > Content Sources.

1. Click to select a Khoros (Lithium) interaction style.

   

2. Add content fields one at a time. Each field corresponds to an interaction style field.

   

3. OPTIONAL. Each field is assigned a label and a type, but they can be changed. You can enter a new value in Label and select boolean, number, datetime, or string in Type.

   

4. OPTIONAL. Pick a value in Select. If the value of a field is isSearchable, the data appears in search results. But if the value is isFilterable, the field will be used as a facet.

   

5. Click Add.

   

6. Repeat the steps 2–5 for other fields and Save.

   

7. Repeat the steps 1-6 for other Khoros (Lithium) objects, and navigate to By Boards.

   

8. Find your boards with the index. A board named "Discussions" is found under "D" and a board named "Xenon" under "X."  If you have added or deleted a board, use Reindex to view the latest list of boards. If no board is selected, then SearchUnify will index data from all the boards.

   

9. Check Enable and click Save.

First Crawl

Return to the Content Sources screen and click in Actions. The number of indexed documents is updated after the crawl is complete. You can view crawl progress in in Actions. Documentation on crawl progress is in View Crawl Logs.

NOTE 1

Review the settings in Rules if there is no progress in Crawl Logs.

NOTE 2

For Mamba '22 and newer instances, search isn't impacted during a crawl. However, in older instances, some documents remain inaccessible while a crawl is going on.

Once the first crawl is complete, click in Actions open the content source for editing, and set a crawl frequency.

1. In Choose a Date, click to fire up a calendar and select a date. Only the data after the selected date is indexed.

   

2. Use the Frequency dropdown to select how often SearchUnify should index the data. For illustration, the frequency has been set to Weekly and Tuesday has been chosen as the crawling day. Whenever the Frequency is other than Never, a third dropdown appears where you can specify the interval. Also, whenever Frequency is set to Hourly, then manual crawls are disabled.

   

3. Click Set to save crawl frequency settings. On clicking Set, you are taken to the Rules tab.