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