From WikiThing

If you're only installing the Reviews Enhancement and not the Catalog Enhancements, please go here.

[edit] LibraryThing for Libraries enhancements: Installation instructions

[edit] 1. Sign into your account

You should have an email with your username and password.

• Sign into your account at http://www.librarything.com/forlibraries
  • Enter your account name and password at the bottom left-hand corner of the page where it says "sign in".

[edit] 2. Export file

You can export data either as tab-delimited text or full MARC.

If doing tsv, use the Create list function. here is a screenshot showing the configuration settings needed for export:

Enter the Control Character 9 (a tab) for the field delimiter and Control Character 32 (a space) for the Repeated Field Delimiter. (Note, these are ASCII characters 9 and 32, not the literal numbers "9" and "32"). Additionally you may want to only retrieve records that are NOT suppressed (public can view and are not being worked on); and they HAVE an ISBN field filled in (020 > "").

Larger libraries might find it better to use the Data Exchange module in Millennium to create an output file of MARC records. The file can then be output and any further editing done in MARCEdit.

Important note for Shelf Browse: If you're installing the Shelf Browse Enhancement, you cannot use the export settings as above. You can either include more data in your tab-delimited export (see below), or just do a full MARC export that includes item level call numbers. Before uploading, you'll need to set which type of call number (LC or Dewey) you're using, the call number location in your records, and the subfield for the collection code (if using collections to group items within Shelf Browse). Set this on the Configure tab, under Shelf Browse.

• If you are uploading a tab-delimited file for Shelf Browse, the fields should be ordered as: ISBN TITLE AUTHOR LOCATION (can be empty) CALLNO COLLECTION
  • The first three (ISBN, title, and author) are self explanatory. Location is a location code--typically used by libraries or consortia with multiple branches. If you don't have or don't use location codes, leave this empty (but include the tab for it). Call number is your call number. Collection is the collection code that indicates things like "teen graphic novels" (optional).

[edit] 3. Upload file

• Click on the "Upload holdings" link on the Enhancements tab.
• Choose a file format
• Choose an action. "Add additional items" adds new items to the list of items you have already uploaded. "Replace all items" deletes previous files and replaces them.
• Enter your email to get a note telling you that the indexing is done (indexing is processed every evening)
• Click "Next". The Choose a file to upload page will open
• Click on the "Get File" button to upload your file from your computer
• Click the "Browse" button to find the file
• Click "Begin File Upload" to ... begin the file upload

[edit] 4. Add code to your OPAC

• You will be copying and pasting a section of javascript, and also div tags into the code of your bibliographic template page.
  • Open your bibliographic template page, named bibdisplay.html.
  • If you have WebPac Pro, but you don't see a bibdisplay.html page, you need to add one. You can do this by going to the set of III example pages, and choosing the bibdisplay.html page appropriate for your version of the OPAC.
  • If you are on III non-Pro, you cannot edit the bibdisplay.html file. We can give you an extra script to get around that limitation. Contact abby@librarything.com for more info.

• You will need your LTFL Account Number, which you can find on your account page. It will look like this: XXX-XXXXXXXXX
• Copy the javascript code, and paste it near the bottom of the page.

<script src="http://ltfl.librarything.com/forlibraries/widget.js?id=XXX-XXXXXXXXX" type="text/javascript"></script><noscript>This page contains enriched content visible when JavaScript is enabled or by clicking <a href="http://ltfl.librarything.com/forlibraries/noscript.php?id=XXX-XXXXXXXXX &accessibility=1">here</a>.</noscript>

• • In the code you've just pasted, look for the placeholders for your account number. There are two of them, and they will look like this: XXX-XXXXXXXXX. Replace the two placeholders with your account number.

• Important for libraries in Australia and New Zealand: We have a server located in Australia. To ensure that your catalogue is taking advantage of this server located closer to you (which will make LTFL load considerably faster in your catalog), you'll need to make the following change in the code above, from ltfl to ltflau like this:

<script src="http://ltflau.librarything.com/forlibraries/widget.js?id=XXX-XXXXXXXXXX" type="text/JavaScript"></script><noscript>This page contains enriched content visible when JavaScript is enabled or by <a href="http://ltflau.librarything.com/forlibraries/noscript.php?id=XXX-XXXXXXXXXX&accessibility=1">clicking here</a>.</noscript> 

[edit] Catalog Enhancements

• Paste the div tags in the HTML where you'd like the catalog enhancements to appear.

• • Tags and Tag Browser

  <div id="ltfl_tagbrowse" class="ltfl"></div>

• • Recommendations (similar books)

  <div id="ltfl_similars" class="ltfl"></div>

• • Other editions and translations

  <div id="ltfl_related" class="ltfl"></div>

• Save the page.

[edit] Reviews Enhancement

• If you are also installing the Reviews Enhancement, keep the bibliographic template page open.
• Copy the div tag in the HTML where you'd like the enhancement to appear.
  • Reviews

  <div class="ltfl_reviews"></div> 

• Save the file.

[edit] (Optional)Reviews in the search results/summary page

If you'd like the Reviews Enhancement to appear on the search results summary display, it is imperative that the javascript code only appear once in the HTML output (not multiple times for each item on the summary screen.)

• Open the search results/summary template page.
• Copy and paste this code near the bottom of the page:

  <script src="http://ltfl.librarything.com/forlibraries/widget.js?id=XXX-XXXXXXXXX" type="text/javascript"></script>

• Copy the Reviews div tag in the HTML where you'd like the enhancement to appear.

  <div class="ltfl_reviews"></div> 

• Save the file.

• If you want to add other Reviews moderators, under the Enhancements > Reviews section, click the "Create/manage moderator accounts" link.
  • You can create the secondary user an account. (What this is doing is creating a LibraryThing.com account.)
  • If the person already has a LibraryThing account (for the main site), they can associate their username to moderate reviews. (It will not affect their LibraryThing.com account.)
• You can add more people to be alerted when there are reviews to moderate, by adding them in the "Email when moderation needed" text box, with commas between, eg: abby@librarything.com, kate@librarything.com

[edit] Shelf Browse Enhancement

• If you are also installing the Shelf Browse Enhancement, keep the bibliographic template page open.
• Copy the following div tag in the HTML where you'd like the enhancement to appear.

<div id="ltfl_shelfbrowse_both" class="ltfl"></div>

• You could also add the divs individually if you like—"ltfl_shelfbrowse_mini" is the small shelf which appears on the big page and "ltfl_shelfbrowse_large" provides the link to the full-screen shelf. So you would add one or both of the following:

<div id="ltfl_shelfbrowse_large" class="ltfl"></div>
<div id="ltfl_shelfbrowse_mini" class="ltfl"></div>

• Important: add either the "both" div or the individual ones, but not all of them!
• Save the file.

Limit items shown by collections and/or collection groups

• Collections and Collection Groups can be used to limit the items viewed in the Shelf Browse to items in the same collection. If, for example, you are viewing a book in a children's collection, you would only see other children's books around that book. If you do not use Collections and Collection Groups, Shelf Browse will sort your items by call number only, irrespective of collections.
• Under Shelf Browse > Advanced options on the Configure tab, select whether to use collections and/or collection groups.
• Click "Manage collections". Here you will see all the collection codes that we've indexed from your data. You can assign human readable names to the collections, and group collections together.

[edit] Series and Awards Enhancements

• If you are also installing the Shelf Browse Enhancement, keep the bibliographic template page open.
• Copy the following div tags in the HTML where you'd like the enhancement to appear.

<div id="ltfl_series" class="ltfl"></div>

<div id="ltfl_awards" class="ltfl"></div>

[edit] Lexile Measures

• This is a FREE enhancement for anyone using any of the other LTFL in-catalog enhancements. To add it to your OPAC, just include the div tag on your bibliographic template page, wherever you'd like it to appear:

<div id="ltfl_lexile" class="ltfl"></div>

If you want to make the Lexile search available on its own, just include a link like this:

<a href="#" onclick="LibraryThingConnector.widgets.wiki.showLexile('');">LexileFramework search</a>

• We can also help you add the appropriate code to non-catalog pages.

[edit] 5. Add the ISBN-based URL

You will fill in the ISBN-based URL within your LTFL account, on the Enhancements tab, under Settings > Global configuration.

http://<Your catalog URL>/search/i?SEARCH=MAGICNUMBER

If you are installing the Shelf Browse Enhancement, you will also need to fill in the Title based URL and Keyword based URL on the Configure tab, under Global Configuration. Those URLs should be:

http://<Your catalog URL>/search/t?SEARCH=TITLE
http://<Your catalog URL>/search/X?SEARCH=KEYWORDS

• If you're not sure how to find your library's link, read here.

[edit] 6. Configure the enhancements

Control how the enhancements look by clicking on the Enhancements tab.

• Make changes on the Global Configuration page.
• You can add, change, and edit the Cascading Style Sheets (meaning: change the way the LTFL text looks to match your existing catalog page)
• If you have one of the OPACs listed on the configure page, and would like to prepopulate the CSS fields, click on the appropriate link.
  • You can continue to edit the CSS after clicking the link - it's a great starting point.
  • If you click the link again, any editing you did will revert to the generic settings for your OPAC, erasing anything you'd edited - so beware.

[edit] 7. Testing LTFL

[edit] Testing mode

For each of our enhancements, we have 'testing' mode. On the Enhancements tab, under Settings > Account info, you can switch each enhancement on, off, or to testing mode.

• You can test the enhancements without needing a development or testing server with this. In 'testing mode', the enhancements only show up if you manually add &testing=1 to the end of the bib result page URL. Example:

  URL from catalog:
  http://durfingtonpl.com/ipac20/ipac.jsp?index=ISBNEX&term=0765318741

  Now modified to show LTFL:
  http://durfingtonpl.com/ipac20/ipac.jsp?index=ISBNEX&term=0765318741&testing=1

Everything will look and work the way it would if it were live, including the tag browser, and links to similar titles.

• If you will be using a development server, you'll turn the enhancements from 'off' or 'testing' to 'on'.

[edit] Test on a development server

• On the development server, modify your templates to include the HTML for the reviews link (and our javascript, if it's not already there).
  • If you already have the catalog enhancements, make sure 'auto-insert review link' setting on the Configure page is set to off. If this setting is on and the reviews feature is on and you already have the catalog enhancements, it will try to automatically show the reviews feature on your production server.
  • Make sure the reviews feature is turned to on (not testing).

[edit] 8. Go live!

• Go to Settings > Account info and switch the enhancements to "on" - LTFL content should now appear in your OPAC.

[edit] 9. (Optional) Add widgets

Recent library reviews widget
Instructions on how to set up the widget to show recent reviews from your patrons, to put on your library's front page (or wherever you like.)