Koha/koha-tmpl/intranet-tmpl/prog/en/modules/admin/preferences/searching.pref
Magnus Enger 20fd03724a Bug 7092 - Complete-subfield searches TraceCompleteSubfields syspref not working correctly
This patch adds a syspref UseICU for toggling between using "" and {} for
quoting in subject tracings. With normal Zebra indexing, "" must be used. With
ICU Zebra indexing, {} must be used.

This syspref interacts with TraceCompleteSubfields and TraceSubjectSubdivisions.

To test:

- marcflavour = MARC21
- make sure you have a record with a "complex subject", like
  "Internet -- Law and legislation"

Toggle UseICU, TraceCompleteSubfields, and TraceSubjectSubdivisions and check
that you get the expected results for the clickable links in the OPAC detail
view:

TraceCompleteSubfields   = Don't force
TraceSubjectSubdivisions = Don't include
UseICU                   = Not using
  opac-search.pl?q=su:"Internet"
UseICU                   = Using
  opac-search.pl?q=su:{Internet}

TraceCompleteSubfields   = Force
TraceSubjectSubdivisions = Don't include
UseICU                   = Not using
  opac-search.pl?q=su,complete-subfield:"Internet"
UseICU                   = Using
  opac-search.pl?q=su,complete-subfield:{Internet}

TraceCompleteSubfields   = Don't force
TraceSubjectSubdivisions = Include
UsingICU                 = Not using
  opac-search.pl?q=(su:"Internet") and (su:"Law and legislation.")
UsingICU                 = Using
  opac-search.pl?q=(su:{Internet}) and (su:{Law and legislation.})

TraceCompleteSubfields   = Force
TraceSubjectSubdivisions = Include
UseICU                   = Not using
  opac-search.pl?q=(su,complete-subfield:"Internet") and (su,complete-subfield:"Law and legislation.")
UseICU                   = Using
  opac-search.pl?q=(su,complete-subfield:{Internet}) and (su,complete-subfield:{Law and legislation.})

Check that clicking on the generated links gives the expected search results,
but with normal and ICU indexing. (I have actually not tested this with ICU, so
doing that before signing off is crucial.)

UPDATE 2012-03-16:

Changed the name of the syspref from TracingQuotes to UseICU after a suggestion
from Paul P., to make it more generally useful.

I have used "Using/Not using" instead of "Use/Don't use" in the description of
the syspref, to reflect the fact that this syspref will not change how Zebra
does its indexing - it's just a way of telling Koha how the indexing is
actually done.

I have also set UseICU = 1 in updatedatabase.pl, since that will preserve the
current behaviour of Koha, but UseICU = 0 in sysprefs.sql, since most new
installations will not have ICU activated.

Signed-off-by: Jared Camins-Esakov <jcamins@cpbibliography.com>
2012-03-21 14:53:14 +01:00

174 lines
6.8 KiB
Text

Searching:
Features:
-
- pref: NoZebra
choices:
yes: "Don't use"
no: Use
- the Zebra search engine. It is recommended to use Zebra; the option to not use Zebra is deprecated and is not guaranteed to work.
-
- When Zebra is not in use, translate the following MARC fields to the following indexes (each line should look something like <code>'indexname' =&gt; '100a,245a,500*',</code>):
- pref: NoZebraIndexes
type: textarea
class: list
-
-
- Perform wildcard searching (where, for example, <cite>Har</cite> would match <cite>Harry</cite> and <cite>harp</cite>)
- pref: QueryAutoTruncate
type: boolean
choices:
yes: automatically.
no: only if * is added.
- "<br />(The * character would be used like so: <cite>Har*</cite> or <cite>*logging</cite>.)"
-
- pref: QueryFuzzy
type: boolean
choices:
yes: Try
no: "Don't try"
- to match similarly spelled words in a search (for example, a search for <cite>flang</cite> would also match <cite>flange</cite> and <cite>fang</cite>; REQUIRES ZEBRA).
-
- pref: QueryRemoveStopwords
type: boolean
choices:
yes: Ignore
no: "Don't ignore"
- stopwords specified in Koha when searching. (Only applies when Zebra is off).
-
- pref: QueryStemming
type: boolean
choices:
yes: Try
no: "Don't try"
- to match words of the same base in a search (for example, a search for <cite>enabling</cite> would also match <cite>enable</cite> and <cite>enabled</cite>; REQUIRES ZEBRA).
-
- pref: QueryWeightFields
type: boolean
choices:
yes: Enable
no: Disable
- ranking of search results by relevance (REQUIRES ZEBRA).
-
- pref: OpacGroupResults
default: 0
choices:
yes: Use
no: "Don't use"
- PazPar2 to group similar results on the OPAC. This requires that PazPar2 is set up and running.
-
- pref: TraceCompleteSubfields
default: 0
choices:
yes: Force
no: "Don't force"
- subject tracings in the OPAC and Staff Client to search only for complete-subfield matches.
-
- pref: TraceSubjectSubdivisions
default: 0
choices:
yes: Include
no: "Don't include"
- subdivisions for searches generated by clicking on subject tracings.
-
- pref: UseICU
default: 0
choices:
yes: Using
no: "Not using"
- 'ICU Zebra indexing. Please note: This setting will not affect Zebra indexing, it should only be used to tell Koha that you have activated ICU indexing if you have actually done so, since there is no way for Koha to figure this out on its own.'
Search Form:
-
- Show tabs in OPAC and staff-side advanced search for limiting searches on the
- pref: AdvancedSearchTypes
class: long
- "fields (separate values with |). Tabs appear in the order listed.<br/>"
- "<em>Currently supported values</em>: Item types (<strong>itemtypes</strong>), Collection Codes (<strong>ccode</strong>) and Shelving Location (<strong>loc</strong>)."
-
- By default,
- pref: expandedSearchOption
type: boolean
choices:
yes: show
no: "don't show"
- '"More options" on the OPAC and staff advanced search pages.'
Results Display:
-
- By default, sort search results in the staff client by
- pref: defaultSortField
default: relevance
choices:
relevance: relevance
popularity: total number of checkouts
callnumber: call number
pubdate: date of publication
acqdate: date added
title: title
author: author
- ','
- pref: defaultSortOrder
choices:
asc: ascending.
dsc: descending.
az: from A to Z.
za: from Z to A.
-
- pref: displayFacetCount
type: boolean
default: no
choices:
yes: Show
no: "Don't show"
- facet counts. The relevance of these numbers highly depends on the value of the maxRecordsForFacets preference. Applies to OPAC and staff interface.
-
- By default, show
- pref: numSearchResults
class: integer
- results per page in the staff client.
-
- By default, sort search results in the OPAC by
- pref: OPACdefaultSortField
default: relevance
choices:
relevance: relevance
popularity: total number of checkouts
callnumber: call number
pubdate: date of publication
acqdate: date added
title: title
author: author
- ","
- pref: OPACdefaultSortOrder
choices:
asc: ascending.
dsc: descending.
az: from A to Z.
za: from Z to A.
-
-
- Show up to
- pref: maxItemsInSearchResults
class: integer
- items per biblio in the search results
-
- Build facets based on
- pref: maxRecordsForFacets
class: integer
default: 20
- records from the search results.
-
- By default, show
- pref: OPACnumSearchResults
class: integer
- results per page in the OPAC.
-
- pref: OPACItemsResultsDisplay
type: boolean
choices:
yes: Show
no: "Don't show"
- "an item's library, location and call number in OPAC search results."
-
- Truncate facets length to
- pref: FacetLabelTruncationLength
class: integer
- characters, in OPAC/staff interface.