Advertise Here!

This addon provides extended visualization of ads served by SAM Pro (Lite and Free edition). It adds possibility of displaying ads as popup ads, fly-in ads, background ads and corner ads. All single Ad Objects (Ad, Place, Zone) can be used as content of XAds addon.

You can use this addon not only for extended visualization of ads, you can use it also as simple messaging system.

XAds Ad Types

Features

  • Peelback corner ad (javascript)
  • Background ads
  • FlyIn ads
  • Popup ad
  • The ability to triggering of fly-in ads by scroll events
  • The ability to customize the appearance of ad dialog boxes
  • The ability to customize positions of fixed ads dialog boxes
  • Several animation effects of triggering ad dialog boxes

System Requirements

  • PHP 5.3+
  • WordPress 4.1+
  • SAM Pro (Free or Lite) 1.9.9+

Installation

To install this addon you must have a working version of WordPress already installed. Also you must have installed SAM Pro (Free or Lite Edition) version 1.9.9 or later. This addon will work properly only with Free or Lite edition of SAM Pro.

By FTP

  1. Unzip the downloaded sp-xads-pack.X.X.X.XX.zip file in the suitable folder. After that unpack sp-xads.zip archive file.
  2. Log into your hosting space via an FTP software.
  3. Upload the extracted plugin folder (sp-xads) into wp-content/plugins folder on hosting. Correct path after upload will be wp-content/plugins/sp-xads
  4. Activate the installed plugin.

By WordPress

  1. Navigate to Plugins > Add New
  2. Click Upload Plugin button
  3. Select sp-xads.zip file on your computer and click “Install Now
  4. Activate the installed plugin

After activating the plugin, visit the SAM Pro plugin settings page and verify that addon appeared in the list of active addons.

Settings

Addon adds its own options on the SAM Pro plugin settings page. Thus, to configure settings for the addon, go to the SAM Pro plugin settings page.

General Tab

Upgrading Section

one-click-updating

This feature simplifies the process of updating XAds addon. By using this feature there is no more necessity to download install packages and upload them via wp-admin or FTP protocol manually. This way, automatic updates save your time and prevent you from doing boring routine. Thanks to them you are quickly informed about a new version and with just only one click will be your plugin up to date. All important information can be found in Updates section of WordPress Dashboard.

From 1.1.0.11 version you can update the plugin directly from your WordPress blog using Oauth authentication. If you want to use addon under SAM Pro Lite, you should purchase this addon from the same account where you obtained SAM Pro Lite plugin.

OAuth is an authentication protocol that allows users to approve application to act on their behalf without sharing their password. More information can be found at oauth.net or in the excellent Beginner’s Guide to OAuth from Hueniverse.

To enable the plugin update from your blog, you should generate a Personal Token on the site of the Envato API. Paste the generated Personal Token in the “Your Envato Market Personal Token” field and turn on checkbox “Allow upgrading of the plugin using WordPress tools”.
The required permissions for your Personal Token should be:

token-required-permissions

Corner Ad Tab

Corner Ad Section

Enable corner ad – To starting display peel back corner ad you should enable it.

Ad Object – Select necessary Ad Object. For correct display of the corner ad, you should only use a square images as ads.

Width of “Closed” AdThe width of the ads in the inactive phase (semi-closed position). The width of corner ad in the active phase is the width of the ad defined in the Ad Object.

You can enable animation of the corner ad. In other words animated bend of the page corner to the minimal width immediately after page is loaded.

Peel Image – By default is used dark peelback image. You can create and use your own peel back image. If empty, will be used default image.

Background Ads Tab

Background Target Section

Target Background HTML Element – Usually used the body  HTML element, but some premium themes hide the body element under its own div  HTML element. In this case you should define this element here. For example: div.wrapper  or #wrapper . Use standard CSS rules of selectors naming for naming elements in this field.

Left Background Ad Section

You should enable left background ad for using it as background ad.

Ad Object – Select necessary Ad Object for using as background ad. You should select only image ads. Ad, Place and Zone Objects are available for selecting. This Ad Object may be used as the left background ad or as full width background ad.

Right Background Ad Section

You should enable right background ad for using it as background ad.

Ad Object – Select necessary Ad Object for using as background ad. You should select only image ads. Ad, Place and Zone Objects are available for selecting. If this Ad Object is disabled and the Left Ad Object is enabled, the Left Ad Object will be using as full background ad.

FlyIn Ads Tab

All options for all FlyIn Ads are identical excluding Bottom FlyIn Ad.

You should enable FlyIn Ad that you want to be shown on your site. When you enable any fly-in ad, its options will be available for adjusting.

Ad Object – Select necessary Ad Object for using as fly-in ad. All types of Ad Objects are allowed, including an Ad Slider sets of ads.

Delay of Show – The time between triggering event and starting selected animation in milliseconds.

Animation – The type of animation (fade, vertical sliding, horizontal sliding).

Duration of Animation – The time of animation duration in milliseconds.

Background Color – Background color of the FlyIn ad dialog window (RGBA).

Border Color – Border color of the FlyIn ad dialog window (RGBA).

Border Width – Border width of the FlyIn ad dialog window in pixels.

Text Color – Text color of the FlyIn ad dialog window (RGBA). You also can use this option to change color of the close button of the dialog window.

Horizontal Offset – This is offset from the nearest side of screen. For left ads – from left side, for right ads – from right side.

Vertical Offset – This is offset from the nearest side of screen. For top ads – from top side, for bottom ads – from bottom side. For middle ads this option is not available.

Event – The triggering event, in other words, the event that calls procedure of showing of a FlyIn ad dialog window. Select from:

  1. Immediately after page is loaded – this Ad will be triggered immediatelly after page will be loaded.
  2. On scroll down – this Ad will be triggered after visitor starts scrolling down the page.
  3. On scroll down to the middle of page – this Ad will be triggered when visitor scrolls down to the middle of page.
  4. On scroll down to a target element – this Ad will be triggered when visitor scrolls down to the defined element of page. Do not forget to define this element.

Offset – This is the offset from the scroll position. For example: If event is set to “On scroll down” and Offset to 100, the ad will be triggered when a visitor scrolls down the page to 100 pixels from the top position.

Trigger Element – The selector of element which starts procedure of showing ad when a visitor scrolls down the page and reaches this element.

Bottom FlyIn Ad Section

Bottom FlyIn Ad has the same options as other FlyIn ads, but also has two additional options.

Show on mobile devices too… – The screen on mobile device is so small that can’t contain a lot of ads. And so only Bottom FlyIn Ad and Popup Ad are available to display on these devices. If you have other opinion, contact me – there are no problems to allow to display other FlyIn ads on mobile devices.

Overlay Color – The color (RGBA) of layer under the Bottom FlyIn Ad. Usually used semi transparent gray color.

Popup Ad Tab

Popup Ad Section

You should enable Popup Ad that you want to be shown on your site.

Show on mobile devices too… – Just enabling display of this ad on mobile devices.

Ad Object – Select necessary Ad Object for using as popup ad. All types of Ad Objects are allowed, including an Ad Slider sets of ads.

Delay of Show – The time between triggering event and starting fade animation in milliseconds.

Duration of Animation – The time of animation duration in milliseconds.

Background Color – Background color of the popup ad dialog window (RGBA).

Border Color – Border color of the popup ad dialog window (RGBA).

Border Width – Border width of the popup ad dialog window in pixels.

Text Color – Text color of the popup ad dialog window (RGBA). You also can use this option to change color of the close button of the dialog window.

Popup Event – The triggering event, in other words, the event that calls procedure of showing of a popup ad dialog window. Select from:

  1. Immediately after page is loaded – Popup Ad will be triggered immediatelly after page will be loaded.
  2. On scroll down – Popup Ad will be triggered after visitor starts scrolling down the page.
  3. On scroll down to the middle of page – Popup Ad will be triggered when visitor scrolls down to the middle of page.
  4. On scroll down to a target element – Popup Ad will be triggered when visitor scrolls down to the defined element of page. Do not forget to define this element.

Offset – This is the offset from the scroll position. For example: If event is set to “On scroll down” and Offset to 100, the ad will be triggered when a visitor scrolls down the page to 100 pixels from the top position.

Trigger Element – The selector of element which starts procedure of showing ad when a visitor scrolls down the page and reaches this element.

 Purchase XAds addon just for $12

© 2017, minimus. All rights reserved.

Advertise Here!