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             - 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 checkout and fines 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             - .
 407         -
 408             - Include up to
 409             - pref: PrintNoticesMaxLines
 410               class: integer
 411             - "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."
 412         -
 413             - pref: OverduesBlockCirc
 414               choices:
 415                   block: Block
 416                   noblock: "Don't block"
 417                   confirmation: Ask for confirmation
 418             - "when checking out to a patron that has overdues outstanding."
 419         -
 420             - "When checking out an item with rental fees, "
 421             - pref: RentalFeesCheckoutConfirmation
 422               choices:
 423                   1: ask
 424                   0: "don't ask"
 425             - "for confirmation."
 426         -
 427             - By default, set the LOST value of an item to
 428             - pref: DefaultLongOverdueLostValue
 429               class: integer
 430             - when the item has been overdue for more than
 431             - pref: DefaultLongOverdueDays
 432               class: integer
 433             - days.
 434             - <br>WARNING — These preferences will activate the automatic item loss process. Leave these fields empty if you don't want to activate this feature.
 435             - "<br>Example: [1] [30] Sets an item to the LOST value 1 when it has been overdue for more than 30 days."
 436             - <br>(Used when the longoverdue.pl script is called without the --lost parameter)
 437             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/longoverdue.pl</code> cronjob. Ask your system administrator to schedule it."
 438         -
 439             - "Charge a lost item to the patron's account when the LOST value of the item changes to:"
 440             - pref: DefaultLongOverdueChargeValue
 441               class: integer
 442             - <br>Leave this field empty if you don't want to charge the patron for lost items.
 443             - <br>(Used when the longoverdue.pl script is called without the --charge parameter)
 444             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/longoverdue.pl</code> cronjob. Ask your system administrator to schedule it."
 445         -
 446             - When using the automatic item loss process, skip items with lost values matching any of
 447             - pref: DefaultLongOverdueSkipLostStatuses
 448             - "."
 449             - <br>Leave this field empty if you don't want to skip any lost statuses.
 450             - <br>Set to a list of comma separated values, e.g. <em>5,6,7</em>.
 451         -
 452             - "When issuing an item that has been marked as lost, "
 453             - pref: IssueLostItem
 454               choices:
 455                   confirm: "require confirmation"
 456                   alert: "display a message"
 457                   nothing : "do nothing"
 458             - .
 459         -
 460             - "When checking out an item, "
 461             - pref: RecordStaffUserOnCheckout
 462               choices:
 463                   1: "record"
 464                   0: "don't record"
 465             - "the user who checked out the item."
 466         -
 467             - "Mark items as returned when flagged as lost "
 468             - pref: MarkLostItemsAsReturned
 469               multiple:
 470                 cronjob: "from the longoverdue cronjob"
 471                 batchmod: "from the batch item modification tool"
 472                 additem: "when cataloguing an item"
 473                 moredetail: "from the items tab of the catalog module"
 474                 pendingreserves: "from the 'Holds to pull' list"
 475                 onpayment: "when receiving payment for the item"
 476                 claim_returned: "when marking an item as a return claim"
 477             - .
 478         -
 479             - pref: AllowMultipleIssuesOnABiblio
 480               choices:
 481                   1: Allow
 482                   0: "Don't allow"
 483             - "patrons to check out multiple items from the same record. (<strong>NOTE:</strong> This will only affect records without a subscription attached.)"
 484         -
 485             - pref: OnSiteCheckouts
 486               choices:
 487                   1: Enable
 488                   0: Disable
 489             - the on-site checkouts feature.
 490         -
 491             - pref: OnSiteCheckoutsForce
 492               choices:
 493                   1: Enable
 494                   0: Disable
 495             - the on-site checkout for all cases (even if a patron is debarred, etc.).
 496         -
 497             - pref: ConsiderOnSiteCheckoutsAsNormalCheckouts
 498               choices:
 499                   1: Consider
 500                   0: "Don't consider"
 501             - on-site checkouts as normal checkouts.
 502             - 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.
 503             - If disabled, both values will be checked separately.
 504         -
 505             - pref: SwitchOnSiteCheckouts
 506               choices:
 507                   1: Switch
 508                   0: "Don't switch"
 509             - on-site checkouts to normal checkouts when checked out.
 510         -
 511             - When a patron's checked out item is overdue,
 512             - pref: OverduesBlockRenewing
 513               type: choice
 514               choices:
 515                   allow: allow renewing.
 516                   blockitem: block renewing only for this item.
 517                   block: block renewing for all the patron's items.
 518         -
 519             - If a patron owes more than the value of <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACFineNoRenewals">OPACFineNoRenewals</a>,
 520             - pref: OPACFineNoRenewalsBlockAutoRenew
 521               choices:
 522                   1: block
 523                   0: allow
 524             - their auto-renewals.
 525         -
 526             - If a patron pays off all fines on an overdue item that is accruing fines,
 527             - pref: RenewAccruingItemWhenPaid
 528               choices:
 529                   1: renew
 530                   0: "don't renew"
 531             - 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.
 532         -
 533             - If a patron pays off all fines on an overdue item that is accruing fines in the OPAC via a payment plugin,
 534             - pref: RenewAccruingItemInOpac
 535               choices:
 536                   1: renew
 537                   0: "don't renew"
 538             - 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.
 539         -
 540             - pref: ItemsDeniedRenewal
 541               type: textarea
 542               syntax: text/x-yaml
 543               class: code
 544             - Define custom rules to deny specific items from renewal.
 545             - "<br />Can name any field in the items table followed by a colon then a space then"
 546             - "a bracketed list of values separated by commas."
 547             - "For example:"
 548             - "<br />ccode: [NEWFIC,null,DVD]"
 549             - "<br />itype: [NEWBK,\"\"]"
 550             - "<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."
 551         -
 552             - pref: UpdateNotForLoanStatusOnCheckout
 553               type: textarea
 554               syntax: text/x-yaml
 555               class: code
 556             - 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
 557             - "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."
 558             - Each pair of values should be on a separate line.
 559     Checkin policy:
 560         -
 561             - pref: TrapHoldsOnOrder
 562               choices:
 563                   1: Trap
 564                   0: "Don't trap"
 565             - items that are not for loan but holdable ( notforloan < 0 ) to fill holds.
 566         -
 567             - Never trap items with 'not for loan' values of
 568             - pref: SkipHoldTrapOnNotForLoanValue
 569               class: integer
 570             - to fill holds.
 571             - "(list of not for loan values separated with a pipe '|')"
 572         -
 573             - pref: HoldsAutoFill
 574               choices:
 575                   1: Do
 576                   0: "Don't"
 577             - automatically fill holds instead of asking the librarian.
 578         -
 579             - pref: HoldsNeedProcessingSIP
 580               choices:
 581                   1: "Don't fulfill"
 582                   0: Fulfill
 583             - holds automatically if matching item is returned via SIP protocol.
 584         -
 585             - pref: HoldsAutoFillPrintSlip
 586               choices:
 587                   1: Do
 588                   0: "Don't"
 589             - automatically display the hold slip dialog for auto-filled holds.
 590         -
 591             - pref: BlockReturnOfWithdrawnItems
 592               choices:
 593                   1: Block
 594                   0: "Don't block"
 595             - returning of items that have been withdrawn.
 596         -
 597             - pref: BlockReturnOfLostItems
 598               choices:
 599                   1: Block
 600                   0: "Don't block"
 601             - returning of items that have been lost.
 602         -
 603             - pref: CalculateFinesOnReturn
 604               choices:
 605                   1: Do
 606                   0: "Don't"
 607             - calculate and update overdue charges when an item is returned.
 608             - "<br /><strong>NOTE:</strong> If you are doing hourly loans then you should have this on."
 609             - '<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."'
 610         -
 611             - pref: CalculateFinesOnBackdate
 612               choices:
 613                   1: Do
 614                   0: "Don't"
 615             - calculate and update overdue charges when an item is returned with a backdated return date.
 616         -
 617             - pref: UpdateItemLocationOnCheckin
 618               type: textarea
 619               syntax: text/x-yaml
 620               class: code
 621             - "This is a list of value pairs. The first value is followed immediately by colon space then the second value.<br/><br/>"
 622             - "Examples:<br/>"
 623             - "PROC: FIC - causes an item in the Processing Center location to be updated into the Fiction location on check in.<br/>"
 624             - "FIC: GEN - causes an item in the Fiction location to be updated into the General stacks location on check in.<br/>"
 625             - "_BLANK_: FIC - causes an item that has no location to be updated into the Fiction location on check in.<br/>"
 626             - "FIC: _BLANK_ - causes an item in location FIC to be updated to a blank location on check in.<br/>"
 627             - "_ALL_: FIC - causes all items to be updated into the Fiction location on check in.<br/>"
 628             - "PROC: _PERM_ - causes an item that is in the Processing Center to be updated to it's permanent location.<br/><br/>"
 629             - "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/>"
 630             - "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/>"
 631             - "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/>"
 632             - "The special term _ALL_ is used on the left side of the colon (:) to affect all items, <strong>and overrides all other rules.</strong>"
 633         -
 634             - pref: UpdateNotForLoanStatusOnCheckin
 635               type: textarea
 636               syntax: text/x-yaml
 637               class: code
 638             - 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
 639             - "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."
 640             - "Can be used for showing only the not for loan description. E.g. '-1: ONLYMESSAGE'."
 641             - Each pair of values should be on a separate line.
 642         -
 643             - pref: HidePersonalPatronDetailOnCirculation
 644               choices:
 645                   1: "Hide"
 646                   0: "Don't hide"
 647             - "a patron's phone number, email address, street address and city on the circulation page."
 648         -
 649             - pref: TransfersBlockCirc
 650               choices:
 651                   1: "Block"
 652                   0: "Don't block"
 653             - staff from continuing to checkin items when a transfer is triggered.
 654         -
 655             - pref: AutomaticConfirmTransfer
 656               choices:
 657                   1: "Do"
 658                   0: "Don't"
 659             - automatically confirm a transfer when the modal is dismissed without clicking 'Yes'.
 660         -
 661             - pref: StoreLastBorrower
 662               default: 0
 663               choices:
 664                   1: Store
 665                   0: "Don't store"
 666             - '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.'
 667     Holds policy:
 668         -
 669             - pref: EnableItemGroups
 670               choices:
 671                   1: Enable
 672                   0: "Don't enable"
 673             - the item groups feature to allow collecting groups of items on a record together.
 674         -
 675             - In the staff interface, split the holds queue into separate tables by
 676             - pref: HoldsSplitQueue
 677               choices:
 678                   nothing: nothing
 679                   branch: "pickup library"
 680                   itemtype: "hold item type"
 681                   branch_itemtype: "pickup library and item type"
 682             - "."
 683         -
 684             - pref: EnableItemGroupHolds
 685               choices:
 686                   1: Enable
 687                   0: "Don't enable"
 688             - the ability to place holds on item groups.
 689         -
 690             - If the holds queue is split, show librarians
 691             - pref: HoldsSplitQueueNumbering
 692               choices:
 693                   actual: "the actual priority, which may be out of order"
 694                   virtual: "'virtual' priorities, where each group is numbered separately"
 695             - "."
 696         -
 697             - pref: RealTimeHoldsQueue
 698               choices:
 699                   1: Enable
 700                   0: Disable
 701             - updating the holds queue in real time.
 702         -
 703             - pref: AllowHoldItemTypeSelection
 704               choices:
 705                   1: Allow
 706                   0: "Don't allow"
 707             - hold fulfillment to be limited by item type.
 708         -
 709             - pref: AllowRenewalIfOtherItemsAvailable
 710               choices:
 711                   1: Allow
 712                   0: "Don't allow"
 713             - a patron to renew an item with unfilled holds if other available items can fill that hold.
 714         -
 715             - pref: AllowHoldPolicyOverride
 716               choices:
 717                   1: Allow
 718                   0: "Don't allow"
 719             - staff to override hold policies when placing holds.
 720         -
 721             - pref: AllowHoldsOnDamagedItems
 722               choices:
 723                   1: Allow
 724                   0: "Don't allow"
 725             - hold requests to be placed on and filled by damaged items.
 726         -
 727             - pref: AllowHoldDateInFuture
 728               choices:
 729                   1: Allow
 730                   0: "Don't allow"
 731             - hold requests to be placed that do not enter the waiting list until a certain future date.
 732         -
 733             - pref: OPACAllowHoldDateInFuture
 734               choices:
 735                   1: Allow
 736                   0: "Don't allow"
 737             - 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).
 738         -
 739             - When placing a hold from the OPAC, make
 740             - pref: OPACMandatoryHoldDates
 741               choices:
 742                   "": "no hold dates"
 743                   "start": "hold start date"
 744                   "end": "hold end date"
 745                   "both": "both hold dates"
 746             - mandatory.
 747             - '<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.'
 748         -
 749             - Confirm future hold requests (starting no later than
 750             - pref: ConfirmFutureHolds
 751               class: integer
 752             - 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.
 753         -
 754             - Check the rule from the
 755             - pref: ReservesControlBranch
 756               choices:
 757                   ItemHomeLibrary: "item's home library"
 758                   PatronLibrary: "patron's home library"
 759             - to see if the patron can place a hold on the item.
 760         -
 761             - Mark a hold as problematic if it has been waiting for more than
 762             - pref: ReservesMaxPickUpDelay
 763               class: integer
 764             - days.
 765         -
 766             - pref: ExpireReservesMaxPickUpDelay
 767               choices:
 768                   1: Allow
 769                   0: "Don't allow"
 770             - '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>'
 771             - pref: ExpireReservesAutoFill
 772               choices:
 773                   1: "Do"
 774                   0: "Don't"
 775             - automatically fill the next hold using the item.
 776             - Send email notification of the new hold filled with a canceled item to
 777             - pref: ExpireReservesAutoFillEmail
 778               class: email
 779             - . If no address is defined here, the email will be sent to the library's reply-to address.
 780             - '<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>'
 781         -
 782             - 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
 783             - pref: ExpireReservesMaxPickUpDelayCharge
 784               class: currency
 785             - "."
 786         -
 787             - The holds queue should prioritize filling a hold by matching the patron's home library with an item having a matching
 788             - pref: HoldsQueuePrioritizeBranch
 789               type: choice
 790               choices:
 791                   homebranch: home library (homebranch).
 792                   holdingbranch: holding library (holdingbranch).
 793         -
 794             - Satisfy holds using items from the libraries
 795             - pref: StaticHoldsQueueWeight
 796               class: multi
 797             - (as branchcodes, separated by commas; if empty, uses all libraries)
 798             - when they are
 799             - pref: HoldsQueueSkipClosed
 800               choices:
 801                   1: open
 802                   0: open or closed
 803             - pref: RandomizeHoldsQueueWeight
 804               choices:
 805                   1: in random order.
 806                   0: in that order.
 807             - "<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."
 808             -
 809         -
 810             - pref: canreservefromotherbranches
 811               choices:
 812                   1: Allow
 813                   0: "Don't allow (with independentbranches)"
 814             - a user from one library to place a hold on an item from another library
 815         -
 816             - pref: OPACAllowUserToChooseBranch
 817               choices:
 818                   1: Allow
 819                   0: "Don't allow"
 820             - a user to choose the library to pick up a hold from.
 821         -
 822             - 'Allow users to change the library to pick up a hold for these statuses:'
 823             - pref: OPACAllowUserToChangeBranch
 824               multiple:
 825                 pending: Pending
 826                 intransit: In transit
 827                 suspended: Suspended
 828         -
 829             - pref: ReservesNeedReturns
 830               choices:
 831                   1: "Don't automatically"
 832                   0: Automatically
 833             - mark a hold as found and waiting when a hold is placed on a specific item and that item is already checked in.
 834         -
 835             - Patrons can have a maximum of
 836             - pref: maxreserves
 837               class: integer
 838             - holds at once (leave blank or set to 0 to disable). Additional limits may apply based on circulation rules.
 839         -
 840             - pref: emailLibrarianWhenHoldIsPlaced
 841               choices:
 842                   1: Enable
 843                   0:  "Don't enable"
 844             - "sending an email to the Koha administrator email address whenever a hold request is placed."
 845         -
 846             - pref: DisplayMultiPlaceHold
 847               choices:
 848                   1: Enable
 849                   0:  "Don't enable"
 850             - "the ability to place holds on multiple bibliographic records from the search results"
 851         -
 852             - pref: TransferWhenCancelAllWaitingHolds
 853               choices:
 854                   1: Transfer
 855                   0: "Don't transfer"
 856             - items when cancelling all waiting holds.
 857         -
 858             - pref: AutoResumeSuspendedHolds
 859               choices:
 860                   1: Allow
 861                   0: "Don't allow"
 862             - "suspended holds to be automatically resumed by a set date."
 863             - "<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."
 864         -
 865             - pref: SuspendHoldsIntranet
 866               choices:
 867                   1: Allow
 868                   0: "Don't allow"
 869             - holds to be suspended from the staff interface.
 870         -
 871             - pref: SuspendHoldsOpac
 872               choices:
 873                   1: Allow
 874                   0: "Don't allow"
 875             - holds to be suspended from the OPAC.
 876         -
 877             - If using <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=ExpireReservesMaxPickUpDelay">ExpireReservesMaxPickUpDelay</a>,
 878             - pref: ExpireReservesOnHolidays
 879               choices:
 880                   1: allow
 881                   0: "don't allow"
 882             - expired holds to be canceled on days the library is closed per the calendar.
 883         -
 884             - pref: ExcludeHolidaysFromMaxPickUpDelay
 885               choices:
 886                   1: Use the calendar
 887                   0: Ignore the calendar
 888             - when calculating the period for a hold's max pickup delay.
 889         -
 890             - pref: decreaseLoanHighHolds
 891               choices:
 892                   1: Enable
 893                   0:  "Don't enable"
 894             - the reduction of loan period to
 895             - pref: decreaseLoanHighHoldsDuration
 896               class: integer
 897             - days for high demand items with more than
 898             - pref: decreaseLoanHighHoldsValue
 899               class: integer
 900             - holds
 901             - pref: decreaseLoanHighHoldsControl
 902               choices:
 903                   static: "on the record"
 904                   dynamic: "over the number of holdable items on the record"
 905             - ". Ignore items with the following statuses when counting items:"
 906             - pref: decreaseLoanHighHoldsIgnoreStatuses
 907               multiple:
 908                 damaged: Damaged
 909                 itemlost: Lost
 910                 withdrawn: Withdrawn
 911                 notforloan: Not for loan
 912             - "Note: The reduced loan period can also be set up in the circulation conditions and will then overwrite the setting here."
 913         -
 914             - pref: AllowHoldsOnPatronsPossessions
 915               choices:
 916                   1: Allow
 917                   0: "Don't allow"
 918             - a patron to place a hold on a record where the patron already has one or more items attached to that record checked out.
 919         -
 920             - pref: LocalHoldsPriority
 921               choices:
 922                   1: Give
 923                   0: "Don't give"
 924             - priority for filling holds to patrons whose
 925             - pref: LocalHoldsPriorityPatronControl
 926               choices:
 927                   PickupLibrary: "pickup library"
 928                   HomeLibrary: "home library"
 929             - matches the item's
 930             - pref: LocalHoldsPriorityItemControl
 931               choices:
 932                   homebranch: "home library"
 933                   holdingbranch: "holding library"
 934         -
 935             - pref: OPACHoldsIfAvailableAtPickup
 936               choices:
 937                   1: Allow
 938                   0: "Don't allow"
 939             - to pickup holds at libraries where the item is available.
 940         -
 941             - 'Patron categories not affected by <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACHoldsIfAvailableAtPickup">OPACHoldsIfAvailableAtPickup</a>:'
 942             - pref: OPACHoldsIfAvailableAtPickupExceptions
 943               choices: patron-categories
 944               class: multiple
 945         -
 946             - pref: CanMarkHoldsToPullAsLost
 947               choices:
 948                   do_not_allow: "Do not allow to mark items as lost"
 949                   allow: "Allow to mark items as lost"
 950                   allow_and_notify: "Allow to mark items as lost and notify the patron"
 951             - 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>.
 952         -
 953             - A list of values to update an item's values with when it is marked as lost from the 'Holds to pull' page.
 954             - '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>)'
 955             - pref: UpdateItemWhenLostFromHoldList
 956               type: textarea
 957               syntax: text/x-yaml
 958         -
 959             - pref: DefaultHoldExpirationdate
 960               default: 0
 961               choices:
 962                   1: Set
 963                   0: Don't set
 964             - default expiration date for holds automatically.
 965             - If enabled, set expiration date
 966             - pref: DefaultHoldExpirationdatePeriod
 967               default: 0
 968               class: integer
 969             - pref: DefaultHoldExpirationdateUnitOfTime
 970               default: days
 971               choices:
 972                   days: days
 973                   months: months
 974                   years: years
 975             - from reserve date.
 976         -
 977             - When placing a hold via the staff interface default the pickup location to the
 978             - pref: DefaultHoldPickupLocation
 979               default: loggedinlibrary
 980               choices:
 981                   loggedinlibrary: "logged in library"
 982                   homebranch: "item's home library"
 983                   holdingbranch: "item's holding library"
 984             - "."
 985     Patron restrictions:
 986         -
 987             - pref: PatronRestrictionTypes
 988               choices:
 989                   1: Allow
 990                   0: Don't allow
 991             - "the type of patron restriction to be specified when applying manually."
 992         -
 993             - pref: CumulativeRestrictionPeriods
 994               choices:
 995                   1: Cumulate
 996                   0: "Don't cumulate"
 997             - the restriction periods.
 998         -
 999             - pref: AutoRemoveOverduesRestrictions
1000               choices:
1001                   1: "Do"
1002                   0: "Don't"
1003             - allow OVERDUES restrictions triggered by sent notices to be cleared automatically when all overdue items are returned by a patron.
1004         -
1005             - If a patron is restricted,
1006             - pref: RestrictionBlockRenewing
1007               choices:
1008                   1: block
1009                   0: allow
1010             - renewing of items from the staff interface and via the <code>misc/cronjobs/automatic_renewals.pl</code> cronjob.
1011     Fines Policy:
1012         -
1013             - pref: finesCalendar
1014               type: choice
1015               choices:
1016                   ignoreCalendar: Ignore the calendar
1017                   noFinesWhenClosed: Use the calendar
1018             - when calculating the period for fines.
1019         -
1020             - pref: SuspensionsCalendar
1021               type: choice
1022               choices:
1023                   ignoreCalendar: Ignore the calendar
1024                   noSuspensionsWhenClosed: Use the calendar
1025             - when calculating the period for suspension expiration.
1026         -
1027             - pref: finesMode
1028               type: choice
1029               choices:
1030                   off: "Don't calculate"
1031                   production: Calculate and charge
1032             - fines (when <code>cronjobs/fines.pl</code> is being run).
1033             - '<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/>'
1034             - pref: ChargeFinesOnClosedDays
1035               type: choice
1036               choices:
1037                   0: "Don't charge"
1038                   1: Charge
1039             - on close days. If set the fines.pl cronjob will not generate fines when run on days marked as closed in the calendar.
1040         -
1041             - If a lost item is returned, apply the refunding rules defined for the
1042             - pref: RefundLostOnReturnControl
1043               choices:
1044                   CheckinLibrary: "check-in library."
1045                   ItemHomeBranch: "item's home library."
1046                   ItemHoldingBranch: "item's holding library."
1047         -
1048             - pref: FinesIncludeGracePeriod
1049               choices:
1050                   1: Include
1051                   0: "Don't include"
1052             - the grace period when calculating the fine for an overdue item.
1053         -
1054             - pref: WhenLostForgiveFine
1055               choices:
1056                   1: Forgive
1057                   0: "Don't forgive"
1058             - the fines on an item when it is marked as lost.
1059         -
1060             - "Don't refund lost fees if a lost item is checked in more than"
1061             - pref: NoRefundOnLostReturnedItemsAge
1062               class: integer
1063             - days after it was marked lost.
1064         -
1065             - pref: WhenLostChargeReplacementFee
1066               choices:
1067                   1: Charge
1068                   0: "Don't charge"
1069             - the replacement price when a patron loses an item.
1070         -
1071             - Charge a hold fee
1072             - pref: HoldFeeMode
1073               choices:
1074                   any_time_is_placed: "any time a hold is placed."
1075                   not_always: "only if all items are checked out and the record has at least one hold already."
1076                   any_time_is_collected: "any time a hold is collected."
1077         -
1078             - pref: useDefaultReplacementCost
1079               choices:
1080                   1: Use
1081                   0: "Don't use"
1082             - the default replacement cost defined for the item type.
1083         -
1084             - "Text to be recorded in the column 'note', table 'accountlines' when the processing fee (defined for the item type) is applied:"
1085             - pref: ProcessingFeeNote
1086               type: textarea
1087               class: code
1088     Self check-in module:
1089         -
1090             - "Include the following HTML on the self check-in screen:"
1091             - pref: SelfCheckInMainUserBlock
1092               type: textarea
1093               syntax: text/html
1094               class: code
1095         -
1096             - pref: SelfCheckInModule
1097               choices:
1098                   1: Enable
1099                   0: "Don't enable"
1100             - "the standalone self check-in module (available at: /cgi-bin/koha/sci/sci-main.pl)."
1101         -
1102             - "Reset the current self check-in screen after"
1103             - pref: SelfCheckInTimeout
1104               class: integer
1105             - seconds.
1106         -
1107             - "Include the following CSS on all the self check-in screens:"
1108             - pref: SelfCheckInUserCSS
1109               type: textarea
1110               syntax: css
1111               class: code
1112         -
1113             - "Include the following JavaScript on all the self check-in screens:"
1114             - pref: SelfCheckInUserJS
1115               type: textarea
1116               syntax: javascript
1117               class: code
1118     Self check-out module:
1119         -
1120             - "Include the following JavaScript on all pages in the web-based self checkout:"
1121             - pref: SCOUserJS
1122               type: textarea
1123               syntax: javascript
1124               class: code
1125         -
1126             - "Include the following HTML on the the web-based self checkout screen:"
1127             - pref: SCOMainUserBlock
1128               type: textarea
1129               syntax: text/html
1130               class: code
1131         -
1132             - "Include the following CSS on all pages in the web-based self checkout:"
1133             - pref: SCOUserCSS
1134               type: textarea
1135               syntax: css
1136               class: code
1137         -
1138             - pref: ShowPatronImageInWebBasedSelfCheck
1139               choices:
1140                   1: Show
1141                   0: "Don't show"
1142             - "the patron's picture (if one has been added) when they use the web-based self checkout."
1143         -
1144             - pref: WebBasedSelfCheck
1145               choices:
1146                   1: Enable
1147                   0: "Don't enable"
1148             - "the web-based self checkout system (available at: /cgi-bin/koha/sco/sco-main.pl)."
1149         -
1150             - Have patrons log into the web-based self checkout system with their
1151             - pref: SelfCheckoutByLogin
1152               choices:
1153                   1: username and password
1154                   0: cardnumber
1155             - ".</br>NOTE: If using 'cardnumber' and AutoSelfCheckAllowed you should set SelfCheckAllowByIPRanges to prevent brute force attacks to gain patron information outside the library."
1156         -
1157             - "Time out the current patron's web-based self checkout system login after"
1158             - pref: SelfCheckTimeout
1159               class: integer
1160             - seconds.
1161         -
1162             - pref: SCOAllowCheckin
1163               choices:
1164                   1: Allow
1165                   0: "Don't allow"
1166             - patrons to return items through web-based self checkout system.
1167         -
1168             - "Include the following HTML in the Help page of the web-based self checkout system:"
1169             - pref: SelfCheckHelpMessage
1170               type: textarea
1171               syntax: text/html
1172               class: code
1173         -
1174             - pref: AutoSelfCheckAllowed
1175               choices:
1176                   1: Allow
1177                   0: "Don't allow"
1178             - "the web-based self checkout system to automatically log in with this staff login"
1179             - pref: AutoSelfCheckID
1180             - and this password
1181             - pref: AutoSelfCheckPass
1182               class: password
1183             - .
1184             - "Note: Any patron entered here will be unable to log into the OPAC."
1185         -
1186             - pref: SelfCheckReceiptPrompt
1187               choices:
1188                   1: Show
1189                   0: "Don't show"
1190             - "the print receipt popup dialog when self checkout is finished."
1191         -
1192             - "Allow access to the self check from the following IP addresses:"
1193             - pref: SelfCheckAllowByIPRanges
1194               class: short
1195             - (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>.)
1196     Course reserves:
1197         -
1198             - pref: UseCourseReserves
1199               choices:
1200                   1: Use
1201                   0: "Don't use"
1202             - "course reserves."
1203     Batch checkout:
1204         -
1205             - pref: BatchCheckouts
1206               choices:
1207                   1: Allow
1208                   0: "Don't allow"
1209             - "batch checkouts."
1210         -
1211             - "Patron categories allowed to checkout in a batch:"
1212             - pref: BatchCheckoutsValidCategories
1213               choices: patron-categories
1214               class: multiple
1215     Housebound module:
1216         -
1217             - pref: HouseboundModule
1218               choices:
1219                   1: Enable
1220                   0: Disable
1221             - "the housebound module."
1222     Stock rotation module:
1223         -
1224             - pref: StockRotation
1225               choices:
1226                   1: Enable
1227                   0: Disable
1228             - "the stock rotation module."
1229     Article requests:
1230         -
1231             - pref: ArticleRequests
1232               choices:
1233                   1: Enable
1234                   0: "Don't enable"
1235             - patrons to place article requests.
1236         -
1237             - pref: ArticleRequestsOpacHostRedirection
1238               choices:
1239                   1: Enable
1240                   0: Disable
1241             - " redirection from child to host based on MARC21 773$w when the child has no items when requesting articles on the Opac."
1242         -
1243             - pref: ArticleRequestsLinkControl
1244               choices:
1245                   always: Always show
1246                   calc: Use algorithm to show or hide
1247             - article request links on search results.
1248         -
1249             - "For records that are record level or item level requestable, make the following fields mandatory:"
1250             - pref: ArticleRequestsMandatoryFields
1251               multiple:
1252                 title: Title
1253                 author: Author
1254                 volume: Volume
1255                 issue: Issue
1256                 date: Date
1257                 pages: Pages
1258                 chapters: Chapters
1259             -
1260         -
1261             - "For records that are only record level requestable, make the following fields mandatory:"
1262             - pref: ArticleRequestsMandatoryFieldsRecordOnly
1263               multiple:
1264                 title: Title
1265                 author: Author
1266                 volume: Volume
1267                 issue: Issue
1268                 date: Date
1269                 pages: Pages
1270                 chapters: Chapters
1271             -
1272         -
1273             - "For records that are only item level requestable, make the following fields mandatory:"
1274             - pref: ArticleRequestsMandatoryFieldsItemOnly
1275               multiple:
1276                 title: Title
1277                 author: Author
1278                 volume: Volume
1279                 issue: Issue
1280                 date: Date
1281                 pages: Pages
1282                 chapters: Chapters
1283             -
1284         -
1285             - "The following article request formats are supported:"
1286             - pref: ArticleRequestsSupportedFormats
1287             - "(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.)"
1288
1289
1290     Item bundles:
1291         -
1292             - Use the <a href="/cgi-bin/koha/admin/authorised_values.pl?searchfield=LOST">LOST</a> authorized value
1293             - pref: BundleLostValue
1294             - to represent 'missing from bundle' at return.
1295         -
1296             - Use the <a href="/cgi-bin/koha/admin/authorised_values.pl?searchfield=NOT_LOAN">NOT_LOAN</a> authorized value
1297             - pref: BundleNotLoanValue
1298             - to represent 'added to bundle' when an item is attached to bundle.
1299
1300     Return claims:
1301         -
1302             - When marking a checkout as "claims returned",
1303             - pref: ClaimReturnedChargeFee
1304               default: ask
1305               choices:
1306                   ask: ask if a lost fee should be charged
1307                   charge: charge a lost fee
1308                   no_charge: don't charge a lost fee
1309             - .
1310         -
1311             - Use the <a href="/cgi-bin/koha/admin/authorised_values.pl?searchfield=LOST">LOST</a> authorized value
1312             - pref: ClaimReturnedLostValue
1313             - to represent 'claims returned'.
1314         -
1315             - Warn librarians that a patron has excessive return claims if the patron has claimed the return of more than
1316             - pref: ClaimReturnedWarningThreshold
1317               class: integer
1318             - items.
1319         -
1320             - Remove resolved return claims older than
1321             - pref: CleanUpDatabaseReturnClaims
1322               class: integer
1323             - days.
1324             - <span class="hint">This system preference is used by the cleanup_database.pl cronjob.</span>
1325
1326     Recalls:
1327         -
1328             - Mark a recall as problematic if it has been waiting to be picked up for
1329             - pref: RecallsMaxPickUpDelay
1330             - class: integer
1331             - days.
1332         -
1333             - pref: UseRecalls
1334               choices:
1335                   1: Use
1336                   0: "Don't use"
1337             - recalls. Make sure you configure <a href="/cgi-bin/koha/admin/smart-rules.pl">circulation and fines rules</a> for recalls once enabled.
1338
1339     SIP2:
1340         -
1341             - "Use the following mappings to determine the sort_bin of a returned item.<br/>"
1342             - "The mapping should be of the form 'branchcode:item field:comparator:item field value:sort bin number', with one mapping per line.<br/>"
1343             - "- 'branchcode' is the location where the checkin is being performed (i.e. branch assigned to SIP user)<br/>"
1344             - "- 'item field' is a database column in the items table<br/>"
1345             - "- 'comparator' is the type of comparison, possible values are: eq,<,<=,>,>=,ne<br/>"
1346             - "- 'item field value' is the value to compare against the value in the specified 'item field'<br/>"
1347             - "- 'sort bin number' is the expected return value in the CL field of the SIP response for an item matching a rule<br/><br/>"
1348             - "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/>"
1349             - "i.e. \\$holdingbranch<br/></br>"
1350             - "Examples:<br/>"
1351             - "CPL:itype:eq:BOOK:1 - Will return sort bin 1 for an item of itemtype 'BOOK' returned to CPL.<br/>"
1352             - "CPL:itemcallnumber:<:339.6:3 - Will return sort bin 3 for an item with a callnumber less than 339.6 returned to CPL .<br/>"
1353             - "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/>"
1354             - pref: SIP2SortBinMapping
1355               type: textarea
1356               class: long
1357         -
1358             - Use
1359             - pref: UseLocationAsAQInSIP
1360               choices:
1361                   1: permanent_location
1362                   0: homebranch
1363             - for AQ field in SIP protocol.
1364
1365     Curbside pickup module:
1366         -
1367             - pref: CurbsidePickup
1368               choices:
1369                   1: Enable
1370                   0: Disable
1371             - "the curbside pickup module."