a1878233f60cdf1fd42b73b9c8e8a91f6aa9b36e
[koha-ffzg.git] / koha-tmpl / intranet-tmpl / prog / en / modules / admin / preferences / opac.pref
1 OPAC:
2     Appearance:
3         -
4             - pref: OPACUserSummary
5               choices:
6                   1: Show
7                   0: "Don't show"
8             - "a summary of a logged in patron's checkouts, overdues, holds and charges on the OPAC start page."
9         -
10             - For search results in the OPAC, show the item's
11             - pref: OPACResultsLibrary
12               choices:
13                   holdingbranch: "current library"
14                   homebranch: "home library"
15             - . Please note that this feature is currently available for MARC21 and UNIMARC.
16         -
17             - Use the
18             - pref: opacthemes
19               choices: opac-templates
20             - theme on the OPAC.
21         -
22             - Use the
23             - pref: OPACFallback
24               choices:
25                   bootstrap: bootstrap
26                   prog: prog
27             - theme as the fallback theme on the OPAC.
28         -
29             - "The OPAC is located at "
30             - pref: OPACBaseURL
31               class: url
32             - . This should be a complete URL, starting with <code>http://</code> or <code>https://</code>. Do not include a trailing slash in the URL. (This must be filled in correctly for RSS, unAPI, and search plugins to work.)
33         -
34             - Show
35             - pref: LibraryName
36               class: long
37             - as the name of the library on the OPAC.
38         -
39             - pref: OpacPublic
40               choices:
41                   1: Enable
42                   0: Disable
43             - "Koha OPAC as public. Private OPAC requires authentication before accessing the OPAC. "
44             - 'Note: This does not affect the public API, see the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=RESTPublicAnonymousRequests">RESTPublicAnonymousRequests</a> to control the API.'
45         -
46             - "Show star-ratings on"
47             - pref: OpacStarRatings
48               choices:
49                   all: "results, details, and patron"
50                   disable: "no"
51                   details: "only details"
52             - "pages."
53         -
54             - pref: OpacMaintenance
55               choices:
56                   1: Show
57                   0: "Don't show"
58             - "a warning that the OPAC is under maintenance, instead of the OPAC itself. Note: this shows the same warning as when the database needs to be upgraded, but unconditionally."
59         -
60             - 'Show the following HTML when <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OpacMaintenance">OpacMaintenance</a> is enabled:'
61             - pref: OpacMaintenanceNotice
62               type: textarea
63               syntax: text/html
64               class: code
65         -
66             - "This description will show in search engine results (160 characters)."
67             - pref: OpacMetaDescription
68               type: textarea
69         -
70             - By default, show bibliographic records
71             - pref: BiblioDefaultView
72               choices:
73                   normal: in simple form.
74                   marc: in their MARC form.
75                   isbd: as specified in the ISBD template.
76         -
77             - When patrons click on a link to another website from your OPAC (like Amazon or OCLC),
78             - pref: OPACURLOpenInNewWindow
79               choices:
80                   1: do
81                   0: "don't"
82             - open the website in a new window.
83         -
84             - pref: hidelostitems
85               choices:
86                   1: "Don't show"
87                   0: Show
88             - lost items on search and detail pages.
89         -
90             - 'Display lists in the OPAC using XSLT stylesheet at: '
91             - pref: OPACXSLTListsDisplay
92               class: file
93             - '<br />Options:<ul><li>Enter "<a href="#" class="set_syspref" data-syspref="OPACXSLTListsDisplay" data-value="default">default</a>" for the default stylesheet</li><li>Put a path to define an xslt file</li><li>Put a URL for an external specific stylesheet.</li></ul>If you have multiple stylesheets for different languages the placeholder {langcode} will be replaced with current interface language.'
94         -
95             - 'Display OPAC results using XSLT stylesheet at: '
96             - pref: OPACXSLTResultsDisplay
97               class: file
98             - '<br />Options:<ul><li>Enter "<a href="#" class="set_syspref" data-syspref="OPACXSLTResultsDisplay" data-value="default">default</a>" for the default stylesheet</li><li>Put a path to define an xslt file</li><li>Put a URL for an external specific stylesheet.</li><li>NOTE: The system preference <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=PassItemMarcToXSLT">PassItemMarcToXSLT</a> must be enabled if your custom stylesheet utilizes data in the item fields</li></ul>If you have multiple stylesheets for different languages the placeholder {langcode} will be replaced with current interface language.'
99         -
100             - 'Display OPAC details using XSLT stylesheet at: '
101             - pref: OPACXSLTDetailsDisplay
102               class: file
103             - '<br />Options:<ul><li>Enter "<a href="#" class="set_syspref" data-syspref="OPACXSLTDetailsDisplay" data-value="default">default</a>" for the default stylesheet</li><li>Put a path to define an xslt file</li><li>Put a URL for an external specific stylesheet.</li></ul>If you have multiple stylesheets for different languages the placeholder {langcode} will be replaced with current interface language.'
104         -
105             - 'Display authority results in the OPAC using the XSLT stylesheet at: '
106             - pref: AuthorityXSLTOpacResultsDisplay
107               class: file
108             - '<br />Options:<ul><li>Empty. No XSLT will be applied (<strong>default</strong>)</li><li>Enter a path to a custom XSLT file.</li><li>Enter a URL for an external stylesheet.</li></ul>If you have multiple stylesheets for: <ul><li>different languages: use the placeholder {langcode} - this will be replaced with the current interface language</li><li>authority types: use the placeholder {authtypecode} - this will be replaced with the authority type code'
109         -
110             - pref: OpacNoItemTypeImages
111               default: 0
112               choices:
113                   1: "Don't show"
114                   0: "Show"
115             - "itemtype icons in the OPAC."
116         -
117             - pref: DisplayOPACiconsXSLT
118               choices:
119                   1: Show
120                   0: "Don't show"
121             - the format, audience, and material type icons and descriptions in XSLT MARC21 results and detail pages in the OPAC.
122         -
123             - pref: COinSinOPACResults
124               choices:
125                   1: Include
126                   0: "Don't include"
127             - "COinS / OpenURL / Z39.88 in OPAC search results.  <br/>Warning: Enabling this feature will slow OPAC search response times."
128             - "<br/>If you want to display a link to an OpenURL resolver, look at the following system preferences:"
129             - '<br/><a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OpenURLResolverURL">OpenURLResolverURL</a>, <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACShowOpenURL">OPACShowOpenURL</a>, <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACOpenURLItemTypes">OPACOpenURLItemTypes</a>, <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OpenURLText">OpenURLText</a>, <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OpenURLImageLocation">OpenURLImageLocation</a>'
130         -
131             - pref: OPACShowUnusedAuthorities
132               choices:
133                   1: Show
134                   0: "Don't show"
135             - unused authorities in the OPAC authority browser.
136         -
137             - pref: OPACShowHoldQueueDetails
138               choices:
139                   none: "Don't show any hold details"
140                   priority: "Show priority level"
141                   holds: "Show holds"
142                   holds_priority: "Show holds and their priority level"
143             - to patrons in the OPAC.
144         -
145             - pref: OPACShowCheckoutName
146               default: 0
147               choices:
148                   1: Show
149                   0: "Don't show"
150             - the name of the patron that has an item checked out on item detail pages on the OPAC.
151         -
152             - Display the
153             - pref: OpacLocationBranchToDisplay
154               choices:
155                   home: "home library"
156                   holding: "holding library"
157                   both: "home and holding libraries"
158             - for items on the OPAC record details page.
159         -
160             - 'Display the shelving location '
161             - pref: OpacLocationOnDetail
162               choices:
163                   home: "below the home library"
164                   holding: "below the holding library"
165                   both: "below both home and holding libraries"
166                   column: "on a separate column"
167             - "for items on the OPAC record details page."
168             - "<br />Note: If 'on a separate column' is selected, you still need to enable the item_shelving_location display on the <a href='/cgi-bin/koha/admin/columns_settings.pl'>configure columns</a> administration page."
169         -
170             - pref: OPACShowMusicalInscripts
171               default: 0
172               choices:
173                 1: Show
174                 0: "Don't show"
175             - musical inscripts on the OPAC record details page.
176         -
177             - pref: OPACPlayMusicalInscripts
178               default: 0,'','If displayed musical inscripts, play midi conversion for items on the OPAC record details page.'
179               choices:
180                 1: Play
181                 0: "Don't play"
182             - MIDI representation of musical inscripts on the OPAC record details page.
183         -
184             - pref: OpacKohaUrl
185               default: 0
186               choices:
187                   1: Show
188                   0: "Don't show"
189             - "'Powered by Koha' text on OPAC footer."
190         -
191             - pref: OpacShowRecentComments
192               default: 0
193               choices:
194                   1: Show
195                   0: "Don't show"
196             - a link to recent comments in the OPAC masthead.
197         -
198             - pref: OpacHighlightedWords
199               choices:
200                   1: Highlight
201                   0: "Don't highlight"
202             - "words the patron searched for in their search results and detail pages. To prevent certain words from ever being highlighted, enter a list of stopwords here:"
203             - pref: NotHighlightedWords
204               class: multi
205             - (separate columns with |).
206         -
207             - Use the image at
208             - pref: OpacFavicon
209               class: url
210             - for the OPAC's favicon. (This should be a complete URL, starting with <code>http://</code>.)
211         -
212             - "Include the following JavaScript on all pages in the OPAC:"
213             - pref: OPACUserJS
214               type: textarea
215               syntax: javascript
216               class: code
217         -
218             - Include the additional CSS stylesheet
219             - pref: OpacAdditionalStylesheet
220               class: file
221             - to override specific settings from the default stylesheet (leave blank to disable). Enter just a filename, a full local path or a complete URL starting with <code>http://</code> (if the file lives on a remote server). Please note that if you just enter a filename, the file should be in the css subdirectory for each active theme and language within the Koha templates directory. A full local path is expected to start from your HTTP document root.
222         -
223             - Use the CSS stylesheet
224             - pref: opaclayoutstylesheet
225               class: file
226             - on all pages in the OPAC, instead of the default CSS (used when leaving this field blank). Enter just a filename, a full local path or a complete URL starting with <code>http://</code> (if the file lives on a remote server). Please note that if you just enter a filename, the file should be in the css subdirectory for each active theme and language within the Koha templates directory. A full local path is expected to start from your HTTP document root.
227         -
228             - "Include the following CSS on all pages in the OPAC:"
229             - pref: OPACUserCSS
230               type: textarea
231               syntax: css
232               class: code
233         -
234             - 'Include a "More Searches" box on the detail pages of items on the OPAC, with the following HTML (leave blank to disable):'
235             - '<br />Note: The placeholders {BIBLIONUMBER}, {CONTROLNUMBER}, {OCLC_NO}, {TITLE}, {ISBN}, {ISSN} and {AUTHOR} will be replaced with information from the displayed record.'
236             - pref: OPACSearchForTitleIn
237               type: textarea
238               syntax: text/html
239               class: code
240         -
241             - 'Include a "Links" column on the "my summary" and "my checkout history" tabs when a patron is logged in to the OPAC, with the following HTML (leave blank to disable):'
242             - '<br />Note: The placeholders {BIBLIONUMBER}, {TITLE}, {ISBN} and {AUTHOR} will be replaced with information from the displayed record.'
243             - pref: OPACMySummaryHTML
244               type: textarea
245               syntax: text/html
246               class: code
247         -
248             - "Include the following HTML under the facets in OPAC search results:"
249             - pref: OPACResultsSidebar
250               type: textarea
251               syntax: text/html
252               class: code
253         -
254             - pref: OpacAddMastheadLibraryPulldown
255               choices: 
256                   1: Add
257                   0: "Don't add"
258             - a library select pulldown menu on the OPAC masthead.
259         -
260             - 'Display this HTML when no results are found for a search in the OPAC:'
261             - '<br />Note: You can insert placeholders {QUERY_KW} that will be replaced with the keywords of the query.'
262             - pref: OPACNoResultsFound
263               type: textarea
264               syntax: text/html
265               class: code
266         -
267             - 'Display the URI in the 856u field as an image on: '
268             - pref: OPACDisplay856uAsImage
269               choices:
270                   OFF: "neither detail or result pages"
271                   Details: "detail page only"
272                   Results: "result page only"
273                   Both: "both detail and result pages"
274             - '. Note: The corresponding <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACXSLT">OPACXSLT</a> option must be turned on.'
275         -
276             - 'Select export options that should be available from OPAC detail page:'
277             - pref: OpacExportOptions
278               multiple:
279                 bibtex: BibTeX
280                 dc: Dublin Core
281                 marcxml: MARCXML
282                 marc8: MARC-8 encoded MARC
283                 utf8: Unicode/UTF-8 encoded MARC
284                 marcstd: Unicode/UTF-8 encoded MARC without local use -9xx, x9x, xx9- fields and subfields
285                 mods: MODS
286                 ris: RIS
287                 isbd: ISBD
288         -
289             - pref: OpacSeparateHoldings
290               choices:
291                   1: Separate
292                   0: Don't separate
293             - "items display into two tabs, where the first tab contains items whose"
294             - pref: OpacSeparateHoldingsBranch
295               choices:
296                 homebranch: 'home library'
297                 holdingbranch: 'holding library'
298             - "is the logged in patrons's library. The second tab will contain all other items."
299         -
300             - pref: OPACHoldingsDefaultSortField
301               choices:
302                   first_column: First column of the table
303                   homebranch: Home library
304                   holdingbranch: Holding library
305             - "is the default sort field for the holdings table."
306         -
307             - Display up to
308             - pref: OpacMaxItemsToDisplay
309               class: integer
310             - items on the bibliographic record detail page (if the bibliographic record has more items than this, a link is displayed instead that allows the patron to choose to display all items).
311         -
312             - "Display language selector on "
313             - pref: OpacLangSelectorMode
314               choices:
315                   both: "both top and footer"
316                   top: "top"
317                   footer: "only footer"
318             - "."
319         -
320             - "List the following not for loan statuses as available for reference in OPAC search results:"
321             - pref: Reference_NFL_Statuses
322             - "(Use | as delimiter.)"
323         -
324             - Show no more than
325             - pref: OPACResultsMaxItems
326             - (available) individual items on the OPAC XSLT search results, and show no more than
327             - pref: OPACResultsMaxItemsUnavailable
328             - "(unavailable) individual items for categories like Checked out, Damaged, On Hold, but only when you group them by branch.<br>"
329             - Group unavailable items by
330             - pref: OPACResultsUnavailableGroupingBy
331               choices:
332                   branch: "branch and substatus"
333                   substatus: "substatus only"
334                   branchonly: "branch only"
335             - ". (NOTE: For large consortia we recommend to group unavailable items by substatus, listing item counts only.)"
336
337     Features:
338         -
339             - pref: OpacCatalogConcerns
340               default: 0
341               choices:
342                   0: "Don't allow"
343                   1: Allow
344             - "OPAC users to report concerns about catalog records."
345             - '<p><strong>NOTE:</strong> Enabling `<a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=CatalogConcerns">CatalogConcerns</a>` will allow concern submissions from the staff interface.</p>'
346         -
347             - pref: OPACReportProblem
348               choices:
349                   1: Allow
350                   0: "Don't allow"
351             - patrons to submit problem reports for OPAC pages to the library or Koha administrator.
352             - "<br/>"
353             - '<strong>NOTE:</strong> You must have <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=KohaAdminEmailAddress">KohaAdminEmailAddress</a> enabled.'
354         -
355             - pref: opacuserlogin
356               choices:
357                   1: Allow
358                   0: "Don't allow"
359             - patrons to log in to their accounts on the OPAC.
360         -
361             - Show
362             - pref: OpacItemLocation
363               choices:
364                   location: "library, location, and call number"
365                   ccode: "library, collection code, and call number"
366                   callnum: "library and call number"
367                   library: "only library"
368             - for items on the OPAC search results.
369         -
370             - pref: OpacPasswordChange
371               choices:
372                   1: Allow
373                   0: "Don't allow"
374             - patrons to change their own password on the OPAC. Note that this must be off to use LDAP authentication.
375         -
376             - "Library patrons are "
377             - pref: OpacResetPassword
378               default: 1
379               choices:
380                   1: "allowed"
381                   0: "not allowed"
382             - " to recover their password via e-mail in the OPAC."
383         -
384             - pref: OPACpatronimages
385               choices:
386                   1: Show
387                   0: "Don't show"
388             - patron images on the patron information page in the OPAC.
389         -
390             - pref: OPACDetailQRCode
391               choices:
392                   1: Enable
393                   0: Disable
394             - the option to show a QR Code on the OPAC bibliographic detail page.
395         -
396             - pref: OPACFinesTab
397               choices:
398                   1: Allow
399                   0: "Don't allow"
400             - patrons to access the charges tab on their account page on the OPAC.
401         -
402             - pref: OpacBrowser
403               choices:
404                   1: Allow
405                   0: "Don't allow"
406             - "patrons to browse subject authorities on the OPAC."
407             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/build_browser_and_cloud.pl</code> cronjob. Ask your system administrator to schedule it."
408         -
409             - pref: OpacCloud
410               choices:
411                   1: Show
412                   0: "Don't show"
413             - "a subject cloud on the OPAC."
414             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/build_browser_and_cloud.pl</code> cronjob. Ask your system administrator to schedule it."
415         -
416             - pref: OpacAuthorities
417               choices:
418                   1: Allow
419                   0: "Don't allow"
420             - patrons to search your authority records.
421         -
422             - pref: opacbookbag
423               choices:
424                   1: Allow
425                   0: "Don't allow"
426             - patrons to store items in a temporary "Cart" on the OPAC.
427         -
428             - pref: OpacTopissue
429               choices:
430                   1: Allow
431                   0: "Don't allow"
432             - patrons to access a list of the most checked out items on the OPAC. Note that this is somewhat experimental, and should be avoided if your collection has a large number of items.
433         -
434             - pref: OPACComments
435               choices:
436                   1: Allow
437                   0: "Don't allow"
438             - patrons to make comments on items on the OPAC.
439         -
440             - Show
441             - pref: ShowReviewer
442               choices:
443                   none: no name
444                   full: full name
445                   first: first name
446                   surname: last name
447                   firstandinitial: first name and last name initial
448                   username: username
449             - of commenter with comments in OPAC.
450         -
451             - pref: ShowReviewerPhoto
452               choices:
453                   1: Show
454                   0: Don't show
455             - reviewer's avatar beside comments in OPAC. The avatar will be searched on <a href="https://www.libravatar.org" target="_blank">Libravatar</a> using the patron's e-mail address.
456         -
457             - pref: OPACHoldRequests
458               choices:
459                   1: Allow
460                   0: "Don't allow"
461             - patrons to place holds on items from the OPAC.
462         -
463             - Display
464             - pref: numSearchRSSResults
465               class: long
466             -  search results in the RSS feed.
467         -
468             - Show
469             - pref: SocialNetworks
470               multiple:
471                 facebook: Facebook
472                 linkedin: LinkedIn
473                 email: Email
474                 twitter: Twitter
475
476             - "social network links on the OPAC detail pages."
477         -
478             - pref: OpacBrowseResults
479               default: 1
480               choices:
481                   1: Enable
482                   0: Disable
483             - browsing and paging search results from the OPAC detail page.
484         -
485             - Show quote of the day in the
486             - pref: QuoteOfTheDay
487               multiple:
488                 intranet: staff interface
489                 opac: OPAC
490             - main page.
491         -
492             - pref: OPACPopupAuthorsSearch
493               default: 0
494               choices:
495                 1: Show
496                 0: Don't show
497             - the list of authors/subjects in a popup for a combined search on OPAC detail pages.
498         -
499             - pref: OpacHoldNotes
500               default: 0
501               choices:
502                   1: Allow
503                   0: "Don't allow"
504             - patrons to add a note when placing a hold.
505         -
506             - pref: OPACAcquisitionDetails
507               default: 0
508               choices:
509                   1: Show
510                   0: Don't show
511             - the acquisition details on OPAC detail pages.
512         -
513             - pref: OpacNewsLibrarySelect
514               default: 0
515               choices:
516                   1: Show
517                   0: Don't show
518             - a library selection list for news items in the OPAC.
519         -
520             - "Use the following as the OPAC ISBD template:"
521             - pref: OPACISBD
522               type: textarea
523               syntax: text/html
524               class: code
525         -
526             - pref: OpacBrowseSearch
527               default: 0
528               choices:
529                   1: Enable
530                   0: Disable
531             - "interface for browsing all holdings (Elasticsearch only)."
532         -
533             - pref: OPACAuthorIdentifiers
534               default: 0
535               choices:
536                   1: Display
537                   0: "Don't display"
538             - "identifiers for authors and contributors to the detail pages in the OPAC."
539             - "This feature requires authorities with 024$2 and 024$a."
540             - "Valid source codes in $2 are currently: orcid, scopus, loop, rid and viaf."
541         -
542             - "Calculate the amount a patron has 'saved' by using the library based on replacement prices, and display:"
543             - pref: OPACShowSavings
544               multiple:
545                   checkouthistory: "on patron's checkout history page (the system preference <em>opacreadinghistory</em> must be enabled)"
546                   summary: "in user summary box on OPAC homepage (the system preference <em>OPACUserSummary</em> must be enabled)"
547                   user: "on patron's 'your summary' page"
548             - ". Note that displayed savings may be inaccurate if checkout history is anonymized."
549     OpenURL:
550         -
551             - 'Complete URL of OpenURL resolver (starting with <code>http://</code> or <code>https://</code>):'
552             - pref: OpenURLResolverURL
553               class: url
554         -
555             - 'Text of OpenURL links (or image title if <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OpenURLImageLocation">OpenURLImageLocation</a> is defined):'
556             - pref: OpenURLText
557         -
558             - 'Location of image for OpenURL links:'
559             - pref: OpenURLImageLocation
560               class: url
561             - '<br />Can be an absolute URL starting with <code>http://</code> or'
562             - '<code>https://</code> or a relative URL'
563             - '<br />Examples:'
564             - '<br />- <code>http://www.example.com/img/openurl.png</code>'
565             - '<br />- <code>/opac-tmpl/bootstrap/images/OpenURL.png</code>'
566         -
567             - pref: OPACShowOpenURL
568               choices:
569                   1: Enable
570                   0: Disable
571             - 'display of OpenURL link in OPAC search results and detail page.'
572         -
573             - 'List of item type codes (separated by spaces) for those you want to show the OpenURL link:'
574             - pref: OPACOpenURLItemTypes
575             - '<br />'
576     Policy:
577         -
578             - pref: SearchMyLibraryFirst
579               choices:
580                   1: Limit
581                   0: "Don't limit"
582             - "patrons' searches to the library they are registered at."
583         -
584             - pref: OpacRenewalAllowed
585               choices:
586                   1: Allow
587                   0: "Don't allow"
588             - patrons to renew their own books on the OPAC.
589         -
590             - Use 
591             - pref: OpacRenewalBranch
592               choices:
593                   itemhomebranch: "the item's home library"
594                   patronhomebranch: "the patron's home library"
595                   checkoutbranch: "the library the item was checked out from"
596                   none: "NULL"
597                   opacrenew: "'OPACRenew'"
598             - as branchcode to store in the statistics table.
599         -
600             - Only allow patrons to renew their own books on the OPAC if they have less than
601             - pref: OPACFineNoRenewals
602               class: currency
603             - '[% local_currency %] in charges (leave blank to disable).'
604         -
605             - pref: OPACFineNoRenewalsIncludeCredits
606               choices:
607                   1: Include
608                   0: "Don't include"
609             - outstanding/unapplied credits when applying the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACFineNoRenewals">OPACFineNoRenewals</a> rule to patrons.
610         -
611             - pref: OpacHiddenItems
612               type: textarea
613               syntax: text/x-yaml
614               class: code
615             - Define custom rules to hide specific items from search and view on the OPAC. How to write these rules is documented on the <a href="http://wiki.koha-community.org/wiki/OpacHiddenItems" target="_blank">Koha wiki</a>.
616         -
617             - 'List of patron categories, that can see items otherwise hidden by <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OpacHiddenItems">OpacHiddenItems</a>:'
618             - pref: OpacHiddenItemsExceptions
619               choices: patron-categories
620               class: multiple
621         -
622             - pref: OpacHiddenItemsHidesRecord
623               default: 1
624               choices:
625                   0: "Don't hide"
626                   1: Hide
627             - "the bibliographic record when all its items are hidden by <a href='/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OpacHiddenItems'>OpacHiddenItems</a>."
628         -
629             - pref: OpacAllowPublicListCreation
630               default: 1
631               choices:
632                   0: "Don't allow"
633                   1: Allow
634             - "OPAC users to create public lists."
635         -
636             - pref: OpacAllowSharingPrivateLists
637               default: 0
638               choices:
639                   0: "Don't allow"
640                   1: Allow
641             - "OPAC users to share private lists with other patrons."
642         -
643             - pref: BlockExpiredPatronOpacActions
644               choices:
645                 1: "Block"
646                 0: "Don't block"
647             - expired patrons from OPAC actions such as placing a hold or renewing. Note that the setting for a patron category takes priority over this system preference.
648
649     Privacy:
650         -
651             - pref: opacreadinghistory
652               choices:
653                   1: Allow
654                   0: "Don't allow"
655             - patrons to see what books they have checked out in the past.
656         -
657             - pref: OPACHoldsHistory
658               choices:
659                   1: Allow
660                   0: "Don't allow"
661             - patrons to see the list of their past holds.
662         -
663             - pref: EnableOpacSearchHistory
664               default: 0
665               choices:
666                   1: Keep
667                   0: "Don't keep"
668             - patron search history in the OPAC.
669         -
670             - pref: OPACPrivacy
671               default: 0
672               choices:
673                   1: Allow
674                   0: "Don't allow"
675             - 'patrons to choose their own privacy settings for their checkout history. This requires <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=opacreadinghistory">opacreadinghistory</a> and <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=AnonymousPatron">AnonymousPatron</a> system preferences.'
676         -
677             - pref: AllowPatronToSetCheckoutsVisibilityForGuarantor
678               default: 0
679               choices:
680                   1: Allow
681                   0: "Don't allow"
682             - "patrons to choose their own privacy settings for showing the patron's checkouts to the patron's guarantor."
683         -
684             - pref: AllowPatronToSetFinesVisibilityForGuarantor
685               default: 0
686               choices:
687                   1: Allow
688                   0: "Don't allow"
689             - "patrons to choose their own privacy settings for showing the patron's charges to the patron's guarantor."
690         -
691             - Use borrowernumber
692             - pref: AnonymousPatron
693               class: integer
694             - "as the anonymous patron (for anonymous suggestions and checkout history)."
695         -
696             - pref: TrackClicks
697               default: 0
698               choices:
699                   anonymous: "Track anonymously"
700                   track: "Track"
701                   0: "Don't track"
702             - "links that patrons click on."
703     Restricted page:
704         -
705             - "Access from IP addresses beginning with"
706             - pref: RestrictedPageLocalIPs
707             - "do not need to be authenticated (comma separated - ex: '127.0.0,127.0.1')."
708         -
709             - "HTML content of your restricted page (available at /cgi-bin/koha/opac-restrictedpage.pl)"
710             - pref: RestrictedPageContent
711               type: textarea
712               syntax: text/html
713               class: HTML
714         -
715             - Use
716             - pref: RestrictedPageTitle
717               class: long
718             - "as title of your restricted page (appears in the breadcrumb and on the top of the restricted page)."
719     Shelf browser:
720         -
721             - pref: OPACShelfBrowser
722               choices:
723                   1: Show
724                   0: "Don't show"
725             - "a shelf browser on item details pages, allowing patrons to see what's near that item on the shelf. Note that this uses up a fairly large amount of resources on your server, and should be avoided if your collection has a large number of items."
726         -
727             - pref: ShelfBrowserUsesLocation
728               default: 1
729               choices:
730                   1: Use
731                   0: "Don't use"
732             - "the item location when finding items for the shelf browser."
733         -
734             - pref: ShelfBrowserUsesHomeBranch
735               default: 1
736               choices:
737                   1: Use
738                   0: "Don't use"
739             - "the item home library when finding items for the shelf browser."
740         -
741             - pref: ShelfBrowserUsesCcode
742               default: 0
743               choices:
744                   1: Use
745                   0: "Don't use"
746             - "the item collection code when finding items for the shelf browser."      
747
748     Self registration and modification:
749         -
750             - pref: PatronSelfRegistration
751               choices:
752                   1: Allow
753                   0: "Don't allow"
754             - "library patrons to register for an account via the OPAC."
755             - "<br><strong>NOTE:</strong> This needs <a href='/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=PatronSelfRegistrationDefaultCategory'>PatronSelfRegistrationDefaultCategory</a> to be set to a valid patron category code."
756         -
757             - pref: PatronSelfRegistrationVerifyByEmail
758               choices:
759                   1: Require
760                   0: "Don't require"
761             - "that a self-registering patron verify themselves via email."
762             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/cleanup_database.pl</code> cronjob. Ask your system administrator to schedule it."
763         -
764             - "Use"
765             - pref: PatronSelfRegistrationDefaultCategory
766               choices: patron-categories
767             - "as the default patron category for patrons registered via the OPAC."
768             - "<br><strong>WARNING: Do not use a regular patron category for self registration.</strong>"
769             - "<br>If the <code>misc/cronjobs/cleanup_database.pl</code> cronjob is setup to delete unverified and unfinished OPAC self registrations, it will permanently and unrecoverably delete all patrons that have registered more than <a href='/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=PatronSelfRegistrationExpireTemporaryAccountsDelay'>PatronSelfRegistrationExpireTemporaryAccountsDelay</a> days ago (unless that delay is empty or zero)."
770         -
771             - Delete patrons still in the category indicated by <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=PatronSelfRegistrationDefaultCategory">PatronSelfRegistrationDefaultCategory</a>
772             - pref: PatronSelfRegistrationExpireTemporaryAccountsDelay
773               class: integer
774             - "days after account creation."
775             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/cleanup_database.pl</code> cronjob. Ask your system administrator to schedule it.<br>No patrons will be deleted if you set the pref to zero or make it empty."
776         -
777             - "The following <a href='http://schema.koha-community.org/__VERSION__/tables/borrowers.html' target='blank'>database columns</a> must be filled in on the patron modification screen:"
778             - pref: PatronSelfModificationMandatoryField
779               type: modalselect
780               source: borrowers
781               exclusions: password|cardnumber|dateexpiry|categorycode|sort1|sort2|opacnote|borrowernotes|gonenoaddress|lost|flags
782         -
783             - "The following <a href='http://schema.koha-community.org/__VERSION__/tables/borrowers.html' target='blank'>database columns</a> must be filled in on the patron entry screen:"
784             - pref: PatronSelfRegistrationBorrowerMandatoryField
785               type: modalselect
786               source: borrowers
787               exclusions: sort1|sort2|opacnote|borrowernotes|gonenoaddress|lost|flags
788         -
789             - "The following <a href='http://schema.koha-community.org/__VERSION__/tables/borrowers.html' target='blank'>database columns</a> will not appear on the patron self-registration screen:"
790             - pref: PatronSelfRegistrationBorrowerUnwantedField
791               type: modalselect
792               source: borrowers
793               exclusions: branchcode|sort1|sort2|gonenoaddress|lost|flags
794         -
795             - "The following <a href='http://schema.koha-community.org/__VERSION__/tables/borrowers.html' target='blank'>database columns</a> will not appear on the patron self-modification screen:"
796             - pref: PatronSelfModificationBorrowerUnwantedField
797               type: modalselect
798               source: borrowers
799               exclusions: sort1|sort2|gonenoaddress|lost|flags
800         -
801             - "Display the following additional instructions for patrons who self register via the OPAC ( HTML is allowed ):"
802             - pref: PatronSelfRegistrationAdditionalInstructions
803               type: textarea
804               syntax: text/html
805               class: html
806         -
807             - pref: PatronSelfRegistrationEmailMustBeUnique
808               choices:
809                   1: "Consider"
810                   0: "Don't consider"
811             - "patron's email (borrowers.email) as unique on self registering. An email won't be accepted if it already exists in the database."
812         -
813             - "Enable the self registration for the following libraries:"
814             - pref: PatronSelfRegistrationLibraryList
815             - (separate branchcode with |).
816             - If empty, all libraries will be listed.
817         -
818             - pref: PatronSelfRegistrationPrefillForm
819               choices:
820                   1: "Show and prefill"
821                   0: "Don't show and prefill"
822             - "password and login form after a patron has self registered."
823         -
824             - pref: PatronSelfRegistrationConfirmEmail
825               choices:
826                   1: Require
827                   0: "Don't require"
828             - patrons to confirm their email address by entering it twice.
829         -
830             - pref: OPACPatronDetails
831               choices:
832                   1: Allow
833                   0: "Don't allow"
834             - patrons to notify the library of changes to their contact information from the OPAC.
835         -
836             - "Choose email address that new patron self-registrations will be sent to: "
837             - pref: EmailPatronRegistrations
838               default: 0
839               choices:
840                   0: none
841                   EmailAddressForPatronRegistrations: EmailAddressForPatronRegistrations
842                   BranchEmailAddress: email address of library
843                   KohaAdminEmailAddress: KohaAdminEmailAddress
844             - '<br>If you chooose <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=EmailAddressForPatronRegistrations">EmailAddressForPatronRegistrations</a> you have to enter a valid email address: '
845             - pref: EmailAddressForPatronRegistrations
846               class: email
847     Suggestions:
848         -
849             - pref: OpacSuggestionManagedBy
850               choices:
851                   1: Show
852                   0: Don't show
853             - "the name of the staff member who managed a suggestion in OPAC."
854         -
855             - pref: AnonSuggestions
856               choices:
857                   1: Allow
858                   0: "Don't allow"
859             - 'patrons that aren''t logged in to make purchase suggestions. Suggestions are connected to the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=AnonymousPatron">AnonymousPatron</a> system preference.'
860         -
861             - Limit patrons to
862             - pref: MaxOpenSuggestions
863               class: integer
864             - "open suggestions. Leave empty for no limit. **Note: this setting does not affect anonymous suggestions."
865         -
866             - Number of total suggestions allowed
867             - pref: MaxTotalSuggestions
868               class: integer
869             - "in"
870             - pref: NumberOfSuggestionDays
871               class: integer
872             - "days."
873         -
874             - pref: OPACViewOthersSuggestions
875               choices:
876                   1: Show
877                   0: "Don't show"
878             - purchase suggestions from other patrons on the OPAC.
879         -
880             - "Fields that should be mandatory for patron purchase suggestions:"
881             - pref: OPACSuggestionMandatoryFields
882               type: modalselect
883               source: suggestions
884               required: title
885             - "<br />Note: if none of the above options are selected, 'Title' field would be mandatory anyway, by default."
886         -
887             - "Fields that should be hidden for patron purchase suggestions:"
888             - pref: OPACSuggestionUnwantedFields
889               type: modalselect
890               source: suggestions
891               exclusions: title
892             - '<br />Note: Do not make <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACSuggestionMandatoryFields">OPACSuggestionMandatoryFields</a> unwanted fields '
893         -
894             - pref: suggestion
895               choices:
896                   1: Enable
897                   0: "Disable"
898             - 'purchase suggestions in the OPAC.<br>'
899             - 'When <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=suggestion">suggestion</a> is enabled and <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=AnonSuggestions">AnonSuggestions</a> is disabled, following patron categories are not allowed to make purchase suggestions:'
900             - pref: suggestionPatronCategoryExceptions
901               choices: patron-categories
902               class: multiple
903         -
904             - pref: OPACSuggestionAutoFill
905               default: 0
906               choices:
907                   1: Enable
908                   0: Disable
909             - OPAC suggestions form automatically filling with data from Google Books API.
910     Advanced search options:
911         -
912             - "Show search options:"
913             - pref: OpacAdvSearchOptions
914               multiple:
915                 pubdate: Publication date
916                 itemtype: Item types
917                 language: Language
918                 subtype: Subtypes
919                 sorting: Sorting
920                 location: Location and availability
921         -
922             - "Show search options for the expanded view:"
923             - pref: OpacAdvSearchMoreOptions
924               multiple:
925                 pubdate: Publication date
926                 itemtype: Item types
927                 language: Language
928                 subtype: Subtypes
929                 sorting: Sorting
930                 location: Location and availability
931         -
932             - Show tabs in the OPAC advanced search for limiting searches on the
933             - pref: OpacAdvancedSearchTypes
934               class: long
935             - "fields (separate values with |). Tabs appear in the order listed.<br/>"
936             - "<em>Currently supported values</em>: Item types (<strong>itemtypes</strong>), Collection, (<strong>ccode</strong>) and Shelving location (<strong>loc</strong>)."
937     Authentication:
938         -
939             - pref: OPACShibOnly
940               choices:
941                   1: "Don't allow"
942                   0: Allow
943             - patrons to login by means other than Shibboleth.