This is an open web app, targetted at Firefox OS and tested initially on the Geeksphone Peak, that enables simple checking to nearby locations on Foursquare.
It does not attempt to be a complete Foursquare application: you can't enter new venues, you can't "explore" or see where your friends are. You can checkin. That's it.
I wrote it for two reasons: I wanted to be able to simply and easily checkin from my Firefox OS phone, and I wanted to learn more, and document for others, how to do OAuth2 authentication via JavaScript, without needing any server proxies or other shims.
To install from Firefox Marketplace:
The Marketplace version is out of date because Firefox OS only allows "certified" apps permission to obtain the data necessary to establish location from Mozilla Location Services, and regular everyday people like me can't submit certified apps to the Marketplace.
To install from source, which doesn't have these limitations:
- Connect your device via USB to a computer running Firefox and the Firefox OS Simulator or Firefox App Manager
- Clone the repository to your local machine.
- From the Firefox OS Simulator or App Manager, push the app to your device.
On first run the "Settings" screen will open. Switch "Enable Foursquare" to "On" and (as long as you're online somehow) you'll be prompted to authenticate to Foursquare and give the app permission to communicate to Foursquare on your behalf.
You also have the option of having the app asking you for confirmation of each checkin (which prevents accidental checkins if your device is extra-sensitive to touch).
Under "How to Find Device Location?" select either:
- "Use GPS" (which is more accurate, but as the GPS can take time to establish a lock, can be slower)
- "Use Mozilla Location Services" or "Use OpenCellID.org" (which are less accurate, may have poor coverage for your area, but can be much faster than GPS and have less impact on battery life).
When you return to the main screen, the app will establish your location and you'll be shown a list of nearby Foursquare venues; to checkin, just tap a venue, and optionally confirm your checkin. That's it.
- Handle failure of Foursquare authorization or updates more elegantly (or, indeed, at all).
- Handle failure of OpenCellID.org authorization elegantly
-
- Allow creating new venues (that's about the only new feature I want to add).
- jQuery
- jQuery Mobile
- Olle Jonsson provided Swedish and Danish localizations.
- Peter Bihr provided German localization.
- Pedro Custódio provided Portuguese localization.
- Mikko Pervilä provided Finnish localization.
