About Features Downloads Getting Started Documentation Events Support GitHub

Love VuFind®? Consider becoming a financial supporter. Your support helps build a better VuFind®!

Site Tools


Warning: This page has not been updated in over over a year and may be outdated or deprecated.
configuration:overdrive

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
configuration:overdrive [2023/11/15 13:31] demiankatzconfiguration:overdrive [2023/11/15 13:32] (current) demiankatz
Line 1: Line 1:
-====== Overdrive Configuration ======+====== OverDrive Configuration ======
  
-VuFind® can integrate with the [[https://www.overdrive.com/|Overdrive]] service. To set it up, see the notes/comments in [[configuration:files:Overdrive.ini]].+VuFind® can integrate with the [[https://www.overdrive.com/|OverDrive]] service. To set it up, see the notes/comments in [[configuration:files:Overdrive.ini]].
  
 The functionality was added by [[https://github.com/vufind-org/vufind/pull/1188|pull request #1188]]. The functionality was added by [[https://github.com/vufind-org/vufind/pull/1188|pull request #1188]].
  
 ===== Features ===== ===== Features =====
-  * Support for both MARC and Overdrive record formats+  * Support for both MARC and OverDrive record formats
   * Real-time availability using AJAX   * Real-time availability using AJAX
-  * Overdrive Patron Eligibility Check+  * OverDrive Patron Eligibility Check
   * Place/Cancel Holds   * Place/Cancel Holds
   * Previews (samples)   * Previews (samples)
Line 17: Line 17:
  
 ===== Key ===== ===== Key =====
-In order to use the Overdrive Integration, you must have an API Key.  If you don't already have one, you can request one from the [[https://developer.overdrive.com/docs/getting-started|Overdrive developer site]]. You should tell them that you are planning on using "Vufind with Overdrive Integration" This should allow  you to get a production key instead of "integration" (i.e. testing) access.+In order to use the OverDrive Integration, you must have an API Key.  If you don't already have one, you can request one from the [[https://developer.overdrive.com/docs/getting-started|OverDrive developer site]]. You should tell them that you are planning on using "Vufind with OverDrive Integration" This should allow  you to get a production key instead of "integration" (i.e. testing) access.
  
 ===== Indexing ===== ===== Indexing =====
-You will need to import your Overdrive records into Vufind, either by importing records straight from Overdrive or from your ILS using your normal import method.  In either case, the Overdrive records have to be marked as  type "overdrive" (lowercase).  If using MARC records you need to edit the Overdrive configuration file to designate that. Note: I've also made the assumption that the Overdrive ID for the title is in the MARC record somewhere.  I'm pretty sure it always is if you get your MARC records from OD.+You will need to import your OverDrive records into Vufind, either by importing records straight from OverDrive or from your ILS using your normal import method.  In either case, the OverDrive records have to be marked as  type "overdrive" (lowercase).  If using MARC records you need to edit the OverDrive configuration file to designate that. Note: I've also made the assumption that the OverDrive ID for the title is in the MARC record somewhere.  I'm pretty sure it always is if you get your MARC records from OD.
  
-If importing straight from Overdrive I highly recommend using the [[https://github.com/NatLibFi/RecordManager|Record Manager]]. It does not have built-in support for Overdrive records, but if you email the list, I can provide something to get you started.+If importing straight from OverDrive I highly recommend using the [[https://github.com/NatLibFi/RecordManager|Record Manager]]. It does not have built-in support for OverDrive records, but if you email the list, I can provide something to get you started.
  
 ===== Architecture ===== ===== Architecture =====
-The Overdrive feature is made up of 4 main components in addition to a handful of templates.  The Overdrive Connector is the main piece that handles all of the calls to the Overdrive API.  The record driver is a thin layer on top of the SolrMarc record driver hierarchy and just adds a little bit of logic for non-MARC based record information. The Overdrive Controller mostly just  handles requests from the "action" buttons (placing and canceling  holds, checking and returning titles out) and for the user account page.+The OverDrive feature is made up of 4 main components in addition to a handful of templates.  The OverDrive Connector is the main piece that handles all of the calls to the OverDrive API.  The record driver is a thin layer on top of the SolrMarc record driver hierarchy and just adds a little bit of logic for non-MARC based record information. The OverDrive Controller mostly just  handles requests from the "action" buttons (placing and canceling  holds, checking and returning titles out) and for the user account page.
  
   * [[https://github.com/vufind-org/vufind/blob/dev/config/vufind/Overdrive.ini|Configuration File]]   * [[https://github.com/vufind-org/vufind/blob/dev/config/vufind/Overdrive.ini|Configuration File]]
-  * [[https://github.com/vufind-org/vufind/blob/dev/module/VuFind/src/VuFind/DigitalContent/OverdriveConnector.php|Overdrive Connector]]+  * [[https://github.com/vufind-org/vufind/blob/dev/module/VuFind/src/VuFind/DigitalContent/OverdriveConnector.php|OverDrive Connector]]
   * [[https://github.com/vufind-org/vufind/blob/dev/module/VuFind/src/VuFind/RecordDriver/SolrOverdrive.php|Record Driver]]   * [[https://github.com/vufind-org/vufind/blob/dev/module/VuFind/src/VuFind/RecordDriver/SolrOverdrive.php|Record Driver]]
   * [[https://github.com/vufind-org/vufind/blob/dev/module/VuFind/src/VuFind/Controller/OverdriveController.php|Controller]]   * [[https://github.com/vufind-org/vufind/blob/dev/module/VuFind/src/VuFind/Controller/OverdriveController.php|Controller]]
Line 36: Line 36:
 ==== Admin Page ==== ==== Admin Page ====
  
-There is a troubleshooting page in the admin module that you can use to check whether the integration is connecting to the Overdrive API correctly.  +There is a troubleshooting page in the admin module that you can use to check whether the integration is connecting to the OverDrive API correctly.  
  
 ==== Log Files ==== ==== Log Files ====
  
-The basic log file is going to be the most helpful in troubleshooting.  If something isn't working, there will likely be a message in there somewhere.  The Overdrive components put out quite a bit of logging at the debug level.+The basic log file is going to be the most helpful in troubleshooting.  If something isn't working, there will likely be a message in there somewhere.  The OverDrive components put out quite a bit of logging at the debug level.
  
 ==== VuFind® Users list ==== ==== VuFind® Users list ====
configuration/overdrive.txt · Last modified: 2023/11/15 13:32 by demiankatz