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