Code Monkey home page Code Monkey logo

cordova-plugin-revmob's Introduction

RevMob Plugin For Cordova

Adds support for RevMob Ads to your Cordova and Phonegap based mobile apps. I created this because the official Phonegap/Cordova SDK from RevMob is let's say lacking and requires too many manual steps.

How do I install it?

If you're like me and using Cordova CLI:

cordova plugin add cordova-plugin-revmob

or

phonegap local plugin add cordova-plugin-revmob

TODO: add manual installation steps

WARNING: iOS Cordova Registry

Installing this plugin directly from Cordova Registry results in Xcode using a broken RevMobAds.framework, this is because the current publish procedure to NPM breaks symlinks CB-6092. Please install the plugin through through the github url or re-add the RevMobAds.framework manually.

How do I use it?

document.addEventListener('deviceready', function() {

	window.revmob = new RevMob();

	// get things started by passing in your app id
	revmob.init('<your app id>', function() {
		console.log('super dope it worked');
	}, function(err) {
		console.error(['oh crap', err]);
	});

	// show a banner at the top the screen and resize the webview to make space for it
	revmob.showBannerAd(true, true, function() {
		console.log('oh snap I got a banner at the top');
	}, function(err) {
		console.error(['oh crap', err]);
	});

	// show a banner at the bottom of the screen and overlay the webview.  overlaying is useful if the space the banner has already been accounted for
	revmob.showBannerAd(false, false, function() {
		console.log('what what see the banner at the bottom');
	}, function(err) {
		console.error(['oh crap', err]);
	});

	// hide the banner but the keep the where it was occupied
	revmob.hideBannerAd(false, function() {
		console.log('now you see me now you do not');
	}, function(err) {
		console.error(['oh crap', err]);
	});

	// hide the banner and release the space that it occupied
	revmob.hideBannerAd(true, function() {
		console.log('now you see me now you do not');
	}, function(err) {
		console.error(['oh crap', err]);
	});

	// make space at the top of the screen for a banner that will be displayed later
	// this will resize the webview
    revmob.claimBannerAdSpace(true);

	// make space at the bottom of the screen for a banenr that will be displayed later.
	// if not argument is passed it will default to making the space at the bottom
	revmob.claimBannerAdSpace(false);

    // release the space occupied the banner
    revmob.releaseBannerAdSpace();

	// show an interstitial
	revmob.showInterstitialAd(function() {
		console.log('now that is a big ole interstitial');
	}, function(err) {
		console.error(['oh crap', err]);
	});

	// show a popup ad
	revmob.showPopupAd(function() {
		console.log('pop!');
	}, function(err) {
		console.error(['oh crap', err]);
	});

	// open an ad link (useful if want to tightly integrate ads into your UI)
	revmob.openAdLink(function() {
		console.log('we ya link bredren');
	}, function(err) {
		console.error(['oh crap', err]);
	});

	// enable test mode with ads (defaults to true if no argument is passed)
	revmob.enableTestMode(true);

	// enable test mode without ads
	revmob.enableTestMode(false);

	// enable test mode without ads
	revmob.disableTestMode();

	// change the time to wait for an add to be served (value is in seconds)
	revmob.setConnectionTimeout(90);

	// spit out a bunch data about the environment
	revmob.printEnvironmentInformation();

}, false);

For a full working example see the demo project.

Enjoy!

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.