koha-tmpl/intranet-tmpl/prog/en/modules/admin/preferences/circulation.pref

   1 Circulation:
   2     Interface:
   3         -
   4             - pref: CircSidebar
   5               choices:
   6                   1: Activate
   7                   0: Deactivate
   8             - the navigation sidebar on all circulation pages.
   9         -
  10             - pref: CircConfirmItemParts
  11               choices:
  12                   1: "Require"
  13                   0: "Don't require"
  14             - staff to confirm that all parts of an item are present at checkin/checkout.
  15         -
  16             - pref: AutoSwitchPatron
  17               choices:
  18                   1: "Enable"
  19                   0: "Don't enable"
  20             - the automatic redirection to another patron when a patron barcode is scanned instead of a book.
  21             - This should not be enabled if you have overlapping patron and book barcodes.
  22         -
  23             - pref: PatronAutoComplete
  24               choices:
  25                   1: Try
  26                   0: "Don't try"
  27             - to guess the patron being entered while typing a patron search for circulation or patron search.
  28             - Only returns the first 10 results at a time.
  29         -
  30             - pref: itemBarcodeInputFilter
  31               choices:
  32                   OFF: "Don't filter"
  33                   whitespace: Remove spaces from
  34                   cuecat: Convert from CueCat form
  35                   T-prefix: Remove the first number from T-prefix style
  36                   libsuite8: Convert from Libsuite8 form
  37                   EAN13: EAN-13 or zero-padded UPC-A form
  38             - scanned item barcodes. Mind that any leading or trailing whitespace in a barcode gets removed before this filter.
  39         -
  40             - pref: itemBarcodeFallbackSearch
  41               choices:
  42                   1: "Enable"
  43                   0: "Don't enable"
  44             - the automatic use of a keyword catalog search if the phrase entered as a barcode on the checkout page does not turn up any results during an item barcode search.
  45         -
  46             - Sort previous checkouts on the circulation page from
  47             - pref: previousIssuesDefaultSortOrder
  48               choices:
  49                   asc: earliest to latest
  50                   desc: latest to earliest
  51             - due date.
  52         -
  53             - "Sort today's checkouts on the circulation page from"
  54             - pref: todaysIssuesDefaultSortOrder
  55               type: choice
  56               choices:
  57                   asc: earliest to latest
  58                   desc: latest to earliest
  59             - checkout time.
  60         -
  61             - pref: SpecifyDueDate
  62               choices:
  63                   1: Allow
  64                   0: "Don't allow"
  65             - staff to specify a due date for a checkout.
  66         -
  67             - pref: SpecifyReturnDate
  68               choices:
  69                   1: Allow
  70                   0: "Don't allow"
  71             - staff to specify a return date for a check in.
  72         -
  73             - Set the default start date for the Holds to pull list to
  74             - pref: HoldsToPullStartDate
  75               class: integer
  76             - day(s) ago. Note that the default end date is controlled by the system preference <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=ConfirmFutureHolds">ConfirmFutureHolds</a>.
  77         -
  78             - pref: AllowAllMessageDeletion
  79               choices:
  80                   1: Allow
  81                   0: "Don't allow"
  82             - staff to delete messages added from other libraries.
  83         -
  84             - Show the
  85             - pref: numReturnedItemsToShow
  86               class: integer
  87             - last returned items on the checkin screen.
  88         -
  89             - pref: FineNotifyAtCheckin
  90               choices:
  91                   1: Notify
  92                   0: "Don't notify"
  93             - librarians of overdue fines on the items they are checking in.
  94         -
  95             - pref: WaitingNotifyAtCheckin
  96               choices:
  97                   1: Notify
  98                   0: "Don't notify"
  99             - librarians of waiting holds for the patron whose items they are checking in.
 100         -
 101             - pref: FilterBeforeOverdueReport
 102               choices:
 103                   1: Require
 104                   0: "Don't require"
 105             - staff to choose which checkouts to show before running the overdues report.
 106         -
 107             - pref: DisplayClearScreenButton
 108               choices:
 109                   no: "Don't show clear screen button"
 110                   issueslip: "Show print slip and clear screen buttons"
 111                   issueqslip: "Show print quick slip and clear screen buttons"
 112             - to clear the current patron from the screen on the circulation screen.
 113         -
 114             - pref: RecordLocalUseOnReturn
 115               choices:
 116                   1: Record
 117                   0: "Don't record"
 118             - local use when an unissued item is checked in.
 119         -
 120             - When an empty barcode field is submitted in circulation
 121             - pref: CircAutoPrintQuickSlip
 122               choices:
 123                   clear: "clear the screen"
 124                   qslip: "open a print quick slip window"
 125                   slip: "open a print slip window"
 126             - .
 127         -
 128             - Include the stylesheet at
 129             - pref: NoticeCSS
 130               class: url
 131             - on notices. (This should be a complete URL, starting with <code>http://</code>)
 132         -
 133             - pref: UpdateTotalIssuesOnCirc
 134               choices:
 135                   1: Do
 136                   0: "Don't"
 137             - update a bibliographic record's total checkouts count whenever an item is checked out (WARNING! This increases server load significantly; if performance is a concern, use the update_totalissues.pl cron job to update the total checkouts count).
 138         -
 139             - pref: ExportCircHistory
 140               choices:
 141                   1: Show
 142                   0: "Don't show"
 143             - the export patron checkout history options.
 144         -
 145             - "The following fields should be excluded from the patron checkout history CSV or MARC (ISO 2709) export:"
 146             - pref: ExportRemoveFields
 147             - (separate fields with space, e.g. 100a 200b 300c).
 148         -
 149             - pref: AllowOfflineCirculation
 150               choices:
 151                   1: Enable
 152                   0: "Don't enable"
 153             - "offline circulation on regular circulation computers. (<strong>NOTE:</strong> This system preference does not affect the Firefox add-on or the desktop application)."
 154         -
 155             - pref: ShowAllCheckins
 156               choices:
 157                   1: Show
 158                   0: "Don't show"
 159             - all items in the "Checked-in items" list, even items that were not checked out.
 160         -
 161             - pref: AllowCheckoutNotes
 162               choices:
 163                   1: Allow
 164                   0: "Don't allow"
 165             - patrons to submit notes about checked out items.
 166         -
 167             - pref: UseCirculationDesks
 168               choices:
 169                   1: "Use"
 170                   0: "Don't use"
 171             - circulation desks with circulation.
 172
 173     Checkout policy:
 174         -
 175             - pref: OnSiteCheckoutAutoCheck
 176               choices:
 177                   1: Enable
 178                   0: Don't enable
 179             - on-site checkout by default if last checkout was an on-site one.
 180         -
 181             - pref: AutoReturnCheckedOutItems
 182               choices:
 183                   1: Don't
 184                   0: Do
 185             - require librarians to manually confirm a checkout where the item is already checked out to another patron.
 186         -
 187             - pref: AllowSetAutomaticRenewal
 188               choices:
 189                   1: Allow
 190                   0: "Don't allow"
 191             - staff to flag items for autorenewal on the checkout page.
 192         -
 193             - pref: AllowTooManyOverride
 194               choices:
 195                   1: Allow
 196                   0: "Don't allow"
 197             - staff to override and check out items when the patron has reached the maximum number of allowed checkouts.
 198         -
 199             - pref: AllowNotForLoanOverride
 200               choices:
 201                   1: Allow
 202                   0: "Don't allow"
 203             - staff to override and check out items that are marked as not for loan.
 204         -
 205             - pref: AllowRenewalLimitOverride
 206               choices:
 207                   1: Allow
 208                   0: "Don't allow"
 209             - staff to manually override renewal blocks and renew a checkout when it would go over the renewal limit or be premature for the "No renewal before" setting in the circulation policy or has been scheduled for automatic renewal.
 210         -
 211             - pref: AllowRenewalOnHoldOverride
 212               choices:
 213                   1: Allow
 214                   0: "Don't allow"
 215             - staff to renew items that are on hold by manually specifying a due date.
 216         -
 217             - pref: AllowItemsOnHoldCheckoutSIP
 218               choices:
 219                   1: Allow
 220                   0: "Don't allow"
 221             - checkouts of items reserved to someone else via SIP checkout messages.
 222             - If allowed do not generate RESERVED warning.
 223             - This allows self checkouts for those items. If using the holds queue items with pending holds will be marked as "unavailable" if this set to "Don't allow".
 224         -
 225             - pref: AllowItemsOnHoldCheckoutSCO
 226               choices:
 227                   1: Allow
 228                   0: "Don't allow"
 229             - checkouts of items reserved to someone else in the SCO module. If allowed do not generate RESERVE_WAITING and RESERVED warning. This allows self checkouts for those items.
 230         -
 231             - pref: AllFinesNeedOverride
 232               choices:
 233                   1: Require
 234                   0: "Don't require"
 235             - staff to manually override all fines, even fines less than set in the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=noissuescharge">noissuescharge</a> system preference. Enabling this system preference will block all checkouts for patrons with fines both via the web-based self checkout system and via SIP.
 236         -
 237             - pref: AllowFineOverride
 238               choices:
 239                   1: Allow
 240                   0: "Don't allow"
 241             - staff to manually override and check out items to patrons who have more in fines than set in the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=noissuescharge">noissuescharge</a> system preference.
 242         -
 243             - pref: AutomaticItemReturn
 244               choices:
 245                   1: Do
 246                   0: "Don't"
 247             - automatically transfer items to their home library when they are checked in.
 248         -
 249             - pref: UseBranchTransferLimits
 250               choices:
 251                   1: Enforce
 252                   0: "Don't enforce"
 253             - library transfer limits based on
 254             - pref: BranchTransferLimitsType
 255               choices:
 256                   ccode: collection code
 257                   itemtype: item type
 258             - .
 259         -
 260             - pref: UseTransportCostMatrix
 261               choices:
 262                   1: Use
 263                   0: "Don't use"
 264             - the transport cost matrix for calculating optimal holds filling between libraries.
 265         -
 266             - Use the calendar and circulation rules of
 267             - pref: CircControl
 268               type: choice
 269               choices:
 270                   PickupLibrary: the library you are logged in at.
 271                   PatronLibrary: the library the patron is from.
 272                   ItemHomeLibrary: the library the item is from.
 273         -
 274             - Use the checkout and fines rules of
 275             - pref: HomeOrHoldingBranch
 276               type: choice
 277               choices:
 278                   homebranch: the item's home library (homebranch).
 279                   holdingbranch: the item's holding library (holdingbranch).
 280         -
 281             - Allow items to be checked in
 282             - pref: AllowReturnToBranch
 283               type: choice
 284               choices:
 285                   anywhere: at any library.
 286                   homebranch: only at the library the item is from.
 287                   holdingbranch: only at the library the item was checked out from.
 288                   homeorholdingbranch: either at the library the item is from or the library it was checked out from.
 289         -
 290             - For search results in the staff interface, display
 291             - pref: StaffSearchResultsDisplayBranch
 292               type: choice
 293               choices:
 294                   homebranch: the library the item is from.
 295                   holdingbranch: the library the item is held by.
 296         -
 297             - pref: useDaysMode
 298               choices:
 299                   Days: Ignore the calendar
 300                   Calendar: Use the calendar to skip days the library is closed
 301                   Datedue: Use the calendar to push the due date to the next open day
 302                   Dayweek: Use the calendar to push the due date to the next open matching weekday for weekly loan periods, or the next open day otherwise
 303             - when calculating the date due.
 304         -
 305             - Calculate "No renewal before" based on
 306             - pref: NoRenewalBeforePrecision
 307               choices:
 308                   date: date.
 309                   exact_time: exact time.
 310             - Only relevant for loans calculated in days, hourly loans are not affected.
 311         -
 312             - When renewing checkouts, base the new due date on
 313             - pref: RenewalPeriodBase
 314               choices:
 315                   date_due: the old due date of the checkout.
 316                   now: the current date.
 317         -
 318             - pref: RenewalSendNotice
 319               choices:
 320                   1: Send
 321                   0: "Don't send"
 322             - "a renewal notice according to patron's messaging preferences for 'Item checkout'."
 323         -
 324             - pref: UnseenRenewals
 325               choices:
 326                   1: Allow
 327                   0: "Don't allow"
 328             - renewals to be recorded as "unseen" by the library, and count against the patrons unseen renewals limit.
 329         -
 330             - Prevent patrons from making holds on the OPAC if they owe more than
 331             - pref: maxoutstanding
 332               class: currency
 333             - '[% local_currency %] in fines.'
 334         -
 335             - Show a warning on the "Transfers to receive" screen if the transfer has not been received
 336             - pref: TransfersMaxDaysWarning
 337               class: integer
 338             - days after it was sent.
 339         -
 340             - pref: IssuingInProcess
 341               choices:
 342                   1: "Don't prevent"
 343                   0: "Prevent"
 344             - patrons from checking out an item whose rental charge would take them over the limit.
 345         -
 346             - "Restrict patrons with the following target audience values from checking out inappropriate materials:"
 347             - pref: AgeRestrictionMarker
 348             - ". For example, enter target audience keyword(s) split by | (bar) FSK|PEGI|Age| (No white space near |). Be sure to map agerestriction in Koha to MARC mapping (e.g. 521$a). A MARC field value of FSK 12 or PEGI 12 would mean: Borrower must be 12 years old. Leave empty to not apply an age restriction."
 349         -
 350             - pref: AgeRestrictionOverride
 351               choices:
 352                   1: Allow
 353                   0: "Don't allow"
 354             - staff to check out an item with age restriction.
 355         -
 356             - Prevent patrons from checking out items if they have more than
 357             - pref: noissuescharge
 358               class: integer
 359             - '[% local_currency %] in fines.'
 360         -
 361             - Prevent a patron from checking out if the patron has guarantees owing in total more than
 362             - pref: NoIssuesChargeGuarantees
 363               class: integer
 364             - '[% local_currency %] in fines.'
 365         -
 366             - Prevent a patron from checking out if the patron has guarantors and those guarantor's guarantees owing in total more than
 367             - pref: NoIssuesChargeGuarantorsWithGuarantees
 368               class: integer
 369             - '[% local_currency %] in fines.'
 370         -
 371             - pref: RentalsInNoissuesCharge
 372               choices:
 373                   1: Include
 374                   0: "Don't include"
 375             - rental charges when summing up charges for limit set in the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=noissuescharge">noissuescharge</a> system preference.
 376         -
 377             - pref: ManInvInNoissuesCharge
 378               choices:
 379                   1: Include
 380                   0: "Don't include"
 381             - custom debit type charges when summing up charges for limit set in the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=noissuescharge">noissuescharge</a> system preference.
 382         -
 383             - pref: HoldsInNoissuesCharge
 384               choices:
 385                   1: Include
 386                   0: "Don't include"
 387             - hold charges when summing up charges for limit set in the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=noissuescharge">noissuescharge</a> system preference.
 388         -
 389             - pref: ReturnBeforeExpiry
 390               choices:
 391                   1: Require
 392                   0: "Don't require"
 393             - "patrons to return items before their accounts expire (by restricting due dates to before the patron's expiration date)."
 394         -
 395             - "Send all notices as a BCC to this email address:"
 396             - pref: NoticeBcc
 397               class: email
 398         -
 399             - pref: OverdueNoticeCalendar
 400               choices:
 401                   1: "Use calendar"
 402                   0: "Ignore calendar"
 403             - "when working out the period for overdue notices."
 404         -
 405             - "Organize and send overdue notices using the"
 406             - pref: OverdueNoticeFrom
 407               choices:
 408                   cron: "command-line option"
 409                   item-issuebranch: "checkout library"
 410                   item-homebranch: "item home library"
 411             - .
 412         -
 413             - Include up to
 414             - pref: PrintNoticesMaxLines
 415               class: integer
 416             - "item lines in a printed overdue notice. If the number of items is greater than this number, the notice will end with a warning asking the patron to check their online account for a full list of overdue items. Set to 0 to include all overdue items in the notice, no matter how many there are."
 417         -
 418             - pref: OverduesBlockCirc
 419               choices:
 420                   block: Block
 421                   noblock: "Don't block"
 422                   confirmation: Ask for confirmation
 423             - "when checking out to a patron that has overdues outstanding."
 424         -
 425             - "When checking out an item with rental fees, "
 426             - pref: RentalFeesCheckoutConfirmation
 427               choices:
 428                   1: ask
 429                   0: "don't ask"
 430             - "for confirmation."
 431         -
 432             - By default, set the LOST value of an item to
 433             - pref: DefaultLongOverdueLostValue
 434               class: integer
 435             - when the item has been overdue for more than
 436             - pref: DefaultLongOverdueDays
 437               class: integer
 438             - days.
 439             - <br>WARNING — These preferences will activate the automatic item loss process. Leave these fields empty if you don't want to activate this feature.
 440             - "<br>Example: [1] [30] Sets an item to the LOST value 1 when it has been overdue for more than 30 days."
 441             - <br>(Used when the longoverdue.pl script is called without the --lost parameter)
 442             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/longoverdue.pl</code> cronjob. Ask your system administrator to schedule it."
 443         -
 444             - "Charge a lost item to the patron's account when the LOST value of the item changes to:"
 445             - pref: DefaultLongOverdueChargeValue
 446               class: integer
 447             - <br>Leave this field empty if you don't want to charge the patron for lost items.
 448             - <br>(Used when the longoverdue.pl script is called without the --charge parameter)
 449             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/longoverdue.pl</code> cronjob. Ask your system administrator to schedule it."
 450         -
 451             - When using the automatic item loss process, skip items with lost values matching any of
 452             - pref: DefaultLongOverdueSkipLostStatuses
 453             - "."
 454             - <br>Leave this field empty if you don't want to skip any lost statuses.
 455             - <br>Set to a list of comma separated values, e.g. <em>5,6,7</em>.
 456         -
 457             - "When issuing an item that has been marked as lost, "
 458             - pref: IssueLostItem
 459               choices:
 460                   confirm: "require confirmation"
 461                   alert: "display a message"
 462                   nothing : "do nothing"
 463             - .
 464         -
 465             - "When checking out an item, "
 466             - pref: RecordStaffUserOnCheckout
 467               choices:
 468                   1: "record"
 469                   0: "don't record"
 470             - "the user who checked out the item."
 471         -
 472             - "Mark items as returned when flagged as lost "
 473             - pref: MarkLostItemsAsReturned
 474               multiple:
 475                 cronjob: "from the longoverdue cronjob"
 476                 batchmod: "from the batch item modification tool"
 477                 additem: "when cataloguing an item"
 478                 moredetail: "from the items tab of the catalog module"
 479                 pendingreserves: "from the 'Holds to pull' list"
 480                 onpayment: "when receiving payment for the item"
 481                 claim_returned: "when marking an item as a return claim"
 482             - .
 483         -
 484             - pref: AllowMultipleIssuesOnABiblio
 485               choices:
 486                   1: Allow
 487                   0: "Don't allow"
 488             - "patrons to check out multiple items from the same record. (<strong>NOTE:</strong> This will only affect records without a subscription attached.)"
 489         -
 490             - pref: OnSiteCheckouts
 491               choices:
 492                   1: Enable
 493                   0: Disable
 494             - the on-site checkouts feature.
 495         -
 496             - pref: OnSiteCheckoutsForce
 497               choices:
 498                   1: Enable
 499                   0: Disable
 500             - the on-site checkout for all cases (even if a patron is debarred, etc.).
 501         -
 502             - pref: ConsiderOnSiteCheckoutsAsNormalCheckouts
 503               choices:
 504                   1: Consider
 505                   0: "Don't consider"
 506             - on-site checkouts as normal checkouts.
 507             - If enabled, on-site checkouts will count toward the checkout limit for regular checkouts. The on-site limit will still apply for on-site checkouts.
 508             - If disabled, both values will be checked separately.
 509         -
 510             - pref: SwitchOnSiteCheckouts
 511               choices:
 512                   1: Switch
 513                   0: "Don't switch"
 514             - on-site checkouts to normal checkouts when checked out.
 515         -
 516             - When a patron's checked out item is overdue,
 517             - pref: OverduesBlockRenewing
 518               type: choice
 519               choices:
 520                   allow: allow renewing.
 521                   blockitem: block renewing only for this item.
 522                   block: block renewing for all the patron's items.
 523         -
 524             - If a patron owes more than the value of <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACFineNoRenewals">OPACFineNoRenewals</a>,
 525             - pref: OPACFineNoRenewalsBlockAutoRenew
 526               choices:
 527                   1: block
 528                   0: allow
 529             - their auto-renewals.
 530         -
 531             - If a patron pays off all fines on an overdue item that is accruing fines,
 532             - pref: RenewAccruingItemWhenPaid
 533               choices:
 534                   1: renew
 535                   0: "don't renew"
 536             - the item automatically. If the system preference <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=RenewalPeriodBase">RenewalPeriodBase</a> is set to "due date", renewed items may still be overdue.
 537         -
 538             - If a patron pays off all fines on an overdue item that is accruing fines in the OPAC via a payment plugin,
 539             - pref: RenewAccruingItemInOpac
 540               choices:
 541                   1: renew
 542                   0: "don't renew"
 543             - the item automatically. If the system preference <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=RenewalPeriodBase">RenewalPeriodBase</a> is set to "due date", renewed items may still be overdue.
 544         -
 545             - pref: ItemsDeniedRenewal
 546               type: textarea
 547               syntax: text/x-yaml
 548               class: code
 549             - Define custom rules to deny specific items from renewal.
 550             - "<br />Can name any field in the items table followed by a colon then a space then"
 551             - "a bracketed list of values separated by commas."
 552             - "For example:"
 553             - "<br />ccode: [NEWFIC,NULL,DVD]"
 554             - "<br />itype: [NEWBK,\"\"]"
 555             - "<br /> <strong>NOTE:</strong> The word 'NULL' can be used to block renewal on undefined fields, while an empty string \"\" will block on an empty (but defined) field."
 556     Checkin policy:
 557         -
 558             - pref: TrapHoldsOnOrder
 559               choices:
 560                   1: Trap
 561                   0: "Don't trap"
 562             - items that are not for loan but holdable ( notforloan < 0 ) to fill holds.
 563         -
 564             - Never trap items with 'not for loan' values of
 565             - pref: SkipHoldTrapOnNotForLoanValue
 566               class: integer
 567             - to fill holds.
 568             - "(list of not for loan values separated with a pipe '|')"
 569         -
 570             - pref: HoldsAutoFill
 571               choices:
 572                   1: Do
 573                   0: "Don't"
 574             - automatically fill holds instead of asking the librarian.
 575         -
 576             - pref: HoldsNeedProcessingSIP
 577               choices:
 578                   1: "Don't fulfill"
 579                   0: Fulfill
 580             - holds automatically if matching item is returned via SIP protocol.
 581         -
 582             - pref: HoldsAutoFillPrintSlip
 583               choices:
 584                   1: Do
 585                   0: "Don't"
 586             - automatically display the hold slip dialog for auto-filled holds.
 587         -
 588             - pref: BlockReturnOfWithdrawnItems
 589               choices:
 590                   1: Block
 591                   0: "Don't block"
 592             - returning of items that have been withdrawn.
 593         -
 594             - pref: BlockReturnOfLostItems
 595               choices:
 596                   1: Block
 597                   0: "Don't block"
 598             - returning of items that have been lost.
 599         -
 600             - pref: CalculateFinesOnReturn
 601               choices:
 602                   1: Do
 603                   0: "Don't"
 604             - calculate and update overdue charges when an item is returned.
 605             - "<br /><strong>NOTE:</strong> If you are doing hourly loans then you should have this on."
 606             - '<br /><strong>NOTE:</strong> This system preference requires <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=FinesMode">FinesMode</a> to be set to "Calculate and charge."'
 607         -
 608             - pref: CalculateFinesOnBackdate
 609               choices:
 610                   1: Do
 611                   0: "Don't"
 612             - calculate and update overdue charges when an item is returned with a backdated return date.
 613         -
 614             - pref: UpdateItemLocationOnCheckin
 615               type: textarea
 616               syntax: text/x-yaml
 617               class: code
 618             - "This is a list of value pairs. The first value is followed immediately by colon space then the second value.<br/><br/>"
 619             - "Examples:<br/>"
 620             - "PROC: FIC - causes an item in the Processing Center location to be updated into the Fiction location on check in.<br/>"
 621             - "FIC: GEN - causes an item in the Fiction location to be updated into the General stacks location on check in.<br/>"
 622             - "_BLANK_: FIC - causes an item that has no location to be updated into the Fiction location on check in.<br/>"
 623             - "FIC: _BLANK_ - causes an item in location FIC to be updated to a blank location on check in.<br/>"
 624             - "_ALL_: FIC - causes all items to be updated into the Fiction location on check in.<br/>"
 625             - "PROC: _PERM_ - causes an item that is in the Processing Center to be updated to it's permanent location.<br/><br/>"
 626             - "General rule: if the location value on the left of the colon (:) matches the item's current location, it will be updated to match the location value on the right of the colon (:).<br/>"
 627             - "Note: PROC and CART are special values, for these locations the location and permanent_location can differ, in all other cases an update will affect both. Items in the CART location will be returned to their permanent location on checkout.<br/>"
 628             - "The special term _BLANK_ may be used on either side of a value pair to update or remove the location from items with no location assigned.<br/>"
 629             - "The special term _ALL_ is used on the left side of the colon (:) to affect all items, <strong>and overrides all other rules.</strong>"
 630         -
 631             - pref: UpdateNotForLoanStatusOnCheckin
 632               type: textarea
 633               syntax: text/x-yaml
 634               class: code
 635             - This is a list of value pairs. When an item is checked in, if the not for loan value on the left matches the items not for loan value
 636             - "it will be updated to the right-hand value. For example, '-1: 0' will cause an item that was set to 'Ordered' to now be available for loan."
 637             - Each pair of values should be on a separate line.
 638         -
 639             - pref: HidePersonalPatronDetailOnCirculation
 640               choices:
 641                   1: "Hide"
 642                   0: "Don't hide"
 643             - "a patron's phone number, email address, street address and city on the circulation page."
 644         -
 645             - pref: TransfersBlockCirc
 646               choices:
 647                   1: "Block"
 648                   0: "Don't block"
 649             - staff from continuing to checkin items when a transfer is triggered.
 650         -
 651             - pref: StoreLastBorrower
 652               default: 0
 653               choices:
 654                   1: Store
 655                   0: "Don't store"
 656             - 'the last patron to return an item. This setting is independent of the <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.'
 657     Holds policy:
 658         -
 659             - pref: EnableItemGroups
 660               choices:
 661                   yes: Enable
 662                   no: "Don't enable"
 663             - the item groups feature to allow collecting groups of items on a record together.
 664         -
 665             - In the staff client, split the holds queue into separate tables by
 666             - pref: HoldsSplitQueue
 667               choices:
 668                   nothing: nothing
 669                   branch: "pickup library"
 670                   itemtype: "hold item type"
 671                   branch_itemtype: "pickup library and item type"
 672             - "."
 673         -
 674             - If the holds queue is split, show librarians
 675             - pref: HoldsSplitQueueNumbering
 676               choices:
 677                   actual: "the actual priority, which may be out of order"
 678                   virtual: "'virtual' priorities, where each group is numbered separately"
 679             - "."
 680         -
 681             - pref: RealTimeHoldsQueue
 682               choices:
 683                   1: Enable
 684                   0: Disable
 685             - updating the holds queue in real time.
 686         -
 687             - pref: AllowHoldItemTypeSelection
 688               choices:
 689                   1: Allow
 690                   0: "Don't allow"
 691             - hold fulfillment to be limited by item type.
 692         -
 693             - pref: AllowRenewalIfOtherItemsAvailable
 694               choices:
 695                   1: Allow
 696                   0: "Don't allow"
 697             - a patron to renew an item with unfilled holds if other available items can fill that hold.
 698         -
 699             - pref: OPACInTransitHoldPickupLocationChange
 700               choices:
 701                   1: Allow
 702                   0: "Don't allow"
 703             - patrons to change their in transit holds pickup location.
 704         -
 705             - pref: AllowHoldPolicyOverride
 706               choices:
 707                   1: Allow
 708                   0: "Don't allow"
 709             - staff to override hold policies when placing holds.
 710         -
 711             - pref: AllowHoldsOnDamagedItems
 712               choices:
 713                   1: Allow
 714                   0: "Don't allow"
 715             - hold requests to be placed on and filled by damaged items.
 716         -
 717             - pref: AllowHoldDateInFuture
 718               choices:
 719                   1: Allow
 720                   0: "Don't allow"
 721             - hold requests to be placed that do not enter the waiting list until a certain future date.
 722         -
 723             - pref: OPACAllowHoldDateInFuture
 724               choices:
 725                   1: Allow
 726                   0: "Don't allow"
 727             - patrons to place holds that don't enter the waiting list until a certain future date. (<a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=AllowHoldDateInFuture">AllowHoldDateInFuture</a> must also be enabled).
 728         -
 729             - When placing a hold from the OPAC, make
 730             - pref: OPACMandatoryHoldDates
 731               choices:
 732                   "": "no hold dates"
 733                   "start": "hold start date"
 734                   "end": "hold end date"
 735                   "both": "both hold dates"
 736             - mandatory.
 737             - '<br><strong>NOTE:</strong> The hold start date option is only effective and shown on the hold form when <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=AllowHoldDateInFuture">AllowHoldDateInFuture</a> and <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACAllowHoldDateInFuture">OPACAllowHoldDateInFuture</a> are enabled.'
 738         -
 739             - Confirm future hold requests (starting no later than
 740             - pref: ConfirmFutureHolds
 741               class: integer
 742             - days from now) at checkin time. Note that this number of days will be used too in calculating the default end date for the Holds to pull-report. But it does not interfere with issuing, renewing or transferring items.
 743         -
 744             - Check the rule from the
 745             - pref: ReservesControlBranch
 746               choices:
 747                   ItemHomeLibrary: "item's home library"
 748                   PatronLibrary: "patron's home library"
 749             - to see if the patron can place a hold on the item.
 750         -
 751             - Mark a hold as problematic if it has been waiting for more than
 752             - pref: ReservesMaxPickUpDelay
 753               class: integer
 754             - days.
 755         -
 756             - pref: ExpireReservesMaxPickUpDelay
 757               choices:
 758                   1: Allow
 759                   0: "Don't allow"
 760             - 'holds to expire automatically if they have not been picked by within the time period specified in the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=ReservesMaxPickUpDelay">ReservesMaxPickUpDelay</a> system preference.</br>'
 761             - pref: ExpireReservesAutoFill
 762               choices:
 763                   1: "Do"
 764                   0: "Don't"
 765             - automatically fill the next hold using the item.
 766             - Send email notification of the new hold filled with a canceled item to
 767             - pref: ExpireReservesAutoFillEmail
 768               class: email
 769             - . If no address is defined here, the email will be sent to the library's reply-to address.
 770             - '<br><strong>NOTE:</strong> These system preferences require the <code>misc/cronjobs/holds/cancel_expired_holds.pl</code> cronjob. Ask your system administrator to schedule it.<br>'
 771         -
 772             - If using <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=ExpireReservesMaxPickUpDelay">ExpireReservesMaxPickUpDelay</a>, charge a patron who allows their waiting hold to expire a fee of
 773             - pref: ExpireReservesMaxPickUpDelayCharge
 774               class: currency
 775             - "."
 776         -
 777             - Satisfy holds using items from the libraries
 778             - pref: StaticHoldsQueueWeight
 779               class: multi
 780             - (as branchcodes, separated by commas; if empty, uses all libraries)
 781             - when they are
 782             - pref: HoldsQueueSkipClosed
 783               choices:
 784                   1: open
 785                   0: open or closed
 786             - pref: RandomizeHoldsQueueWeight
 787               choices:
 788                   1: in random order.
 789                   0: in that order.
 790             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/holds/build_holds_queue.pl</code> cronjob. Ask your system administrator to schedule it."
 791             -
 792         -
 793             - pref: canreservefromotherbranches
 794               choices:
 795                   1: Allow
 796                   0: "Don't allow (with independentbranches)"
 797             - a user from one library to place a hold on an item from another library
 798         -
 799             - pref: OPACAllowUserToChooseBranch
 800               choices:
 801                   1: Allow
 802                   0: "Don't allow"
 803             - a user to choose the library to pick up a hold from.
 804         -
 805             - pref: ReservesNeedReturns
 806               choices:
 807                   1: "Don't automatically"
 808                   0: Automatically
 809             - mark a hold as found and waiting when a hold is placed on a specific item and that item is already checked in.
 810         -
 811             - Patrons can have a maximum of
 812             - pref: maxreserves
 813               class: integer
 814             - holds at once (leave blank or set to 0 to disable). Additional limits may apply based on circulation rules.
 815         -
 816             - pref: emailLibrarianWhenHoldIsPlaced
 817               choices:
 818                   1: Enable
 819                   0:  "Don't enable"
 820             - "sending an email to the Koha administrator email address whenever a hold request is placed."
 821         -
 822             - pref: DisplayMultiPlaceHold
 823               choices:
 824                   1: Enable
 825                   0:  "Don't enable"
 826             - "the ability to place holds on multiple bibliographic records from the search results"
 827         -
 828             - pref: TransferWhenCancelAllWaitingHolds
 829               choices:
 830                   1: Transfer
 831                   0: "Don't transfer"
 832             - items when cancelling all waiting holds.
 833         -
 834             - pref: AutoResumeSuspendedHolds
 835               choices:
 836                   1: Allow
 837                   0: "Don't allow"
 838             - "suspended holds to be automatically resumed by a set date."
 839             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/holds/auto_unsuspend_holds.pl</code> cronjob. Ask your system administrator to schedule it."
 840         -
 841             - pref: SuspendHoldsIntranet
 842               choices:
 843                   1: Allow
 844                   0: "Don't allow"
 845             - holds to be suspended from the staff interface.
 846         -
 847             - pref: SuspendHoldsOpac
 848               choices:
 849                   1: Allow
 850                   0: "Don't allow"
 851             - holds to be suspended from the OPAC.
 852         -
 853             - If using <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=ExpireReservesMaxPickUpDelay">ExpireReservesMaxPickUpDelay</a>,
 854             - pref: ExpireReservesOnHolidays
 855               choices:
 856                   1: allow
 857                   0: "don't allow"
 858             - expired holds to be canceled on days the library is closed per the calendar.
 859         -
 860             - pref: ExcludeHolidaysFromMaxPickUpDelay
 861               choices:
 862                   1: Use the calendar
 863                   0: Ignore the calendar
 864             - when calculating the period for a hold's max pickup delay.
 865         -
 866             - pref: decreaseLoanHighHolds
 867               choices:
 868                   1: Enable
 869                   0:  "Don't enable"
 870             - the reduction of loan period to
 871             - pref: decreaseLoanHighHoldsDuration
 872               class: integer
 873             - days for high demand items with more than
 874             - pref: decreaseLoanHighHoldsValue
 875               class: integer
 876             - holds
 877             - pref: decreaseLoanHighHoldsControl
 878               choices:
 879                   static: "on the record"
 880                   dynamic: "over the number of holdable items on the record"
 881             - ". Ignore items with the following statuses when counting items:"
 882             - pref: decreaseLoanHighHoldsIgnoreStatuses
 883               multiple:
 884                 damaged: Damaged
 885                 itemlost: Lost
 886                 withdrawn: Withdrawn
 887                 notforloan: Not for loan
 888             - "Note: The reduced loan period can also be set up in the circulation conditions and will then overwrite the setting here."
 889         -
 890             - pref: AllowHoldsOnPatronsPossessions
 891               choices:
 892                   1: Allow
 893                   0: "Don't allow"
 894             - a patron to place a hold on a record where the patron already has one or more items attached to that record checked out.
 895         -
 896             - pref: LocalHoldsPriority
 897               choices:
 898                   1: Give
 899                   0: "Don't give"
 900             - priority for filling holds to patrons whose
 901             - pref: LocalHoldsPriorityPatronControl
 902               choices:
 903                   PickupLibrary: "pickup library"
 904                   HomeLibrary: "home library"
 905             - matches the item's
 906             - pref: LocalHoldsPriorityItemControl
 907               choices:
 908                   homebranch: "home library"
 909                   holdingbranch: "holding library"
 910         -
 911             - pref: OPACHoldsIfAvailableAtPickup
 912               choices:
 913                   1: Allow
 914                   0: "Don't allow"
 915             - to pickup holds at libraries where the item is available.
 916         -
 917             - 'Patron categories not affected by <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACHoldsIfAvailableAtPickup">OPACHoldsIfAvailableAtPickup</a>:'
 918             - pref: OPACHoldsIfAvailableAtPickupExceptions
 919               choices: patron-categories
 920               class: multiple
 921         -
 922             - pref: CanMarkHoldsToPullAsLost
 923               choices:
 924                   do_not_allow: "Do not allow to mark items as lost"
 925                   allow: "Allow to mark items as lost"
 926                   allow_and_notify: "Allow to mark items as lost and notify the patron"
 927             - from the 'Holds to pull' page. Values to be applied must be defined in <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=UpdateItemWhenLostFromHoldList">UpdateItemWhenLostFromHoldList</a>.
 928         -
 929             - A list of values to update an item's values with when it is marked as lost from the 'Holds to pull' page.
 930             - 'Example: "itemlost: 1" to set items.itemlost to 1 when the item is marked as lost. (Requires <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=CanMarkHoldsToPullAsLost">CanMarkHoldsToPullAsLost</a>)'
 931             - pref: UpdateItemWhenLostFromHoldList
 932               type: textarea
 933               syntax: text/x-yaml
 934         -
 935             - pref: DefaultHoldExpirationdate
 936               default: 0
 937               choices:
 938                   1: Set
 939                   0: Don't set
 940             - default expiration date for holds automatically.
 941             - If enabled, set expiration date
 942             - pref: DefaultHoldExpirationdatePeriod
 943               default: 0
 944               class: integer
 945             - pref: DefaultHoldExpirationdateUnitOfTime
 946               default: days
 947               choices:
 948                   days: days
 949                   months: months
 950                   years: years
 951             - from reserve date.
 952         -
 953             - When placing a hold via the staff interface default the pickup location to the
 954             - pref: DefaultHoldPickupLocation
 955               default: loggedinlibrary
 956               choices:
 957                   loggedinlibrary: "logged in library"
 958                   homebranch: "item's home library"
 959                   holdingbranch: "item's holding library"
 960             - "."
 961     Patron restrictions:
 962         -
 963             - pref: PatronRestrictionTypes
 964               choices:
 965                   1: Allow
 966                   0: Don't allow
 967             - "the type of patron restriction to be specified when applying manually."
 968         -
 969             - pref: CumulativeRestrictionPeriods
 970               choices:
 971                   1: Cumulate
 972                   0: "Don't cumulate"
 973             - the restriction periods.
 974         -
 975             - pref: AutoRemoveOverduesRestrictions
 976               choices:
 977                   1: "Do"
 978                   0: "Don't"
 979             - allow OVERDUES restrictions triggered by sent notices to be cleared automatically when all overdue items are returned by a patron.
 980         -
 981             - If a patron is restricted,
 982             - pref: RestrictionBlockRenewing
 983               choices:
 984                   1: block
 985                   0: allow
 986             - renewing of items from the staff interface and via the <code>misc/cronjobs/automatic_renewals.pl</code> cronjob.
 987     Interlibrary loans:
 988         -
 989             - pref: ILLModule
 990               default: 0
 991               choices:
 992                   1: Enable
 993                   0: Disable
 994             - the interlibrary loans module (master switch).
 995         -
 996             - "Adding text will enable the copyright clearance stage in request creation. The text you enter will be the text displayed."
 997             - pref: ILLModuleCopyrightClearance
 998               type: textarea
 999               class: long
1000         -
1001             - "Enabled ILL backends for OPAC initiated requests:"
1002             - pref: ILLOpacbackends
1003               class: multi
1004             - (separated with |). If left empty, all installed backends will be enabled.
1005         -
1006             - pref: ILLModuleUnmediated
1007               default: 0
1008               choices:
1009                   1: Enable
1010                   0: Disable
1011             - unmediated interlibrary loan requests. If enabled and the ILL backend supports it, the newly created requests are immediately requested by backend.
1012         -
1013             - pref: CirculateILL
1014               default: 0
1015               choices:
1016                   1: Enable
1017                   0: Disable
1018             - the circulation of ILL requested items.
1019         -
1020             - pref: ILLCheckAvailability
1021               default: 0
1022               choices:
1023                   1: Check
1024                   0: "Don't check"
1025             - external sources for availability during the request process.
1026         -
1027             - "ILL statuses that are considered finished and should not be displayed in the ILL module: "
1028             - pref: ILLHiddenRequestStatuses
1029               class: multi
1030             - (separated with |). If left empty, all ILL requests will be displayed. The request codes can be found in the ILLSTATUS authorized value category.
1031         -
1032             - "Send these ILL notices to staff when appropriate:"
1033             - pref: ILLSendStaffNotices
1034               class: multi
1035             - "(separated with |). e.g. ILL_REQUEST_CANCEL|ILL_REQUEST_MODIFIED If left empty, no staff ILL notices will be sent."
1036         -
1037             - "Fallback email address for staff ILL notices to be sent to in the absence of a library address:"
1038             - pref: ILLDefaultStaffEmail
1039               class: email
1040     Fines Policy:
1041         -
1042             - pref: finesCalendar
1043               type: choice
1044               choices:
1045                   ignoreCalendar: Ignore the calendar
1046                   noFinesWhenClosed: Use the calendar
1047             - when calculating the period for fines.
1048         -
1049             - pref: SuspensionsCalendar
1050               type: choice
1051               choices:
1052                   ignoreCalendar: Ignore the calendar
1053                   noSuspensionsWhenClosed: Use the calendar
1054             - when calculating the period for suspension expiration.
1055         -
1056             - pref: finesMode
1057               type: choice
1058               choices:
1059                   off: "Don't calculate"
1060                   production: Calculate and charge
1061             - fines (when <code>cronjobs/fines.pl</code> is being run).
1062             - '<br><strong>NOTE:</strong> If the cronjobs/fines.pl cronjob is being run, accruing and final fines will be calculated when the cron runs and accruing fines will be finalized when an item is returned. If <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=CalculateFinesOnReturn">CalculateFinesOnReturn</a> is enabled, final fines will be calculated when an item is returned.<br/>'
1063             - pref: ChargeFinesOnClosedDays
1064               type: choice
1065               choices:
1066                   0: "Don't charge"
1067                   1: Charge
1068             - on close days. If set the fines.pl cronjob will not generate fines when run on days marked as closed in the calendar.
1069         -
1070             - If a lost item is returned, apply the refunding rules defined for the
1071             - pref: RefundLostOnReturnControl
1072               choices:
1073                   CheckinLibrary: "check-in library."
1074                   ItemHomeBranch: "item's home library."
1075                   ItemHoldingBranch: "item's holding library."
1076         -
1077             - pref: FinesIncludeGracePeriod
1078               choices:
1079                   1: Include
1080                   0: "Don't include"
1081             - the grace period when calculating the fine for an overdue item.
1082         -
1083             - pref: WhenLostForgiveFine
1084               choices:
1085                   1: Forgive
1086                   0: "Don't forgive"
1087             - the fines on an item when it is marked as lost.
1088         -
1089             - "Don't refund lost fees if a lost item is checked in more than"
1090             - pref: NoRefundOnLostReturnedItemsAge
1091               class: integer
1092             - days after it was marked lost.
1093         -
1094             - pref: WhenLostChargeReplacementFee
1095               choices:
1096                   1: Charge
1097                   0: "Don't charge"
1098             - the replacement price when a patron loses an item.
1099         -
1100             - Charge a hold fee
1101             - pref: HoldFeeMode
1102               choices:
1103                   any_time_is_placed: "any time a hold is placed."
1104                   not_always: "only if all items are checked out and the record has at least one hold already."
1105                   any_time_is_collected: "any time a hold is collected."
1106         -
1107             - pref: useDefaultReplacementCost
1108               choices:
1109                   1: Use
1110                   0: "Don't use"
1111             - the default replacement cost defined for the item type.
1112         -
1113             - "Text to be recorded in the column 'note', table 'accountlines' when the processing fee (defined for the item type) is applied:"
1114             - pref: ProcessingFeeNote
1115               type: textarea
1116               class: code
1117     Self check-in module:
1118         -
1119             - "Include the following HTML on the self check-in screen:"
1120             - pref: SelfCheckInMainUserBlock
1121               type: textarea
1122               syntax: text/html
1123               class: code
1124         -
1125             - pref: SelfCheckInModule
1126               choices:
1127                   1: Enable
1128                   0: "Don't enable"
1129             - "the standalone self check-in module (available at: /cgi-bin/koha/sci/sci-main.pl)."
1130         -
1131             - "Reset the current self check-in screen after"
1132             - pref: SelfCheckInTimeout
1133               class: integer
1134             - seconds.
1135         -
1136             - "Include the following CSS on all the self check-in screens:"
1137             - pref: SelfCheckInUserCSS
1138               type: textarea
1139               syntax: css
1140               class: code
1141         -
1142             - "Include the following JavaScript on all the self check-in screens:"
1143             - pref: SelfCheckInUserJS
1144               type: textarea
1145               syntax: javascript
1146               class: code
1147     Self check-out module:
1148         -
1149             - "Include the following JavaScript on all pages in the web-based self checkout:"
1150             - pref: SCOUserJS
1151               type: textarea
1152               syntax: javascript
1153               class: code
1154         -
1155             - "Include the following HTML on the the web-based self checkout screen:"
1156             - pref: SCOMainUserBlock
1157               type: textarea
1158               syntax: text/html
1159               class: code
1160         -
1161             - "Include the following CSS on all pages in the web-based self checkout:"
1162             - pref: SCOUserCSS
1163               type: textarea
1164               syntax: css
1165               class: code
1166         -
1167             - pref: ShowPatronImageInWebBasedSelfCheck
1168               choices:
1169                   1: Show
1170                   0: "Don't show"
1171             - "the patron's picture (if one has been added) when they use the web-based self checkout."
1172         -
1173             - pref: WebBasedSelfCheck
1174               choices:
1175                   1: Enable
1176                   0: "Don't enable"
1177             - "the web-based self checkout system (available at: /cgi-bin/koha/sco/sco-main.pl)."
1178         -
1179             - Have patrons log into the web-based self checkout system with their
1180             - pref: SelfCheckoutByLogin
1181               choices:
1182                   1: username and password
1183                   0: cardnumber
1184             - ".</br>NOTE: If using 'cardnumber' and AutoSelfCheckAllowed you should set SelfCheckAllowByIPRanges to prevent brute force attacks to gain patron information outside the library."
1185         -
1186             - "Time out the current patron's web-based self checkout system login after"
1187             - pref: SelfCheckTimeout
1188               class: integer
1189             - seconds.
1190         -
1191             - pref: SCOAllowCheckin
1192               choices:
1193                   1: Allow
1194                   0: "Don't allow"
1195             - patrons to return items through web-based self checkout system.
1196         -
1197             - "Include the following HTML in the Help page of the web-based self checkout system:"
1198             - pref: SelfCheckHelpMessage
1199               type: textarea
1200               syntax: text/html
1201               class: code
1202         -
1203             - pref: AutoSelfCheckAllowed
1204               choices:
1205                   1: Allow
1206                   0: "Don't allow"
1207             - "the web-based self checkout system to automatically log in with this staff login"
1208             - pref: AutoSelfCheckID
1209             - and this password
1210             - pref: AutoSelfCheckPass
1211               class: password
1212             - .
1213             - "Note: Any patron entered here will be unable to log into the OPAC."
1214         -
1215             - pref: SelfCheckReceiptPrompt
1216               choices:
1217                   1: Show
1218                   0: "Don't show"
1219             - "the print receipt popup dialog when self checkout is finished."
1220         -
1221             - "Allow access to the self check from the following IP addresses:"
1222             - pref: SelfCheckAllowByIPRanges
1223               class: short
1224             - (Leave blank if not used. Use ranges or simple IP addresses separated by spaces, like <code>192.168.1.1 192.168.0.0/24</code>.)
1225     Course reserves:
1226         -
1227             - pref: UseCourseReserves
1228               choices:
1229                   1: Use
1230                   0: "Don't use"
1231             - "course reserves."
1232     Batch checkout:
1233         -
1234             - pref: BatchCheckouts
1235               choices:
1236                   1: Allow
1237                   0: "Don't allow"
1238             - "batch checkouts."
1239         -
1240             - "Patron categories allowed to checkout in a batch:"
1241             - pref: BatchCheckoutsValidCategories
1242               choices: patron-categories
1243               class: multiple
1244     Housebound module:
1245         -
1246             - pref: HouseboundModule
1247               choices:
1248                   1: Enable
1249                   0: Disable
1250             - "the housebound module."
1251     Stock rotation module:
1252         -
1253             - pref: StockRotation
1254               choices:
1255                   1: Enable
1256                   0: Disable
1257             - "the stock rotation module."
1258     Article requests:
1259         -
1260             - pref: ArticleRequests
1261               choices:
1262                   1: Enable
1263                   0: "Don't enable"
1264             - patrons to place article requests.
1265         -
1266             - pref: ArticleRequestsOpacHostRedirection
1267               choices:
1268                   yes: Enable
1269                   no: Disable
1270             - " redirection from child to host based on MARC21 773$w when the child has no items when requesting articles on the Opac."
1271         -
1272             - pref: ArticleRequestsLinkControl
1273               choices:
1274                   always: Always show
1275                   calc: Use algorithm to show or hide
1276             - article request links on search results.
1277         -
1278             - "For records that are record level or item level requestable, make the following fields mandatory:"
1279             - pref: ArticleRequestsMandatoryFields
1280               multiple:
1281                 title: Title
1282                 author: Author
1283                 volume: Volume
1284                 issue: Issue
1285                 date: Date
1286                 pages: Pages
1287                 chapters: Chapters
1288             -
1289         -
1290             - "For records that are only record level requestable, make the following fields mandatory:"
1291             - pref: ArticleRequestsMandatoryFieldsRecordOnly
1292               multiple:
1293                 title: Title
1294                 author: Author
1295                 volume: Volume
1296                 issue: Issue
1297                 date: Date
1298                 pages: Pages
1299                 chapters: Chapters
1300             -
1301         -
1302             - "For records that are only item level requestable, make the following fields mandatory:"
1303             - pref: ArticleRequestsMandatoryFieldsItemOnly
1304               multiple:
1305                 title: Title
1306                 author: Author
1307                 volume: Volume
1308                 issue: Issue
1309                 date: Date
1310                 pages: Pages
1311                 chapters: Chapters
1312             -
1313         -
1314             - "The following article request formats are supported:"
1315             - pref: ArticleRequestsSupportedFormats
1316             - "(Valid choices are currently: PHOTOCOPY and SCAN. Separate the supported formats by a vertical bar. The first listed format is selected by default when you request via the OPAC.)"
1317
1318
1319     Item bundles:
1320         -
1321             - Use the LOST authorised value
1322             - pref: BundleLostValue
1323             - to represent 'missing from bundle' at return.
1324         -
1325             - Use the NOT_LOAN authorised value
1326             - pref: BundleNotLoanValue
1327             - to represent 'added to bundle' when an item is attached to bundle.
1328
1329     Return claims:
1330         -
1331             - When marking a checkout as "claims returned",
1332             - pref: ClaimReturnedChargeFee
1333               default: ask
1334               choices:
1335                   ask: ask if a lost fee should be charged
1336                   charge: charge a lost fee
1337                   no_charge: don't charge a lost fee
1338             - .
1339         -
1340             - Use the LOST authorised value
1341             - pref: ClaimReturnedLostValue
1342             - to represent 'claims returned'.
1343         -
1344             - Warn librarians that a patron has excessive return claims if the patron has claimed the return of more than
1345             - pref: ClaimReturnedWarningThreshold
1346               class: integer
1347             - items.
1348         -
1349             - Remove resolved return claims older than
1350             - pref: CleanUpDatabaseReturnClaims
1351               class: integer
1352             - days.
1353             - <span class="hint">This system preference is used by the cleanup_database.pl cronjob.</span>
1354
1355     Recalls:
1356         -
1357             - Mark a recall as problematic if it has been waiting to be picked up for
1358             - pref: RecallsMaxPickUpDelay
1359             - class: integer
1360             - days.
1361         -
1362             - pref: UseRecalls
1363               choices:
1364                   1: Use
1365                   0: "Don't use"
1366             - recalls. Make sure you configure <a href="/cgi-bin/koha/admin/smart-rules.pl">circulation and fines rules</a> for recalls once enabled.
1367
1368     SIP2:
1369         -
1370             - "Use the following mappings to determine the sort_bin of a returned item.<br/>"
1371             - "The mapping should be of the form 'branchcode:item field:comparator:item field value:sort bin number', with one mapping per line.<br/>"
1372             - "- 'branchcode' is the location where the checkin is being performed (i.e. branch assigned to SIP user)<br/>"
1373             - "- 'item field' is a database column in the items table<br/>"
1374             - "- 'comparator' is the type of comparison, possible values are: eq,<,<=,>,>=,ne<br/>"
1375             - "- 'item field value' is the value to compare against the value in the specified 'item field'<br/>"
1376             - "- 'sort bin number' is the expected return value in the CL field of the SIP response for an item matching a rule<br/><br/>"
1377             - "NOTE: Specifying 'item_field_value' with a leading '\\$' and an item field name will use the value of that field in the item for comparison:<br/>"
1378             - "i.e. \\$holdingbranch<br/></br>"
1379             - "Examples:<br/>"
1380             - "CPL:itype:eq:BOOK:1 - Will return sort bin 1 for an item of itemtype 'BOOK' returned to CPL.<br/>"
1381             - "CPL:itemcallnumber:<:339.6:3 - Will return sort bin 3 for an item with a callnumber less than 339.6 returned to CPL .<br/>"
1382             - "CPL:homebranch:ne:\\$holdingbranch:X - Will return sort bin 'X' for an item returned to CPL where the holdingbranch is not equal to the homebranch (i.e. any item belonging to a different branch than CPL).<br/><br/>"
1383             - pref: SIP2SortBinMapping
1384               type: textarea
1385               class: long
1386         -
1387             - Use
1388             - pref: UseLocationAsAQInSIP
1389               choices:
1390                   yes: permanent_location
1391                   no: homebranch
1392             - for AQ field in SIP protocol.
1393
1394     Curbside pickup module:
1395         -
1396             - pref: CurbsidePickup
1397               choices:
1398                   1: Enable
1399                   0: Disable
1400             - "the curbside pickup module."