WP Bannerize Pro is the new version of WP Bannerize. It is an easy to use adv image manager with html and free text support.
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.8.0
In order to continue 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
HOW TO
You can display the banners by shortcodes, PHP functions or Widgets.
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 example:
[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 desktop 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 shortcode, 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 shortcode, 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 example:
[wp_bannerize_pro_geo city="rome"] <h3>You're from Rome</h3> [wp_bannerize_pro id="1678"] [/wp_bannerize_pro_geo]
The above shortcode, 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"]
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:
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"
This section describes how to install the plugin and get it working.
/wp-content/plugins/
directory.Currently you can’t change th HTML but you may set your own CSS styled by following the HTML markyp below:
<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>
The most important thing here is the wp_bannerize_banner_box
class.
This is the main class that will be used to style the banner.
For example, if you want to set the border of the images, you may use:
.wp_bannerize_banner_box img { border-radius: 16px; }
As you can see, you may use the wp_bannerize_category_cocacola
as well to styled a specific banner category. Or you may use the id
to style a specific banner.
In addition, you may use the data-*
attributes to set the banner properties.
Below, we will add the border radius just for GIF images:
.wp_bannerize_banner_box[data-mime_type=imagegif] img { border-radius: 16px; }