Go to the first, previous, next, last section, table of contents.

Catalog search (csearch)

`Description'

Searching a thematic catalog is a two step process, if not specified otherwise by the what parameter. First, the category names are searched with the search criterion (text parameter). If categories are found, they are displayed. If no category matches the search criterion, the records are searched with the same criterion. A new search form is shown on top of the search results, giving the opportunity to the user to change the search criterion or to search in the records instead of the categories. The search criterion specified in the text parameter is split in a list of words (alphanumerical sequence of character, including the dash (-)). The words are searched using the boolean operator specified with the boolean parameter. By default the boolean operator used is or and any occurrence of a word is a hit. If the boolean operator is set to and, the search only hits if all the words are found, the order in which they appear is not relevant. When searching the categories, the search is done on the name field, See section catalog. The ordering of the categories is ascending alphabetical. When searching the records, the search is done using all the fields of type char, varchar or text, if not specified otherwise in the catalog.conf configuration file, See section Catalog configuration file. The first order criterion of the records is the name of the category they belong to so that every record in the same category are displayed together. Optional additional order criterion may be specified in the catalog.conf configuration file, See section Catalog configuration file.

`Template file'

See section csearch.html.

`Parameters'

`context (mandatory, csearch)'

`name (mandatory)'

Unique name of the catalog. It must be the name of a thematic catalog.

`text (mandatory)'

The search criterion. Each alphanumerical and dash (-) sequence of character of this parameter is a distinct search criterion.

`what (optional)'

Specifies the domain of the search. If set to categories, only the category names will be searched. If set to records, only the records will be searched. If not set the categories will be searched first and, if no category matches, the records will be searched.

`mode (optional, default cbrowse)'

Specifies the context in which the search is made. It can be either cbrowse, cedit or pathcontext. The href links displayed in the result page will use the specified context.

`boolean (optional, default or)'

Specifies the boolean operator used to glue search terms.

Go to the first, previous, next, last section, table of contents.