Switch branches/tags
Nothing to show
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
..
Failed to load latest commit information.
www
LICENSE
README.md
config.xml

README.md

Foursquare Cards

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

Applies To

Author(s)

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

Contributing

Screenshots

image

Using The Sample

####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);
	}
);

Required Plugins

####The following Cordova Plugins are required for this sample:####

com.blackberry.invoke
com.blackberry.invoke.card
com.blackberry.ui.toast

How to Build

  1. Clone this repo to your local machine.

  2. Ensure the BlackBerry 10 WebWorks SDK 2.0 is correctly installed.

  3. Open a command prompt (windows) or terminal (mac) and run the following command:

    webworks create <your source folder>\Foursquare-Cards
    
  4. Replace the default Foursquare-Cards\www folder with the \www folder from this project

  5. Replace the default Foursquare-Cards\config.xml with the config.xml from this project

  6. From the command prompt (Windows) or terminal (mac), navigate to the Foursquare-Cards folder

    cd <your source folder>\Foursquare-Cards
    
  7. Run the following commands to configure plugins used by this app

     webworks plugin add com.blackberry.invoke
     webworks plugin add com.blackberry.invoke.card
     webworks plugin add com.blackberry.ui.toast	
    
  8. Run the following command to build and deploy the app to a device connected via USB

    webworks run
    

More Info

Contributing Changes

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

Bug Reporting and Feature Requests

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

Disclaimer

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.