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

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