=== FourSquareAPI === Contributors: nzguru Donate link: http://nzguru.net/foursquareapi-plugin-for-wordpress Tags: foursquare,checkin,badges,widget,sidebar,api,social,google map,four square,social media,venue,location,4SQ,mayors,mayorships,recent,checkins,latest Requires at least: 2.7 Tested up to: 3.2.1 Stable tag: 1.4.1 The 1st plugin to integrate the foursquare® API into Wordpress to show your checkins and badges == Description == This plugin uses the foursquare® API to retrieve your recent check-ins, badges, and/or mayorships to display them in a widget or directly in posts and pages with a variety of display options. You can * display the check-in timestamp * display the venues icon image and mayorships * display the venues stats * display your check-ins/badges/mayorships on a Google map * display the badge description The map is my favorite feature. Venue icons or badges will be placed on the map and, if selected, on your list of checked in venues or achieved badges. Clicking an icon from the list will move the map to that venue. == Installation == You can either install it automatically from the WordPress admin, or do it manually: 1. Download the plugin from the wordpress.org site 2. Either: a. Unzip the archive and upload the foursquareapi folder to your plugins folder: 'wp-content/plugins/' or b. Upload the archive from your Plugins admin panel 3. Activate the 'FourSquareAPI' plugin from your Plugins admin panel. 4. Go to the Settings -> FourSquareAPI admin panel and follow the instructions to connect with foursquare®. == Frequently Asked Questions == = What is foursquare®? = foursquare® is a mobile application that is a cross between a friend-finder, a social city-guide, and a game that encourages users to explore their neighborhoods and rewards them for doing so. = What is the foursquare® API? = API stands for "application programming interface." APIs facilitate interaction between different software programs by making it easy for them to share data and resources. = What about the foursquare® API limits? = foursquare® has a very generous 500 requests/hour limit but that doesn't mean we should just plow through it all. This plugin allows you to specify a cache time which will limit your requests to, for example, 1 per minute regardless of the number of visitors to your site. == Screenshots == 1. Install process step 1 2. Install process step 2 3. Install process step 3 4. Install process step 4 5. Install process step 5 6. Shortcode options 7. CSS options 8. Lastest Check-In widget options 9. Latest Check-In widget example 10. Checkins shortcode example 11. Badges widget options 12. Badges widget example 13. Badges shortcode example 14. Mayorships widget options 15. Mayorships widget example 16. Mayorships shortcode example == Changelog == = 1.4.2 = * Fix for map not displaying when only using shortcodes (previous update failed) = 1.4.1 = * Fix for map not displaying when only using shortcodes = 1.4.0 = * Added mayorships widget and shortcode = 1.3.9 = * Improved cache handling to reduce calls and data storage = 1.3.8 = * Fixed Badges shortcode map not working * Added check for an unnamed foursquare venue = 1.3.7 = * Fix for Warning: copy() [function.copy]: Filename cannot be empty error = 1.3.6 = * Added byline option for widgets * Added shortcode options * Added CSS customization options = 1.3.5 = * Fix for require_once error on connecting to foursquare® = 1.3.4 = * Corrected conflict with JetPack = 1.3.3 = * Added error checking for FourSquare not being contactable = 1.3.2 = * Added additional screenshoots = 1.3.1 = * Bug fix for missing Zebra_Image.php file = 1.3 = * Added a Badges widget = 1.2 = * Learning about SVN :( = 1.1 = * Corrected issue with folder name = 1.0 = * Initial release == Upgrade Notice == = 1.4.1 = Fixed the issue with maps not displaying when only shortcodes = 1.4.0 = Added the ability to show Mayorships both as a widget and a shortcode = 1.3.9 = Improved the cache handling so both widget and page use the same cache, therefor reducing the number of calls and data stored = 1.3.8 = Update to fix the Badges shortcode not working correctly and handle unnamed foursquare venues = 1.3.7 = Fixed for Warning: copy() [function.copy]: Filename cannot be empty error = 1.3.6 = Added shortcode feature and further customization options = 1.3.5 = Corrected an issue with not finding a required file = 1.3.4 = Discovered a conflict with JetPack authorization = 1.3.3 = Will now use last cached results if there is an error contacting FourSquare = 1.3 = A second widget is now available to show off your badges = 1.2 = Made a mistake in updating the SVN = 1.1 = Fixes the error caused by an incorrectly named folder = 1.0 = Initial release