History: Search Admin

            

! Search Admin

You can activate this feature through "Admin home > Features > Search"

^::{img src="img/wiki_up/search_admin_00.png" }::^

Then, you can set the search settings under the magnifying lens icon ({img src=img/icons/admin_search.png}), which will lead you to "__tiki-admin.php?page=search__".

!! Search permissions
give tiki_p_search to the groups that are allowed to search.

{ANAME()}Search modes{ANAME}
!!Search systems
There are 2 search systems that can be configured by the administrator: __(a) Basic Search (database search) __ and __(b) Advanced search (tiki search)__ . In old versions, each one had a module, a tiki page that displayed the results and a set of settings.

* Old tiki versions:
## the ((Module search_box)):
++ It is called "__database search__". It uses the resources of the database to do the search and indexation. It can be used __with or without fulltext__ capacity. You can see you are running this search if the search page is __tiki-searchresults.php__. If you enable full-text search, your results will be ordered according to their relevance to the search terms. In a similar way, a user knows it is a full text search because each result has a relevance indicator.
## the ((Module search_new)):
++ It is called the "__database independent search__" or "__tiki search__". The search resources are managed by tikiwiki.  There is __no fulltext__ capacity in this module.  __search_new__  was introduced in Tikiwiki 1.8. You can see you run this search if the search page is __tiki-searchindex.php__
+ Both could be used as soon as you checked the feature search. You could even set the 2 search boxes.
* Current tiki versions:
## the ((Module search)), which uses tiki-searchresults.php if the 'Basic Search' is enabled regardless of the choice for 'Advanced search'.

!!!# Basic Search
Uses MySQL Full-Text Search, through __tiki-searchresults.php__. If enabled, the search module and search feature at the main application menu will use it by default, even if 'Advanced Search' is also enabled below.

* search without case consideration
* don't index words less that 3 characters (no stoplist)
* relevance and ranking don't work . the relevance is based function of the object type on number od read, hits.... there is no ranking
* can search on a part of a word

!!!# Advanced Search
Uses Unified Search Index, through __tiki-searchindex.php__. You must choose one unified search engine (default value, Lucene, is ok as a starting point).

!!!!# Lucene (PHP Implementation)
There are a few options you can choose from, here.

!!!!# Mysql Full Text Search
There are a few options you can choose from, here.

!!!!# Elastic Search
You require an extenral server setup appropriately to use this search system.

!! Search on the file galleries
See: ((Search within files))

!! Cron Job for Search
* ((Cron Job to Rebuild Search Index))
!! Settings

{VERSIONS(nav=>y,title=>y,default=>2.0)}
^::{img src="img/wiki_up/search_admin_01_2.png" }::^


-=Search features=-
{FANCYTABLE(head=>Setting ~|~ Description)}
Referer Search Highlighting ~|~ Specify if the search results page will highlight the matched words. See ((Referrer Search Highlighting)) for details.%%% Note: Selecting this option may negatively affect Tiki search performance.
Parse the Result ~|~ Specify if Tiki should parse the wiki syntax on the search results page. If not selected, the wiki sytax (code) will be shown. Selecting this option may negatively affect Tiki search performance. %%% %%% This option was introduced in Tiki 2.0
Activate MySQL Full Text Search~|~If selected, the search uses a full-text database search. If not selected, the database search is primarily an OR search between searched words. The Tikiwiki search will be refreshed automatically.  %%% %%% This option was introduced in Tiki 2.0
Ignore individual object permissions ~|~ If selected, the database search results will show __all__ matches -- even if the user does not have permission to view the specific page. Selecting this option may negatively affect Tiki search performance.
Ignore category viewing restrictions ~|~ If selected, the database search results will show __all__ matches -- even if the user does not have permission to view the specific category. Selecting this option may negatively affect Tiki search performance.
Search stats~|~Specify if Tiki records the searched terms for use in the ((Search Stats)) page.
Search Refresh Mode ~|~ Specify how Tiki determines th search refresh index: __Normal__ or __Random__. %%% %%% Note: This option applies only if the __Activate MySQL Full Text Feature__ is ''not'' enabled.
Search refresh rate ~|~ Specify how often Tikiwiki should refresh the search engine: the bigger is the number, the less often one random object is indexed. At each access to a page of the site, a random number between 1 and the refresh rate is computed . If this number is 1 , a random abject is indexed. Starting with Tiki 2.0, the index is refreshed in real time. %%% %%% Note: This option applies only if the __Activate MySQL Full Text Feature__ is ''not'' enabled.
Minimum length of search word ~|~ Specify the minimum number of characters of the search word.  %%% %%% Note: This option applies only if the __Activate MySQL Full Text Feature__ is ''not'' enabled. When using the MySQL Full Text Search, you must specify the word length it in the MySQL configuration by using the __ft_min_word_len__ variable. See the [http://dev.mysql.com/doc/refman/4.1/en/fulltext-fine-tuning.html|MySQL documentation] for details.
Max. number of words containing a syllable ~|~ only for the db independent search.  %%% %%% Note: This option applies only if the __Activate MySQL Full Text Feature__ is ''not'' enabled.
Max. age in hours of syllable search cache ~|~ only for the db independent search.  %%% %%% Note: This option applies only if the __Activate MySQL Full Text Feature__ is ''not'' enabled.
LRU list purging rate ~|~ only for the db independent search.  %%% %%% Note: This option applies only if the __Activate MySQL Full Text Feature__ is ''not'' enabled.
LRU list length ~|~ only for the db independent search. %%% %%% Note: This option applies only if the __Activate MySQL Full Text Feature__ is ''not'' enabled.
{FANCYTABLE}

Other options:
*Click the __Refresh wiki search index now__ link to refresh the search index of the ((wiki)).
*Click the __Refresh tracker search index now__ link to refresh the search index of the ((trackers)).
*Click the __Refresh search index now__ link to refresh the search index of a Tikiwiki search.
Note: Use these __Refresh...__ option only for small sites -- larger sties should use a cron batch job.
---(1.9)-----------------------------
^::{img src="img/wiki_up/search_admin_01.png" }::^

-=Search features=-
||__Setting__|__Description__
Full text search|If selected, the search uses a full-text database search; if not, the database search is primarily an OR search between searched words, the Tikiwiki search will be refreshed automatically in tikiwiki >=1.10
Search stats|Specify if Tiki records the searched terms for use in the ((Search Stats)) page.
((Referrer Search Highlighting|Referrer search highlighting))|Specify if the results highlight the matched words.%%%Note: Selecting this option may negatively affect Tiki search performance.||

Click the __Refresh wiki search index now__ link to refresh the search index of a Tikiwiki search.
Note: Use the __Refresh...__ option only for small sites -- larger sties should use a cron batch job.

-=Performance issues=-
||__Setting__|__Description__
Ignore individual object permissions|If selected, the database search results will show __all__ matches -- even if the user does not have permission to view the specific page.
Ignore category viewing restrictions|If selected, the database search results will show __all__ matches -- even if the user does not have permission to view the specific category.||
Note: These options may negatively affect Tiki search performance.

-=Settings for searching content=-
||__Setting__|__Description__
Search refresh rate|only for the tiki search. The bigger is the number, the less often one random object is indexed. At each access to a page of the site, a random number between 1 and the refresh rate is computed . If this number is 1 , a random abject is indexed.
In tikiwiki>=1.10, the indexation is refreshed in real time (if full text option is unchecked).
Minimum length of search word|only for the database independent search. For Mysql fulltext you must do it in the MySQL configuration.
Max. number of words containing a syllable|only for the db independent search.
Max. age in hours of syllable search cache|only for the db independent search.
LRU list purging rate|only for the db independent search.
LRU list length|only for the db independent search.||
Note: LRU (Least Recently Used) is search engine technique implemented in Oracle, Java and others. It may also be known as a "search cache."

{VERSIONS}


!!Mysql search tuning
See [http://dev.mysql.com/doc/refman/5.0/en/fulltext-fine-tuning.html] for some setting at mysql level like the stop list words and the 4 character limit.

!!Word highlighting
In v1.9 there is a new search box ((Module search_new)) and results page (tiki-searchindex.php) that together provide highlighting of search words.  Additionally, by adding "&highlight=''words''", where ''words'' are the words you want to highlight, to the end of the URL (web address) for any wiki page, the words will be highlighted in the page.

-=Related pages=-
* ((Search))
* ((Search User))
* ((Search Stats))

-=alias=-
* (alias(Search Config))