LibraryThing for Libraries enhancements: Installation instructions
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".
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
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:
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
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.
7. Testing LTFL
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'.
Test on a development server
- 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.