Index With the BasicHtmlContentInBodyProcessor

This is for:

Developer System Administrator
Important

The recommended Coveo for Sitecore HTML processor is the FetchPageContentProcessor processor (see Index Page Content with the FetchPageContent Processor).

This method is the simplest way to enable full-text search on Sitecore items.

When indexing a Sitecore item, an HTML representation is generated containing the field names and values. This HTML content is then used for full-text search as well as for the Quick View.

Note that the basic HTML content processor returns the raw value of a field directly, not the rendered value. This means that you can’t use it to add the rendered value of a computed field to the HTML representation.

Configuring the Basic HTML Content Processor

  1. Open the Coveo.SearchProvider.Custom.config file in a text editor. By default the file is located in <SITECORE_INSTANCE_ROOT>\website\App_Config\Include\.

  2. Locate the coveoPostItemProcessingPipeline element (see About the coveoPostItemProcessingPipeline Pipeline).

  3. Insert the following processor sub-element right under:

    <processor type="Coveo.SearchProvider.Processors.BasicHtmlContentInBodyProcessor, Coveo.SearchProviderBase"/>

  4. Re-index the Sitecore items.

  5. You can now perform full-text search on this HTML content.

Options on the Processor

A few options are available on the processor:

Name Description Example value

IncludeFieldNames

Whether the field names should be added to the HTML content or not.

true/false

IncludeTextFieldsOnly

Whether to add only plain text fields (type="Sitecore.Data.Fields.TextField,Sitecore.Kernel" fields) in the HTML content (e.g., Single-Line Text fields).

true/false

FieldsToInclude

Comma-separated list of fields to include.

Name,DisplayName

TemplatesToInclude

Comma-separated list of templates to include.

Sample Item,Device

Options can also be configured using the following code block, still under the coveoPostItemProcessingPipeline element in the Coveo.SearchProvider.Custom.config file:

<processor type="Coveo.SearchProvider.Processors.BasicHtmlContentInBodyProcessor, Coveo.SearchProviderBase">
    <IncludeFieldNames>false</IncludeFieldNames>
</processor>