Warning: This page has not been updated in over over a year and may be outdated or deprecated.
legacy:vufind_1.x_developer_manual:building_an_ils_driver
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
building_an_ils_driver [2012/06/13 15:54] – demiankatz | legacy:vufind_1.x_developer_manual:building_an_ils_driver [2018/04/18 12:45] – [getTrendingBibs] demiankatz | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== ILS Driver | + | ====== ILS Drivers (VuFind 1.x) ====== |
+ | |||
+ | // This page refers to VuFind 1.x; for information on newer versions, see the current [[development: | ||
This page contains details on writing a custom driver for an integrated library system not already supported by VuFind. | This page contains details on writing a custom driver for an integrated library system not already supported by VuFind. | ||
Line 7: | Line 9: | ||
* ILS Drivers are found in the web/Drivers folder of the VuFind installation. | * ILS Drivers are found in the web/Drivers folder of the VuFind installation. | ||
- | * The PHP file containing the driver must be named for the value used as the driver setting in the [Catalog] section of web/conf/config.ini. | + | * The PHP file containing the driver must be named for the value used as the driver setting in the [Catalog] section of [[configuration: |
* The name of the class defined in the PHP file should match the filename, and the class must implement the DriverInterface (found in web/ | * The name of the class defined in the PHP file should match the filename, and the class must implement the DriverInterface (found in web/ | ||
* You may wish to define a catalog-specific .ini file in the /web/conf/ directory for your ILS -- you can look at other existing drivers to see how this can be loaded in the constructor. | * You may wish to define a catalog-specific .ini file in the /web/conf/ directory for your ILS -- you can look at other existing drivers to see how this can be loaded in the constructor. | ||
Line 107: | Line 109: | ||
This method queries the ILS for holding information. | This method queries the ILS for holding information. | ||
- | * Input: RecordID | + | * Input: RecordID, logged-in patron data (optional) |
* Output: Returns an array of associative arrays, one for each item attached to the specified bibliographic record. | * Output: Returns an array of associative arrays, one for each item attached to the specified bibliographic record. | ||
* id - the RecordID that was passed in | * id - the RecordID that was passed in | ||
Line 236: | Line 238: | ||
This method returns information on recently received issues of a serial. | This method returns information on recently received issues of a serial. | ||
- | * Input: | + | * Input: |
* Output: Array of associative arrays, each with a single key: | * Output: Array of associative arrays, each with a single key: | ||
* issue - String describing the issue | * issue - String describing the issue | ||
Currently, most drivers do not implement this method, instead always returning an empty array. | Currently, most drivers do not implement this method, instead always returning an empty array. | ||
+ | |||
+ | ==== getRecentlyReturnedBibs ==== | ||
+ | This method returns information on bibliographic records for which items have been recently returned. // Introduced in VuFind 5.0. // | ||
+ | |||
+ | * Input: Limit (max bibs to return), Maximum age (in days), Patron array (optional) | ||
+ | * Output: Array of associative arrays, each with a single key: | ||
+ | * id - Bibliographic ID | ||
==== getRenewDetails ==== | ==== getRenewDetails ==== | ||
Line 277: | Line 286: | ||
* Output: An array of bibliographic record IDs. | * Output: An array of bibliographic record IDs. | ||
+ | |||
+ | ==== getTrendingBibs ==== | ||
+ | This method returns information on bibliographic records which have been subject to recent activity; the exact mechanism for determining this may vary from ILS to ILS (it could, for example, be based on highest circulation within a time window). // Introduced in VuFind 5.0. // | ||
+ | |||
+ | * Input: Limit (max bibs to return), Maximum age (in days -- defining the period in which activity is considered significant), | ||
+ | * Output: Array of associative arrays, each with a single key: | ||
+ | * id - Bibliographic ID | ||
==== hasHoldings ==== | ==== hasHoldings ==== | ||
Line 339: | Line 355: | ||
* [[http:// | * [[http:// | ||
- | * [[ILS Driver Troubleshooting]] | + | * [[configuration: |
---- struct data ---- | ---- struct data ---- | ||
---- | ---- | ||
legacy/vufind_1.x_developer_manual/building_an_ils_driver.txt · Last modified: 2018/12/19 14:15 by demiankatz