General Help
Setup and Customization
Installing JargonFish
General Help
Q: What is JargonFish?
A: JargonFish provides customizable in-text search for your Website or blog. JargonFish adds depth and value to your content and improves the stickiness of your Website.
>> Return to Top
Q: How does JargonFish work?
A: When JargonFish is installed on your Website or blog, our technology scans the contents of your pages and highlights pre-selected keywords or phrases (example: iPod). When visitors click on those uniquely highlighted words, JargonFish is launched in a small window that is displayed above the page. JargonFish contains a set of tools that provide your visitors with additional information related to that specific keyword (example: Yahoo! search results, related Amazon products, YouTube videos, Technorati blog search results, as well as your own custom tools).
>> Return to Top
Q: How do I sign up?
A: To sign up, simply complete the online registration form. After submitting your form, you can create and customize JargonFish for your Website, select your keywords, and copy and paste the code into your Website to begin displaying JargonFish.
>> Return to Top
Q: Are there any costs or fees associated with JargonFish?
A: No. There are no costs or fees to add JargonFish to your Website.
>> Return to Top
Setup and Customization
Q: How do I create my JargonFish widget?
A: After completing the JargonFish registration, log in to JargonFish to access the Setup page. Next, enter a name for your JargonFish widget, the Website URL where JargonFish will be displayed, click the "Add" button and follow these three simple steps:
Step 1: Customize Your Design
Step 2: Select Your Keywords
Step 3: Get Your Code
Once the simple line of JavaScript code is placed on your Website pages, JargonFish will be active on your site.
>> Return to Top
Q: What features can I customize?
A: From the Edit Design page, you can edit/customize the following items:
- Website Name - This name is for your reference only and will not be displayed in the JargonFish window.
- JargonFish Tools - You can select the tools you want to use by simply dragging and dropping a tool into one of the JargonFish tool bars.
- Toolbars - Add more toolbars to provide room for additional tools.
- Link Style - You can choose how you want to highlight the JargonFish keywords on your Website. Choose from single underline, double underline, solid or dashed. You can also choose the color of the underline and whether or not you want to display the JargonFish icon as a part of the link.
- Keyword Limit - Define the maximum number of keywords to highlight on a page.
- Color - Choose the color of JargonFish simply clicking on one of the color icons.
- Size - You can modify the size of JargonFish by simply clicking and dragging the icon in the lower-right-hand corner of the widget.
>> Return to Top
Q: What standard tools does JargonFish provide?
A: The following is a partial list of tools that are available:
- Amazon
- blogger
- del.icio.us
- digg
- ebay
- flickr
- Google Maps
- SmartMoney
- Technorati
- Wikipedia
- Yahoo! Image Search
- Yahoo! News
- Yahoo! Search
- YouTube
>> Return to Top
Q: How do I create my own custom tools?
Tip: Download the
JargonFish Custom Tools instruction sheet. (PDF, 1.2 MB)
A: The custom tool feature allows you to specify any Web page URL and have that page displayed within a JargonFish tool window.
This can be a page within your Website, an external Website, or a custom page that you create and format for the sole purpose of displaying it in the JargonFish widget. There is also an option to create a custom tool using HTML or JavaScript.
Adding a Custom Tool to your JargonFish widget
To create your own custom tool, go to the "Step 1: Design" page. In the "JargonFish Tools" section click on the "Add Tool" link next to the Custom Tools heading. First, enter a name for your tool in the field provided. Second, enter either the URL of the web page or the HTML/JavaScript text you wish to display.
Linking to an existing page
If you choose to link to an existing page in your Website or an external Website, keep in mind that the JargonFish tool window is relatively small. The window size may force the user to scroll in the JargonFish window to view the contents of the page. For optimal results, we suggest using pages with minimal or no navigation at the top or left side of the page.
Creating a custom page
For the best results in creating a custom tool, we suggest building a custom page that you have formatted specifically for the JargonFish widget. Here are recommended guidelines for building a custom page:
- Remove navigation links and buttons across the top and left-hand side of the page
- Build the page so that the contents can expand horizontally to fit within the JargonFish window as the user can modify the window size
- All links on the page should contain the "target=new" tag to launch links in an external window
- Page should not contain any pop-up or pop-under ads
Advanced Features:
The JargonFish widget is driven by specific keywords that are highlighted on your pages. To create a custom tool that is specific to the highlighted keyword, add the following piece of code to your URL: "
${KEYWORD}". When JargonFish sees that piece of code, it will replace it with the actual keyword that activated the widget.
Example:
The sample Website for this example is
sfbay.craigslist.org. If you do a search for "iPod" on this site the resulting URL is
http://sfbay.craigslist.org/search/sss?query=ipod. To customize the URL for JargonFish, remove the keyword "
ipod" at the end of the url and replace it with "
${KEYWORD}". The custom URL would look like this:
http://sfbay.craigslist.org/search/sss?query=${KEYWORD}
JargonFish then replaces "
${KEYWORD}" with whatever keyword is highlighted on your page and displays search results for that specific keyword as a custom tool.
Custom Tool Notes
- JargonFish does not host any custom tool pages
- All links on the page should contain the "target=new" tag to launch links in an external window
- Custom tools are created on the account level. This means they can be used on any widget associated with your account. This also means that when a custom tool is deleted, it will be removed from all associated widgets.
>> Return to Top
Q: How are the keywords selected and highlighted on my Website?
A:
- Category Keyword Selection The category selection feature allows you to simply click on one or more categories that best describe your Website. The categories contain related keywords and phrases that are most likely to appear on your Website.
- Add Keywords Manually If the category selection does not provide adequate keyword coverage, you have the option to manually add your own keywords.
- Exclude Keywords JargonFish gives you the ability to exclude specific keywords by simply entering individual keywords in the Exclude Keywords text box.
>> Return to Top
Q: Can I create different versions of JargonFish for different Websites or pages?
A: Yes. To create a new version of JargonFish simply click on the "Add Website" button at the bottom of the setup home page.
>> Return to Top
Q: How do I edit JargonFish?
A: After you have completed the setup process, you can return to the setup home page and click on any of the edit icons provided (Edit Design, Select Keywords, Get Code, View Reports, Delete).
>> Return to Top
Installing JargonFish
Q: How do I install JargonFish?
A: After completing the JargonFish setup process, copy the JavaScript code from the "Get Code" page and paste it between the
<head></head> tags on the pages you wish to display the JargonFish widget. When pasting the code, make sure that you do not force any line breaks. Forced line breaks may cause errors in the JargonFish widget.
>> Return to Top
Q: How long will it take for JargonFish appear on my Website?
A: After you correctly place the JargonFish code on your Website, JargonFish should appear on your Website immediately (you may need to refresh your pages or clear your cache initially before you can see JargonFish on your site).
>> Return to Top
Q: Will JargonFish affect the formatting or layout of my pages?
A: No. JargonFish is launched as a separate window and will not change your page layouts. The only change you will see is the highlighted keywords that have been selected by JargonFish.
>> Return to Top
Q: Can I prevent JargonFish from adding links to specific areas of my web pages?
A: Yes. To prevent JargonFish from adding links to specific areas our your web pages, add the following code around each section:
Beginning tag:
<span class="nojf">
End tag:
</span>
For example, if you wanted to exclude the code "This is a page headline" from JargonFish, add the exclusion tags as follows:
<span class="nojf">
This is a page headline
</span>
>> Return to Top
Q: How do I remove JargonFish from my Website?
A: There are several options to remove or suspend JargonFish from your Website:
- Remove the JargonFish code from your pages
- Click the "suspend" icon on the Setup page to temporarily pause a JargonFish widget
- Click the "delete" icon on the Setup page to delete a JargonFish widget
>> Return to Top
