WordPress.org

Ready to get started?Download WordPress

Plugin Directory

!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

The 1st plugin to integrate the foursquare® API into WordPress to show your checkins and badges

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)

Requires: 2.7 or higher
Compatible up to: 3.2.1
Last Updated: 2011-11-24
Downloads: 3,978

Ratings

3 stars
3.4 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1 100,2,2 100,1,1 100,1,1 100,1,1 50,2,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 50,2,1 100,1,1 100,1,1 100,1,1 100,1,1
100,1,1 100,1,1
0,1,0
0,1,0