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