Skip to Main Content
It looks like you're using Internet Explorer 11 or older. This website works best with modern browsers such as the latest versions of Chrome, Firefox, Safari, and Edge. If you continue with this browser, you may see unexpected results.
The University of Tampa Macdonald-Kelce Library

Summon, A Library Discovery Service

Explore library resources with one search box (like Google!)

How Do I add a Summon search box or search widget to a web page?

You can create Summon search boxes and widgets that can be placed on any web page, such as research guides, course-management pages, collaborative research portals, and more. This document will describe how to create these tools.
If you haven't already read about Summon search boxes and widgets, start with the introduction, decide whether you want to create a search box or a widget, and determine if you want the tool to search your entire Summon service or be targeted (scoped) with filter and facet options.
Then access the widget builder via either option below:
  • Via the Widget Builder link within the menu on the top right of the screen:
User-added image
Use the links at the top of the page (on the left side as well) to navigate through the 4 steps to create a search box or widget:
  1. Search: In this step you select any facets or filters that you want to apply.
  2. Select widget type: In this step you choose either to build a search box or a search widget.
  3. Customize the widget: In this step you can apply various changes to the look and feel.
  4. Copy the code: In this step you copy the HTML code and paste it into any web page.

Step One

Step 1. Search

The first step is to apply any desired facets or filters. Click the below Go to Search button and a blank search within your Summon instance will display. Apply any facets or filters that you want to include by default, and then move to the second step by clicking Select Widget Type at the top of the page.
Step 1: Search
 

Step Two

Step 2. Select Widget Type

Choose to create either a search box or a widget. The right side of page provides a live Preview environment of the box or widget that you are building.
   

Custom Search Box

A search box is a small search field you can place anywhere on a web page. The default search box looks like       Summon Search Box Builder Default Search Box

By default, a search box searches your entire Summon service. However, with just a few extra clicks you can create a search box with pre-scoped search parameters your patrons would prefer in that particular location. You can also change the labels around your search box, either to use words you prefer, or -- if you create a pre-scoped search box -- to make clear what the patrons will be searching. For example, if you scope your search box to show only those items mapped to both medical and engineering Disciplines, and change the accompanying labels, your search box could look like this:

                Summon Search Box Builder Custom Example

 

Search Widget

A custom search widget with medical and engineering Disciplines selected, and customized labels, could look like this (after the patron performs the search):

           Image      

Step 3A (Building a Search Box)

Step 3a. Customize the Widget: Building a Search Box 

Choose to use the default settings or customize them. The search box Preview pane on the right side will dynamically update to reflect your changes.
Customize

 

The above customization options include:
  1. Show:
  • Tag Line: This text appears above the search box and should help your patron identify the parameters of the scoped search. The default text is "Easily discover the world of library content." To hide the tag line, de-select the checkbox.
  • Advanced Line: This text field links users to your library's Advanced Search page. The default text is "More Search Options". To hide the line, de-select the checkbox.
  • Suggestions: With the checkbox selected, the Autocomplete feature is enabled and provides search suggestions and spelling corrections as the search is being entered.
  • Results in Popup: Uncheck this box if you prefer Summon to open in the user's existing browser window. Default behavior is to open in a new browser window.
  1. Tag Line Color: By default the Tag Line will display in the user's default browser color for text. To change the color, either enter the hexadecimal color code or click in the box and use the color picker.
  2. Links Color: By default the More search options link will display in the user's default browser color for links. To change the color, either enter the hexadecimal color code or click in the box and use the color picker.
  3. Box width: The default width is 125 pixels. To change the size, enter the number of pixels. For example enter "200" for a width of 200 pixels.
  4. Tag Line Text: This text appears above the search box and should help your patron identify the parameters of the scoped search. The default text is "Easily discover the world of library content." This field can be turned off by deselecting the Show Tag Line checkbox.
  5. Search Button Text: This is the text that appears in the button to the right of the search box. The default text is "Search." Enter the word you would like to appear on the button, such as "Find" or "Go." This is a required field.
  6. Advanced Link Text: This text links users to your library's Advanced Search page. The default text is "More Search Options." This field can be turned off by deselecting the Show Advanced Line checkbox.
  7. Placeholder Text: This text displays inside the search box. By default this field is blank.

When you are satisfied with your selections, go to the last step by clicking Copy the code at the top of the page or the left side of the page.

Step 3B Buidling a Search Widget

Step 3b. Customize the Widget: Building a Search  Widget

Choose to use the default settings or customize them. The search widget Preview pane on the right side will dynamically update to reflect your changes.
Customize
The above customization options include:
  1. Title Text: This text appears above the search widget and should help your patron identify the parameters of the scoped search. The default text is "Summon Widget." This is a required field.
  2. Search Button Text: This is the text that appears in the button to the right of the search widget. The default text is "Search." This is a required field.
  3. Title Color: By default the color of the Title Text is the user's default browser color for text. To change the color, either enter the hexadecimal color code or click in the box and use the color picker.
  4. Links Color: By default the color of links in search results is the user's default browser color for links. To change the color, either enter the hexadecimal color code or click in the box and use the color picker.
  5. Header Color: This is the color behind your library logo. This is a required field.
  6. Results Color: This is the color behind the search results. If the field is empty, the user's default browser color will be used.
  7. Box Width: The two choices are either Fixed (250 pixels), which is the same size as the widget in the Preview pane, or Fluid, which changes width depending on the space available on the web page where the widget will appear.

When you are satisfied with your selections, go to the last step by clicking Copy the code at the top of the page or the left side of the page.

Step 4

Step 4. Copy the Code


This page contains the HTML code that you will use on any web page to display your search box or widget:
  • Copy the code from the window.
  • Place the code into any web page.
  • Save the web page and test it.

Create Search Widget in Blackboard

  • Click on Build Content
  • Create Item
  • Name the Search
  • In the Text Box, click on HTML
  • Copy code
  • Click Update
  • Click on Submit

Look here for official UT Colors from Public Information.

Attribution

This page uses step-by-step instructions provided by the vendor.

Macdonald-Kelce Library - The University of Tampa - 401 W. Kennedy Blvd. - Tampa, FL 33606 - 813 257-3056 - library@ut.edu - Accessibility