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

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