WP Bannerize Pro

Description

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

Important updates in 1.6.5

In order to continur to use the Geolocalization feature, you need to create a API KEY from IPStack service.
The API Key is free but you need to register in order to get it.

Once you have the API KEY, you can set it in the plugin settings.

FEATURES

• Manage your banner as Custom Post Types for image, HTML/Javascript and free text
• Create your banner categories
• Sort your banners 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)
• Geolocalization support (by IPStack)
• Analytics reports

HOW TO

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

Shortcode

From v1.4.0 you can use the a new shortcode and a news attribute to display banners only for mobile or desktop.
Let’s see some exmaple:

[wp_bannerize_pro mobile="1" id="1678"]

The banner with id 1768 will be displayed only on mobile device.

[wp_bannerize_pro desktop="1" id="1678"]

The banner with id 1768 will be displayed only on desltop device.
Of course, you may need to display more info. In this case yoy can use the new shortcode to wrap any contents.

[wp_bannerize_pro_mobile]
  <h3>You're from mobile</h3>
  [wp_bannerize_pro id="1678"]
[/wp_bannerize_pro_mobile]

The above shortcodes, will display the banner with id 1678 only for mobile device.

[wp_bannerize_pro_desktop]
  <h3>You're from desktop</h3>
  [wp_bannerize_pro id="1678"]
[/wp_bannerize_pro_desktop]

The above shortcodes, will display the banner with id 1678 only for desktop device.

Of course, you may also

From v1.1.0 you can use the new shortcode to display geo localized banners.

! Remember to get your own API KEY from IPStack service.

Let’s see some exmaple:

[wp_bannerize_pro_geo city="rome"]
  <h3>You're from Rome</h3>
  [wp_bannerize_pro id="1678"]
[/wp_bannerize_pro_geo]

The above shortcodes, will display the banner with id 1678 only for visitors from Rome.

Let’s see more sample.

[wp_bannerize_pro_geo city="Rome"]
  Only for Rome
[/wp_bannerize_pro_geo]

[wp_bannerize_pro_geo city="rome"]
  Only for Rome
[/wp_bannerize_pro_geo]

[wp_bannerize_pro_geo city="rome,london"]
  Only for Rome and Landon
[/wp_bannerize_pro_geo]

[wp_bannerize_pro_geo region_name="lazio"]
  Only for region (Italy) Lazio
[/wp_bannerize_pro_geo]

[wp_bannerize_pro_geo country_code="IT"]
  Italian only
[/wp_bannerize_pro_geo]

[wp_bannerize_pro_geo country_name="italy"]
  Italian only
[/wp_bannerize_pro_geo]

[wp_bannerize_pro_geo zip_code="00137"]
  Wow
[/wp_bannerize_pro_geo]

[wp_bannerize_pro_geo ip="80.182.82.82"]
  Only for me
[/wp_bannerize_pro_geo]

[wp_bannerize_pro_geo time_zone="europe/rome"]
  Rome/Berlin time zone
[/wp_bannerize_pro_geo]

Also, have a look to the new widget UI with geo-localization settings.

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

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

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

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

PHP Function

You may use either wp_bannerize_pro() or get_wp_bannerize_pro() to display your banner. The main difference between them is that get_wp_bannerize_pro() return the HTML output for the banner, for example:

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

By using get_wp_bannerize_pro() you should add echo function to display the output:

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

More example below.

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

// Display a set of banners by a comma separated string
if( function_exists( 'wp_bannerize_pro' ) ) {
  wp_bannerize_pro( array( 'id' => '156,157,158' ) );
}

// Display a set of banners by an array
if( function_exists( 'wp_bannerize_pro' ) ) {
  wp_bannerize_pro( array( 'id' => array( 156, 157, 158 ) ) );
}

// Display a set of banners by mixed id and slug
if( function_exists( 'wp_bannerize_pro' ) ) {
  wp_bannerize_pro( array( 'id' => array( 156, 'my-banner-slug', 158 ) ) );
}

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

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

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

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

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

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

// Display a set of banners only for mobile device
if( function_exists( 'wp_bannerize_pro' ) ) {
  wp_bannerize_pro( [ 'mobile' => true, 'id' => [156,157,158] ] );
}

// Display a set of banners only for desktop device
if( function_exists( 'wp_bannerize_pro' ) ) {
  wp_bannerize_pro( [ 'desktop' => true, 'id' => [156,157,158] ] );
}

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_pro 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"