A phonegap plugin for getting and setting native preferences.
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 47 commits ahead of macdonst:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
LICENSE
README.md
plugin.xml

README.md

Application Preferences plugin for Phonegap

Originally by Simon MacDonald (@macdonst), ported to plugman and some other cleanup by Dan Moore (@mooreds). Dan Moore also pulled in the iOS code, written by Tue Topholm / Sugee

Information on writing plugins for PhoneGap 2.0 was taken from this blog by Simon MacDonald (@macdonst)

This code only supports Phonegap/Cordova 2.9. If you want to have support for 3.0 or greater, check out this repository.

Install

This plugin uses plugman

cordova plugins add https://github.com/8zrealestate/AppPreferences

Using the plugin

There will be a window.applicationPreferences object defined after the plugin is installed.

The applicationPreferences object created above will be used in the following examples.

get

In order to get the value a property you would call the get method.

/**
  * Get the value of the named property.
  *
  * @param key           
  */
get(key, success, fail)

Sample use:

window.applicationPreferences.get("myKey", function(value) {
		alert("Value is " + value);
	}, function(error) {
		alert("Error! " + JSON.stringify(error));
});

set

In order to set the value a property you would call the set method.

/**
  * Set the value of the named property.
  *
  * @param key
  * @param value           
  */
set(key, value, success, fail)

Sample use:

window.applicationPreferences.set("myKey", "myValue", function() {
		alert("Successfully saved!");
	}, function(error) {
		alert("Error! " + JSON.stringify(error));
});