Skip to content
Enhanced MobFox plugin for Cordova/PhoneGap. Banner, Interstitial and Video Ad. Support many other Ad network with server-side integration.
JavaScript Objective-C Java HTML
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs update doc, optimized ad events, add support to phonegap buld, google… Dec 22, 2014
src update mobfox sdk for android to v6.0.8 Mar 29, 2015
test Update index.html Mar 6, 2017
www first commit, tested on android and ios Oct 3, 2014
.gitignore first commit, tested on android and ios Oct 3, 2014
README.md update doc, optimized ad events, add support to phonegap buld, google… Dec 22, 2014
plugin.xml

README.md

MobFox Plugin Pro

Present MobFox Ads in Mobile App/Games natively from JavaScript.

Highlights:

  • Easy-to-use APIs. Display Ad with single line of Js code.
  • Support Banner, Interstitial Ad, and Video Ad.
  • One plugin supports both Android and iOS platform.
  • Multiple banner size, also support custom size.
  • Fixed and overlapped mode.
  • Auto fit on orientation change.

Compatible with:

  • Cordova CLI, v3.5+
  • Intel XDK and Crosswalk, r1095+
  • IBM Worklight, v6.2+
  • Google Mobile Chrome App
  • Adobe PhoneGap Build, since 2014/12/9

How to use?

  • If use with Cordova CLI:
cordova plugin add com.rjfun.cordova.mobfox
  • If use with PhoneGap Buid, just configure in config.xml:
<gap:plugin name="com.rjfun.cordova.mobfox" source="plugins.cordova.io"/>
  • If use with Intel XDK: Project -> CORDOVA 3.X HYBRID MOBILE APP SETTINGS -> PLUGINS AND PERMISSIONS -> Third-Party Plugins -> Add a Third-Party Plugin -> Get Plugin from the Web, input:
Name: MobFoxPluginPro
Plugin ID: com.rjfun.cordova.mobfox
[x] Plugin is located in the Apache Cordova Plugins Registry

Quick start with cordova CLI

Add the plugin to your cordova project with Cordova CLI:

cordova create <project_folder> com.<company_name>.<app_name> <AppName>
cd <project_folder>
cordova platform add android
cordova platform add ios

cordova plugin add com.rjfun.cordova.mobfox

// copy the demo html file to www
rm -r www/*; cp plugins/com.rjfun.cordova.mobfox/test/index.html www/

// connect device or run in emulator
cordova prepare; cordova run android; cordova run ios;

// or import into Xcode / eclipse

Quick Start Example Code

Step 1: Prepare your Mobfox publisher Id for your app, create it in MobFox website

var ad_units = {
	ios : "publisher_id_for_ios_xxx",
	android : "publisher_id_for_android_xxx"
};

// select the right Ad Id according to platform
var publisherId = ( /(android)/i.test(navigator.userAgent) ) ? ad_units.android : ad_units.ios;

Step 2: Create a banner with single line of javascript

// it will display smart banner at top center, using the default options
if(MobFox) MobFox.createBanner( publisherId );

Or, show the banner Ad in some other way:

// or, show a default banner at bottom
if(MobFox) MobFox.createBanner( {
	adId: publisherId, 
	position:MobFox.AD_POSITION.BOTTOM_CENTER, 
	autoShow:true} );

Step 3: Prepare an interstitial, and show it when needed

// preppare and load ad resource in background, e.g. at begining of game level
if(MobFox) MobFox.prepareInterstitial( {adId:publisherId, autoShow:false} );

// show the interstitial later, e.g. at end of game level
if(MobFox) MobFox.showInterstitial();

Step 4: Prepare an video Ad, and show it when needed

// preppare and load ad resource in background, e.g. at begining of game level
if(MobFox) MobFox.prepareInterstitial( {adId:publisherId, enableVideo:true, autoShow:false} );

// show the interstitial later, e.g. at end of game level
if(MobFox) MobFox.showInterstitial();

Javascript API Overview

Methods:

// set default value for other methods
setOptions(options, success, fail);

// for banner
createBanner(adId/options, success, fail);
removeBanner();
showBanner(position);
showBannerAtXY(x, y);
hideBanner();

// for interstitial
prepareInterstitial(adId/options, success, fail);
showInterstitial();

Detailed Documentation

The APIs, Events and Options are detailed documented.

Read the detailed API Reference Documentation English.

FAQ

If encounter problem when using the plugin, please read the FAQ first.

Full Example Code

This MobFox Plugin Pro offers the most flexibility and many options.

Check the [test/index.html] (https://github.com/floatinghotpot/cordova-mobfox-pro/blob/master/test/index.html).

Screenshots

Banner Interstitial Video
ScreenShot ScreenShot ScreenShot
any size overlap
ScreenShot ScreenShot

Ad PluginPro series for the world leading Mobile Ad services:

More Cordova/PhoneGap plugins by Raymond Xie, find them in plugin registry.

If use in commercial project or need prompt support, please buy a license, you will be served with high priority.

Project outsourcing and consulting service is also available. Please contact us if you have the business needs.

You can’t perform that action at this time.