This sample demonstrates how an application can integrate with the available Foursquare Cards in a BlackBerry WebWorks application for BlackBerry 10.

Applies To

• Foursquare
• Invocation Framework
• BlackBerry 10 WebWorks SDK

Author(s)

• Chad Tetreault

Dependencies

1. bbUI.js is licensed under the Apache 2.0 license.
2. Built for BlackBerry Boilerplate is licensed under the Apache 2.0 license.

Icons

• The Liz Myers Icon set is licensed under the CC-BY-3.0 license.

Contributing

• To contribute code to this repository you must be signed up as an official contributor.

####Single Sign-On

var request = {
	target: "com.foursquare.blackberry.sso.card",
	action: "bb.action.VIEW",
	type: "sso/foursquare",
	data: "L4CURGRJ0JCCVA0QJ1Y5JI052HMZI0MSQIQMVTMX1JTN43L2"
};

####Venue Search

var request = {
	target: "com.foursquare.blackberry.venuesearch.card",
	action: "bb.action.VIEW",
	type: "venuesearch/foursquare",
	uri: "foursquare://venues/search?oauth_token=" + accessToken,
};

####Explore

var request = {
	target: "com.foursquare.blackberry.uri",
	action: "bb.action.OPEN",
	uri: "foursquare://venues/explore"
};	

####User Profile

var request = {
	target: "com.foursquare.blackberry.uri",
	action: "bb.action.OPEN",
	uri: "foursquare://users/self/update"
};

####Friend Requests

var request = {
	target: "com.foursquare.blackberry.uri",
	action: "bb.action.OPEN",
	uri: "foursquare://users/requests"
};

####Friend Suggestions

var request = {
	target: "com.foursquare.blackberry.uri",
	action: "bb.action.OPEN",
	uri: "foursquare://users/suggest?type=friend"
};

####Page Suggestions

var request = {
	target: "com.foursquare.blackberry.uri",
	action: "bb.action.OPEN",
	uri: "foursquare://users/suggest?type=page"
};

####Add Friends

var request = {
	target: "com.foursquare.blackberry.uri",
	action: "bb.action.OPEN",
	uri: "foursquare://users/addfriends?from=phonebook"
};

####Checkin

var request = {
	target: "com.foursquare.blackberry.uri",
	action: "bb.action.OPEN",
	uri: "foursquare://checkins/50a08609e4b04c46ea54446d"
};

####How to call the invocation request

blackberry.invoke.invoke(
	request,

	// success
	function() {
		console.log('success');
	},

	// error
	function(e) {
		console.log(e);
	}
);

The following must be whitelisted in the config.xml file

<feature id="blackberry.invoke" />
<feature id="blackberry.invoke.card" />

1. Clone the repo to your local machine
2. Use Using the Ripple Mobile Emulator and the BlackBerry 10 WebWorks SDK, package the contents of your local BB10-WebWorks-Samples/Boilerplate-bbUI.js-0.9x folder into a BlackBerry application.

• BlackBerry HTML5 WebWorks - Downloads, Getting Started guides, samples, code signing keys.
• BlackBerry WebWorks Development Guides
• BlackBerry WebWorks Community Forums
• BlackBerry Open Source WebWorks Contributions Forums

Please see the README of the BB10-WebWorks-Samples repository for instructions on how to add new Samples or make modifications to existing Samples.

If you find a bug in a Sample, or have an enhancement request, simply file an Issue for the Sample.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.