mod_search
See also
mod_search implements various ways of searching through the main resource table using m_search.
Configuration
There are two site configuration variables to tweak PostgreSQL text search settings.
mod_search.rank_behaviour
An integer representation to influence PostgreSQL search behaviour.
Default: 37 (1 | 4 | 32)
mod_search.rank_weight
A set of four numbers to override relative weights for the ABCD categories.
Default: {0.05, 0.25, 0.5, 1.0}
The following searches are implemented in mod_search:
| Name | Description | Required arguments |
|---|---|---|
| query | Very powerful search with which you can implement almost all of the other search functionality. See: Search | |
| facets | Performs a query (see above) and then calculates facets. The facets are defined using the pivot/facet.tpl template. Facets are returned in the facets field of the search result. This shows per facet the counts for alternative values. | |
| subfacets | Performs a query (see above) and then calculates facets. The facets are defined using the pivot/facet.tpl template. Facets are returned in the facets field of the search result. This is a drill down where the facets are counted from the matching resources in the query. That means that only facet values that are in the result set are shown. | |
| facet_values | Returns an empty result with the facets field set to all possible values per facet, or the min/max range for a range facet. | |
| featured | List of pages, featured ones first. | |
| featured | List of pages in a category, featured ones first. | cat |
| featured | List of pages in a category having a certain object, featured pages first. | cat, object, predicate |
| latest | The newest pages. | |
| latest | The newest pages within in a category. | cat |
| upcoming | Selects pages with future date_end. | |
| upcoming_on | Selects pages with date_end after the given time. | datetime |
| upcoming_date | Selects pages with date_end after the given date. | date |
| finished | Selects pages with a past date_end. | |
| finished_on | Selects pages with a date_end before the given time. | datetime |
| finished_date | Selects pages with a date_end before the given date. | date |
| unfinished | Selects pages with a date_end in the future. | |
| unfinished_on | Selects pages with a date_end after the given time. | datetime |
| unfinished_date | Selects pages with a date_end after the given date. | date |
| ongoing | Pages with past date_start and future date_end. | |
| ongoing_on | Pages with a date_start - date_end range around the given time. | datetime |
| ongoing_date | Pages with a date_start - date_end range around the given date. | date |
| autocomplete | Full text search where the last word gets a wildcard. | text |
| autocomplete | Full text search where the last word gets a wildcard, filtered by category. | cat, text |
| fulltext | Full text search. Returns {id,score} tuples. | text |
| fulltext | Full text search, filtered by category. Returns {id,score} tuples. | cat, text |
| referrers | All subjects of a page. | id |
| media_category_image | All pages with a medium and within a certain category. Used to find category images. | cat |
| media_category_depiction | All pages with a depiction edge to an image. Used to find category images. | cat |
| media | All pages with a medium, ordered by descending creation date. | |
| all_bytitle | Return all {title,id} pairs for a category, sorted on title. | cat |
| all_bytitle_featured | Return all {title,id} pairs for a category, sorted on title, featured pages first | cat |
| all_bytitle | Return all {title,id} pairs for a category without subcategories, sorted on title. | cat_is |
| all_bytitle_featured | Return all {title,id} pairs for a category without subcategories, sorted on title, featured pages first. | cat_is |
| match_objects | Returns a list of pages with similar object ids to the objects of the given resource with the given id. Accepts optional cat parameters for filtering on category. Optionally accepts a predicate parameter to only use the objects that are connected to the given id using the predicate or predicates. | id |
| match_objects_cats | Returns a list of pages with similar object ids or categories. Accepts an optional cat parameter for filtering on category. | id |
| archive_year | Returns an overview on publication year basis, for a specified category. Every row returned has parts: “as_date”, “year” and “count”. The order is descending, newest year first. | cat |
| archive_year_month | Return a grouped “archive” overview of resources within a category. The result is a double list, consisting of [ {year, [ months ] }]. The result is grouped on publication year and month, and includes counts. The order is descending, newest year first. | cat |
| keyword_cloud | Return a list of {keyword_id, count} for all resources within a given category. The list is ordered on keyword title. Default predicate is subject, default category is keyword. Change optional keywordpred and keywordcat to create a different cloud. | cat, keywordpred, keywordcat |
| previous | Given an id, return a list of “previous” ids in the given category. This list is ordered by publication date, latest first. | id, cat |
| next | Given an id, return a list of “next” ids in the given category. This list is ordred by publication date, oldest first. | id, cat |