Skip to main content
OCLC Support

Embed your Qwidget using CMS

Overview

The QuestionPoint Qwidget can be embedded in a variety of types of webpages. The simplest is regular HTML pages, but there are also  several different  Content Management Systems that allow embeds.  Below are instructions on how to embed the Qwidget into the most popular Content Management Systems. Please contact OCLC Support if you have any questions regarding other embedding options for the Qwidget.

BlackBoard

BlackBoard 9 uses a JavaScript framework that has a compatibility issue with the JavaScript framework used by the Qwidget. To resolve this issue, you will need to do the following when embedding the Qwidget into BlackBoard:

  1. Copy the Qwiget code from the QuestionPoint Qwidget builder.
  2. Create a blank HTML page that is on a web server that is accessible to both BlackBoard and your users.
  3. Paste the Qwidget code between the body tags. Please do not add anything else to this page.
  4. Publish the page with the Qwidget if needed and note its URL.
  5. Within BlackBoard, create a new HTML Content Block.
  6. Add the iframe call at the end of this section to the HTML Content Block using the URL of the page that you just built in step 3.
  7. Publish your new web part.

Qwidget iFrame call

Drupal

The following directions for Drupal were created using the Sankofa 7.X-1.0 theme but can be applied to other themes as well.

If you encounter an issue embedding the Qwidget into Drupal, please be sure to note the name of the theme when contacting support.

  1. Log into Drupal as the administrator.
  2. Click on Structure > Blocks > Add Block.
  3. On the Block screen (critical steps are in Bold):
    1. Add the Block Title (your choice).
    2. Add the Block description (your choice).
    3. Add the Qwidget Code to the Block Body.
    4. Text format set to FULL HTML.
       Note: Depending on the theme, there are settings for Region and Visibility that will also need to be set based on where you wish the Qwidget to appear.
  4. Save the Block.

At this point the block containing the Qwidget will be available.

Facebook

Please see Add a QuestionPoint Qwidget to Facebook for more details.

Joomla

Prerequisites

  1. Request the custom Qwidget code (newer version than is available on the Qwidget creation page in Admin module).
     Note: You need to be a Super Admin to embed the Qwidget.
  2. Log into the Joomla admin site (<yoursite.com>/administrator) and navigate to User> User Manager to confirm your status as Super User. If you are not a Super User, you will need to upgrade yourself.  If you are unable to upgrade yourself, consult Joomla documentation on how to get upgraded.

    Joomla User Manager: Users screen

Embed the Qwidget

  1. Select Global Configuration from the System drop-down menu.
  2. On the Global Configuration screen, under the Site tab, select Editor - None from the Default Editor drop-down list.
  3. Click Save and Close.
  4. From the Module Manager screen, click New.
  5. Click Custom HTML.
  6. Paste in the Qwidget code provided from the separate document.
  7. Click Save and Close.
  8. Publish as usual.
     Note: If you use the Preview button at the bottom of the Joomla custom HTML page, you will NOT see the Qwidget on the site, but, if you wait awhile, it will be visible on your actual published site.

Sharepoint

When embedding the Qwidget within SharePoint, you will first need to build an HTML page that contains just the Qwidget. Once this file is created, it should be saved as an .htm file that is on a server that is accessible to SharePoint and your users.

Qwidget HTML code

Once the file is created, please follow these steps.

  1. Open the Page in SharePoint.
  2. Click Edit Page.
  3. Click Add a Web Part on the part of the page you want the Qwidget to appear and then select the Content Editor Web Part.
  4. Open the Tool Plane.
  5. Add the URL to the web page hosting the Qwidget to the "To link to a text file, type a URL" field.
  6. Click Apply.
  7. Click Test to ensure that the link works.
  8. Make changes to Appearance and Layout as needed
  9. Click Apply > OK > Publish.
  • Was this article helpful?