Community

Product DocsMenu

Configuring the Culture of a Search Hub With the .NET Interface Editor

When the end-users of your Coveo .NET Front-End search interfaces work in different languages or from different countries, you can configure some aspects of the search interfaces to adapt to their culture.

You can configure the following cultural aspects:

  • The language(s) for the stemming expand of query terms (see About Stemming).

  • The language of the text elements appearing in the search interface (default, dynamically adapt to the browser language settings, custom). The Coveo search interfaces are available in several languages (see Supported Languages).

  • The format of date and time values appearing in the search interface

The procedure below describes how to set culture parameters at the search hub level, thus affecting all search interfaces contained in the search hub. When needed, you can also set the culture parameters for a specific search interface to override the otherwise inherited search hub settings (see Configuring the Culture of a .NET Search Interface).

Note: You can also specify the available languages in which the search interfaces can appear (see Configuring the Available .NET Search Interface Languages).

To configure the culture of a search hub with the .NET Interface Editor

  1. Access the Coveo .NET Front-End Interface Editor (see Opening the .NET Interface Editor).

  2. Select the search hub for which you want to globally set the language and the date/time formats:

    1. Click the Search Hubs tab, and then click the Features menu.

    2. On the menu bar, in the Current Hub drop-down list, select the hub for which you want to make changes.

  3. In the navigation panel on the left, click Culture.

  4. In the panel on the right:

    1. Under Language Specific Query Processing, select one of the following options to determine the language or languages used by the stemming algorithm to expand the query:

      Automatic language selection based on index content

      Expands queries only for the dominant languages detected in indexed documents. This option is useful to maximize search results for terms from the most frequent languages detected in your unified index.

      Example: When the bulk of your unified index contains English, Spanish and German document, queries are expanded only using English, Spanish and German stem classes, not stem classes for other less frequent languages found in your unified index.

      Inherit search interface language

      Expand queries only for the language of the search interface. This option is useful to optimize search results expansion for the language of the search interface.

      Example: In a global enterprise, the query of an employee using a German search interface is expanded using German stem classes. The search results will likely contain more German terms and documents compared to the same query performed from an English search interface.

      All supported languages

      Expand queries for all supported languages found in your unified index (see Supported Languages). This option is useful to maximize search results to all supported languages, but can produce more complex expansions and therefore increase query response time.

      Custom list of languages

      Always expand queries for selected languages. Select one of more languages in the Available Languages list, and then click the right-arrow to move them to the Selected Languages list.

    2. Under Search Hub Culture, select one of the following options to set the default language in which the search interface text elements appear:

      Default culture

      With this option, the search interfaces appear in the culture specified in the web page that displays the search hub. When the web page does not specify the culture, the default culture parameters are taken from the culture settings of the web server from which the web page originates.

      Example: By default, the Default.aspx file that comes with CES is the web page that displays the search hub. This file does not specify the culture (<%@ Page language="c#" %>). The search hub therefore takes the culture from the server settings.
      You can also use one of the culture ready web page files to display the search hub. For example, the Default-es.aspx file specifies the Spanish culture (<%@ Page language="c#" culture="es-ES" uiCulture="ES" %>). The search hub default culture is therefore independent from the server culture settings.

      Important: The Coveo search interfaces are available in several languages (see Supported Languages). When a translation for the language of the selected culture is not supported, the search interface text elements appear in English.

      Client browser language preference

      The search interface culture is determined by the client browser preferences. This option is useful to dynamically switch the language of the search interface to match the language in the browser of each user.

      Custom

      Select this option to specify a culture using the form <language_code>-<country_code>. This option is useful to force the search interface text elements to a specific language, independently from the web page, web server, or client browser settings.

      Example: Enter en-GB for the Great Britain English culture.

      The language is selected independently from the specified country.

      Example: Entering fr-FR or fr-CA selects French as the language for search interface elements in both cases.

      Note: Refer to the Microsoft National Language Support (NLS) API Reference document for a list of available culture names.

    3. Under Date and Time Formats, select one of the following options to set the default formats for date and time values:

      Default formats

      Uses the standard formats for date and time values associated with the selected search hub culture.

      Custom

      Select this option to force multi-language formats for Short time format, Short date format, and Long date format using custom date/time format strings.

      Example: Entering dddd, dd-MM-yyyy in Long date format displays the date 2011-01-15 as Saturday, 15-01-2011..

      Click the button next to the boxes () to open a dialog box where you can customize the format for each supported search interface language.

      The search interface culture determines which of the format will be used.

      Example: When the culture is fr-FR or fr-CA, the French date and time formats are used.

      When the language of the search interface culture is not defined in the above dialog box, the formats associated with English are used.

      Example: When the culture is it-IT, the English date and time formats are used as Italian is not a supported user interface language.

      Note: Refer to the Microsoft Date and Time Format Strings document for details on standard and custom date/time format strings.

    4. Click Apply to make changes effective for all search interfaces of the selected search hub.

  5. When you want to set different language or date/time settings for a specific search interface:

    1. Click the Search Interfaces tab, and then click the Features menu.

    2. On the menu bar, in the Current Interface drop-down list, select the search interface for which you want to make changes.

    3. In the navigation panel on the left, click Culture.

    4. In the page that appears, under Search Interface Culture, select one of the following options to set the language in which the search interface text elements appear:

      Default culture

      With this option, the default search interface culture is inherited from the search hub settings. When the search interface is displayed outside of a hub, the search interface appears in the language specified in the web page from which it is displayed. When the web page does not specify the culture, the culture settings are taken from the server culture settings.

      Client browser language preference

      The search interface culture is determined by the client browser preferences.

      Custom

      Select this option to specify a fix custom culture using the form <language_code>-<country_code>.

    5. Under Date and Time Formats, select one of the following options to set the default formats for date and time values:

      Default formats

      With this option, the data and time formats are inherited from the search hub settings or, when the search interface is displayed outside of a hub, from the search interface culture.

      Custom

      Select this option to force multi-language formats for Short time format, Short date format, and Long date format using custom date/time format strings.

      Click the button next to the boxes () to open a dialog box where you can customize the format for each supported search interface language.

      The search interface culture determines which of the format will be used. When the language of the culture is not defined in the dialog box, the formats associated with English are used.

    6. Click Apply to make changes effective for the selected search interface.

People who viewed this topic also viewed