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

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