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

   1 Circulation:
   2     Interface:
   3         -
   4             - pref: CircSidebar
   5               choices:
   6                   1: Activate
   7                   0: Deactivate
   8             - the navigation sidebar on all circulation pages.
   9         -
  10             - pref: CircConfirmItemParts
  11               choices:
  12                   1: "Require"
  13                   0: "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                   1: "Enable"
  19                   0: "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                   1: Try
  26                   0: "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. Mind that any leading or trailing whitespace in a barcode gets removed before this filter.
  39         -
  40             - pref: itemBarcodeFallbackSearch
  41               choices:
  42                   1: "Enable"
  43                   0: "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                   1: Allow
  64                   0: "Don't allow"
  65             - staff to specify a due date for a checkout.
  66         -
  67             - pref: SpecifyReturnDate
  68               choices:
  69                   1: Allow
  70                   0: "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                   1: Allow
  81                   0: "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                   1: Notify
  92                   0: "Don't notify"
  93             - librarians of overdue fines on the items they are checking in.
  94         -
  95             - pref: WaitingNotifyAtCheckin
  96               choices:
  97                   1: Notify
  98                   0: "Don't notify"
  99             - librarians of waiting holds for the patron whose items they are checking in.
 100         -
 101             - pref: FilterBeforeOverdueReport
 102               choices:
 103                   1: Require
 104                   0: "Don't require"
 105             - staff to choose which checkouts to show before running the overdues report.
 106         -
 107             - pref: DisplayClearScreenButton
 108               choices:
 109                   no: "Don't show clear screen button"
 110                   issueslip: "Show print slip and clear screen buttons"
 111                   issueqslip: "Show print quick slip and clear screen buttons"
 112             - to clear the current patron from the screen on the circulation screen.
 113         -
 114             - pref: RecordLocalUseOnReturn
 115               choices:
 116                   1: Record
 117                   0: "Don't record"
 118             - local use when an unissued item is checked in.
 119         -
 120             - When an empty barcode field is submitted in circulation
 121             - pref: CircAutoPrintQuickSlip
 122               choices:
 123                   clear: "clear the screen"
 124                   qslip: "open a print quick slip window"
 125                   slip: "open a print slip window"
 126             - .
 127         -
 128             - Include the stylesheet at
 129             - pref: NoticeCSS
 130               class: url
 131             - on notices. (This should be a complete URL, starting with <code>http://</code>)
 132         -
 133             - pref: UpdateTotalIssuesOnCirc
 134               choices:
 135                   1: Do
 136                   0: "Don't"
 137             - 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).
 138         -
 139             - pref: ExportCircHistory
 140               choices:
 141                   1: Show
 142                   0: "Don't show"
 143             - the option to export patron checkouts.
 144         -
 145             - "The following fields should be excluded from the patron checkout CSV or MARC (ISO 2709) export:"
 146             - pref: ExportRemoveFields
 147             - (separate fields with space, e.g. 100a 200b 300c).
 148         -
 149             - pref: ShowAllCheckins
 150               choices:
 151                   1: Show
 152                   0: "Don't show"
 153             - all items in the "Checked-in items" list, even items that were not checked out.
 154         -
 155             - pref: AllowCheckoutNotes
 156               choices:
 157                   1: Allow
 158                   0: "Don't allow"
 159             - patrons to submit notes about checked out items.
 160         -
 161             - pref: UseCirculationDesks
 162               choices:
 163                   1: "Use"
 164                   0: "Don't use"
 165             - circulation desks with circulation.
 166
 167     Checkout policy:
 168         -
 169             - Delay the automatic loading of the checkouts table on the checkouts page by
 170             - pref: LoadCheckoutsTableDelay
 171               class: integer
 172             - seconds when "Always show checkouts automatically" is enabled.
 173         -
 174             - pref: OnSiteCheckoutAutoCheck
 175               choices:
 176                   1: Enable
 177                   0: Don't enable
 178             - on-site checkout by default if last checkout was an on-site one.
 179         -
 180             - pref: AutoReturnCheckedOutItems
 181               choices:
 182                   1: Don't
 183                   0: Do
 184             - require librarians to manually confirm a checkout where the item is already checked out to another patron.
 185         -
 186             - pref: AllowSetAutomaticRenewal
 187               choices:
 188                   1: Allow
 189                   0: "Don't allow"
 190             - staff to flag items for autorenewal on the checkout page.
 191         -
 192             - pref: AllowTooManyOverride
 193               choices:
 194                   1: Allow
 195                   0: "Don't allow"
 196             - staff to override and check out items when the patron has reached the maximum number of allowed checkouts.
 197         -
 198             - pref: AllowNotForLoanOverride
 199               choices:
 200                   1: Allow
 201                   0: "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                   1: Allow
 207                   0: "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                   1: Allow
 213                   0: "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                   1: Allow
 219                   0: "Don't allow"
 220             - checkouts of items reserved to someone else via SIP checkout messages.
 221             - If allowed do not generate 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                   1: Allow
 227                   0: "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                   1: Require
 233                   0: "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. Enabling this system preference will block all checkouts for patrons with fines both via the web-based self checkout system and via SIP.
 235         -
 236             - pref: AllowFineOverride
 237               choices:
 238                   1: Allow
 239                   0: "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                   1: Do
 245                   0: "Don't"
 246             - automatically transfer items to their home library when they are checked in.
 247         -
 248             - pref: UseBranchTransferLimits
 249               choices:
 250                   1: Enforce
 251                   0: "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                   1: Use
 262                   0: "Don't use"
 263             - the transport cost matrix for calculating optimal holds filling between libraries.
 264         -
 265             - Use the calendar and circulation 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             - To determine whether an item is transferred or remains in the library after checkin, use the circulation rules of
 274             - pref: CircControlReturnsBranch
 275               type: choice
 276               choices:
 277                   ItemHoldingLibrary: the library the item is currently held by.
 278                   CheckInLibrary: the library the item is checked in at.
 279                   ItemHomeLibrary: the library the item is owned by.
 280         -
 281             - Use the circulation and fine rules of
 282             - pref: HomeOrHoldingBranch
 283               type: choice
 284               choices:
 285                   homebranch: the item's home library (homebranch).
 286                   holdingbranch: the item's holding library (holdingbranch).
 287         -
 288             - Allow items to be checked in
 289             - pref: AllowReturnToBranch
 290               type: choice
 291               choices:
 292                   anywhere: at any library.
 293                   homebranch: only at the library the item is from.
 294                   holdingbranch: only at the library the item was checked out from.
 295                   homeorholdingbranch: either at the library the item is from or the library it was checked out from.
 296         -
 297             - For search results in the staff interface, display
 298             - pref: StaffSearchResultsDisplayBranch
 299               type: choice
 300               choices:
 301                   homebranch: the library the item is from.
 302                   holdingbranch: the library the item is held by.
 303         -
 304             - pref: useDaysMode
 305               choices:
 306                   Days: Ignore the calendar
 307                   Calendar: Use the calendar to skip days the library is closed
 308                   Datedue: Use the calendar to push the due date to the next open day
 309                   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
 310             - when calculating the date due.
 311         -
 312             - Calculate "No renewal before" based on
 313             - pref: NoRenewalBeforePrecision
 314               choices:
 315                   date: date.
 316                   exact_time: exact time.
 317             - Only relevant for loans calculated in days, hourly loans are not affected.
 318         -
 319             - When renewing checkouts, base the new due date on
 320             - pref: RenewalPeriodBase
 321               choices:
 322                   date_due: the old due date of the checkout.
 323                   now: the current date.
 324         -
 325             - pref: RenewalSendNotice
 326               choices:
 327                   1: Send
 328                   0: "Don't send"
 329             - "a renewal notice according to patron's messaging preferences for 'Item checkout'."
 330         -
 331             - pref: UnseenRenewals
 332               choices:
 333                   1: Allow
 334                   0: "Don't allow"
 335             - renewals to be recorded as "unseen" by the library, and count against the patrons unseen renewals limit.
 336         -
 337             - Prevent patrons from making holds on the OPAC if they owe more than
 338             - pref: maxoutstanding
 339               class: currency
 340             - '[% local_currency %] in fines.'
 341         -
 342             - Show a warning on the "Transfers to receive" screen if the transfer has not been received
 343             - pref: TransfersMaxDaysWarning
 344               class: integer
 345             - days after it was sent.
 346         -
 347             - pref: IssuingInProcess
 348               choices:
 349                   1: "Don't prevent"
 350                   0: "Prevent"
 351             - patrons from checking out an item whose rental charge would take them over the limit.
 352         -
 353             - "Restrict patrons with the following target audience values from checking out inappropriate materials:"
 354             - pref: AgeRestrictionMarker
 355             - ". 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."
 356         -
 357             - pref: AgeRestrictionOverride
 358               choices:
 359                   1: Allow
 360                   0: "Don't allow"
 361             - staff to check out an item with age restriction.
 362         -
 363             - Prevent patrons from checking out items if they have more than
 364             - pref: noissuescharge
 365               class: integer
 366             - '[% local_currency %] in fines.'
 367         -
 368             - Prevent a patron from checking out if the patron has guarantees owing in total more than
 369             - pref: NoIssuesChargeGuarantees
 370               class: integer
 371             - '[% local_currency %] in fines.'
 372         -
 373             - Prevent a patron from checking out if the patron has guarantors and those guarantor's guarantees owing in total more than
 374             - pref: NoIssuesChargeGuarantorsWithGuarantees
 375               class: integer
 376             - '[% local_currency %] in fines.'
 377         -
 378             - pref: ReturnBeforeExpiry
 379               choices:
 380                   1: Require
 381                   0: "Don't require"
 382             - "patrons to return items before their accounts expire (by restricting due dates to before the patron's expiration date)."
 383         -
 384             - "Send all notices as a BCC to this email address:"
 385             - pref: NoticeBcc
 386               class: email
 387         -
 388             - pref: OverdueNoticeCalendar
 389               choices:
 390                   1: "Use calendar"
 391                   0: "Ignore calendar"
 392             - "when working out the period for overdue notices."
 393         -
 394             - "Organize and send overdue notices using the"
 395             - pref: OverdueNoticeFrom
 396               choices:
 397                   cron: "command-line option"
 398                   item-issuebranch: "checkout library"
 399                   item-homebranch: "item home library"
 400                   patron-homebranch: "patron home library"
 401             - .
 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                   1: ask
 419                   0: "don't ask"
 420             - "for confirmation."
 421         -
 422             - By default, set the <a href="/cgi-bin/koha/admin/authorised_values.pl?searchfield=LOST">LOST</a> value of an item to
 423             - pref: DefaultLongOverdueLostValue
 424               choices: authval
 425               source: LOST
 426             - when the item has been overdue for more than
 427             - pref: DefaultLongOverdueDays
 428               class: integer
 429             - days.
 430             - <br>WARNING — These preferences will activate the automatic item loss process. Leave these fields empty if you don't want to activate this feature.
 431             - "<br>Example: [1] [30] Sets an item to the <a href='/cgi-bin/koha/admin/authorised_values.pl?searchfield=LOST'>LOST</a> value 1 when it has been overdue for more than 30 days."
 432             - <br>(Used when the longoverdue.pl script is called without the --lost parameter)
 433             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/longoverdue.pl</code> cronjob. Ask your system administrator to schedule it."
 434         -
 435             - "Charge a lost item to the patron's account when the <a href='/cgi-bin/koha/admin/authorised_values.pl?searchfield=LOST'>LOST</a> value of the item changes to:"
 436             - pref: DefaultLongOverdueChargeValue
 437               choices: authval
 438               source: LOST
 439             - <br>Leave this field empty if you don't want to charge the patron for lost items.
 440             - <br>(Used when the longoverdue.pl script is called without the --charge parameter)
 441             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/longoverdue.pl</code> cronjob. Ask your system administrator to schedule it."
 442         -
 443             - When using the automatic item loss process, skip items with <a href="/cgi-bin/koha/admin/authorised_values.pl?searchfield=LOST">LOST</a> values matching any of
 444             - pref: DefaultLongOverdueSkipLostStatuses
 445             - "."
 446             - <br>Leave this field empty if you don't want to skip any <a href="/cgi-bin/koha/admin/authorised_values.pl?searchfield=LOST">LOST</a> statuses.
 447             - <br>Set to a list of comma separated values, e.g. <em>5,6,7</em>.
 448         -
 449             - "When issuing an item that has been marked as lost, "
 450             - pref: IssueLostItem
 451               choices:
 452                   confirm: "require confirmation"
 453                   alert: "display a message"
 454                   nothing : "do nothing"
 455             - .
 456         -
 457             - "When checking out an item, "
 458             - pref: RecordStaffUserOnCheckout
 459               choices:
 460                   1: "record"
 461                   0: "don't record"
 462             - "the user who checked out the item."
 463         -
 464             - "Mark items as returned when flagged as lost "
 465             - pref: MarkLostItemsAsReturned
 466               multiple:
 467                 cronjob: "from the longoverdue cronjob"
 468                 batchmod: "from the batch item modification tool"
 469                 additem: "when cataloguing an item"
 470                 moredetail: "from the items tab of the catalog module"
 471                 pendingreserves: "from the 'Holds to pull' list"
 472                 onpayment: "when receiving payment for the item"
 473                 claim_returned: "when marking an item as a return claim"
 474             - .
 475         -
 476             - pref: AllowMultipleIssuesOnABiblio
 477               choices:
 478                   1: Allow
 479                   0: "Don't allow"
 480             - "patrons to check out multiple items from the same record. (<strong>NOTE:</strong> This will only affect records without a subscription attached.)"
 481         -
 482             - pref: OnSiteCheckouts
 483               choices:
 484                   1: Enable
 485                   0: Disable
 486             - the on-site checkouts feature.
 487         -
 488             - pref: OnSiteCheckoutsForce
 489               choices:
 490                   1: Enable
 491                   0: Disable
 492             - the on-site checkout for all cases (even if a patron is debarred, etc.).
 493         -
 494             - pref: ConsiderOnSiteCheckoutsAsNormalCheckouts
 495               choices:
 496                   1: Consider
 497                   0: "Don't consider"
 498             - on-site checkouts as normal checkouts.
 499             - 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.
 500             - If disabled, both values will be checked separately.
 501         -
 502             - pref: SwitchOnSiteCheckouts
 503               choices:
 504                   1: Switch
 505                   0: "Don't switch"
 506             - on-site checkouts to normal checkouts when checked out.
 507         -
 508             - When a patron's checked out item is overdue,
 509             - pref: OverduesBlockRenewing
 510               type: choice
 511               choices:
 512                   allow: allow renewing.
 513                   blockitem: block renewing only for this item.
 514                   block: block renewing for all the patron's items.
 515         -
 516             - If a patron owes more than the value of <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACFineNoRenewals">OPACFineNoRenewals</a>,
 517             - pref: OPACFineNoRenewalsBlockAutoRenew
 518               choices:
 519                   1: block
 520                   0: allow
 521             - their auto-renewals.
 522         -
 523             - If a patron pays off all fines on an overdue item that is accruing fines,
 524             - pref: RenewAccruingItemWhenPaid
 525               choices:
 526                   1: renew
 527                   0: "don't renew"
 528             - 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.
 529         -
 530             - If a patron pays off all fines on an overdue item that is accruing fines in the OPAC via a payment plugin,
 531             - pref: RenewAccruingItemInOpac
 532               choices:
 533                   1: renew
 534                   0: "don't renew"
 535             - 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.
 536         -
 537             - pref: ItemsDeniedRenewal
 538               type: textarea
 539               syntax: text/x-yaml
 540               class: code
 541             - Define custom rules to deny specific items from renewal.
 542             - "<br />Can name any field in the items table followed by a colon then a space then"
 543             - "a bracketed list of values separated by commas."
 544             - "For example:"
 545             - "<br />ccode: [NEWFIC,NULL,DVD]"
 546             - "<br />itype: [NEWBK,\"\"]"
 547             - "<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."
 548             - "<br /><strong>LINKS:</strong> <a href='/cgi-bin/koha/admin/authorised_values.pl?searchfield=CCODE'>Collection codes</a> | <a href='/cgi-bin/koha/admin/itemtypes.pl'>Item types</a>"
 549         -
 550             - pref: UpdateNotForLoanStatusOnCheckout
 551               type: textarea
 552               syntax: text/x-yaml
 553               class: code
 554             - This is a list of value pairs. When an item is checked out, if the not for loan value on the left matches the items not for loan value
 555             - "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."
 556             - Each pair of values should be on a separate line.
 557     Checkin policy:
 558         -
 559             - pref: TrapHoldsOnOrder
 560               choices:
 561                   1: Trap
 562                   0: "Don't trap"
 563             - items that are not for loan but holdable ( notforloan < 0 ) to fill holds.
 564         -
 565             - Never trap items with <a href="/cgi-bin/koha/admin/authorised_values.pl?searchfield=NOT_LOAN">'not for loan'</a> values of
 566             - pref: SkipHoldTrapOnNotForLoanValue
 567               class: integer
 568             - to fill holds.
 569             - "(list of <a href='/cgi-bin/koha/admin/authorised_values.pl?searchfield=NOT_LOAN'>not for loan</a> values separated with a pipe '|')"
 570         -
 571             - pref: HoldsAutoFill
 572               choices:
 573                   1: Do
 574                   0: "Don't"
 575             - automatically fill holds instead of asking the librarian.
 576         -
 577             - pref: HoldsNeedProcessingSIP
 578               choices:
 579                   1: "Don't fulfill"
 580                   0: Fulfill
 581             - holds automatically if matching item is returned via SIP protocol.
 582         -
 583             - pref: HoldsAutoFillPrintSlip
 584               choices:
 585                   1: Do
 586                   0: "Don't"
 587             - automatically display the hold slip dialog for auto-filled holds.
 588         -
 589             - pref: BlockReturnOfWithdrawnItems
 590               choices:
 591                   1: Block
 592                   0: "Don't block"
 593             - returning of items that have been withdrawn.
 594         -
 595             - pref: BlockReturnOfLostItems
 596               choices:
 597                   1: Block
 598                   0: "Don't block"
 599             - returning of items that have been lost.
 600         -
 601             - pref: CalculateFinesOnReturn
 602               choices:
 603                   1: Do
 604                   0: "Don't"
 605             - calculate and update overdue charges when an item is returned.
 606             - "<br /><strong>NOTE:</strong> If you are doing hourly loans then you should have this on."
 607             - '<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."'
 608         -
 609             - pref: CalculateFinesOnBackdate
 610               choices:
 611                   1: Do
 612                   0: "Don't"
 613             - calculate and update overdue charges when an item is returned with a backdated return date.
 614         -
 615             - pref: UpdateItemLocationOnCheckin
 616               type: textarea
 617               syntax: text/x-yaml
 618               class: code
 619             - "This is a list of value pairs. The first value is followed immediately by colon space then the second value.<br/><br/>"
 620             - <a href="/cgi-bin/koha/admin/authorised_values.pl?searchfield=LOC">Location codes</a><br/><br/>
 621             - "Examples:<br/>"
 622             - "PROC: FIC - causes an item in the Processing Center location to be updated into the Fiction location on check in.<br/>"
 623             - "FIC: GEN - causes an item in the Fiction location to be updated into the General stacks location on check in.<br/>"
 624             - "_BLANK_: FIC - causes an item that has no location to be updated into the Fiction location on check in.<br/>"
 625             - "FIC: _BLANK_ - causes an item in location FIC to be updated to a blank location on check in.<br/>"
 626             - "_ALL_: FIC - causes all items to be updated into the Fiction location on check in.<br/>"
 627             - "PROC: _PERM_ - causes an item that is in the Processing Center to be updated to it's permanent location.<br/><br/>"
 628             - "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/>"
 629             - "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/>"
 630             - "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/>"
 631             - "The special term _ALL_ is used on the left side of the colon (:) to affect all items, <strong>and overrides all other rules.</strong>"
 632         -
 633             - pref: UpdateItemLocationOnCheckout
 634               type: textarea
 635               syntax: text/x-yaml
 636               class: code
 637             - "This is a list of value pairs. The first value is followed immediately by colon space then the second value.<br/><br/>"
 638             - "Examples:<br/>"
 639             - "PROC: FIC - causes an item in the Processing Center location to be updated into the Fiction location on check out.<br/>"
 640             - "FIC: GEN - causes an item in the Fiction location to be updated into the General stacks location on check out.<br/>"
 641             - "_BLANK_: FIC - causes an item that has no location to be updated into the Fiction location on check out.<br/>"
 642             - "FIC: _BLANK_ - causes an item in location FIC to be updated to a blank location on check out.<br/>"
 643             - "_ALL_: FIC - causes all items to be updated into the Fiction location on check out.<br/>"
 644             - "PROC: _PERM_ - causes an item that is in the Processing Center to be updated to it's permanent location.<br/><br/>"
 645             - "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/>"
 646             - "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/>"
 647             - "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/>"
 648             - "The special term _ALL_ is used on the left side of the colon (:) to affect all items, <strong>and overrides all other rules.</strong>"
 649         -
 650             - pref: UpdateNotForLoanStatusOnCheckin
 651               type: textarea
 652               syntax: text/x-yaml
 653               class: code
 654             - 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
 655             - "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."
 656             - "Can be used for showing only the not for loan description. E.g. '-1: ONLYMESSAGE'."
 657             - "Each pair of values should be on a separate line.<br/>"
 658             - <a href="/cgi-bin/koha/admin/authorised_values.pl?searchfield=NOT_LOAN">Not for loan values</a>
 659         -
 660             - pref: HidePersonalPatronDetailOnCirculation
 661               choices:
 662                   1: "Hide"
 663                   0: "Don't hide"
 664             - "a patron's phone number, email address, street address and city on the circulation page."
 665         -
 666             - pref: TransfersBlockCirc
 667               choices:
 668                   1: "Block"
 669                   0: "Don't block"
 670             - staff from continuing to checkin items when a transfer is triggered.
 671         -
 672             - pref: AutomaticConfirmTransfer
 673               choices:
 674                   1: "Do"
 675                   0: "Don't"
 676             - automatically confirm a transfer when the modal is dismissed without clicking 'Yes'.
 677         -
 678             - pref: StoreLastBorrower
 679               default: 0
 680               choices:
 681                   1: Store
 682                   0: "Don't store"
 683             - '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.'
 684     Holds policy:
 685         -
 686             - In the staff interface, split the holds queue into separate tables by
 687             - pref: HoldsSplitQueue
 688               choices:
 689                   nothing: nothing
 690                   branch: "pickup library"
 691                   itemtype: "hold item type"
 692                   branch_itemtype: "pickup library and item type"
 693             - "."
 694         -
 695             - pref: EnableItemGroupHolds
 696               choices:
 697                   1: Enable
 698                   0: "Don't enable"
 699             - "the ability to place holds on item groups. <br><strong>NOTE:</strong> This system preference requires that <a href='/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=EnableItemGroups'>EnableItemGroups</a> to be set to 'Enable'."
 700         -
 701             - If the holds queue is split, show librarians
 702             - pref: HoldsSplitQueueNumbering
 703               choices:
 704                   actual: "the actual priority, which may be out of order"
 705                   virtual: "'virtual' priorities, where each group is numbered separately"
 706             - "."
 707         -
 708             - pref: RealTimeHoldsQueue
 709               choices:
 710                   1: Enable
 711                   0: Disable
 712             - updating the holds queue in real time.
 713         -
 714             - pref: AllowHoldItemTypeSelection
 715               choices:
 716                   1: Allow
 717                   0: "Don't allow"
 718             - hold fulfillment to be limited by item type.
 719         -
 720             - pref: AllowRenewalIfOtherItemsAvailable
 721               choices:
 722                   1: Allow
 723                   0: "Don't allow"
 724             - a patron to renew an item with unfilled holds if other available items can fill that hold.
 725         -
 726             - pref: AllowHoldPolicyOverride
 727               choices:
 728                   1: Allow
 729                   0: "Don't allow"
 730             - staff to override hold policies when placing holds.
 731         -
 732             - pref: AllowHoldsOnDamagedItems
 733               choices:
 734                   1: Allow
 735                   0: "Don't allow"
 736             - hold requests to be placed on and filled by damaged items.
 737         -
 738             - pref: AllowHoldDateInFuture
 739               choices:
 740                   1: Allow
 741                   0: "Don't allow"
 742             - hold requests to be placed that do not enter the waiting list until a certain future date.
 743         -
 744             - pref: OPACAllowHoldDateInFuture
 745               choices:
 746                   1: Allow
 747                   0: "Don't allow"
 748             - 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).
 749         -
 750             - When placing a hold from the OPAC, make
 751             - pref: OPACMandatoryHoldDates
 752               choices:
 753                   "": "no hold dates"
 754                   "start": "hold start date"
 755                   "end": "hold end date"
 756                   "both": "both hold dates"
 757             - mandatory.
 758             - '<br><strong>NOTE:</strong> The hold start date option is only effective and shown on the hold form when <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=AllowHoldDateInFuture">AllowHoldDateInFuture</a> and <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACAllowHoldDateInFuture">OPACAllowHoldDateInFuture</a> are enabled.'
 759         -
 760             - Confirm future hold requests (starting no later than
 761             - pref: ConfirmFutureHolds
 762               class: integer
 763             - 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.
 764         -
 765             - Check the rule from the
 766             - pref: ReservesControlBranch
 767               choices:
 768                   ItemHomeLibrary: "item's home library"
 769                   PatronLibrary: "patron's home library"
 770             - to see if the patron can place a hold on the item.
 771         -
 772             - Mark a hold as problematic if it has been waiting for more than
 773             - pref: ReservesMaxPickUpDelay
 774               class: integer
 775             - days.
 776         -
 777             - pref: ExpireReservesMaxPickUpDelay
 778               choices:
 779                   1: Allow
 780                   0: "Don't allow"
 781             - '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>'
 782             - pref: ExpireReservesAutoFill
 783               choices:
 784                   1: "Do"
 785                   0: "Don't"
 786             - automatically fill the next hold using the item.
 787             - Send email notification of the new hold filled with a canceled item to
 788             - pref: ExpireReservesAutoFillEmail
 789               class: email
 790             - . If no address is defined here, the email will be sent to the library's reply-to address.
 791             - '<br><strong>NOTE:</strong> These system preferences require the <code>misc/cronjobs/holds/cancel_expired_holds.pl</code> cronjob. Ask your system administrator to schedule it.<br>'
 792         -
 793             - 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
 794             - pref: ExpireReservesMaxPickUpDelayCharge
 795               class: currency
 796             - "."
 797         -
 798             - The holds queue should prioritize filling a hold by matching the patron's home library with an item having a matching
 799             - pref: HoldsQueuePrioritizeBranch
 800               type: choice
 801               choices:
 802                   homebranch: home library (homebranch).
 803                   holdingbranch: holding library (holdingbranch).
 804         -
 805             - Satisfy holds using items from the libraries
 806             - pref: StaticHoldsQueueWeight
 807               class: multi
 808             - (as branchcodes, separated by commas; if empty, uses all libraries)
 809             - when they are
 810             - pref: HoldsQueueSkipClosed
 811               choices:
 812                   1: open
 813                   0: open or closed
 814             - pref: RandomizeHoldsQueueWeight
 815               choices:
 816                   1: in random order.
 817                   0: in that order.
 818             - "<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."
 819             -
 820         -
 821             - pref: canreservefromotherbranches
 822               choices:
 823                   1: Allow
 824                   0: "Don't allow (with independentbranches)"
 825             - a user from one library to place a hold on an item from another library
 826         -
 827             - pref: OPACAllowUserToChooseBranch
 828               choices:
 829                   1: Allow
 830                   0: "Don't allow"
 831             - a user to choose the library to pick up a hold from.
 832         -
 833             - 'Allow users to change the library to pick up a hold for these statuses:'
 834             - pref: OPACAllowUserToChangeBranch
 835               multiple:
 836                 pending: Pending
 837                 intransit: In transit
 838                 suspended: Suspended
 839         -
 840             - pref: ReservesNeedReturns
 841               choices:
 842                   1: "Don't automatically"
 843                   0: Automatically
 844             - mark a hold as found and waiting when a hold is placed on a specific item and that item is already checked in.
 845         -
 846             - Patrons can have a maximum of
 847             - pref: maxreserves
 848               class: integer
 849             - holds at once (leave blank or set to 0 to disable). Additional limits may apply based on circulation rules.
 850         -
 851             - pref: emailLibrarianWhenHoldIsPlaced
 852               choices:
 853                   1: Enable
 854                   0:  "Don't enable"
 855             - "sending an email to the Koha administrator email address whenever a hold request is placed."
 856         -
 857             - pref: DisplayMultiPlaceHold
 858               choices:
 859                   1: Enable
 860                   0:  "Don't enable"
 861             - "the ability to place holds on multiple bibliographic records from the search results"
 862         -
 863             - pref: TransferWhenCancelAllWaitingHolds
 864               choices:
 865                   1: Transfer
 866                   0: "Don't transfer"
 867             - items when cancelling all waiting holds.
 868         -
 869             - pref: AutoResumeSuspendedHolds
 870               choices:
 871                   1: Allow
 872                   0: "Don't allow"
 873             - "suspended holds to be automatically resumed by a set date."
 874             - "<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."
 875         -
 876             - pref: SuspendHoldsIntranet
 877               choices:
 878                   1: Allow
 879                   0: "Don't allow"
 880             - holds to be suspended from the staff interface.
 881         -
 882             - pref: SuspendHoldsOpac
 883               choices:
 884                   1: Allow
 885                   0: "Don't allow"
 886             - holds to be suspended from the OPAC.
 887         -
 888             - If using <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=ExpireReservesMaxPickUpDelay">ExpireReservesMaxPickUpDelay</a>,
 889             - pref: ExpireReservesOnHolidays
 890               choices:
 891                   1: allow
 892                   0: "don't allow"
 893             - expired holds to be canceled on days the library is closed per the calendar.
 894         -
 895             - pref: ExcludeHolidaysFromMaxPickUpDelay
 896               choices:
 897                   1: Use the calendar
 898                   0: Ignore the calendar
 899             - when calculating the period for a hold's max pickup delay.
 900         -
 901             - pref: decreaseLoanHighHolds
 902               choices:
 903                   1: Enable
 904                   0:  "Don't enable"
 905             - the reduction of loan period to
 906             - pref: decreaseLoanHighHoldsDuration
 907               class: integer
 908             - days for high demand items with more than
 909             - pref: decreaseLoanHighHoldsValue
 910               class: integer
 911             - holds
 912             - pref: decreaseLoanHighHoldsControl
 913               choices:
 914                   static: "on the record"
 915                   dynamic: "over the number of holdable items on the record"
 916             - ". Ignore items with the following statuses when counting items:"
 917             - pref: decreaseLoanHighHoldsIgnoreStatuses
 918               multiple:
 919                 damaged: Damaged
 920                 itemlost: Lost
 921                 withdrawn: Withdrawn
 922                 notforloan: Not for loan
 923             - "Note: The reduced loan period can also be set up in the circulation conditions and will then overwrite the setting here."
 924         -
 925             - pref: AllowHoldsOnPatronsPossessions
 926               choices:
 927                   1: Allow
 928                   0: "Don't allow"
 929             - a patron to place a hold on a record where the patron already has one or more items attached to that record checked out.
 930         -
 931             - pref: LocalHoldsPriority
 932               choices:
 933                   1: Give
 934                   0: "Don't give"
 935             - priority for filling holds to patrons whose
 936             - pref: LocalHoldsPriorityPatronControl
 937               choices:
 938                   PickupLibrary: "pickup library"
 939                   HomeLibrary: "home library"
 940             - matches the item's
 941             - pref: LocalHoldsPriorityItemControl
 942               choices:
 943                   homebranch: "home library"
 944                   holdingbranch: "holding library"
 945         -
 946             - pref: OPACHoldsIfAvailableAtPickup
 947               choices:
 948                   1: Allow
 949                   0: "Don't allow"
 950             - patrons to place a hold at pickup locations (libraries) where the item is available.
 951         -
 952             - 'Patron categories not affected by <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACHoldsIfAvailableAtPickup">OPACHoldsIfAvailableAtPickup</a>:'
 953             - pref: OPACHoldsIfAvailableAtPickupExceptions
 954               choices: patron-categories
 955               class: multiple
 956         -
 957             - pref: CanMarkHoldsToPullAsLost
 958               choices:
 959                   do_not_allow: "Do not allow to mark items as lost"
 960                   allow: "Allow to mark items as lost"
 961                   allow_and_notify: "Allow to mark items as lost and notify the patron"
 962             - 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>.
 963         -
 964             - A list of values to update an item's values with when it is marked as <a href="/cgi-bin/koha/admin/authorised_values.pl?searchfield=LOST">LOST</a> from the 'Holds to pull' page.
 965             - 'Example: "itemlost: 1" to set items.itemlost to 1 when the item is marked as <a href="/cgi-bin/koha/admin/authorised_values.pl?searchfield=LOST">LOST</a>. (Requires <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=CanMarkHoldsToPullAsLost">CanMarkHoldsToPullAsLost</a>)'
 966             - pref: UpdateItemWhenLostFromHoldList
 967               type: textarea
 968               syntax: text/x-yaml
 969         -
 970             - pref: DefaultHoldExpirationdate
 971               default: 0
 972               choices:
 973                   1: Set
 974                   0: Don't set
 975             - default expiration date for holds automatically.
 976             - If enabled, set expiration date
 977             - pref: DefaultHoldExpirationdatePeriod
 978               default: 0
 979               class: integer
 980             - pref: DefaultHoldExpirationdateUnitOfTime
 981               default: days
 982               choices:
 983                   days: days
 984                   months: months
 985                   years: years
 986             - from reserve date.
 987         -
 988             - When placing a hold via the staff interface default the pickup location to the
 989             - pref: DefaultHoldPickupLocation
 990               default: loggedinlibrary
 991               choices:
 992                   loggedinlibrary: "logged in library"
 993                   homebranch: "item's home library"
 994                   holdingbranch: "item's holding library"
 995             - "."
 996         -
 997             - pref: AutomaticCheckinAutoFill
 998               choices:
 999                   1: "Allow"
1000                   0: "Don't allow"
1001             - holds to be automatically filled after being automatically checked in.
1002             - '<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/automatic_checkin.pl</code> cronjob. Ask your system administrator to schedule it.'
1003     Patron restrictions:
1004         -
1005             - pref: PatronRestrictionTypes
1006               choices:
1007                   1: Allow
1008                   0: Don't allow
1009             - "the type of patron restriction to be specified when applying manually."
1010         -
1011             - pref: CumulativeRestrictionPeriods
1012               choices:
1013                   1: Cumulate
1014                   0: "Don't cumulate"
1015             - the restriction periods.
1016         -
1017             - When returning items
1018             - pref: AutoRemoveOverduesRestrictions
1019               type: choice
1020               choices:
1021                   when_no_overdue: "if patron has no remaining overdue items"
1022                   when_no_overdue_causing_debarment: "if patron has no remaining items that is cause for debarment"
1023                   no: "don't"
1024             - remove OVERDUES restriction triggered by sent notices. The difference between removing restriction when no remaining overdue items exists and doing so only when any of the items would result in debarment is that the latter option will respect possible grace periods of overdue rules also on returns and not only when generating overdue notices.
1025         -
1026             - If a patron is restricted,
1027             - pref: RestrictionBlockRenewing
1028               choices:
1029                   1: block
1030                   0: allow
1031             - renewing of items from the staff interface and via the <code>misc/cronjobs/automatic_renewals.pl</code> cronjob.
1032     Fines Policy:
1033         -
1034             - pref: finesCalendar
1035               type: choice
1036               choices:
1037                   ignoreCalendar: Ignore the calendar
1038                   noFinesWhenClosed: Use the calendar
1039             - when calculating the period for fines.
1040         -
1041             - pref: SuspensionsCalendar
1042               type: choice
1043               choices:
1044                   ignoreCalendar: Ignore the calendar
1045                   noSuspensionsWhenClosed: Use the calendar
1046             - when calculating the period for suspension expiration.
1047         -
1048             - pref: finesMode
1049               type: choice
1050               choices:
1051                   off: "Don't calculate"
1052                   production: Calculate and charge
1053             - fines (when <code>cronjobs/fines.pl</code> is being run).
1054             - '<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.<br/>'
1055             - pref: ChargeFinesOnClosedDays
1056               type: choice
1057               choices:
1058                   0: "Don't charge"
1059                   1: Charge
1060             - on close days. If set the fines.pl cronjob will not generate fines when run on days marked as closed in the calendar.
1061         -
1062             - If a lost item is returned, apply the refunding rules defined for the
1063             - pref: RefundLostOnReturnControl
1064               choices:
1065                   CheckinLibrary: "check-in library."
1066                   ItemHomeBranch: "item's home library."
1067                   ItemHoldingBranch: "item's holding library."
1068         -
1069             - pref: FinesIncludeGracePeriod
1070               choices:
1071                   1: Include
1072                   0: "Don't include"
1073             - the grace period when calculating the fine for an overdue item.
1074         -
1075             - pref: WhenLostForgiveFine
1076               choices:
1077                   1: Forgive
1078                   0: "Don't forgive"
1079             - the fines on an item when it is marked as lost.
1080         -
1081             - "Don't refund lost fees if a lost item is checked in more than"
1082             - pref: NoRefundOnLostReturnedItemsAge
1083               class: integer
1084             - days after it was marked lost.
1085         -
1086             - pref: WhenLostChargeReplacementFee
1087               choices:
1088                   1: Charge
1089                   0: "Don't charge"
1090             - the replacement price when a patron loses an item.
1091         -
1092             - Charge a hold fee
1093             - pref: HoldFeeMode
1094               choices:
1095                   any_time_is_placed: "any time a hold is placed."
1096                   not_always: "only if all items are checked out and the record has at least one hold already."
1097                   any_time_is_collected: "any time a hold is collected."
1098         -
1099             - pref: useDefaultReplacementCost
1100               choices:
1101                   1: Use
1102                   0: "Don't use"
1103             - the default replacement cost defined for the item type.
1104         -
1105             - "Text to be recorded in the column 'note', table 'accountlines' when the processing fee (defined for the item type) is applied:"
1106             - pref: ProcessingFeeNote
1107               type: textarea
1108               class: code
1109     Self check-in module:
1110         -
1111             - "Include the following HTML on the self check-in screen:"
1112             - pref: SelfCheckInMainUserBlock
1113               type: textarea
1114               syntax: text/html
1115               class: code
1116         -
1117             - pref: SelfCheckInModule
1118               choices:
1119                   1: Enable
1120                   0: "Don't enable"
1121             - "the standalone self check-in module (available at: /cgi-bin/koha/sci/sci-main.pl)."
1122         -
1123             - "Reset the current self check-in screen after"
1124             - pref: SelfCheckInTimeout
1125               class: integer
1126             - seconds.
1127         -
1128             - "Include the following CSS on all the self check-in screens:"
1129             - pref: SelfCheckInUserCSS
1130               type: textarea
1131               syntax: css
1132               class: code
1133         -
1134             - "Include the following JavaScript on all the self check-in screens:"
1135             - pref: SelfCheckInUserJS
1136               type: textarea
1137               syntax: javascript
1138               class: code
1139     Self check-out module:
1140         -
1141             - "Include the following JavaScript on all pages in the web-based self checkout:"
1142             - pref: SCOUserJS
1143               type: textarea
1144               syntax: javascript
1145               class: code
1146         -
1147             - "Include the following HTML on the the web-based self checkout screen:"
1148             - pref: SCOMainUserBlock
1149               type: textarea
1150               syntax: text/html
1151               class: code
1152         -
1153             - "Include the following CSS on all pages in the web-based self checkout:"
1154             - pref: SCOUserCSS
1155               type: textarea
1156               syntax: css
1157               class: code
1158         -
1159             - pref: SCOLoadCheckoutsByDefault
1160               choices:
1161                   1: Show
1162                   0: "Don't show"
1163             - "the patron's list of current checkouts by default when they log in to the self checkout module."
1164         -
1165             - pref: ShowPatronImageInWebBasedSelfCheck
1166               choices:
1167                   1: Show
1168                   0: "Don't show"
1169             - "the patron's picture (if one has been added) when they use the web-based self checkout."
1170         -
1171             - pref: WebBasedSelfCheck
1172               choices:
1173                   1: Enable
1174                   0: "Don't enable"
1175             - "the web-based self checkout system (available at: /cgi-bin/koha/sco/sco-main.pl)."
1176         -
1177             - Have patrons log into the web-based self checkout system with their
1178             - pref: SelfCheckoutByLogin
1179               choices:
1180                   1: username and password
1181                   0: cardnumber
1182             - ".</br>NOTE: If using 'cardnumber' and AutoSelfCheckAllowed you should set SelfCheckAllowByIPRanges to prevent brute force attacks to gain patron information outside the library."
1183         -
1184             - "Time out the current patron's web-based self checkout system login after"
1185             - pref: SelfCheckTimeout
1186               class: integer
1187             - seconds.
1188         -
1189             - pref: SCOAllowCheckin
1190               choices:
1191                   1: Allow
1192                   0: "Don't allow"
1193             - patrons to return items through web-based self checkout system.
1194         -
1195             - "Include the following HTML in the Help page of the web-based self checkout system:"
1196             - pref: SelfCheckHelpMessage
1197               type: textarea
1198               syntax: text/html
1199               class: code
1200         -
1201             - pref: AutoSelfCheckAllowed
1202               choices:
1203                   1: Allow
1204                   0: "Don't allow"
1205             - "the web-based self checkout system to automatically log in with this staff login"
1206             - pref: AutoSelfCheckID
1207             - and this password
1208             - pref: AutoSelfCheckPass
1209               class: password
1210             - .
1211             - "Note: Any patron entered here will be unable to log into the OPAC."
1212         -
1213             - pref: SelfCheckReceiptPrompt
1214               choices:
1215                   1: Show
1216                   0: "Don't show"
1217             - "the print receipt popup dialog when self checkout is finished."
1218         -
1219             - "Allow access to the self check from the following IP addresses:"
1220             - pref: SelfCheckAllowByIPRanges
1221               class: short
1222             - (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>.)
1223     Course reserves:
1224         -
1225             - pref: UseCourseReserves
1226               choices:
1227                   1: Use
1228                   0: "Don't use"
1229             - "course reserves."
1230     Batch checkout:
1231         -
1232             - pref: BatchCheckouts
1233               choices:
1234                   1: Allow
1235                   0: "Don't allow"
1236             - "batch checkouts."
1237         -
1238             - "Patron categories allowed to checkout in a batch:"
1239             - pref: BatchCheckoutsValidCategories
1240               choices: patron-categories
1241               class: multiple
1242     Housebound module:
1243         -
1244             - pref: HouseboundModule
1245               choices:
1246                   1: Enable
1247                   0: Disable
1248             - "the housebound module."
1249     Stock rotation module:
1250         -
1251             - pref: StockRotation
1252               choices:
1253                   1: Enable
1254                   0: Disable
1255             - "the stock rotation module."
1256     Article requests:
1257         -
1258             - pref: ArticleRequests
1259               choices:
1260                   1: Enable
1261                   0: "Don't enable"
1262             - patrons to place article requests.
1263         -
1264             - pref: ArticleRequestsOpacHostRedirection
1265               choices:
1266                   1: Enable
1267                   0: Disable
1268             - " redirection from child to host based on MARC21 773$w when the child has no items when requesting articles on the Opac."
1269         -
1270             - pref: ArticleRequestsLinkControl
1271               choices:
1272                   always: Always show
1273                   calc: Use algorithm to show or hide
1274             - article request links on search results.
1275         -
1276             - "For records that are record level or item level requestable, make the following fields mandatory:"
1277             - pref: ArticleRequestsMandatoryFields
1278               multiple:
1279                 title: Title
1280                 author: Author
1281                 volume: Volume
1282                 issue: Issue
1283                 date: Date
1284                 pages: Pages
1285                 chapters: Chapters
1286             -
1287         -
1288             - "For records that are only record level requestable, make the following fields mandatory:"
1289             - pref: ArticleRequestsMandatoryFieldsRecordOnly
1290               multiple:
1291                 title: Title
1292                 author: Author
1293                 volume: Volume
1294                 issue: Issue
1295                 date: Date
1296                 pages: Pages
1297                 chapters: Chapters
1298             -
1299         -
1300             - "For records that are only item level requestable, make the following fields mandatory:"
1301             - pref: ArticleRequestsMandatoryFieldsItemOnly
1302               multiple:
1303                 title: Title
1304                 author: Author
1305                 volume: Volume
1306                 issue: Issue
1307                 date: Date
1308                 pages: Pages
1309                 chapters: Chapters
1310             -
1311         -
1312             - "The following article request formats are supported:"
1313             - pref: ArticleRequestsSupportedFormats
1314             - "(Valid choices are currently: PHOTOCOPY and SCAN. Separate the supported formats by a vertical bar. The first listed format is selected by default when you request via the OPAC.)"
1315
1316
1317     Item bundles:
1318         -
1319             - Use the <a href="/cgi-bin/koha/admin/authorised_values.pl?searchfield=LOST">LOST</a> authorized value
1320             - pref: BundleLostValue
1321               choices: authval
1322               source: LOST
1323             - to represent 'missing from bundle' at return.
1324         -
1325             - Use the <a href="/cgi-bin/koha/admin/authorised_values.pl?searchfield=NOT_LOAN">NOT_LOAN</a> authorized value
1326             - pref: BundleNotLoanValue
1327               choices: authval
1328               source: NOT_LOAN
1329             - to represent 'added to bundle' when an item is attached to bundle.
1330
1331     Return claims:
1332         -
1333             - When marking a checkout as "claims returned",
1334             - pref: ClaimReturnedChargeFee
1335               default: ask
1336               choices:
1337                   ask: ask if a lost fee should be charged
1338                   charge: charge a lost fee
1339                   no_charge: don't charge a lost fee
1340             - .
1341         -
1342             - Use the <a href="/cgi-bin/koha/admin/authorised_values.pl?searchfield=LOST">LOST</a> authorized value
1343             - pref: ClaimReturnedLostValue
1344               choices: authval
1345               source: LOST
1346             - to represent 'claims returned'.
1347         -
1348             - Warn librarians that a patron has excessive return claims if the patron has claimed the return of more than
1349             - pref: ClaimReturnedWarningThreshold
1350               class: integer
1351             - items.
1352         -
1353             - Remove resolved return claims older than
1354             - pref: CleanUpDatabaseReturnClaims
1355               class: integer
1356             - days.
1357             - <span class="hint">This system preference is used by the cleanup_database.pl cronjob.</span>
1358
1359     Recalls:
1360         -
1361             - Mark a recall as problematic if it has been waiting to be picked up for
1362             - pref: RecallsMaxPickUpDelay
1363             - class: integer
1364             - days.
1365         -
1366             - pref: UseRecalls
1367               choices:
1368                   1: Use
1369                   0: "Don't use"
1370             - recalls. Make sure you configure <a href="/cgi-bin/koha/admin/smart-rules.pl">circulation and fine rules</a> for recalls once enabled.
1371
1372     SIP2:
1373         -
1374             - "Use the following mappings to determine the sort_bin of a returned item.<br/>"
1375             - "The mapping should be of the form 'branchcode:item field:comparator:item field value:sort bin number', with one mapping per line.<br/>"
1376             - "- 'branchcode' is the location where the checkin is being performed (i.e. branch assigned to SIP user)<br/>"
1377             - "- 'item field' is a database column in the items table<br/>"
1378             - "- 'comparator' is the type of comparison, possible values are: eq,<,<=,>,>=,ne<br/>"
1379             - "- 'item field value' is the value to compare against the value in the specified 'item field'<br/>"
1380             - "- 'sort bin number' is the expected return value in the CL field of the SIP response for an item matching a rule<br/><br/>"
1381             - "The field comparison triplet, 'item field:comparator:item field value', is repeatable within a single line to allow for more complex cases"
1382             - "NOTE: Specifying 'item_field_value' with a leading '\\$' and an item field name will use the value of that field in the item for comparison:<br/>"
1383             - "i.e. \\$holdingbranch<br/></br>"
1384             - "Examples:<br/>"
1385             - "CPL:itype:eq:BOOK:1 - Will return sort bin 1 for an item of itemtype 'BOOK' returned to CPL.<br/>"
1386             - "CPL:itemcallnumber:<:339.6:3 - Will return sort bin 3 for an item with a callnumber less than 339.6 returned to CPL.<br/>"
1387             - "CPL:homebranch:ne:\\$holdingbranch:X - Will return sort bin 'X' for an item returned to CPL where the holdingbranch is not equal to the homebranch (i.e. any item belonging to a different branch than CPL).<br/>"
1388             - "CPL:itype:eq:BOOK:ccode:eq:TEEN:5 - Will return sort bin 5 for an item of itemtype 'BOOK' and a ccode 'TEEN' returned to CPL.<br/><br/>"
1389             - pref: SIP2SortBinMapping
1390               type: textarea
1391               class: long
1392         -
1393             - Use
1394             - pref: UseLocationAsAQInSIP
1395               choices:
1396                   1: permanent_location
1397                   0: homebranch
1398             - for AQ field in SIP protocol.
1399         -
1400             - Use
1401             - pref: SIP2AddOpacMessagesToScreenMessage
1402               choices:
1403                   1: Do
1404                   0: Don't
1405             - send OPAC patron messages in the SIP2 screen message field.
1406
1407     Curbside pickup module:
1408         -
1409             - pref: CurbsidePickup
1410               choices:
1411                   1: Enable
1412                   0: Disable
1413             - "the curbside pickup module."