cordova-plugin-apprate
Version:
This plugin provide the rate this app functionality into your Cordova/Phonegap application<br>
365 lines (358 loc) • 9.84 kB
HTML
<html>
<head>
<meta charset='UTF-8'>
<title>Documentation</title>
<script src='../javascript/application.js'></script>
<script src='../javascript/search.js'></script>
<link rel='stylesheet' href='../stylesheets/application.css' type='text/css'>
</head>
<body>
<div id='base' data-path='../'></div>
<div id='header'>
<div id='menu'>
<a href='../extra/README.md.html' title='../'>
../
</a>
»
<a href='../alphabetical_index.html' title='Index'>
Index
</a>
»
<span class='title'>AppRate</span>
</div>
</div>
<div id='content'>
<h1>
Class:
AppRate
</h1>
<table class='box'>
<tr>
<td>TypeScript defined in:</td>
<td>typescript/AppRate.d.ts</td>
</tr>
<tr>
<td>CoffeeScript defined in:</td>
<td>www_src/AppRate.coffee</td>
</tr>
</table>
<h2>Overview</h2>
<div class='docstring'>
<div class='note'>
<strong>Note:</strong>
All %@ patterns in customLocale object will be automatically replaced to your application title
</div>
<p>AppRate plugin base class</p>
<div class='examples'>
<h3>Examples:</h3>
<h4>
Simple setup and call
</h4>
<pre><code class='coffeescript'>AppRate.preferences.storeAppURL.ios = '<my_app_id>';
AppRate.preferences.storeAppURL.android = 'market://details?id=<package_name>';
AppRate.promptForRating();</code></pre>
<h4>
Call rate dialog immediately
</h4>
<pre><code class='coffeescript'>AppRate.preferences.storeAppURL.ios = '<my_app_id>';
AppRate.promptForRating(true);</code></pre>
<h4>
Override dialog button callback
</h4>
<pre><code class='coffeescript'>var onButtonClicked = function(buttonIndex) {
console.log("onButtonClicked -> " + buttonIndex);
};
AppRate.preferences.storeAppURL.ios = '<my_app_id>';
AppRate.preferences.storeAppURL.android = 'market://details?id=<package_name>';
AppRate.preferences.callbacks.onButtonClicked = onButtonClicked;
AppRate.promptForRating();</code></pre>
<h4>
Set custom language
</h4>
<pre><code class='coffeescript'>AppRate.preferences.useLanguage = 'ru';
AppRate.preferences.storeAppURL.ios = '<my_app_id>';
AppRate.preferences.storeAppURL.android = 'market://details?id=<package_name>';
AppRate.promptForRating();</code></pre>
<h4>
Set custom Locale object
</h4>
<pre><code class='coffeescript'>var customLocale = {};
customLocale.title = "Rate %@";
customLocale.message = "If you enjoy using %@, would you mind taking a moment to rate it? It won’t take more than a minute. Thanks for your support!";
customLocale.cancelButtonLabel = "No, Thanks";
customLocale.laterButtonLabel = "Remind Me Later";
customLocale.rateButtonLabel = "Rate It Now";
AppRate.preferences.storeAppURL.ios = '<my_app_id>';
AppRate.preferences.storeAppURL.android = 'market://details?id=<package_name>';
AppRate.preferences.customLocale = customLocale;
AppRate.promptForRating();</code></pre>
<h4>
Full setup
</h4>
<pre><code class='coffeescript'>var customLocale = {};
customLocale.title = "Rate %@";
customLocale.message = "If you enjoy using %@, would you mind taking a moment to rate it? It won’t take more than a minute. Thanks for your support!";
customLocale.cancelButtonLabel = "No, Thanks";
customLocale.laterButtonLabel = "Remind Me Later";
customLocale.rateButtonLabel = "Rate It Now";
AppRate.preferences.storeAppURL.ios = '<my_app_id>';
AppRate.preferences.openStoreInApp = true;
AppRate.preferences.storeAppURL.android = 'market://details?id=<package_name>';
AppRate.preferences.customLocale = customLocale;
AppRate.preferences.displayAppName = 'My custom app title';
AppRate.preferences.usesUntilPrompt = 5;
AppRate.preferences.promptAgainForEachNewVersion = false;
AppRate.promptForRating();</code></pre>
<h4>
Callbacks setup and use custom rate-dialog
</h4>
<pre><code class='coffeescript'>var onRateDialogShow = function(callback) {
console.log("onRateDialogShow");
// call this callback when user click on button into your custom rate-dialog
// for example: simulate click on "Rate now" button and display store
callback(3)
};
var onButtonClicked = function(buttonIndex) {
console.log("onButtonClicked -> " + buttonIndex);
};
AppRate.preferences.storeAppURL.ios = '<my_app_id>';
AppRate.preferences.useCustomRateDialog = true;
AppRate.preferences.callbacks.onRateDialogShow = onRateDialogShow;
AppRate.preferences.callbacks.onButtonClicked = onButtonClicked;
// True param show rate-dialog immediately and useful for testing or custom logic
AppRate.promptForRating(true);</code></pre>
</div>
</div>
<div class='tags'>
</div>
<h2>Variables Summary</h2>
<dl class='constants'>
<dt id='locales-variable'>
locales
=
</dt>
<dd>
<pre><code class='coffeescript'>Locales</code></pre>
</dd>
<dt id='preferences-variable'>
preferences
=
</dt>
<dd>
<pre><code class='coffeescript'>{
useLanguage: null,
displayAppName: '',
promptAgainForEachNewVersion: true,
usesUntilPrompt: 3,
openStoreInApp: false,
useCustomRateDialog: false,
callbacks: {
onButtonClicked: null,
onRateDialogShow: null
},
storeAppURL: {
ios: null,
android: null,
blackberry: null,
windows8: null
},
customLocale: null
}</code></pre>
</dd>
</dl>
<h2>Class Method Summary</h2>
<ul class='summary'>
<li>
<span class='signature'>
<a href='#init-static'>
.
(AppRate)
<b>init</b><span>()</span>
</a>
</span>
<span class='desc'>
Initialize
</span>
</li>
<li>
<span class='signature'>
<a href='#promptForRating-static'>
.
(AppRate)
<b>promptForRating</b><span>(immediately = false)</span>
</a>
</span>
<span class='desc'>
Check plugin preferences and display or not display rate popup
</span>
</li>
<li>
<span class='signature'>
<a href='#navigateToAppStore-static'>
.
(AppRate)
<b>navigateToAppStore</b><span>()</span>
</a>
</span>
<span class='desc'>
Open application page in store
</span>
</li>
</ul>
<h2>Class Method Details</h2>
<div class='methods'>
<div class='method_details'>
<p class='signature' id='init-static'>
.
(AppRate)
<b>init</b><span>()</span>
<br>
</p>
<div class='docstring'>
<p>Initialize</p>
</div>
<div class='tags'>
<h3>Returns:</h3>
<ul class='return'>
<li>
<span class='type'></span>
<tt><a href='../class/AppRate.html'>AppRate</a></tt>
</li>
</ul>
</div>
</div>
<div class='method_details'>
<p class='signature' id='promptForRating-static'>
.
(AppRate)
<b>promptForRating</b><span>(immediately = false)</span>
<br>
</p>
<div class='docstring'>
<p>Check plugin preferences and display or not display rate popup</p>
<div class='examples'>
<h3>Examples:</h3>
<h4>
</h4>
<pre><code class='coffeescript'>AppRate.promptForRating();</code></pre>
</div>
</div>
<div class='tags'>
<h3>Parameters:</h3>
<ul class='param'>
<li>
<span class='name'>immediately</span>
<span class='type'>
(
<tt>Boolean</tt>
)
</span>
—
<span class='desc'>open rate dialog immediately </span>
</li>
</ul>
<h3>Returns:</h3>
<ul class='return'>
<li>
<span class='type'></span>
<tt><a href='../class/AppRate.html'>AppRate</a></tt>
</li>
</ul>
</div>
</div>
<div class='method_details'>
<p class='signature' id='navigateToAppStore-static'>
.
(AppRate)
<b>navigateToAppStore</b><span>()</span>
<br>
</p>
<div class='docstring'>
<p>Open application page in store</p>
</div>
<div class='tags'>
<h3>Returns:</h3>
<ul class='return'>
<li>
<span class='type'></span>
<tt><a href='../class/AppRate.html'>AppRate</a></tt>
</li>
</ul>
</div>
</div>
</div>
</div>
<div id='footer'>
February 07, 15 14:33:53 by
<a href='https://github.com/coffeedoc/codo' title='CoffeeScript API documentation generator'>
Codo
</a>
2.0.9
✲
Press H to see the keyboard shortcuts
✲
<a href='http://twitter.com/netzpirat' target='_parent'>@netzpirat</a>
✲
<a href='http://twitter.com/_inossidabile' target='_parent'>@_inossidabile</a>
</div>
<iframe id='search_frame'></iframe>
<div id='fuzzySearch'>
<input type='text'>
<ol></ol>
</div>
<div id='help'>
<p>
Quickly fuzzy find classes, mixins, methods, file:
</p>
<ul>
<li>
<span>T</span>
Open fuzzy finder dialog
</li>
</ul>
<p>
Control the navigation frame:
</p>
<ul>
<li>
<span>L</span>
Toggle list view
</li>
<li>
<span>C</span>
Show class list
</li>
<li>
<span>I</span>
Show mixin list
</li>
<li>
<span>F</span>
Show file list
</li>
<li>
<span>M</span>
Show method list
</li>
<li>
<span>E</span>
Show extras list
</li>
</ul>
<p>
You can focus and blur the search input:
</p>
<ul>
<li>
<span>S</span>
Focus search input
</li>
<li>
<span>Esc</span>
Blur search input
</li>
</ul>
</div>
</body>
</html>