=== WP-BANNERIZE ===
Contributors: Giovambattista Fazioli
Donate link: http://labs.saidmade.com
Tags: Banner, Manage, Image, ADV, Random
Requires at least: 2.8
Tested up to: 2.8.6
Stable tag: 2.3.4

WP_BANNERIZE, banner-image manager.

== Description ==

WP_BANNERIZE is an Amazing Banner Image Manager. In your template insert: `<?php wp_bannerize(); ?>` or set it like Widget

**FEATURES**

* Create your list (group/key) Banners image
* Show your banners list by php code or Widget
* Set random, limit and catories filters
* Wordpress Admin Contextual HELP
* Wordpress MU compatible

**NEW FROM 2.3.2**

* Add alt class in HTML output
* Add additional class for link TAG A
* Fix Widget HTML output

  See CHANGELOG for full history version

**HOW TO**

When you insert a banner you can give a group (key) code. In this way you can "group" a block of banners. For examples if your theme is a 3 columns you can put in left sidebar:

`<?php wp_bannerize('group=left_sidebar'); ?>`

and put in right sidebar:

`<?php wp_bannerize('group=right_sidebar'); ?>`

However wp-bannerize provides a filter by category, for example:

`<?php wp_bannerize('group=right_sidebar&categories=13,14'); ?>`

The code above shows only banners in the categories 13 or 14, for the "right_sidebar" group key.


**params:**

`
* group               If '' show all groups, else show the selected group code (default '')
* container_before    Main tag container open (default <ul>)
* container_after     Main tag container close (default </ul>)
* before              Before tag banner open (default <li %alt%>) see alt_class below
* after               After tag banner close (default </li>) 
* random              Show random banner sequence (default '')
* categories          Category ID separated by commas. (default '')
* alt_class           class alternate for "before" TAG (use before param)
* link_class          Additional class for link TAG A
* limit               Limit rows number (default '' - show all rows) 
`

= Related Links =

* [Saidmade](http://www.saidmade.com/ "Creazione siti Web")
* [Undolog](http://www.undolog.com/ "Author's Web")
* [Labs Saidmade](http://labs.saidmade.com/ "More Wordpress Plugin info")
* [Tutorial Video](http://www.youtube.com/watch?v=sAZOyAwXu-U "Tutorial Video")

For more information on the roadmap for future improvements please e-mail: g.fazioli@saidmade.com

== Screenshots ==

1. Options
2. New inline edit
3. Contextual HELP
4. Widget support

* [Tutorial Video](http://www.youtube.com/watch?v=sAZOyAwXu-U "Tutorial Video")

== Changelog ==

= 2.3.4 =
* Revision readme.txt

= 2.3.3 =
* Split Widget code
* Fix "random" select on Widget

= 2.3.2 =
* Add "alt" class in HTML output
* Add additional class for link TAG A
* Fix Widget output

= 2.3.0 =
* Add Wordpress Categories Filter - Show Banner Group for Categories ID
* Improve admin

= 2.2.2 =
* Fix minor bugs + prepare major release

= 2.2.1 =
* Fix to Wordpress MU compatibilities
* Fix minor bugs

= 2.2.0 =
* Add Widget support
* Fix compatibility with Wordpress 2.8.6

= 2.1.0 =
* Add thickbox support for preview thumbnail
* Resize key field to 128 chars
* Minor Fix

= 2.0.8 =
* Minor Fix, improve admin

= 2.0.3 =
* Minor Fix

= 2.0.2 =
* Add random option
* Fix minor bugs

= 2.0.1 =
* Fix bugs on varchar size in create table

= 2.0.0 =
* Add edit banner
* Combo menu for group/key and target
* Contextual HELP
* Icon
* Limit option
* rev list and rev code!

= 1.4.3 =
* Fix patch on old version database table

= 1.4.2 =
* Add screenshot

= 1.4.1 =
* Clean code

= 1.4.0 =
* Rev UI
* Change database
* Fix upload path server bug

= 1.3.2 =
* Fix bug to sort order with Ajax call

= 1.3.1 =
* Update jQuery to last version

= 1.3.0 =
* New improve class object structure

= 1.2.5 =
* Remove a conflict with a new class object structure

= 1.2 =
* Done doc :)

= 1.1 =
* Rev, Fix and stable release

= 1.0 =
* First release
`

== Upgrade Notice ==

= 2.2.0 =
Add Widget support and fix for Wordpress 2.8.6. Upgrade immediately

= 2.0.0 =
Major release improve. Upgrade immediately.

= 1.4.0 =
Major release improve. Upgrade immediately.

= 1.3.1 =
Upgrade to last jQuery release. Upgrade immediately.

= 1.0 =
Please download :)


== Installation ==

1. Upload the entire content of plugin archive to your `/wp-content/plugins/` directory, 
   so that everything will remain in a `/wp-content/plugins/wp-bannerize/` folder
2. Open the plugin configuration page, which is located under `Options -> wp-bannerize`
3. Activate the plugin through the 'Plugins' menu in WordPress (deactivate and reactivate if you're upgrading).
4. Insert in you template php `<?php wp_bannerize(); ?>` function
5. Done. Enjoy.

See [Tutorial Video](http://www.youtube.com/watch?v=sAZOyAwXu-U "Tutorial Video")

== Thanks ==

* [Ivan](http://www.bobmarleymagazine.com/) for bugs report
* [rotunda](http://wordpress.org/support/profile/2123029) for beta test
* [labs.saidmade.com](http://labs.saidmade.com/ "Creazione siti Web")
* [Tutorial Video](http://www.youtube.com/watch?v=sAZOyAwXu-U "Tutorial Video") 
* [marsev](http://wordpress.org/support/profile/5368431 "marsev") for prefix table suggest and beta test

== Frequently Asked Questions == 

= Can I customize output? =

Yes, use the `args` for set "container" and "before" and "after" tagging.
For example the default output is:
`
<ul>
<li><a href=".."><img src="..." /></a></li>
<li><a href=".."><img src="..." /></a></li>
...
</ul>`  
You can change `<ul>` (container) and `<li>` (before) 

`<?php wp_bannerize('container_before=<div>&container_after=</div>&before=<span>&after=</span>'); ?>`

`
<div>
<span><a href=".."><img src="..." /></a></span>
<span><a href=".."><img src="..." /></a></span>
...
</div>`

= Can I customize arguments TAG? =

Yes, you can cistomize alternate class on "before" TAG and class on link A:

`<?php wp_bannerize('container_before=<div>&container_after=</div>&before=<span %alt%>&after=</span>&link_class=myclass'); ?>`

`
<div>
<span><a href=".."><img src="..." /></a></span>
<span class="alt"><a class="myclass" href=".."><img src="..." /></a></span>
...
</div>`

OR

`<?php wp_bannerize('alt_class=pair&link_class=myclass'); ?>`


<ul>
<li><a href=".."><img src="..." /></a></li>
<li class="pair"><a class="myclass" href=".."><img src="..." /></a></li>
...
</ul>`