[Catalog] host = catalog.library.myuniversity.edu port = 1521 service = VGER.catalog.library.myuniversity.edu user = myusername password = mypassword database = MYDB pwebrecon = http://catalog.library.myuniversity.edu/cgi-bin/Pwebrecon.cgi ; If this is set to false, VuFind will connect to Voyager's Oracle database with ; SERVICE_NAME in the connection string. If set to true, it will use SID. If ; you have connection problems, try changing this setting. connect_with_sid = false ; The field to use as a username when authenticating users; recommended values ; are PATRON_BARCODE (default) and INSTITUTION_ID. username_field = PATRON_BARCODE ; The field in the PATRON table to use as a password when authenticating users; ; recommended values are LAST_NAME or PATRON_PIN (LAST_NAME is default) login_field = LAST_NAME ; If using PATRON_PIN as login_field, allow fallback to another field if the ; user has no PIN code. Disabled by default. ;fallback_login_field = LAST_NAME ; Colon-separated list of barcode statuses ( see PATRON_BARCODE_STATUS table in ; Voyager's database) that allow a user to log in. By default only barcodes with ; status 1 (active) or 4 (expired) are allowed. ;allowed_barcode_statuses = 1:4:5 ; This is the timeout value for making HTTP requests to the Voyager API. http_timeout = 30 ; These settings affect the Fund list used as a limiter in the "new items" module: [Funds] ; Uncomment this line to turn off the fund list entirely. ;disabled = true ; If you know what values you want to allow in your fund list, include them as ; include_list lines below. ONLY VALUES INCLUDED IN THOSE LINES WILL BE SHOWN. ; Leave the include_list commented out to get all values. ;include_list[] = "First Good Value" ;include_list[] = "Second Good Value" ; If you wish to exclude certain values from your fund list, include them as ; exclude_list lines below. There is no point in using exclude_list lines if ; you have already set an include_list above. ;exclude_list[] = "First Bad Value" ;exclude_list[] = "Second Bad Value" ; This setting can be used to limit the fund list to those that are under a specific ; fund. Set it to 0 for top-level funds only. Set it to a FUND_ID deeper in the ; fund tree to filter out unwanted values. Leave it commented out to get all funds. ;parent_fund = 0 ; These settings are used by the Voyager Restful Services - details at ; https://developers.exlibrisgroup.com/voyager/apis/RESTfulWebServices [WebServices] host = 1.2.3.4 port = 7014 app = vxws ; Patron and site information -- these two settings can often be set to the same value. To ; find your possible values, use the GetUBSitesService service as documented here: ; https://developers.exlibrisgroup.com/voyager/apis/XMLoverHTTPWebServices/GetUBSitesService patronHomeUbId = "1@XXXXX" dbKey = "1@XXXXX" ; This section contains patron-related settings. [Patron] ; Before certain actions (such as placing holds or other requests) VuFind checks ; to see if the user's account is blocked. This helps reduce the number of API ; calls and may help prevent unwanted illegal requests from being placed in some ; circumstances. However, it may also be overly exclusive, as some of the block ; reasons are for relatively minor circumstances. Including a block code in this ; comma-separated list will prevent that situation from blocking a user from making ; requests (unless the status also blocks the patron explicitly through other API ; calls). See this page for a list of numeric codes: ; https://developers.exlibrisgroup.com/voyager/apis/RESTfulWebServices/PatronBlocks ; NOTE: You may wish to clear VuFind's cache after changing this setting, as ; block statuses are cached for a short period of time. ignoredBlockCodes = "18,53,54,55" ; This section is used to define library codes and named values which are used by the ; system to indicate the location at which a hold is to be collected. If you leave it ; commented out, a list will automatically be generated using the getPickUpLocations ; method. Your system will perform better if you fill this in, since it will reduce ; the number of database lookups necessary when presenting the hold form. ;[pickUpLocations] ;1 = "Library One" ;2 = "Library Two" ;3 = "Library Three" ; This section controls hold behavior; note that you must also ensure that Holds are ; enabled in the [Catalog] section of config.ini in order to take advantage of these ; settings. Additional notes about some of these settings are available in the wiki: ; https://vufind.org/wiki/configuration:ils:holds [Holds] ; If a colon separated list of item statuses is provided here, only matching items ; will show hold / recall links. Skip this setting to allow all statuses. ;valid_hold_statuses = Charged:Renewed:Overdue ; borrowable - If a colon-separated list of ids from the ITEM_TYPE table is ; provided, only matching items will be included in holds / recalls. Skip this ; setting to allow holds for all item types. ;borrowable = 1:3 ; non_borrowable - If a colon-separated list of ids from the ITEM_TYPE table is ; provided, matching items will be excluded from holds / recalls. Skip this setting ; to allow holds for all item types. ;non_borrowable = 2:4:23:10 ; HMACKeys - A list of hold form element names that will be analyzed for consistency ; during hold form processing. Most users should not need to change this setting. HMACKeys = item_id:holdtype:level ; defaultRequiredDate - A colon-separated list used to set the default "not required ; after" date for holds in the format days:months:years ; e.g. 0:1:0 will set a "not required after" date of 1 month from the current date defaultRequiredDate = 0:1:0 ; extraHoldFields - A colon-separated list used to display extra visible fields in the ; place holds form. Supported values are "comments", "requiredByDate", ; "pickUpLocation" and "requestGroup" extraHoldFields = comments:requiredByDate:pickUpLocation ; A Pick Up Location Code used to pre-select the pick up location drop down list and ; provide a default option if others are not available. Must be one of the following: ; 1) empty string to indicate that the first location is default (default setting) ; 2) "user-selected" to indicate that the user always has to choose the location ; 3) a value within the Location IDs returned by getPickUpLocations() defaultPickUpLocation = "" ; By default the pick up location list is sorted alphabetically. This setting can be ; used to manually set the order by entering location IDs as a colon-separated list. ; You can also disable sorting by setting this to false. ;pickUpLocationOrder = 158:155 ; The maximum number of holding items to generate request links for. The process of ; checking the API for a valid hold is intensive. Any hold items above this this ; limit will have their hold status checked via ajax or when a user clicks on the ; link. Use "0" to check all items via ajax. Default is 15. holdCheckLimit = 15 ; By default recall is the preferred method. Uncomment this setting to disable ; recalls. ;enableRecalls = false ; By default item holds are enabled. Uncomment this setting to disable item holds. ;enableItemHolds = false ; A request group ID used to pre-select the request group drop down list and ; provide a default option if others are not available. Must be one of the following: ; 1) empty string to indicate that the first group is default (default setting) ; 2) "user-selected" to indicate that the user always has to choose the group ; 3) a value within request group IDs returned by getRequestGroups(). ; This setting is only effective if requestGroup is specified in extraHoldFields. ;defaultRequestGroup = "" ; By default the request group list is sorted alphabetically. This setting can be ; used to manually set the order by entering request group IDs as a colon-separated ; list. ; This setting is only effective if requestGroup is specified in extraHoldFields. ;requestGroupOrder = 33 ; By default the available pickup locations don't have to belong to the selected ; request group. ; Uncomment this setting to limit pickup locations to the request group. ; This setting is only effective if requestGroup is specified in extraHoldFields. ;pickupLocationsInRequestGroup = true ; By default a title hold can be placed even when there are no items. Uncomment this ; to prevent holds if no items exist. If request groups are enabled, item existence ; is checked only in the selected request group. ;checkItemsExist = true ; By default a title hold can be placed even when there are items available. ; Uncomment this to prevent holds if items are available. If request groups are ; enabled, availability is checked only in the selected request group. ;checkItemsNotAvailable = true ; A colon-separated list of request group ids for which the available item check is ; disabled. If a listed request group is selected, the availability check is not made ; regardless of the setting above. ; This setting is only effective if requestGroup is specified in extraHoldFields. disableAvailabilityCheckForRequestGroups = "15:19:21:32" ; A colon-separated list of ids from the LOCATION table. If provided, items with a ; matching location are excluded from item availability. ;excludedItemLocations = "2:4:23:10" ; By default a patron can place a hold on records he/she already has on loan. ; This setting can be used to modify this behavior. Must be one of the following: ; 1) false to indicate that loans are not checked (default setting). ; 2) true to indicate that any loan on the bibliographic record prevents further ; holds. ; 3) "same-item" to indicate that a loan on the specific item prevents placing a hold ; on it. ;checkLoans = true ; Optional help texts that can be displayed on the hold form. Displayed as is; ; HTML tags can be used, and everything needs to be properly escaped. ;helpText[*] = "Default help text used if not overridden." ;helpText[en-gb] = "Help text for British English localization." ; By default a request can be canceled even if the item is available for pickup. ; Uncomment this to disable canceling of available requests. ;allowCancelingAvailableRequests = false ; This section controls call slip behavior (storage retrieval requests in VuFind). ; To enable, uncomment (at minimum) the HMACKeys and extraFields settings below. [StorageRetrievalRequests] ; Colon-separated list of item types where call slip is allowed ;valid_item_types = 1:2:3 ; HMACKeys - A list of form element names that will be analyzed for consistency ; during form processing. Most users should not need to change this setting. ;HMACKeys = item_id:holdings_id ; extraFields - A colon-separated list used to display extra visible fields in the ; place call slip request form. Supported values are "comments", "pickUpLocation" ; and "item-issue" ;extraFields = item-issue:comments ; The maximum number of holding items to generate request links for. The process of ; checking the API for a valid call slip is intensive. Any items above this this ; limit will have their status checked via ajax or when a user clicks on the ; link. Use "0" to check all items via ajax. Default is 15. ;checkLimit = 0 ; Optional help texts that can be displayed on the request form. Displayed as is; ; HTML tags can be used, and everything needs to be properly escaped. ;helpText[*] = "Help text for all languages." ;helpText[en-gb] = "Help text for British English localization." ; Colon-separated list of call slip statuses (see CALL_SLIP_STATUS_TYPE table in ; Voyager's database) that control whether a call slip is displayed. Only slips ; matching statuses in this list will be displayed. Current Voyager versions (as of ; May 2016) don't immediately delete a call slip from the database when it has been ; processed and converted to a hold, which may confuse users. ;display_statuses = 1:2:3:5:8:9 ; This section controls UB (Universal Borrowing, ILL in VuFind) behavior. To enable, ; uncomment (at minimum) the HMACKeys and extraFields settings below. See also ; section ILLRequestSources for mapping between patron ID's and UB libraries. [ILLRequests] ; HMACKeys - A list of form element names that will be analyzed for consistency ; during form processing. Most users should not need to change this setting. ;HMACKeys = item_id:holdings_id ; extraFields - A colon-separated list used to display extra visible fields in the ; request form. Supported values are "pickUpLibrary", ; "pickUpLibraryLocation", "requiredByDate" and "comments" (although comments are ; not properly stored for UB requests at least in version 8.1) ;extraFields = pickUpLibrary:pickUpLibraryLocation:requiredByDate ; defaultRequiredDate - A colon-separated list used to set the default "not required ; after" date for holds in the format days:months:years ; e.g. 0:1:0 will set a "not required after" date of 1 month from the current date ;defaultRequiredDate = 0:1:0 ; Optional help texts that can be displayed on the request form. Displayed as is; ; HTML tags can be used, and everything needs to be properly escaped. ;helpText[*] = "Help text for all languages." ;helpText[en-gb] = "Help text for British English localization." ; This section lists the valid patron id prefixes for UB (ILL in VuFind) requests, ; and maps them to the their Voyager UB library IDs. Any patron of another library ; with a prefix listed here may attempt a UB request in this system. [ILLRequestSources] ;devdb = "1@DEVDB20011102161616" ;otherdb = "1@OTHERDB20011030191919" ; Settings for controlling how holdings are displayed [Holdings] ; How purchase history is displayed. Supported values are: ; 1) false - Purchase history is not displayed at all. ; 2) true - Purchase history is displayed below other holdings (default) ; 3) "split" - Purchase history is split to each corresponding holdings record and ; displayed by location ;purchase_history = true ; Fields to include in notes. Default is "852z". ;notes = "845a:852az" ; Fields to include in summary. Default is "866a". ;summary = "863abiz:866az" ; Fields to include in supplements. Default is none. ;supplements = "867az" ; Fields to include in indexes. Default is none. ;indexes = "867az" ; By default holdings are sorted by Voyager's Holdings Sort Groups. Uncomment this ; line to disable sorting. ;use_sort_groups = false ; Status rankings can be used to either promote or demote certain item statuses when ; determining the status to be displayed. The lower the rank, the higher the ; priority. The sample values below make "Missing" most important and drop request ; statuses below others so that e.g. "On Hold" is displayed instead of ; "Hold Request". [StatusRankings] ;Missing = 0 ;Recall Request = 99 ;Hold Request = 99 ; Settings for controlling how loans are displayed [Loans] ; Uncomment this line to display the location where each loan was made ;display_borrowing_location = true ; Colon-separated list of loan intervals for which to display the time part of the ; due date. By default the time is always displayed. Normal interval types are ; H (hours), D (days) and T (term). ;display_due_time_only_for_intervals = H:D ; This regular expression controls which status messages are displayed on the ; Checked Out Items list. show_statuses = "/lost|missing|claim/i" ; Uncomment the following lines to enable password (PIN) change ;[changePassword] ; PIN change parameters. The default limits are taken from the interface documentation. ;minLength = 5 ;maxLength = 12 ; See the password_pattern/password_hint settings in the [Authentication] section ; of config.ini for notes on these settings. When set here, these will override the ; config.ini defaults when Voyager is used for authentication. ;pattern = "alphanumeric" ;hint = "Your optional custom hint can go here." [Profile] ; This setting can be used to define which Voyager phone type is used as the primary ; phone number. Default is "Primary". ;primary_phone = Primary ; This setting can be used to define which Voyager phone type is used as the mobile ; phone number. Default is "Mobile". ;mobile_phone = Mobile