Koha/koha-tmpl/intranet-tmpl/prog/en/modules/admin/preferences/enhanced_content.pref
Frédéric Demians 9570439c50 Bug 9580 Cover images from Coce, a remote image URL cache
Add to Koha support for displaying Book cover requested to Coce, a
remote image URL cache:

  https://github.com/fredericd/coce

With this enhancement, cover images are not fetched directly from
Amazon, Google, and so on. Their URL are requested via a web service to
Coce which manages a cache of URLs.

Three cover image providers are now available: Google Books (gb), Amazon
(aws), and Open Library (ol). Two system preferences enable this service:

  - CoceHost - URL of Coce server
  - CoceProviders - Ordered list of requested providers. For example
    gb,aws,ol, will return the first available URL from those providers.

Several advantages to this architecture:

  - If a book cover is not available from a provider, but is available
    from another one, Koha will be able to display a book cover, which
    isn't the case now
  - Since URLs are cached, it isn't necessary for each book cover to
    request, again and again, the provider, and several of them if
    necessary.
  - Amazon book covers are retrieved with Amazon Product Advertising
    API, which means that more covers are retrieved (ISBN13).

Test plan:

- Apply this patch, and test with 'Bootstrap' themes
- You can verify that nothing has changed on OPAC result and detail
  page, since new syspref haven't been filled
- Install Code: https://github.com/fredericd/coce
  Or ask me directly for the URL of a Coce server
- In sysprefs, tab Enhanced content, modify:
  CoceHost -- enter the URL of your Coce server
  CoceProviders -- fill with: gb,aws,ol
- Do a search. On result page, and detail page, you will see cover
  images originating from the 3 providers: fly over the image to see its
  URL. Try to compare with a Koha with just GoogleJacket or Amazon cover
  to confirm that you have more images. Verify that it's quick, and even
  quicker for cached images URLs.
- Check that Browse Shelf functionnality works properly.
- The ID sent to Coce is EAN or ISBN. Try with various type of biblios. DVD
  have often EAN, but no ISBN.
- You can try with those sysprefs:
    CoceProviders: aws,gb
    CoceHost: http://coce.tamil.fr:8080
  and this EAN (or ISBN): 3333297517744
  => OPACAmazonCoverImages enabled doesn't display a cover because, it's a DVD
  => Coce find and display the DVD cover.

Signed-off-by: Mark Tompsett <mtompset@hotmail.com>
Signed-off-by: Jonathan Druart <jonathan.druart@biblibre.com>
Amended patch: replaced 1 tab with spaces in C4/Shelfbrowser.pm

Signed-off-by: Tomas Cohen Arazi <tomascohen@gmail.com>
2015-04-01 09:31:42 -03:00

348 lines
13 KiB
Text

Enhanced Content:
All:
-
- <strong>NOTE:</strong> you can only choose one source of cover images from below, otherwise Koha will show the images from all sources selected.
-
- pref: FRBRizeEditions
default: 0
choices:
yes: Show
no: "Don't show"
- other editions of an item on the staff client (if found by one of the services below).
-
- pref: OPACFRBRizeEditions
default: 0
choices:
yes: Show
no: "Don't show"
- other editions of an item on the OPAC.
Amazon:
-
- Use Amazon data from its
- pref: AmazonLocale
choices:
US: American
CA: Canadian
DE: German
FR: French
JP: Japanese
UK: British
- website.
-
- Put the associate tag
- pref: AmazonAssocTag
- on links to Amazon. This can net your library referral fees if a patron decides to buy an item.
-
- pref: AmazonCoverImages
default: 1
choices:
yes: Show
no: "Don't show"
- cover images from Amazon on search results and item detail pages on the staff interface.
-
- pref: OPACAmazonCoverImages
default: 1
choices:
yes: Show
no: "Don't show"
- cover images from Amazon on search results and item detail pages on the OPAC.
Babelthèque:
-
- pref: Babeltheque
choices:
yes: Do
no: "Don't"
- include information (such as reviews and citations) from Babelthèque in item detail pages on the OPAC.
-
- pref: Babeltheque_url_js
- Defined the url for the Babeltheque javascript file (eg. http://www.babeltheque.com/bw_XX.js)
-
- pref: Babeltheque_url_update
- Defined the url for the Babeltheque update periodically (eq. http://www.babeltheque.com/.../file.csv.bz2).
Baker and Taylor:
-
- pref: BakerTaylorEnabled
choices:
yes: Add
no: "Don't add"
- Baker and Taylor links and cover images to the OPAC and staff client. This requires that you have entered in a username and password (which can be seen in image links).
-
- 'Baker and Taylor "My Library Bookstore" links should be accessed at <code>https://'
- pref: BakerTaylorBookstoreURL
class: url
- <em>isbn</em></code> (this should be filled in with something like <code>ocls.mylibrarybookstore.com/MLB/actions/searchHandler.do?nextPage=bookDetails&amp;parentNum=10923&amp;key=</code>). Leave it blank to disable these links.
-
- Access Baker and Taylor using username
- pref: BakerTaylorUsername
class: password
- and password
- pref: BakerTaylorPassword
class: password
- .
Novelist Select:
-
- pref: NovelistSelectEnabled
choices:
yes: Add
no: "Don't add"
- Novelist Select content to the OPAC (requires that you have entered in a user profile and password, which can be seen in image links).
-
- Display Novelist Select content
- pref: NovelistSelectView
choices:
tab: in an OPAC tab
above: above the holdings table
below: below the holdings table
right: under the Save Record dropdown, on the right
- .
-
- Access Novelist Select using user profile
- pref: NovelistSelectProfile
- and password
- pref: NovelistSelectPassword
class: password
- .
Google:
-
- pref: GoogleJackets
choices:
yes: Add
no: "Don't add"
- cover images from Google Books to search results and item detail pages on the OPAC.
Open Library:
-
- pref: OpenLibraryCovers
choices:
yes: Add
no: "Don't add"
- cover images from Open Library to search results and item detail pages on the OPAC.
Library Thing:
# Awkward syntax below, due to quoting conflicts
-
- pref: ThingISBN
choices:
yes: Use
no: "Don't use"
- the ThingISBN service to show other editions of a title (when either FRBRizeEditions or OPACFRBRizeEditions is on). This is separate from Library Thing for Libraries.
-
- pref: LibraryThingForLibrariesEnabled
choices:
yes: Show
no: "Don't show"
- "reviews, similar items, and tags from Library Thing for Libraries on item detail pages on the OPAC. If you've enabled this, you need to "
- <a href="http://www.librarything.com/forlibraries/">sign up</a>, then enter in your ID below.
-
- Access Library Thing for Libraries using the customer ID
- pref: LibraryThingForLibrariesID
- .
-
- Show Library Thing for Libraries content
- pref: LibraryThingForLibrariesTabbedView
choices:
yes: in tabs.
no: in line with the bibliographic information.
IDreamLibraries:
-
- pref: IDreamBooksReviews
choices:
yes: Add
no: "Don't add"
- a tab on the OPAC details with book reviews from critics aggregated by <a href='http://idreambooks.com/'>IDreamBooks.com</a>.
-
- pref: IDreamBooksReadometer
choices:
yes: Add
no: "Don't add"
- a "Readometer" that summarizes the reviews gathered by <a href='http://idreambooks.com/'>IDreamBooks.com</a> to the OPAC details page.
-
- pref: IDreamBooksResults
choices:
yes: Add
no: "Don't add"
- the rating from <a href='http://idreambooks.com/'>IDreamBooks.com</a> to OPAC search results.
OCLC:
-
- pref: XISBN
choices:
yes: Use
no: "Don't use"
- the OCLC xISBN service to show other editions of a title (when either FRBRizeEditions or OPACFRBRizeEditions is on).
-
- Use the <a href="http://www.worldcat.org/affiliate/webservices/xisbn/app.jsp">OCLC affiliate ID</a>
- pref: OCLCAffiliateID
- to access the xISBN service. Note that unless you have signed up for an ID, you are limited to 1000 requests per day.
-
- Only use the xISBN service
- pref: XISBNDailyLimit
class: integer
- times a day. Unless you are paying for the xISBN service, you should leave this at the default of 999 (as detailed above).
Syndetics:
-
- pref: SyndeticsEnabled
choices:
yes: Use
no: "Don't use"
- content from Syndetics. Note that this requires that you have signed up for the service and entered in your client code below.
-
- Use the client code
- pref: SyndeticsClientCode
- to access Syndetics.
-
- pref: SyndeticsCoverImages
choices:
yes: Show
no: "Don't show"
- cover images from Syndetics on search results and item detail pages on the OPAC in a
- pref: SyndeticsCoverImageSize
choices:
MC: medium
LC: large
- size.
-
- pref: SyndeticsAuthorNotes
choices:
yes: Show
no: "Don't show"
- notes about the author of a title from Syndetics on item detail pages on the OPAC.
-
- pref: SyndeticsAwards
choices:
yes: Show
no: "Don't show"
- information from Syndetics about the awards a title has won on item detail pages on the OPAC.
-
- pref: SyndeticsEditions
choices:
yes: Show
no: "Don't show"
- information about other editions of a title from Syndetics on item detail pages on the OPAC (when OPACFRBRizeEditions is on).
-
- pref: SyndeticsExcerpt
choices:
yes: Show
no: "Don't show"
- excerpts from of a title from Syndetics on item detail pages on the OPAC.
-
- pref: SyndeticsReviews
choices:
yes: Show
no: "Don't show"
- reviews of a title from Syndetics on item detail pages on the OPAC.
-
- pref: SyndeticsSeries
choices:
yes: Show
no: "Don't show"
- "information on other books in a title's series from Syndetics on item detail pages on the OPAC."
-
- pref: SyndeticsSummary
choices:
yes: Show
no: "Don't show"
- a summary of a title from Syndetics on item detail pages on the OPAC.
-
- pref: SyndeticsTOC
choices:
yes: Show
no: "Don't show"
- the table of contents of a title from Syndetics on item detail pages on the OPAC.
Tagging:
-
- pref: TagsEnabled
choices:
yes: Allow
no: "Don't allow"
- patrons and staff to put tags on items.
-
- pref: TagsModeration
choices:
yes: Require
no: "Don't require"
- that tags submitted by patrons be reviewed by a staff member before being shown.
-
- Show
- pref: TagsShowOnList
class: integer
- tags on search results on the OPAC.
-
- pref: TagsInputOnList
choices:
yes: Allow
no: "Don't allow"
- patrons to input tags on search results on the OPAC.
-
- Show
- pref: TagsShowOnDetail
class: integer
- tags on item detail pages on the OPAC.
-
- pref: TagsInputOnDetail
choices:
yes: Allow
no: "Don't allow"
- patrons to input tags on item detail pages on the OPAC.
-
- Allow tags in the dictionary of the ispell executable
- pref: TagsExternalDictionary
class: file
- on the server to be approved without moderation.
Local Cover Images:
-
- pref: LocalCoverImages
choices:
yes: Display
no: "Don't display"
- local cover images on intranet search and details pages.
-
- pref: OPACLocalCoverImages
choices:
yes: Display
no: "Don't display"
- local cover images on OPAC search and details pages.
-
- pref: AllowMultipleCovers
choices:
yes: Allow
no: "Don't allow"
- multiple images to be attached to each bibliographic record.
HTML5 Media:
-
- Show a tab with a HTML5 media player for files catalogued in field 856
- pref: HTML5MediaEnabled
choices:
not: "not at all."
opac: "in the OPAC."
staff: "in the staff client."
both: "in OPAC and staff client."
-
- Media file extensions
- pref: HTML5MediaExtensions
class: multi
- (separated with |).
Plugins:
-
- pref: UseKohaPlugins
choices:
yes: Enable
no: "Don't enable"
- the ability to use Koha Plugins. Note, the plugin system must also be enabled in the Koha configuration file to be fully enabled.
OverDrive:
-
- Include OverDrive availability information with the client key
- pref: OverDriveClientKey
- and client secret
- pref: OverDriveClientSecret
- .
-
- "Show items from the OverDrive catalog of library #"
- pref: OverDriveLibraryID
- .
Coce Cover images cache:
-
- Coce server URL
- pref: CoceHost
class: url
-
- Providers
- pref: CoceProviders
- 'separated by comma, for example: aws,gb. Leave empty not to activate this service.'