Google Search Appliance
The University of Minnesota licenses and runs an instance of Google Search Appliance (GSA). The University’s GSA searches U of M websites, mostly in the umn.edu domain, and indexes the results. If you search from the header of a University web page, you’re likely getting results through the GSA.
The GSA can highlight key matches. For instance, a search for "admissions" might highlight admissions offices from each of the U’s campuses. The display of search results can be customized.
For more information, visit the Office of Information Technology’s Web Search site.
For your website, you can use a search application that separates search results for people and web pages at the University. You can also customize it to include tabbed results specific to your site.
How do I … ?
Caution: while it’s quick and easy to do, setting up a tabbed search requires some knowledge of HTML.
How do I add tabbed search to my website?
- Locate the header search form in your code.
- Change the form action to use tabbed search. Make sure the method is set to "get." For systemwide sites:
<form action=http://search.umn.edu/s/ method="get">For Twin Cities sites:
<form action=http://search.umn.edu/tc/ method="get">Note: search.umn.edu is available securely. Substitute https for http in the action.
- Make sure the name of the text field where users enter their search is set to “q." Do not change any other attributes in the input element. Example:
<input … type="text" … name="q" … />
- If any hidden elements exist, they can be deleted. The most common hidden elements in existing code have the names “client" and “site." Examples:
<input type="hidden" name="client" value="searchumn" />
<input type="hidden" name="site" value="default_collection />
How do I include a tab specific to my site?
- Follow the instructions for adding tabbed search above.
- Add a hidden input element with your hostname. For instance, if your site is located at www.coolstuff.umn.edu, use
<input type="hidden" name="r" value="www.coolstuff.umn.edu" /> If your site is located in a subdirectory, e.g., www.coolstuff.umn.edu/gnarly/, use <input type="hidden" name="r" value="www.coolstuff.umn.edu/gnarly/" />
- To change the name of the additional tab to something other than “This Site," add another hidden element. For instance, to name the tab “Cool Stuff," use
<input type="hidden" name="l" value="Cool Stuff" />
How do I set up other, custom tabs?
If you familiar with the Google Search Appliance and have your own client or collection defined, we can easily set up a tab for you. Write us at email@example.com.
Note: only search.umn.edu/s/ and search.umn.edu/tc/, for systemwide and Twin Cities, respectively, are set up for general use.
A basic query with only the "All Results" tab.
Adding tabs for the Twin Cities and Duluth graduate program catalogs.
The same as above, with the Twin Cities graduate program catalog up.
Adding a tab for the Academic Health Center and an extra tab, using AHC defaults, for the Medical School website.
Giving the extra tab a useful name.
Setting the on-the-fly tab to use the AHC extra tab configuration.
Tabbed search parameters
The following is a complete listing of parameters that may be used for tabbed search. Note: the s and e parameters require setup by UR.
- Parameter q
- Query, i.e., q=list+of+colleges or q=admissions.
- Parameter s
- A hyphen-delimited list of sets (e.g., s=catgs-catdgs) in the order to be displayed. The "All Results" tab will always precede these additional tabs and any extra tab will follow. Optional.
- Parameter u
- The index of the results tab to display initially. Tabs are zero-indexed, so the third tab would be brought up using u=2. Optional.
- Parameter r
- A hostname used to restrict results in an extra tab (e.g., r=www.ur.umn.edu). Using this parameter with a well-formed hostname will add the "This Site" tab to the end of the tab set. A partial path on the host may be added (e.g., r=www.ur.umn.edu/imageslib). Optional.
- Parameter l
- A name for the additional tab, used to override the default of “This Site." Names must match the regular expression /^[\w\d\s&.,"\.-]+$/. Optional.
- Parameter e
- The name of the set used to set defaults for the additional tab. By default, the additional tab searches the entire University, using the standard set of keymatches from the GSA. A different site, collection or other parameters may be set for use with the additional tab (e.g., e=eAHC). Optional.