Presentation
This service offers a configurable search engine for pages, documents, content and users.
Add Search service
Click on Add a service ( Page tab) and choose the Search service:
Service settings
The service is configured in 5 steps:
- General service configuration
- Search context (site/pages/language)
- Criteria imposed or chosen by the visitor
- Results configuration
- Service display
Step 1: General configuration - Define the items you are looking for
|
Parameter |
Description |
Mandatory |
|---|---|---|
|
Title |
Service title |
No |
|
What we're looking for |
Select at least one type of item to search for from :
|
Yes |
|
Choice of content type |
Select the type of content to be searched. The list is updated according to the search items selected above. Configurable either using the drop-down list or the |
No (By default, All is selected) |
Step 2: Search context - Limiting the search
|
Parameter |
Description |
Mandatory |
|---|---|---|
|
Site(s) |
Select the site(s) to be searched. The available values are :
|
Yes |
|
Page(s) |
Select the pages to be searched. The list is accessible only if a site has been selected in the previous field. The available values are :
* In this case, it is necessary to select a "parent" page via the drop-down list, or via the tree view by clicking on the button. |
Yes |
|
Language(s) |
Select the language for the search. The language will be selected by default if you have selected "page filles" in the previous field. The available values are :
|
Yes |
|
Labels |
|
No |
Step 3: Add search criteria
Click on 
to add criteria :
This step allows you to add one or more criteria to the search.
A search criterion consists of :
- a field
- an operator (depending on the type of field selected)
- a value (imposed or chosen by the visitor at the time of the search)
|
Name |
Description |
|
the value |
An input field, depending on the type of criterion, is located just after this field. This field is used to enter the fixed value used to check the criterion. Example below for a Date field:
|
|
a value entered by the visitor |
When the search service is displayed, the user is prompted to enter a value. This value, entered by the user, will be used to check the criterion. |
|
a value entered by the visitor |
This option is only available for certain field types. When the search service is displayed, the user is prompted to enter one of several values from a list. This list is defined when the search service is configured, in this field. Example below for a Site field:
|
Criteria can be linked together using the operators AND, OR, )AND(, )OR(.
At the end of each criterion, the following buttons allow you to order them:
|
Button |
Description |
|
|
Deletes the associated criterion |
|
|
Adds a criterion above this criterion |
|
|
Moves the criterion below |
|
|
Moves the criterion above |
Under criteria, the following checkboxes are available:
|
Name |
Description |
|
Display number of results for listed criteria |
When the box is checked, the criteria listed will display the number of results in brackets next to the choice to indicate to the visitor which choices are most commonly used. |
|
Memorize values entered by visitors when they log on |
When the box is checked, the criteria entered by a logged-in user will be saved in his account. The next time they visit, the fields will be pre-filled for them. |
In the example below, 2 search criteria have been configured:
-
The first waits for the visitor to enter a text.
-
The second, on the other hand, is imposed on the visitor: only content labelled "News" will be displayed.
- Finally, since the two criteria are linked by an "AND", both criteria must be met for the search to retrieve content.
Step 4: Configure results
|
Parameter |
Description |
Mandatory |
|
|---|---|---|---|
|
Facet filters |
This drop-down list lets you select the facets that will be displayed to visitors in a dedicated area, allowing them to refine their search results. We recommend that you do not propose a criterion here that has already been requested from the visitor beforehand. |
No | |
|
Suggested sorting |
The sorting options are left to the visitor's choice. |
No | |
|
Initial sorts |
Initial sorts are the default sorts applied in the absence of any sort chosen by the visitor. The sort order (ascending, descending) of a field can be changed by clicking on it (except in certain special cases, such as relevance). If the 'Suggested sort' field is not empty, you can only choose an initial sort from among those suggested to the visitor. The default initial sort is "Relevance". |
Yes
| |
|
Maximum number of results |
Maximum number of results to display (broken down into pages if necessary) Leave empty to send everything back |
No | |
|
Number of results per page |
Number of results to display on each result page. Leave empty to load all results at once. By default, this field is set to 10. |
No | |
|
Reading rights |
Select the reading rights verification mode to be used:
Rights are calculated according to the logged-in user, at the cost of a slower display.
Rights are calculated in a unique way, regardless of the user connected: a user may therefore see fewer results than he is entitled to (but he will never see a result pointing to a resource he is not entitled to consult. This optimization is only possible if the service contains no criteria to be validated, no faceted filters and no sorting. This is the default value.
No fee calculation is performed. (NOT RECOMMENDED) A user may therefore see a result leading to a resource he or she is not authorized to consult. |
Yes |
Step 5: Service display
|
Category/Parameter |
Description |
Mandatory |
|
|---|---|---|---|
|
Display |
|
| |
|
Content view |
This field is only present if you have selected a specific type of content (e.g. an article) in the first step. Select the view used to render content By default, the view used is the Full view. |
Yes | |
|
Service display |
Select the service display rendering. The following entries are available:
|
Yes | |
|
Results |
|
| |
|
Location |
There are 3 options for displaying results:
|
Yes
| |
|
Launch search on first display |
This field is only present if the "Instead of search criteria" or "Under search criteria" options have been selected for the location. By checking this box, the search is launched automatically when the service is first displayed. Visitors can then enter the values they require. If the visitor has no search criteria, the search is always launched automatically. |
No | |
|
Results page |
This field is only present if the "On the page selected below" option has been selected for the location. A drop-down list and a tree button allow you to select a page containing the "Search engine" service and display the results. |
Yes | |
|
Service identifier |
This field is used to give the same identifier to two instances of this service, in different zones, so that they can communicate. This allows you, for example, to display results in a different area of the search form. |
No | |
|
Link |
|
| |
|
Link to a page |
Add a link to a page that will be displayed in addition to the search result |
No | |
|
Link title |
This field is only present if a link to a page has been selected, allows you to specify a title for the link that will replace the page title. |
No | |
|
Miscellaneous |
|
| |
|
Wires RSS |
Add an icon allowing visitors to subscribe to the RSS feed for this search. |
No |
Overview
How you render the service depends on your graphic charter.
Here are a few examples of what can be achieved.
Example 1:
Search service configured for news content on the current site,
with a "Title or full text" criterion to be filled in by the visitor
Example 2:
Search service configured for all site content and project members
with 3 criteria to be filled in by the user Full text, Content type and Tags
Facets positioned on content type and labels
Back to top