Documentation

Banner Ad Advertising Manager WordPress Plugin

Ad Banners 2017-12-06T13:15:28+00:00

Ad Banners

An ad banner represents a single advertising banner, normally formed of an image hyperlinked to a specific web address. The plugin allows each ad banner can be scheduled to be displayed between specific dates and at specific times of the week. The plugin also stores statistics regarding an ad banner’s impressions and clicks† and also provides information regarding click through ratios (CTR).

† Click events are only stored for image ad banners.

Ad Banners list page

The ad banners list page, accessed within the WordPress admin area by clicking “Ad Manager” menu item, or its “Ad Banners” sub-item, is where all existing ad banners are displayed, along with overview information on them. This information includes:

  • Name of the ad banner
  • Current status of the ad banner
  • Shortcode & PHP Code used for placing the ad banner within the site
  • Performance (Impressions, clicks, CTRs) for the previous 7 days
  • Performance for the previous 30 days
  • Performance for the previous year

Creating and managing Ad Banners

The creation and management of ad banners is designed to be very similar to how you create and manage normal WordPress posts and pages. Once on the list page, you can:

  • Create a new ad banner by clicking “Add New Ad Banner”
  • Make changes to an existing ad banner by hovering over it and clicking “Edit”
  • Delete an existing ad banner by hovering over it and clicking “Bin”

Ad Banner details

Once you start a new ad banner or edit an existing one, you will be presented with an edit screen that allows you to set up the banner’s details.

The fields you will be presented with are as follows:

Title

The title of the ad banner is purely for labelling and does not affect its operation. It is recommended that this is set to a value that is meaningful and will allow the banner to be identified at a glance. If you leave this blank, the system will assign a unique name for you based on the banner’s internal ID (e.g. “Ad Banner 345”).

Enabled

This setting should be “on” for normal operation. Switching it off allows you to disable an ad banner. This is useful if you do not necessarily wish to delete (bin) the banner, but wish to temporarily (or indefinitely) stop it from being displayed.

Banner type

This setting gives you the option to choose the type of banner ad. Options are:

  • Local image (from media library)
  • Remote image or with image URL
  • HTML/JavaScript code

Each option opens the relevant settings for that banner type.

Local image (from media library)

This option uses an image from your WordPress media library as the image and allows you to hyperlink it to the web address of your choice.

You are presented with the following:

  • Banner image
    Clicking the “Set Image” button will allow you to select an image from your WordPress media library (or if necessary, upload one to your media library).
  • Link URL
    The full web address where the image is to hyperlink to (including any “http://”).
  • Open link in new window
    Checking this setting will open the link in a new browser window. Unchecking it will cause the link in the same browser window as the page the banner appears on.
  • Shrink banner to fit containing area
    Where the image is too large to fit in the containing area (e.g. if it is too wide for the page or the sidebar), checking this option will cause it to be shrunk to fit in the available area.
  • Mark link as “NOFOLLOW”
    Advisable for search engine optimisation, this option will add a “nofollow” attribute (behind the scenes HTML), instructing search engine robots not to follow the link.
  • Alignment
    This setting will determine the banner’s display alignment – for example, if you wish the surrounding text and content to wrap around the banner. Please note that wrapping will depend on the block of content directly below the banner – where the block has a fixed width that does not allow enough room for the banner or where it is set to clear floating content, wrapping will not occur.

Remote image or with image URL

This option is very similar to the local image option, except the image is referenced by its web address as opposed to selection from the media library. This is useful when the image is not hosted on your WordPress website, but elsewhere on the web.

You are presented with the following:

  • Banner image URL
    The full web address of the image (including any “http://”).
  • Link URL
    As with Local Image option.
  • Open link in new window
    As with Local Image option.
  • Shrink banner to fit containing area
    As with Local Image option.
  • Mark link as “NOFOLLOW”
    As with Local Image option.
  • Alignment
    As with Local Image option.­­­­­

HTML/JavaScript code

This option is to be used when you are provided with HTML or JavaScript banner code from a third party, for example Google AdSense or other advertising networks.

You are presented with the following:

  • HTML/JavaScript code
    This text box is where you can copy and paste the code for the banner.
  • Alignment
    As with Local Image option.

Campaign Dates

This setting allows you to set up a continuous campaign or one with specific start and (if required) end dates.

Selecting “No start/end dates” will cause the campaign to run straight away and continue indefinitely.

Selecting “Specify dates” will present a calendar for specifying the start date and a further option for setting up an end date if required.

Selecting “No end date” will cause the campaign to continue indefinitely. Selecting “Specify end date” will present a calendar for specifying the end date.

Note that the end date is inclusive. For example, setting an end date of 30th September will cause the campaign to run until midnight† 30th September.

† Times are based on the time zone set up in your website’s WordPress “General Settings”.

Weekly Schedule

This setting allows you to set up a weekly schedule for displaying the ad banner.

Selecting “Run at all times” will cause the ad banner to display continuously.

Selecting “Run to weekly schedule” will present a daily breakdown of the week.

To run the ad banner on specific days of the week (e.g. 9:00am to 6:00pm, Monday to Friday), check the relevant days and use the sliders to change the start and end times for each day.

Saving the Ad Banner

Once you have set up or edited the ad banner, the new settings will need to be saved. This can be done by clicking the “Save” button.

Errors with Ad Banner settings

If there are errors with an ad banner’s settings that will cause it not to display, this will be indicated once you save it.

This will also be indicated in the ad banners list page in the specific banner’s status column.

Placing Ad Banners on the site

Ad banners may be placed anywhere on your WordPress website by three main means: using shortcodes, using widgets or using PHP.

Using shortcodes

A “shortcode” is a small piece of text that looks like:

[ls-abm-banner id="526"]

When placed in the body of a post or page content, this instructs WordPress to display an ad banner (in the above example ad banner with unique ID 526) in place of the shortcode.

The shortcode for each ad banner may be found in two places: the first is on the ad banners list page and the other is on the ad banner edit page.

Using widgets

The plugin provides a widget for placing ad banners within sidebars and other widgetised areas. This can be accessed from the WordPress “Widgets” menu sub-item under the main “Appearance” menu item.

To place a specific banner on a sidebar, just drag the “Loomisoft Ad Banner” item to the relevant sidebar and drop it in place.

When it is in place, select the relevant banner from the drop down and click save.

Using PHP

For programmers and developers who want to make changes to the PHP script within their theme files, the plugin provides the function “ls_abm_banner”, which can be invoked in the following manner:

<?php echo ls_abm_banner( 187 ); ?>

In this example, “187” is the unique ID for the specific ad banner.

The PHP code for each ad banner may be found in two places: the first is on the ad banners list page and the other is on the ad banner edit page.