|
|
Google Web Search @ Temple
Overview | Instructions for Web Administrators | Advanced Search Options | FAQs
Please note that you need to be an experienced web developer to use these advanced options. The form can send one or more input parameters as follows:
| Name |
Required |
Type |
Allowed values |
Description |
| searchString |
Yes |
text |
Any string |
Field where the user will type the string to query |
| searchEngines |
No |
hidden |
google
kb |
A comma separated list of engines to include in the results. As of today, the available engines are kb((knowledge base) and Google . The order that each engine occupies on this list will determine the order in which the results will appear. |
| searchFolder |
No |
hidden |
Any URL segment |
If a value is included, the results will only come from certain sites or folders within any Temple sites indexed by the Google site search. For example if this parameter is temple.edu/bursar, only results from www.temple.edu/bursar/ will be displayed. This parameter only affects the filtering of Google results. |
| searchCount |
No |
hidden |
An integer between 1 and 20 |
This parameter determines the number of results to display from each search engine on each page. A value bigger than 20 is ignored. The default is 10 results. |
| mobile |
No |
hidden |
the word yes |
If this parameter is included, the results web page will be customized with special headers to make it mobile friendly. |
| asXML |
No |
hidden |
the word yes |
If this parameter is included, the results will be returned as an XML document. |
The following is an example of a search box using a different engine order, restricting the Google results to folder cs, mobile view
and only displaying 3 results per engine.
<!-- START Google Site Search box -->
<form name="templesearch" method='get' action='http://search.temple.edu/search.php'>
<label for="searchString" style="position:absolute;left:-1000px;top:auto;width:1px;height:1px;overflow:hidden;">
Search</label>
<input type='text' value='Search' id="search" name='searchString' title="Type text to search" size="25" />
<input type='hidden' value='kb,google' name='searchEngines'/>
<input type='hidden' value='www.temple.edu/cs' name='searchFolder'/>
<input type='hidden' value='3' name='searchCount'/>
<input type='hidden' value='yes' name='mobile'/>
<input type='submit' value='Search'/>
</form>
<!-- END Google Site Search box -->
By default the results are displayed on a generic Temple University results page. If you are an experienced web developer and would like to customize the CSS, header and footer of the results page to match your website design, please follow these steps:
Note:
- You can choose to customize just the CSS, header, footer or a combination of the three.
- In the HTML files for the header and footer only insert code that is relevant to the header or footer. Ignore all other HTML tags including body, html, head , doctype etc
- If there are references to external files then make sure they are all absolute references.
- Create an HTML file with the header and publish it to your web site. Please name the file as websitename_header.htm.
e.g. If your website is www.temple.edu/cs, then the name of the file should be cs_header.htm
- Create an HTML file with the footer and publish it to your web site. Please name the file as websitename_footer.htm.
e.g. If your website is www.temple.edu/cs, then the name of the file should be cs_footer.htm
- Optional: If you want to change the look and feel of the actual results, you can do so by creating a custom CSS file. The CSS file (if provided) will be loaded AFTER the default CSS used for Temple search.
- Submit a request via TUhelp asking for a validation key for a custom CSS, header and footer. Please submit the urls for the CSS, header and footer with your request.
- A consultant will generate a validation key and share that with you. The key could look like this: 2e3059c963b2b96db2125901141c5fd0
Once you have received the validation key, you can add the following parameters to your search code so that the results are displayed on a custom results page.
| Name |
Required |
Type |
Allowed values |
Description |
| css |
No |
hidden |
A valid URL of a CSS file |
The results can be displayed using any CSS file. The default CSS file will be loaded on the results page along with any customizations made in your css file. |
| header |
No |
hidden |
A valid URL of an HTML file |
The header of the results page can be customized using another HTML file.
IMPORTANT NOTE: Once a certain file is registered to be used in a customized and validated search, the application will cache the file on the search server, both as an optimization and as a security measure. In order to make later changes to the header or footer, a new file name should be used or the cache needs to be erased.
Please name the file as websitename_header.htm.
e.g. If your website is www.temple.edu/cs, then the name of the file should be cs_header.htm |
| footer |
No |
hidden |
A valid URL of an HTML file |
The footer can also be customized via HTML file. Please name the file as websitename_footer.htm.
e.g. If your website is www.temple.edu/cs, then the name of the file should be cs_footer.htm |
| validation |
No |
hidden |
A key provided by the administrator |
This key provides explicit validation for forms that use special CSS, a header or footer. This is a unique value for each combination of CSS, a header and footer. It needs to be requested from the administrator via a TUhelp request. |
The following is an example of a search box with custom CSS, a header and footer,
using a different engine order, restricting the Google results to folder cs/ and only displaying 3 results per engine:
<form name="templesearch" method='get' action='http://search.temple.edu/search.php'>
<label for="searchString" style="position:absolute;left:-1000px;top:auto;width:1px;height:1px;overflow:hidden;">
Search</label>
<input type='text' value='Search' id="search" name='searchString' title="Type text to search" size="25" />
<input type='hidden' value='http://www.temple.edu/cs/cs_styles.css' name='css'/>
<input type='hidden' value='http://www.temple.edu/cs/cs_header.htm' name='header'/>
<input type='hidden' value='http://www.temple.edu/cs/cs_footer.htm' name='footer'/>
<input type='hidden' value='kb,google' name='searchEngines'/>
<input type='hidden' value='www.temple.edu/cs' name='searchFolder'/>
<input type='hidden' value='3' name='searchCount'/>
<input type='hidden' value='893b45d120719bf512f913a8a1e24af2' name='validation'/>
<input type='submit' value='Search'/>
</form>
|
|
