=== WP Bannerize ===
Contributors: gfazioli
Donate link: http://undolog.com
Tags: Banner, Manage, Image, ADV, Random, Adobe Flash, Impressions, Click Counter
Requires at least: 4.5.2
Tested up to: 4.6.1
Stable tag: 4.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

WP Bannerize is an easy to use adv image manager with html and free text support.

== Description ==

**Of course, if you are using a previous version of WP Bannerize, you can import the previous banners to new version. WP Bannerize will detect the previous version and will display an Import wizard view.**

WP Bannerize is an Amazing Banner Manager. With WP Bannerize you can manage all your advertising stuff through widgets, shortcodes or directly from your template.

**FEATURES**

* Manage your banner as Custom Post Types for image, HTML/Javascript and free text
* Create your banner categories
* Sort your banner with easy Drag & Drop
* Display your banners by PHP code, WordPress **shortcode** or Widget
* Set the filters such as random order, numbers, user roles and categories filters
* Date Time schedule
* "nofollow" attribute support
* Clicks and Impressions Counter engine for stats
* CTR (Click-through rate)
* Analytics reports

**WHAT'S NEWS IN 4.0 RELEASE**

* New core engine
* New Analytics reports
* Removed Adobe Flash support

**HOW TO**

You can display the banners by shortcodes, PHP functions or Widgets.

= Shortcode =

`
// single banners
[wp_bannerize id="1678"]
[wp_bannerize id="my-banner-slug"]
[wp_bannerize id="1678,my-banner-slug"]

// random
[wpx_bannerize numbers="1" orderby="random"]

// random with category
[wpx_bannerize orderby="random" categories="56"]
[wpx_bannerize orderby="random" categories="sidebar-blog"]

// post categories
[wpx_bannerize post_categories="news,events"]
[wpx_bannerize post_categories="34,67"]
`

= PHP Function =

`
<?php
// Display a single banner
if( function_exists( 'wp_bannerize' ) ) {
  wp_bannerize( array( 'id' => '156' ) );
}

// Display a more single banner
if( function_exists( 'wp_bannerize' ) ) {
  wp_bannerize( array( 'id' => '156,157,158' ) );
}

// Display a more single banner
if( function_exists( 'wp_bannerize' ) ) {
  wp_bannerize( array( 'id' => array( 156, 157, 158 ) ) );
}

// Display a more single banner by mixed id and slug
if( function_exists( 'wp_bannerize' ) ) {
  wp_bannerize( array( 'id' => array( 156, 'my-banner-slug', 158 ) ) );
}


// Display all banners from banner category "sidebar" in random order
if( function_exists( 'wp_bannerize' ) ) {
  wp_bannerize( array( 'orderby' => 'random', 'categories' => 'sidebar' ) );
}

// Display one banner from banner category "sidebar" in random order
if( function_exists( 'wp_bannerize' ) ) {
  wp_bannerize( array( 'orderby' => 'random', 'numbers' => 1, 'categories' => 'sidebar' ) );
}

// Display banners from banner category "sidebar" and post categories news and events
if( function_exists( 'wp_bannerize' ) ) {
  wp_bannerize( array( 'category' => 'sidebar', 'post_categories' => 'news,events' ) );
}

// Or... as array of slug
if( function_exists( 'wp_bannerize' ) ) {
  wp_bannerize( array( 'categories' => 'sidebar', 'post_categories' => array( 'news', 'events' ) ) );
}

// Or... as array of Title
if( function_exists( 'wp_bannerize' ) ) {
  wp_bannerize( array( 'categories' => 'sidebar', 'post_categories' => array( 'News', 'Events' ) ) );
}

// Or... as array of ids
if( function_exists( 'wp_bannerize' ) ) {
  wp_bannerize( array( 'categories' => 'sidebar', 'post_categories' => array( 24, 67 ) ) );
}
`

The code above shows banners only for the posts categories 13 or 14, for the "right_sidebar" banner category.

or in your post:

`[wp_bannerize categories="adv" orderby="random" numbers="3"]`

The default HTML output for above code is:

= Params =

`
 Name              | Default      | Description
 ------------------+--------------+------------------------------------------------
 id                | null         | ID or slug comma separate (default null)
 categories        | []           | Banner categories slug or id (default '')
 post_categories   | []           | Any string, int or array of string, id. (default '')
 order             | "DESC"       | Order "ASC" or "DESC"
 orderby           | "menu_order" | Order by or 'impressions', 'clicks', 'ctr' or 'random'. (default 'menu_order')
 rank_seed         | true         | Set to true to give some chances to the banners to be showed when use Impressions, Click or CTR order by. Set to false to absolute order
 numbers           | 10           | Max numbers of banners (default 10)
 layout            | vertical     | Banners layout, "horizontal" or "vertical"
`
== Installation ==

This section describes how to install the plugin and get it working.

1. Upload the entire content of plugin archive to your `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress (deactivate and reactivate if you're upgrading).
3. Done. Enjoy.

== Frequently Asked Questions ==

= Can I customize the HTML output? =

Yes, below a typical output:

`
<div class="wp_bannerize_banner_box wp_bannerize_category_cocacola"
     data-title="Amiga Ball"
     data-mime_type="imagegif"
     data-impressions_enabled="true"
     data-clicks_enabled="true"
     data-banner_id="241"
     id="wpbanner-241">
    <a href="http://undolog.com">
      <img src="http://wordpress.dev/wp-content/uploads/2016/10/Boing.gif"
           alt="Amiga Ball"
           title="Amiga Ball"
           width="173px"
           height="141px"
           border="0">
     </a>
</div>
`

== Screenshots ==

1. Add new banner by local media library
2. Add new banner text
3. Real time preview
4. Date range rules
5. Enable impressions and click for single banner
6. Banner categories
7. Statistics overview
8. Single report with filters
9. Settings
10. Widget

Your screenshot

== Changelog ==

= 4.0.0 =

* New core framework

== Upgrade Notice ==

= 4.0.0 =
Please download :)