What you'll need:
- A LibAnswers/LibChat account for your library
- A login for your library's Serials Solutions Client Center, with Summon admin permissions
- 10 minutes.
Ready? Let's Get Started.
Step 1: Get your LibChat "Hash"
LibChat works by dynamically loading a chat "widget" from the Springshare servers into Summon. It knows which widget to load by giving each widget it's own "hash," which is a long string of random-looking characters. We'll need the hash for your widget so that we can load it in Summon.
- Log in to your library's LibAnswers site
- Click on 'LibChat' in the Orange header, then select 'Chat Widgets'
- Find the chat widget you want to use in the list, then click the "View Code" icon on the right.
- Select the code from the box that popped up by clicking on the text and pressing Ctrl-C
- Now paste the code into the box below.
Nice work! On to the next step.
- First, click in the box below and copy all the code by pressing Ctrl-C.
- Now open up a new window or tab in your browser and go to your library's Summon site. Do a search so that you have a sceen with some results, like this:
- I want you to open up your browser's "Developer Tools Console." In most browsers, you can right-click on the web page and click "Inspect Element," and then click the "Console" link. If you need help finding it, head over to Andromeda Yelton's Excellent Intro to Programming page and look over her tips for finding your browser's Developer Tools Console. I'll wait!
- You should see a chevron in the console with a cursor next to it.
I want you to click next to that chevron and then paste the code you copied earlier. You can press Ctrl-V for that. Once you've pasted the code, hit enter.
- Now move the Developer Tools window so you can see your Summon site. Do you have a chat button in the upper right hand corner, like this?
Take a look at the Developer Tools console, where you pasted the code. Did you get any red messages? They'll help determine what the problem is. For now, copy that message and email it to firstname.lastname@example.org and I'll try to help you work out what went wrong!
Step 3: Upload your file to a server
To use Dropbox:
- Save the libchat2summon.js file you just downloaded into your Dropbox "Public" folder. Wait for the file to sync.
- Right-click (Ctrl-click on Mac) on the file, and select "Copy Public Link."
- Paste that link into the box below.
Okay! I've uploaded my script! Show me the next step.
Now we're going to tell Summon where to find your script.
- Log in to the Serials Solutions Client Center.
- Click on the Summon Administration Console.
- Scroll all the way to the bottom of the Adminstration Console. The second-to-last box is called "Summon 2.0 External Script".
- Click in the box below and copy the URL (Ctrl-C):
- Paste (Ctrl-V) that URL into the field for the "Custom Script URL".
- Click "Save Settings" at the bottom of the form.
Almost done! Let's go to the last step!
Step 5: Test and Celebrate!
Now let's go back to your library's Summon site and do a new search. You should see your new chat box in the upper right hand corner!
Did it work?
Uh-oh. Something went wrong.
The easiest thing to do right now is email email@example.com and tell me what happened. I'll take a look and see if we can get it working!