Inserting A WebFeat Search Box on a Silva Page

Wiki Tools

Get a Valid WebFeat Search Key

Before you can insert a WebFeat search box onto a Silva page, you need a valid WebFeat search key.  WebFeat is a commercial database search engine that is licensed to Bethel University Library.  To obtain a valid search key you must consult a Bethel University Librarian with permission to generate a key on the WebFeat search site.

A valid key will be an alpha-numeric constant like the example below.  Some constants will start with a minus sign (-) like a negative number.  The minus sign is a part of the search key constant and must be included with the key.  The easiest way to receive a valid key is by email or other electronic form.  You may copy the key on paper and type it into your Silva form.  That is tedious, but it will work. 

NOTE:  Valid keys can only be generated by someone with permission to access the WebFeat key generation process (A Bethel University Librarian).

An Example of a valid WebFeat Search Key URL:

5617ab59bd3f8b78da1e9d4fd9e0c5ae

Identify the location for the WebFeat Search Box

Create a new Silva page or open the Silva page that will contain the WebFeat search box.  Identify the location of the search box on the page.  You may have to use a table if you want the placement somewhere other than the left margin of the page.

Select the External Code Source

Once the cursor is located in a position where you want to place the search box, it is time to add the external code source.  In the left hand menu of the Silva editor, you will find a menu selection identified as external source (see figure 1).  Expanding the external source menu item will expose a drop down list of available external sources and a button with the caption "add external source".  Open the drop down list and select "WebFeat Search Box" as the external source you wish to place.  Click the button that is labeled "add external source".

	figure 1

Add the WebFeat Search Key

Once you click the "add external source" button, the external source menu item will display a text box labeled "Search Key" as well as an "add external source" button and a "cancel" button.  (see figure 2).

The WebFeat search key is that alpha-numeric string which you received from a Bethel Librarian.  Copy the search key that was given to you by a Bethel Librarian and paste it into the text box labeled search key.  From the example above (see WebFeat key example above) the search key is 5617ab59bd3f8b78da1e9d4fd9e0c5ae.  Note:  paste the entire search key as you received it into the text box.  Anything more or less than the actual search key will result in an invalid key.

Once the search key has been pasted into the the textbox, click the "add external source" button.

	figure 2

External Code Source in Edit View

Once you click the "add external source" button in the previous step, the external code source will be placed onto the Silva page that you are in the process of editing (see figure 3).  It will appear as a yellow colored masked out area entitled "Silva Code Source".  Save your page in the Silva editor.  Once your page is saved in the Silva editor the code source will be identified as a "WebFeat Search Box" (see figure 3) and the valid search key that you pasted into the text box will be identified.

	figure 3

Validate Search Key

There are a number of ways to validate your WebFeat search box on your web page.  The steps to validation are outlined below.

Examine the Key

The first step in validation is to examine the key that is displayed in the Silva Code Source on your web page.  The search key should look similar to the valid one displayed in figure 3.  If it does not consist of alpha-numeric characters or does not resemble the valid key (see figure 4), go back to the original WebFeat Search Key you received from a Bethel University Librarian and repeat the copy and paste operation outlined above.

	figure 4

Preview the Page

Save the page that you are editing.  Click the preview tab.  If you have a valid search key in the Search Key textbox, you will see a series of controls that comprise a "WebFeat Search line" on your page.  If you do not have a valid WebFeat search key in the Search Key textbox, you will see nothing (see figure 5).  If you see nothing, you will need to edit your code source and make sure you have a valid key in the Search Key textbox.  If you continue to see nothing after a number of tries, you may need to validate your key with a Bethel University Librarian.

	figure 5

Publish the Page

Save the page.  Click the publish button in the Silva editor.  If you have a valid search key in the Search Key textbox, you will see the "WebFeat Search line" on your published preview in the Silva editor.  If you do not have a valid WebFeat search key in the Search Key textbox, you will see nothing (see figure 6).  If you see nothing, you will need to create a new version and edit your code source in order to make sure you have a valid key in the Search Key textbox.    If you continue to see nothing after a number of tries, you may need to validate your key with a Bethel University Librarian.

	figure 6

Examine the Site

Once the site is published, you can validate your search key by looking at the production web site.  The consequences of validating only with this method is that the Internet world can see that you have a WebFeat search box on your page.  If there is a reference to the search box in your text, the viewers of your site will know that it is missing.  Like other methods of validation, the production page validation will show a WebFeat search line if there is a valid key, otherwise it will show nothing (see figure 7).  Like other methods of validation,   if you continue to see nothing after a number of tries, you may need to validate your key with a Bethel University Librarian.

	figure 7