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

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