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: OPACReportProblem
 340               choices:
 341                   1: Allow
 342                   0: "Don't allow"
 343             - patrons to submit problem reports for OPAC pages to the library or Koha administrator.
 344             - "<br/>"
 345             - '<strong>NOTE:</strong> You must have <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=KohaAdminEmailAddress">KohaAdminEmailAddress</a> enabled.'
 346         -
 347             - pref: opacuserlogin
 348               choices:
 349                   1: Allow
 350                   0: "Don't allow"
 351             - patrons to log in to their accounts on the OPAC.
 352         -
 353             - Show
 354             - pref: OpacItemLocation
 355               choices:
 356                   location: "library, location, and call number"
 357                   ccode: "library, collection code, and call number"
 358                   callnum: "library and call number"
 359                   library: "only library"
 360             - for items on the OPAC search results.
 361         -
 362             - pref: OpacPasswordChange
 363               choices:
 364                   1: Allow
 365                   0: "Don't allow"
 366             - patrons to change their own password on the OPAC. Note that this must be off to use LDAP authentication.
 367         -
 368             - "Library patrons are "
 369             - pref: OpacResetPassword
 370               default: 1
 371               choices:
 372                   1: "allowed"
 373                   0: "not allowed"
 374             - " to recover their password via e-mail in the OPAC."
 375         -
 376             - pref: OPACpatronimages
 377               choices:
 378                   1: Show
 379                   0: "Don't show"
 380             - patron images on the patron information page in the OPAC.
 381         -
 382             - pref: OPACDetailQRCode
 383               choices:
 384                   1: Enable
 385                   0: Disable
 386             - the option to show a QR Code on the OPAC bibliographic detail page.
 387         -
 388             - pref: OPACFinesTab
 389               choices:
 390                   1: Allow
 391                   0: "Don't allow"
 392             - patrons to access the charges tab on their account page on the OPAC.
 393         -
 394             - pref: OpacBrowser
 395               choices:
 396                   1: Allow
 397                   0: "Don't allow"
 398             - "patrons to browse subject authorities on the OPAC."
 399             - "<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."
 400         -
 401             - pref: OpacCloud
 402               choices:
 403                   1: Show
 404                   0: "Don't show"
 405             - "a subject cloud on the OPAC."
 406             - "<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."
 407         -
 408             - pref: OpacAuthorities
 409               choices:
 410                   1: Allow
 411                   0: "Don't allow"
 412             - patrons to search your authority records.
 413         -
 414             - pref: opacbookbag
 415               choices:
 416                   1: Allow
 417                   0: "Don't allow"
 418             - patrons to store items in a temporary "Cart" on the OPAC.
 419         -
 420             - pref: OpacTopissue
 421               choices:
 422                   1: Allow
 423                   0: "Don't allow"
 424             - 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.
 425         -
 426             - pref: OPACComments
 427               choices:
 428                   1: Allow
 429                   0: "Don't allow"
 430             - patrons to make comments on items on the OPAC.
 431         -
 432             - Show
 433             - pref: ShowReviewer
 434               choices:
 435                   none: no name
 436                   full: full name
 437                   first: first name
 438                   surname: last name
 439                   firstandinitial: first name and last name initial
 440                   username: username
 441             - of commenter with comments in OPAC.
 442         -
 443             - pref: ShowReviewerPhoto
 444               choices:
 445                   1: Show
 446                   0: Don't show
 447             - 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.
 448         -
 449             - pref: OPACHoldRequests
 450               choices:
 451                   1: Allow
 452                   0: "Don't allow"
 453             - patrons to place holds on items from the OPAC.
 454         -
 455             - Display
 456             - pref: numSearchRSSResults
 457               class: long
 458             -  search results in the RSS feed.
 459         -
 460             - Show
 461             - pref: SocialNetworks
 462               multiple:
 463                 facebook: Facebook
 464                 linkedin: LinkedIn
 465                 email: Email
 466                 twitter: Twitter
 467
 468             - "social network links on the OPAC detail pages."
 469         -
 470             - pref: OpacBrowseResults
 471               default: 1
 472               choices:
 473                   1: Enable
 474                   0: Disable
 475             - browsing and paging search results from the OPAC detail page.
 476         -
 477             - Show quote of the day in the
 478             - pref: QuoteOfTheDay
 479               multiple:
 480                 intranet: staff interface
 481                 opac: OPAC
 482             - main page.
 483         -
 484             - pref: OPACPopupAuthorsSearch
 485               default: 0
 486               choices:
 487                 1: Show
 488                 0: Don't show
 489             - the list of authors/subjects in a popup for a combined search on OPAC detail pages.
 490         -
 491             - pref: OpacHoldNotes
 492               default: 0
 493               choices:
 494                   1: Allow
 495                   0: "Don't allow"
 496             - patrons to add a note when placing a hold.
 497         -
 498             - pref: OPACAcquisitionDetails
 499               default: 0
 500               choices:
 501                   1: Show
 502                   0: Don't show
 503             - the acquisition details on OPAC detail pages.
 504         -
 505             - pref: OpacNewsLibrarySelect
 506               default: 0
 507               choices:
 508                   1: Show
 509                   0: Don't show
 510             - a library selection list for news items in the OPAC.
 511         -
 512             - "Use the following as the OPAC ISBD template:"
 513             - pref: OPACISBD
 514               type: textarea
 515               syntax: text/html
 516               class: code
 517         -
 518             - pref: OpacBrowseSearch
 519               default: 0
 520               choices:
 521                   1: Enable
 522                   0: Disable
 523             - "interface for browsing all holdings (Elasticsearch only)."
 524         -
 525             - pref: OPACAuthorIdentifiers
 526               default: 0
 527               choices:
 528                   1: Display
 529                   0: "Don't display"
 530             - "identifiers for authors and contributors to the detail pages in the OPAC."
 531             - "This feature requires authorities with 024$2 and 024$a."
 532             - "Valid source codes in $2 are currently: orcid, scopus, loop, rid and viaf."
 533     OpenURL:
 534         -
 535             - 'Complete URL of OpenURL resolver (starting with <code>http://</code> or <code>https://</code>):'
 536             - pref: OpenURLResolverURL
 537               class: url
 538         -
 539             - 'Text of OpenURL links (or image title if <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OpenURLImageLocation">OpenURLImageLocation</a> is defined):'
 540             - pref: OpenURLText
 541         -
 542             - 'Location of image for OpenURL links:'
 543             - pref: OpenURLImageLocation
 544               class: url
 545             - '<br />Can be an absolute URL starting with <code>http://</code> or'
 546             - '<code>https://</code> or a relative URL'
 547             - '<br />Examples:'
 548             - '<br />- <code>http://www.example.com/img/openurl.png</code>'
 549             - '<br />- <code>/opac-tmpl/bootstrap/images/OpenURL.png</code>'
 550         -
 551             - pref: OPACShowOpenURL
 552               choices:
 553                   1: Enable
 554                   0: Disable
 555             - 'display of OpenURL link in OPAC search results and detail page.'
 556         -
 557             - 'List of item type codes (separated by spaces) for those you want to show the OpenURL link:'
 558             - pref: OPACOpenURLItemTypes
 559             - '<br />'
 560     Policy:
 561         -
 562             - pref: SearchMyLibraryFirst
 563               choices:
 564                   1: Limit
 565                   0: "Don't limit"
 566             - "patrons' searches to the library they are registered at."
 567         -
 568             - pref: OpacRenewalAllowed
 569               choices:
 570                   1: Allow
 571                   0: "Don't allow"
 572             - patrons to renew their own books on the OPAC.
 573         -
 574             - Use
 575             - pref: OpacRenewalBranch
 576               choices:
 577                   itemhomebranch: "the item's home library"
 578                   patronhomebranch: "the patron's home library"
 579                   checkoutbranch: "the library the item was checked out from"
 580                   none: "NULL"
 581                   opacrenew: "'OPACRenew'"
 582             - as branchcode to store in the statistics table.
 583         -
 584             - Only allow patrons to renew their own books on the OPAC if they have less than
 585             - pref: OPACFineNoRenewals
 586               class: currency
 587             - '[% local_currency %] in fines (leave blank to disable).'
 588         -
 589             - pref: OPACFineNoRenewalsIncludeCredits
 590               choices:
 591                   1: Include
 592                   0: "Don't include"
 593             - outstanding/unapplied credits when applying the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACFineNoRenewals">OPACFineNoRenewals</a> rule to patrons.
 594         -
 595             - pref: OpacHiddenItems
 596               type: textarea
 597               syntax: text/x-yaml
 598               class: code
 599             - 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>.
 600         -
 601             - '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>:'
 602             - pref: OpacHiddenItemsExceptions
 603               choices: patron-categories
 604               class: multiple
 605         -
 606             - pref: OpacHiddenItemsHidesRecord
 607               default: 1
 608               choices:
 609                   0: "Don't hide"
 610                   1: Hide
 611             - "the bibliographic record when all its items are hidden by <a href='/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OpacHiddenItems'>OpacHiddenItems</a>."
 612         -
 613             - pref: OpacAllowPublicListCreation
 614               default: 1
 615               choices:
 616                   0: "Don't allow"
 617                   1: Allow
 618             - "OPAC users to create public lists."
 619         -
 620             - pref: OpacAllowSharingPrivateLists
 621               default: 0
 622               choices:
 623                   0: "Don't allow"
 624                   1: Allow
 625             - "OPAC users to share private lists with other patrons."
 626         -
 627             - pref: BlockExpiredPatronOpacActions
 628               choices:
 629                 1: "Block"
 630                 0: "Don't block"
 631             - 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.
 632
 633     Privacy:
 634         -
 635             - pref: opacreadinghistory
 636               choices:
 637                   1: Allow
 638                   0: "Don't allow"
 639             - patrons to see what books they have checked out in the past.
 640         -
 641             - pref: OPACHoldsHistory
 642               choices:
 643                   1: Allow
 644                   0: "Don't allow"
 645             - patrons to see the list of their past holds.
 646         -
 647             - pref: EnableOpacSearchHistory
 648               default: 0
 649               choices:
 650                   1: Keep
 651                   0: "Don't keep"
 652             - patron search history in the OPAC.
 653         -
 654             - pref: OPACPrivacy
 655               default: 0
 656               choices:
 657                   1: Allow
 658                   0: "Don't allow"
 659             - '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.'
 660         -
 661             - pref: AllowPatronToSetCheckoutsVisibilityForGuarantor
 662               default: 0
 663               choices:
 664                   1: Allow
 665                   0: "Don't allow"
 666             - "patrons to choose their own privacy settings for showing the patron's checkouts to the patron's guarantor."
 667         -
 668             - pref: AllowPatronToSetFinesVisibilityForGuarantor
 669               default: 0
 670               choices:
 671                   1: Allow
 672                   0: "Don't allow"
 673             - "patrons to choose their own privacy settings for showing the patron's fines to the patron's guarantor."
 674         -
 675             - Use borrowernumber
 676             - pref: AnonymousPatron
 677               class: integer
 678             - "as the anonymous patron (for anonymous suggestions and checkout history)."
 679         -
 680             - pref: TrackClicks
 681               default: 0
 682               choices:
 683                   anonymous: "Track anonymously"
 684                   track: "Track"
 685                   0: "Don't track"
 686             - "links that patrons click on."
 687     Restricted page:
 688         -
 689             - "Access from IP addresses beginning with"
 690             - pref: RestrictedPageLocalIPs
 691             - "do not need to be authenticated (comma separated - ex: '127.0.0,127.0.1')."
 692         -
 693             - "HTML content of your restricted page (available at /cgi-bin/koha/opac-restrictedpage.pl)"
 694             - pref: RestrictedPageContent
 695               type: textarea
 696               syntax: text/html
 697               class: HTML
 698         -
 699             - Use
 700             - pref: RestrictedPageTitle
 701               class: long
 702             - "as title of your restricted page (appears in the breadcrumb and on the top of the restricted page)."
 703     Shelf browser:
 704         -
 705             - pref: OPACShelfBrowser
 706               choices:
 707                   1: Show
 708                   0: "Don't show"
 709             - "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."
 710         -
 711             - pref: ShelfBrowserUsesLocation
 712               default: 1
 713               choices:
 714                   1: Use
 715                   0: "Don't use"
 716             - "the item location when finding items for the shelf browser."
 717         -
 718             - pref: ShelfBrowserUsesHomeBranch
 719               default: 1
 720               choices:
 721                   1: Use
 722                   0: "Don't use"
 723             - "the item home library when finding items for the shelf browser."
 724         -
 725             - pref: ShelfBrowserUsesCcode
 726               default: 0
 727               choices:
 728                   1: Use
 729                   0: "Don't use"
 730             - "the item collection code when finding items for the shelf browser."
 731
 732     Self registration and modification:
 733         -
 734             - pref: PatronSelfRegistration
 735               choices:
 736                   1: Allow
 737                   0: "Don't allow"
 738             - "library patrons to register for an account via the OPAC."
 739             - "<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."
 740         -
 741             - pref: PatronSelfRegistrationVerifyByEmail
 742               choices:
 743                   1: Require
 744                   0: "Don't require"
 745             - "that a self-registering patron verify themselves via email."
 746             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/cleanup_database.pl</code> cronjob. Ask your system administrator to schedule it."
 747         -
 748             - "Use"
 749             - pref: PatronSelfRegistrationDefaultCategory
 750               choices: patron-categories
 751             - "as the default patron category for patrons registered via the OPAC."
 752             - "<br><strong>WARNING: Do not use a regular patron category for self registration.</strong>"
 753             - "<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)."
 754         -
 755             - Delete patrons still in the category indicated by <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=PatronSelfRegistrationDefaultCategory">PatronSelfRegistrationDefaultCategory</a>
 756             - pref: PatronSelfRegistrationExpireTemporaryAccountsDelay
 757               class: integer
 758             - "days after account creation."
 759             - "<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."
 760         -
 761             - "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:"
 762             - pref: PatronSelfModificationMandatoryField
 763               type: modalselect
 764               source: borrowers
 765               exclusions: password|cardnumber|dateexpiry|categorycode|sort1|sort2|opacnote|borrowernotes|gonenoaddress|lost|flags
 766         -
 767             - "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:"
 768             - pref: PatronSelfRegistrationBorrowerMandatoryField
 769               type: modalselect
 770               source: borrowers
 771               exclusions: sort1|sort2|opacnote|borrowernotes|gonenoaddress|lost|flags
 772         -
 773             - "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:"
 774             - pref: PatronSelfRegistrationBorrowerUnwantedField
 775               type: modalselect
 776               source: borrowers
 777               exclusions: branchcode|sort1|sort2|gonenoaddress|lost|flags
 778         -
 779             - "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:"
 780             - pref: PatronSelfModificationBorrowerUnwantedField
 781               type: modalselect
 782               source: borrowers
 783               exclusions: sort1|sort2|gonenoaddress|lost|flags
 784         -
 785             - "Display the following additional instructions for patrons who self register via the OPAC ( HTML is allowed ):"
 786             - pref: PatronSelfRegistrationAdditionalInstructions
 787               type: textarea
 788               syntax: text/html
 789               class: html
 790         -
 791             - pref: PatronSelfRegistrationEmailMustBeUnique
 792               choices:
 793                   1: "Consider"
 794                   0: "Don't consider"
 795             - "patron's email (borrowers.email) as unique on self registering. An email won't be accepted if it already exists in the database."
 796         -
 797             - "Enable the self registration for the following libraries:"
 798             - pref: PatronSelfRegistrationLibraryList
 799             - (separate branchcode with |).
 800             - If empty, all libraries will be listed.
 801         -
 802             - pref: PatronSelfRegistrationPrefillForm
 803               choices:
 804                   1: "Show and prefill"
 805                   0: "Don't show and prefill"
 806             - "password and login form after a patron has self registered."
 807         -
 808             - pref: PatronSelfRegistrationConfirmEmail
 809               choices:
 810                   1: Require
 811                   0: "Don't require"
 812             - patrons to confirm their email address by entering it twice.
 813         -
 814             - pref: OPACPatronDetails
 815               choices:
 816                   1: Allow
 817                   0: "Don't allow"
 818             - patrons to notify the library of changes to their contact information from the OPAC.
 819         -
 820             - "Choose email address that new patron self-registrations will be sent to: "
 821             - pref: EmailPatronRegistrations
 822               default: 0
 823               choices:
 824                   0: none
 825                   EmailAddressForPatronRegistrations: EmailAddressForPatronRegistrations
 826                   BranchEmailAddress: email address of library
 827                   KohaAdminEmailAddress: KohaAdminEmailAddress
 828             - '<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: '
 829             - pref: EmailAddressForPatronRegistrations
 830               class: email
 831     Suggestions:
 832         -
 833             - pref: OpacSuggestionManagedBy
 834               choices:
 835                   1: Show
 836                   0: Don't show
 837             - "the name of the staff member who managed a suggestion in OPAC."
 838         -
 839             - pref: AnonSuggestions
 840               choices:
 841                   1: Allow
 842                   0: "Don't allow"
 843             - '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.'
 844         -
 845             - Limit patrons to
 846             - pref: MaxOpenSuggestions
 847               class: integer
 848             - "open suggestions. Leave empty for no limit. **Note: this setting does not affect anonymous suggestions."
 849         -
 850             - Number of total suggestions allowed
 851             - pref: MaxTotalSuggestions
 852               class: integer
 853             - "in"
 854             - pref: NumberOfSuggestionDays
 855               class: integer
 856             - "days."
 857         -
 858             - pref: OPACViewOthersSuggestions
 859               choices:
 860                   1: Show
 861                   0: "Don't show"
 862             - purchase suggestions from other patrons on the OPAC.
 863         -
 864             - "Fields that should be mandatory for patron purchase suggestions:"
 865             - pref: OPACSuggestionMandatoryFields
 866               type: modalselect
 867               source: suggestions
 868               required: title
 869             - "<br />Note: if none of the above options are selected, 'Title' field would be mandatory anyway, by default."
 870         -
 871             - "Fields that should be hidden for patron purchase suggestions:"
 872             - pref: OPACSuggestionUnwantedFields
 873               type: modalselect
 874               source: suggestions
 875               exclusions: title
 876             - '<br />Note: Do not make <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACSuggestionMandatoryFields">OPACSuggestionMandatoryFields</a> unwanted fields '
 877         -
 878             - pref: suggestion
 879               choices:
 880                   1: Enable
 881                   0: "Disable"
 882             - 'purchase suggestions in the OPAC.<br>'
 883             - '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:'
 884             - pref: suggestionPatronCategoryExceptions
 885               choices: patron-categories
 886               class: multiple
 887         -
 888             - pref: OPACSuggestionAutoFill
 889               default: 0
 890               choices:
 891                   1: Enable
 892                   0: Disable
 893             - OPAC suggestions form automatically filling with data from Google Books API.
 894     Advanced search options:
 895         -
 896             - "Show search options:"
 897             - pref: OpacAdvSearchOptions
 898               multiple:
 899                 pubdate: Publication date
 900                 itemtype: Item types
 901                 language: Language
 902                 subtype: Subtypes
 903                 sorting: Sorting
 904                 location: Location and availability
 905         -
 906             - "Show search options for the expanded view:"
 907             - pref: OpacAdvSearchMoreOptions
 908               multiple:
 909                 pubdate: Publication date
 910                 itemtype: Item types
 911                 language: Language
 912                 subtype: Subtypes
 913                 sorting: Sorting
 914                 location: Location and availability
 915         -
 916             - Show tabs in the OPAC advanced search for limiting searches on the
 917             - pref: OpacAdvancedSearchTypes
 918               class: long
 919             - "fields (separate values with |). Tabs appear in the order listed.<br/>"
 920             - "<em>Currently supported values</em>: Item types (<strong>itemtypes</strong>), Collection, (<strong>ccode</strong>) and Shelving location (<strong>loc</strong>)."
 921     Authentication:
 922         -
 923             - pref: OPACShibOnly
 924               choices:
 925                   1: "Don't allow"
 926                   0: Allow
 927             - patrons to login by means other than Shibboleth.