From WikiThing

Jump to: navigation, search
LogoLTFL small.gif

LibraryThing for Libraries Wiki

Main wiki page | Web page

LibraryThing for Libraries enhancements: Installation instructions

1. Sign into your account

You should have an email with your username and password.

2. Export file

Data export for Oasis

The export is in MARC format. You must log on with permission to access Cataloging features, then click Cataloging Tools.


On the Advanced Cataloging Tools page, click Export. Search Anywhere using an asterisk ( * ) to bring up all the records in the collection. The records returned by the query load in the right half of the screen.


Click Select All, then click Next. You will be prompted to enter a filename.


Click Finish to start the export.

The export file is saved in \Inetpub\wwwroot\m4\AdvancedCataloging\UploadedFiles. They can get the file via HTTP using a path such as http://[example.hostname]/m4/AdvancedCataloging/UploadedFiles/[savedFilename.ext]. I recommend giving the filename an extension. Some security implementations will not allow getting files that do not have file extensions.

Data export for M3

In M3, search for all your records (Anywhere = *). Right-click over the results and choose Select All from the context menu.

Select File > Export. Choose Standard Export. Click OK. Enter a filename and click OK. The records will be exported to the file you specified.

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

4. Add code to your OPAC

Catalog Enhancement

Hosted solutions need to contact Mandarin and give them their username and password.

Unhosted solutions need to email Sonya for the three files you'll need to upload:

  • Details.js
  • Details.js.html
  • Labeled.js

Once you've received the files, upload them to the following folders:

  • Details.js and Details.js.html to \Inetpub\wwwroot\m4\opac
  • Labeled.js to \Inetpub\wwwroot\m4\opac\report-formats

This includes an updated Expanded Labeled display format that shows the ISBN number. (Unfortunately, there are other display formats, such as the MLA and APA formats, where the ISBN is not shown -- and this will break LibraryThing when these formats are used.)

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. Change YOURLIBRARYSERVER to your server name, and LIBRARYNAME to the one-word name of your library.

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

6. Configure the enhancements

You can change the styles and the way each enhancement appears using CSS on the Global Configuration page, as well as the configure pages for each individual enhancement.

Read here for more tips on configuring your enhancements, including adding headers, changing colors, and including cover images: Customize LTFL in your catalog

7. Testing LTFL

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:
  Now modified to show LTFL:

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'.

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).

8. Go live!

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

You are using the new servers! | About | Privacy/Terms | Help/FAQs | Blog | Store | APIs | TinyCat | Legacy Libraries | Early Reviewers | Common Knowledge | 115,169,822 books! | Top bar: Always visible