=== BillyBen Ring ===
Contributors: BillyBen
Tags: Links, tag, category, Circle, Ring, SideBar,widget, multi instance
Requires at least: 2.8.1
Tested up to: 3.1.1
Stable tag: 2.0.0

Display your links, tag, pages, and/or categories by a circular sideBar widget, with full or arrowed circles. Fully customizable. Mutli Instance

== Description ==

BB Rings can display your links, with or without their own category, your categories, your page and your posts tags. It show them by circle, full or arrowed, and it is moving!  
It is quite entirely customizable, especially all colors can be indivudually choosen.
Each instance of BB Ring are customizable (see screenshots).
You can now choose wether it open a new windows or keep the same for each display's type.
It use an swf integrated by swfObject2 (javascript) in the html page. The Option page also uses Javascript for a really convenient experience.. (...).  
  
**Requirements**  
  
It require Javascript enabled, and Flash Player 10 or higher.

You can also visit <a href="http://82.228.191.29/asblog/?page_id=488&lang=en">Widget Page</a>  
  
*note : ColorPicker javascript code were from* <a href=\"http://odvarko.cz/\">Jan Odvarko</a> (<a href=\"http://jscolor.com/\">jscolor</a>) 

*WPML Compatibility : It can display colors for différent languages, based on the admin language choosen colors. Option panel are ready for traduction.....*

== Installation ==

1. Upload the "BillyBenRing.zip" file.  
2. Unzip it to the "/wp-content/plugins/" directory  
3. Activate the plugin through the "Plugins" menu in WordPress  
4. Configure the Ring's colors on "BB Ring" page (into the Setting section)  
5. At the widget page, add BillyBenRing to your sidebar, and configure instance.

== Frequently Asked Questions ==

Please Ask! <a href="http://82.228.191.29/asblog/?page_id=488&lang=en">Widget Page</a>

= When I drag an instance to my SideBar, ColorPicker does not appear on click? =
That's a known issue, I'm on it. Just "Save" once and it will work again.


== Screenshots ==

1. The BillyBen Ring widget displaying "Links" and "Page", arrowed and full, 2 différent Text direction.
2. The BB Ring instance configuration (widget page).
3. The BBR's Options Page - Link direction and ColorPicking for each Rings.

== Changelog ==
= 2.0.0 =
* It is now Multi instance
* added the choice for _self or _blank for each category

**Important** Upgrading to this version will initialize Instance Setting but your defined colors for each category will remain the same.

= 1.0.1 =  
* Add Page to the display possibility
* Turn Option page to internationalization (so can be translate)

= 1.0 =  
* Adding some modification to be partially compatible with wpml plugin

== Options description == 

= Instance Options = 
  
**Dimensions** 
  
   * Width, Height : The width and Heigth of the swf  
   * Ring Size : the thickness of each ring  
   * First Ring Size : the first ring inner radius  
  
**Rings**  
  
   * Text Color (Off/Over) : the two text colors, when mouse is up or out  
   * Ring Glow Color : the glow color applied when mouse is over  
   * Space between rings : the spacing between rings  
   * Ring fit text : rings are full filled ("Entire") or arrowed ("fit")  
   * Start Alignement : The alignement of rings- for "Decal" chose the angle step between rings (can be negative)  
   * Start Angle : the start angle for the rings alignement  
   * Text Direction : The direction of the text turn to the center ("in") or off the center ("out") or it can follow the ring’s perimeter (the two other)  
  
**What to show**  
  
Here you chose what you want to display : Links, Categories, pages and/or Post Tag.
For "links" you can choose wether you want to show their categories. 

= General Options =

Click on radio button to show the corresponding table, it does not influence instances display, it is just more convenient than scrolling and scrolling.
At the top of each table their is a dropDown list which allow you to choose where the link will open.
  
**Color Chooser**  
  
You can Choose any color you want for each rings. Simply click into the text field and it will display a colorPicker. At the top of each category you can find a "Create Gradient" button, which allow you to create a color gradient for its category.


== Known Issue == 

* When you drag an instance to your SideBar, ColorPicker does not appear on click. Just "Save" once and it will work again.
* Whith Firefox 4 (at least), when you click to a "_self" link and then get back, it disable clik onto the widget instance that call it... don't know why for the moment.