My favorites | Sign in
Project Home Downloads Wiki Issues Source
Search
for
Thesaurus  
Documentation
Updated Apr 10, 2012 by web.sbel...@gmail.com

Introduction

You can apply the plugin for content areas on your site pages and it will highlight all the terms from the dictionary (by default: sample.csv). When hovering a term, visitors of your site will get definition of the term on a tooltip. Content of the appeared tooltip is being processed as well. So if any terms are encountered , they get definition-tooltips attached. If you switch to DB data-source, you will have visits and click statistics collected.

You can use this plugin to create intelligent advertisement, tooltip to show portal news description, interactive reference book and so on and so forth.

Usage and API

Step 1

Unpack the package into a folder on your server. Include the plugin script after jQuery (requires jQuery 1.4+):

<script src="./js/jquery.thesaurus.js" type="text/javascript"></script>

Step 2

Now let's apply the plugin on a set of elements when document is ready. Here any article elements on the page will be parsed for thesaurus terms:

<script type="text/javascript"> 
<!-- 
$(document).ready(function(){ 
   $('article').Thesaurus({ 
      effect: 'fade', 
      caseSensitive: false 
    }); 
}); // --> </script>

Available Options

caseSensitive

defines if the plugin does case sensitive search for the terms
effect
transition effect for tooltip: fade or any manual
pushStats
states if the plugins collects tooltip click and view statistics into queue and uploads the queue to the server every 5 sec (if it is not empty).

Back-end configuration

In ./app/Config/config.php you will find a CSV file is set up as data source. If you want to use DB, just uncomments another configuration section.

Manual transition effects making

You can make your own effect for Thesaurus using CSS3. Just describe the initial state of tooltip overlay and final state. Name those CSS classes by the pattern thesaurus-EFFECTNAME-start and thesaurus-EFFECTNAME-end:

.thesaurus-scale-start { 
opacity: 0; -moz-transform: scale(0.1); 
} 
.thesaurus-scale-end { 
-webkit-transition: all 1s ease-in-out; 
-moz-transition: all 1s ease-in-out; 
-o-transition: all 1s ease-in-out; 
transition: all 1s ease-in-out; 
opacity: 1 !important; 
-moz-transform: scale(1); 
}

Now you can just specify the effect (EFFECTNAME) in the plugin options.

Comment by clas...@gmail.com, Jun 14, 2010

Hi Dmitry, thank you very much for this open-source script.

Comment by fad...@gmail.com, Jul 29, 2010

Great codeing, Cheers!

A small suggestion..

  • Instancing of tooltips. When the term occures within the tooltip text it will cause another tooltip when hovering by mouse. is simply great except the term used to open this tool tip must be disabled to avoid repeated tooltip instances.
Comment by nghien...@gmail.com, Jul 30, 2010

Great! Why not support replace Vietnamese?

Comment by retep.r...@gmail.com, Oct 3, 2010

Hi Dimitry, this is much work ! thank you very much for this great performance !

cu,Peter

Comment by leung.ma...@gmail.com, Jul 7, 2011

HI, I encountered difficulties when using this plugin. I extracted the zip file to /thesaurus/ and set it as web root of Apache. I opened the index.html in thesaurus folder with localhost, but there is no word being underlined with dotted line..

Where did I go wrong. Please help.. Thank you very much.


Sign in to add a comment
Powered by Google Project Hosting