• If you are citizen of an European Union member nation, you may not use this service unless you are at least 16 years old.

  • Social distancing? Try a better way to work remotely on your online files. Dokkio, a new product from PBworks, can help your team find, organize, and collaborate on your Drive, Gmail, Dropbox, Box, and Slack files. Sign up for free.


Qwidget Tips

Page history last edited by Wren 1 year ago

Placing the Qwidget in Blackboard


See attached instructions from Morgan Brynnan, Butte College (CA), on how to insert your Qwidget into Blackboard 9: qwidget_for_Blackboard 9.docx


You may also visit our Support and Documention site for instructions on placing Question in Blackboard

Placing the Qwidget in SharePoint 2010

Please follow these steps for adding the Qwidget to a web page hosted by SharePoint 2010.
1. Copy the Qwidget code from the Qwidget Manager
2. Create a new .htm file complete with opening and closing <html>, <head> and <body> tags
3. Paste the Qwidget code between the opening and closing <body> tags
4. Add this page to a web site your SharePoint site would have access to via a URL
In SharePoint:
1. Edit the page you wish to add the Qwidget
2. Add a new Content Editor Web Part
3. Open the Content Editor Web Part
4. Use the "Content Link" field to paste the URL in the "Content Link" box
5. Click Save
6. Have SharePoint treat this as the a page viewer web part (aka Render)
At this point you will be ready to publish the page.

Placing the Qwidget in LibGuides


Please see http://askawaybc.pbworks.com/w/page/36110332/Embedding%20the%20Qwidget#libguides for more information. 

Thanks to AskAway BC for this list.

Placing the Qwidget in EbscoHost


To embed the Qwidget in Ebsco products, you must contact Ebsco Technical Support  (support@ebsco.com)


After you have configured your Qwidget using  your QuestionPoint admin account, Admin module >Forms> Forms Manager>Qwidget creation, save any changes you have made to the default options, then copy the code snippet from the right hand box, and  Email Ebsco the entire snippet. 


Be sure to include the googleapi script that is in the first part of the code, or the Qwidget will not appear on the page.


Using the Qwidget on Mobile Devices and with QR Codes


Jaclyn McKewan, the Virtual Services & Training Librarian for the Ask Us 24/7 service (Western New York Library Resources Council), has made a video on youtube on how the Qwidget is used on mobile devices.  She also shows how to make a QR code for your Qwidget URL, so mobile devices with cameras can capture the code and have the Qwidget immediately at hand, whenever they need it, through a mobile app.  Watch her video here:  http://www.youtube.com/watch?v=pZJFUVXcKIw


The Collapsible Qwidget

The Schlow Centre Region Library, which is part of the Ask Here PA library cooperative, implemented the Qwidget in such a way that it can be collapsed into just a link until a patron clicks.  Then the Qwidget opens up, ready for input.  See https://web.archive.org/web/20130410132954/http://www.schlowlibrary.org:80/.


Project Manager for New York State's Ask Us 24/7, Jaclyn McKewan, devised the following collapsible link:


At http://www.askus247.org/collapsibleqwidget.html is an example of a collapsible qwidget. When you click on the chat link, it moves the surrounding text out of the way. Here are the steps:

1. Download this javascript file, and put it in the same directory as the page where you will put the collapsible Qwidget: http://www.askus247.org/collapse.js

2. On any page that uses the collapsible Qwidget, put this in the Head tag in the html:

<script language="JavaScript" src="collapse.js"></script>

3. In the Body of the html page where you want to put the collapsible Qwidget, use this code. Paste the actual code for your Qwidget in the space indicated. The height is dependent on whether you've used the small or regular Qwidget. (This code is for the regular-sized one.) You could make the height higher, and also include some extra text or a logo right after that, so it will appear above the Qwidget box.

<p><a href="" onmousedown="toggleSlide('mydiv');">Chat with a Librarian</a></p>

<div id="mydiv" style="display:none; overflow:hidden; height:285px;">

......paste your Qwidget code here...........



Qwidget remains open if librarian has not used logout link 

 At Arlington Heights, we've had a few cases where questions came in via the qwidget overnight when no one was monitoring it and the "away" message should have been up (which directs patrons to our 24/7 form).
After some checking, we realized that the reason this happened is that a librarian closed their chat monitor window before properly clicking on the green "Logout" link.  This leaves their login active and leaves the qwidget open to chat, even if no one is really monitoring!
Eventually, QP will close out that login, but it does take at least 1/2-hour, possibly longer, leaving any patron who encounters the qwidget with the impression that help is available.  They'll enter their question, sit and wait several minutes while nothing happens, and then probably go away.
The moral?  When your shift is over, make sure you log out properly using the "Logout" link in the chat monitor.  If you forget, simply go back in, reselect your queue(s) and then click on Logout.  You can then close the window.  A good idea when your library or local/state consortium is supposed to be completely logged off is to check your local qwidget to see if it's properly showing it's away message.  If not, someone's probably still logged in.
If you suspect one of your librarians is still logged in but has gone home, check the "Chat Monitoring Tool" in the "My QuestionPoint" page or the Librarians list in the Chat Monitor to see if someone's still showing as monitoring.  If you have their password and account number, you can log in as that librarian and go through the steps above.  Otherwise, you'll have to contact QP to ask them to log the librarian out from their end.
--Bill Pardue

Implementing not-available links

I wanted to include a live link to our 24/7 chat form in the "away" message for the Qwidget.  Unlike in regular chatting, a URL didn't automatically show up as a live link in the away message.  You can use regular html coding for links within the away message (<a href="/....etc.).


Here's what I'm using for ours now.  I've subsituted our institution code with "#####".  Just swap your own institution code in.


This chat box is currently offline. However, you can still <a href="/http://www.questionpoint.org/crs/servlet/org.oclc.home.TFSRedirect?virtcategory=#####"> click here</a> for help right now!  (24/7/365) 

[Here is where you set this up in the Admin module.]




--Bill Pardue, Arlington Heights Public Library, Illinois


NOTE from QP team:  Please check the URL for  your service, and make sure that you are using the correct form URL if you are placing a link as Bill describes above.  The example above for Arlington Heights Library uses a code that may not work for your library's site, even if you input the correct institution ID for your library. 

Your code may look more like this:



If you are unsure of what URL to use, please contact support@oclc.org, and we will help you determine the proper URL to use!

The Qwidget in Pennsylvania 

 Here are a few examples of how libraries are making the Qwidget available in Pennsylvania:


Schlow Centre Region Library (State College, PA)

The chat widget is available when a "no results" search is performed on their catalog.  To check it out, go to http://www.schlowlibrary.org/ and perform a catalog search that will provide no results.  (There is a catalog search available from the upper left of the main page.)


Albright Memorial Library (Scranton, PA)

The chat widget is available on their Reference Department blog:



Carnegie Library of Pittsburgh

The chat widget is available from their “Ask a Librarian” page:



The following libraries make the Qwidget available from their front page:


Eastern Monroe Public Library (Stroudsburg, PA)



Memorial Library of Nazareth and Vicinity (Nazareth, PA)



James V. Brown Library (Williamsport, PA)



 --Vince Mariner, Ask Here PA Coordinator, Pennsylvania


Creating Secure patron forms (chat, email, Qwidget)


1. Make sure that all librarians log in using https://www.questionpoint.org/crs/servlet/org.oclc.home.BuildPage?show=authorize&language=1

Please note:

- the Account information will be the same

- If you go to https://www.questionpoint.org and click on the "Librarian Login" button you will be taken to the HTTP site and will not see the patron sessions submitted over HTTPS at this time.


2. On pages that contain the QuestionPoint hosted chat and email forms, please change the URL to use HTTPS (the https part of the code is highlighted in yellow)

Chat Form Example: insert your institution ID where you see XXXXX


Email Form Example: insert your institution ID where you see XXXXX



3. On all QuestionPoint Qwidget pages, change all HTTP URLs to use HTTPS within the code snippet.

Qwidget Example: insert your institution ID where you see XXXXX


<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.8.0/jquery.min.js" type="text/javascript" ></script>

<!-- If using qwidget size "fill", make sure that the minimum height for the parent element of qwidget container on this page is 230 px and the minimum width is 160px.-->

<!-- NOTE - After pasting the code to your page, check it to ensure it does not contain any text formatting such as smart or curly quotation marks.-->

<!-- IMPORTANT - If using multiple chat widgets on the same page: Please incrementally change the "qwidgetno" attribute on the div and script elements for each additional qwidget on the same page.-->

<!-- Beginning of QuestionPoint qwidget code. -->

<div id="questionpoint.chatwidget" qwidgetno="1" ></div>

<script id="questionpoint.bootstrap" qwidgetno="1" type="text/javascript" src="https://www.questionpoint.org/crs/qwidgetV4/js/qwidget.bootstrap.js?langcode=1&instid=XXXXX&skin=black&size=standard" charset="utf-8">//<noscript>Please enable javascript to chat with librarians online</noscript></script>


If you have questions, please email support@oclc.org      



Comments (0)

You don't have permission to comment on this page.