安装

Add the Plugin to your Website

1. Download and Unzip https://downloads.wordpress.org/plugin/custom-banners.zip
2. Upload the contents of ‘/custom-banners/’ to the ‘/wp-content/plugins/’ directory
3. Activate Custom Banners through the ‘Plugins’ menu in WordPress

This section describes how to use the plugin on your website.

Adding a New Banner

Adding a New Banner is easy! There are 3 ways to start adding a new banner

How to Add a New Banner

1. Click on “+ New” -> Banner, from the Admin Bar or
2. Click on “Add New Banner” from the Menu Bar in the WordPress Admin or
3. Click on “Add New Banner” from the top of the list of Banners, if you’re viewing them all.

New Banner Content

You have a few things to pay attention to:

• Banner Title: this is for internal reference.
• Banner Body: this is the content of your Banner. This will be output in the Call to Action bar.
• Target URL: where a user should be sent when they click on the banner or the call to action button.
• Call To Action Text: the “Call To Action” (text) of the button. Leave this field blank to hide the call to action button.
• CSS Class: any extra CSS classes that you would like applied to this banner.
• Featured Image: this image is shown as the banner.

Editing a Banner

This is as easy as adding a New Banner!

1. Click on “Banners” in the Admin Menu.
2. Hover over the Banner you want to Edit and click “Edit”.
3. Change the fields to the desired content and click “Update”.

Deleting a Banner

This is as easy as adding a New Banner!

1. Click on “Banners” in the Admin Menu.
2. Hover over the Banner you want to Delete and click “Delete”. You can also change the Status of a Banner, if you want to keep it on file.

Outputting Banners

• To output a Random Banner, place the shortcode [banner count="1"] in the desired area of the Page or Post Content.
• To output a specific Banner, place the shortcode [banner id="123"] in the desired area of the Page or Post Content.
• To output a Random Banner from a Specific Group, place the shortcode [banner count="1" group="test"] in the desired area of the Page or Post Content.
• To control the postion of the Caption, use the attribute caption_position=”left”. Acceptable values are left, right, top, bottom. For example, [banner caption_positon="left"].
• To use an image tag, instead of background image, for the banner, add the attribute use_image_tag=”true” to your banner shortcode. For example, [banner use_image_tag="true"].

Outputting Fading or Sliding Banners

• To output Random Banners from a Specific Group, place the shortcode [banner group="test" count="3" transition="scrollHorz" timer="2000"] in the desired area of the Page or Post Content. Change the value of count from 3 to however many slides you want to use. For transition, use either “scrollHorz” or “fade”. For timer, use 1000 times the number of seconds you want between transitions (ie, for 4 seconds input 4000.)
• To output Random Banners, place the shortcode [banner count="3" transition="scrollHorz" timer="2000"] in the desired area of the Page or Post Content. Change the value of count from 3 to however many slides you want to use. For transition, use either “scrollHorz” or “fade”. For timer, use 1000 times the number of seconds you want between transitions (ie, for 4 seconds input 4000.)
• Free Transitions include scrollHorz,fade
• To Show Pager Icons below your Banner, use the attribute pager="true" or pager="1". On the Widget, check the box next to Show Pager Icons.
• To have the Slideshow Pause on Hover, use the attribute pause_on_hover=true. Defaults to false.
• NOTE: Advanced Transitions are Included in the Pro version of Custom Banners
• LIVE Examples are available here
• Supported Advanced Transitions are scrollVert,flipHorz,flipVert, and tileSlide.