This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

FourSquareAPI

Description

This plugin uses the foursquare® API to retrieve various information and display it in a widget or directly in posts and pages via a shortcode. Information currently available includes …

  • your recent checkins
  • your mayorships
  • your badges
  • your checkin history

To display your selected data in a widget, simply drag the widget to your sidebar and select the optins you want to display. Similarly, you can add the widget styled data to a page or post by using the shortcode features (see FAQ)

Your foursquare data may be displayed with options to include a map showing the location(s), address details, and statistics relating to the venue. Some data also allows you display a timestamp relating to when the event occured (such as when you checked in or when you received a badge)

Screenshots

  • Install process step 1
  • Install process step 2
  • Install process step 3
  • Install process step 4
  • Install process step 5
  • API Stats
  • Venues widget options
  • Badges widget options
  • Venues widget example showing recent checkins
  • Venues widget example showing history
  • Badges widget example
  • Venues shortcode example
  • Badges shortcode example

Installation

For an automatic installation through WordPress:

  1. Go to the ‘Add New’ plugins screen in your WordPress admin area
  2. Search for ‘foursquareapi’
  3. Click ‘Install Now’ and activate the plugin
  4. Go to the Settings -> FourSquareAPI admin panel and follow the instructions to connect with foursquare®.

For a manual upload installation through WordPress:

  1. Download the FourSquareAPI zip file from wordpress.org
  2. Go to the ‘Add New’ plugins screen in your WordPress admin area and select the ‘Upload’ tab
  3. Browse to where you download the zip file
  4. Click ‘Install Now’ and activate the plugin
  5. Go to the Settings -> FourSquareAPI admin panel and follow the instructions to connect with foursquare®.

For a manual installation via FTP:

  1. Download the FourSquareAPI zip file from wordpress.org
  2. Unzip to your local drive
  3. Upload the foursquareapi folder to the /wp-content/plugins/ directory on your server
  4. Activate the plugin through the ‘Plugins’ screen in your WordPress admin area
  5. Go to the Settings -> FourSquareAPI admin panel and follow the instructions to connect with foursquare®.

FAQ

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.

Can I get this plugin in a different language?

Language translations are being added as I am able to do them. If you would like to help by completing a translation, please send gettext PO and MO files to me via NZGuru.net and I will include them in the next update. You can download the latest POT file from here.

How do I use the [foursquare_venues] shortcode?

Simply place [foursquare_venues] in your page or post. You may optionally add any of the following to customize the appearance –

  • type=x where x is either checkins, mayorships, or venuehistory (default is venuehistory)
  • width=x where x is the pixel width of the resulting data (default is 400)
  • map_height=x where x is the pixel height of the map (default is 0 meaning do not show map)
  • map_zoom=x where x is the initial zoom level for the map (default is 16)
  • timestamp=1 to show when you visited (default is 0 meaning do not show timestamp, data not available for all types)
  • address=1 to show address data (default is 0 meaning do not show address data)
  • stats=1 to show venue stats (default is 0 meaning do not show venue stats)
  • limit=x where x is the maximum number of venues to show (default is 0 meaning show all available venues)
  • list=1 to show venues in a list (default is 0 showing scrollable venues)
  • autoscroll=1600 speed in milliseconds for scrolling box (default is 0 which disables scrolling, ignored if displaying as a list)
  • id=x where x is a unique number allowing you to have multiple shortcodes on the same page (default is 1)
How do I use the [foursquare_badges] shortcode?

Simply place [foursquare_badges] in your page or post. You may optionally add any of the following to customize the appearance –

  • type=x where x is currently only badges (default is badges)
  • width=x where x is the pixel width of the resulting data (default is 400)
  • map_height=x where x is the pixel height of the map (default is 0 meaning do not show map)
  • map_zoom=x where x is the initial zoom level for the map (default is 16)
  • timestamp=1 to show when you visited (default is 0 meaning do not show timestamp, data not available for all types)
  • description=1 to show the badge description (default is 0 meaning do not show description, data not available for all types)
  • limit=0 to show all badges (default is 0 meaning show only earned badges)
  • venue=1 to show venue data (default is 0 meaning do not show venue data, must be enabled to show address and/or stats)
  • address=1 to show address data (default is 0 meaning do not show address data)
  • stats=1 to show venue stats (default is 0 meaning do not show venue stats)
  • list=1 to show badges in a list (default is 0 showing scrollable badges)
  • autoscroll=1600 speed in milliseconds for scrolling box (default is 0 which disables scrolling, ignored if displaying as a list)
  • id=x where x is a unique number allowing you to have multiple shortcodes on the same page (default is 1)

Contributors & Developers

“FourSquareAPI” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

2.0.6

  • Added ability to showcase your site on NZGuru

2.0.5

  • Better caching and resizing of images for map

2.0.4

  • Corrected some typos

2.0.3

  • Corrected missing image

2.0.2

  • Added ability include/exclude private checkins (excluded by default)

2.0.1

  • Changed some class names to avoid template clashes
  • Changed slider javascript to better use native jQuery

2.0.0

  • Completely rewritten code for better performance
  • Cleaner layouts matching foursquare
  • Multi widget capability
  • Language translations for Swedish, French, and Spanish

1.4.3

  • Fix for checkins not obaying limit

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