Enterprise
From WikiThing
LibraryThing for Libraries only works on Enterprise 4.1.1 or higher.
[edit] 1. Sign into your LTFL account. You should have an email from Abby with your username and password.
- Sign into your account at http://www.librarything.com/forlibraries
- Enter your account name and password at the bottom right corner of the page where it says "sign in".
[edit] 2. Export your holdings data
- Export a MARC21, UNIMARC, or a tab-delimited file. This file can be zipped, it can be a number of files, or it can be a number of files zipped.
- If tab-delimited, the file should be formatted as follows:
- ISBN<tab>TITLE<tab>AUTHOR
- Or if you're planning on using the Shelf Browse enhancement, like this:
- ISBN<tab>TITLE<tab>AUTHOR<tab>LOCATION (can be empty)<tab>CALLNO<tab>COLLECTION (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 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. Enable LTFL in Enterprise - instructions specific to Enterprise version, see below
[edit] 4a. Enterprise 4.1.1 - 4.2: Enable the web20_enterprise.js file
- Log in to the admin section of Enterprise.
- Go to Manage Profiles.
- Click Configure Custom Page Elements for the Profile you are applying the web20_enterprise.js to.
- Select the language you are configuring for and click Next.
- Scroll down to Custom Page Content, and put the following into the Custom Javascript Url: "/custom/demo/javascript/web20_enterprise.js"
- Scroll down and click the Finish button.
There are then variables within the js file that you can set to true to display the various LTFL enhancements in your catalog.
- Note this file also contains a timeout imposed on LTFL enhancements. If the LTFL data doesn't load with 2.5 seconds, it won't load it all. If you think this timeout should be longer (libraries in Australia in particular might want a longer timeout period) then ask us what you'll need to change.
[edit] 4b. Enterprise 4.2.1: Create HTML Widget
- Log in to the admin section of Enterprise.
- Navigate to Manage Display > Manage HTML Widgets > Edit HTML Widget.
- Type should be “Script Only”
- Name and description you can choose.
- Selected fields should be ISBN.
- Javascript Function should say “prepLibraryThing” (without the quotes).
Below is the text that should be automatically inserted into the “Custom Javascript” section.
Important. There are two key things you'll need to modify in the text below.
- You'll need to include your LTFL account number (replacing the ##-######### placeholder).
- Set each LTFL on or off using the true/false toggles. Note that in the text below, each enhancement is toggled to "true" - modify according to which enhancements your library has subscribed to.
/* Library Thing for Libraries */
var libraryThingForLibrariesEnabled = true; //Enables LTFL content on the detail page
var libraryThingForLibrariesAccountNumber = "###-#########"; //Enter your LTFL account number here. It will be of the form XXX-XXXXXXXXX
var libraryThingForLibrariesSimilarItems = true; //the Similar Items content will be displayed on the details page in the LibraryThing for Libraries tab.
var libraryThingForLibrariesOtherEditionsAndTranslations = true; //The Other Editions and Translations content will be displayed on the details page in the LibraryThing for Libraries tab.
var libraryThingForLibrariesTagBrowser = true; //The Tag Browser content will be displayed on the details page in the LibraryThing for Libraries tab.
var libraryThingForLibrariesShelfBrowseMini = true; //The Tag Browser content will be displayed on the details page in the LibraryThing for Libraries tab.
var libraryThingForLibrariesShelfBrowseFull = true; //The Full Shelf Browser content will be displayed on the details page in the LibraryThing for Libraries tab.
var libraryThingForLibrariesReviews = true; //The Reviews content will be displayed on the details page in the LibraryThing for Libraries tab.
function customDetailJavaScript(detail){
// LIBRARY THING FOR LIBRARIES
if (libraryThingForLibrariesEnabled == true)
{
currentLTAttempt = 1;
if( typeof(LibraryThingConnector) == 'undefined' )
{
libraryThingForLibrariesScript = new Element('script', {
type: 'text/javascript',
src: 'http://ltfl.librarything.com/forlibraries/js/enterprise_js.php?manual=1&id='+libraryThingForLibrariesAccountNumber
});
$$('head')[0].appendChild(libraryThingForLibrariesScript);
}
customLibraryThingForLibraries(detail);
}
}
- Once the widget has been created and saved, you will need to add the widget to the Detailed Display for the ILS Target Display:
- Mange Displays > Manage Detail Displays > (Click on the HTML button for the ILS Target Default Display) and select the widget from the list.
If you have problems with any of this, email Abby (abby@librarything.com) or your account manager at SirsiDynix Enterprise and we'll sort it out together.
- Important for all 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 javascript above, from ltfl to ltflau like this:
src: 'http://ltflau.librarything.com/forlibraries/js/enterprise_js.php?manual=1&id='+libraryThingForLibrariesAccountNumber
[edit] 5. Global Configuration settings
In the LTFL admin pages, on the Enhancements tab, under Configuration > Global configuration
[edit] Global CSS
You'll want to add this code to the Global CSS field:
#LT_LB {
z-index:9999; /* need high z-index to show up above fullpage modal dialog */
}
#LT_LB_divcontainer {
display: none; /* this starts out hidden and gets shown by js */
}
[edit] URLs
- If using ISBN linking, the URL structure looks like this (where MAGICNUMBER in the string is replaced with the ISBN):
- or maybe this:
http://yourcatalogurl.com/client/search/results?qu=ISBN%3D%22MAGICNUMBER%22
- Different versions of Enterprise might have slightly different ISBN-based URLs - we can play around and find the one that works for your catalog, just email us!
[edit] Callbacks
In the JavaScript callback on success field, enter the following:
/* success callback */
jQuery('#LT_LB_iframeloading').hide(); jQuery('#LT_LB_divcontainer').show();
In the JavaScript callback on failure field, enter the following:
/* failure callback */
jQuery('#LT_LB_iframeloading').hide();
jQuery('#LT_LB_divcontainer').show();
- Click Save settings.
[edit] 6. Configuration
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.
[edit] 7. Testing LTFL
Testing mode For each of our enhancements, we have 'testing' mode. The modes are found on the Configure page.
- 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'.