{"id":15517,"date":"2011-10-31T23:58:24","date_gmt":"2011-10-31T23:58:24","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/foursquareapi\/"},"modified":"2011-12-14T17:09:53","modified_gmt":"2011-12-14T17:09:53","slug":"foursquareapi","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/foursquareapi\/","author":8496406,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.0.6","stable_tag":"2.0.6","tested":"3.2.1","requires":"2.7","requires_php":"","requires_plugins":"","header_name":"FourSquareAPI","header_author":"the Guru","header_description":"","assets_banners_color":"","last_updated":"2011-12-14 17:09:53","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/nzguru.net\/cool-stuff\/foursquareapi-plugin-for-wordpress","header_plugin_uri":"http:\/\/nzguru.net\/cool-stuff\/foursquareapi-plugin-for-wordpress","header_author_uri":"http:\/\/nzguru.net","rating":1,"author_block_rating":0,"active_installs":10,"downloads":5223,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"2.0.5":"<p>Improved the way images are cached locally and resized for the map<\/p>","2.0.4":"<p>Found a couple of typos<\/p>","2.0.3":"<p>Corrected missing image<\/p>","2.0.2":"<p>Keeps private checkins private (unless you decide to show them<\/p>","2.0.1":"<p>Fixes compatability issues with some templates<\/p>","2.0.0":"<p>Major rewite<\/p>","1.4.3":"<p>Fixed the issue with all checkins showing when a limit is set<\/p>","1.4.1":"<p>Fixed the issue with maps not displaying when only shortcodes<\/p>","1.4.0":"<p>Added the ability to show Mayorships both as a widget and a shortcode<\/p>","1.3.9":"<p>Improved the cache handling so both widget and page use the same cache, therefor reducing the number of calls and data stored<\/p>","1.3.8":"<p>Update to fix the Badges shortcode not working correctly and handle unnamed foursquare venues<\/p>","1.3.7":"<p>Fixed for Warning: copy() [function.copy]: Filename cannot be empty error<\/p>","1.3.6":"<p>Added shortcode feature and further customization options<\/p>","1.3.5":"<p>Corrected an issue with not finding a required file<\/p>","1.3.4":"<p>Discovered a conflict with JetPack authorization<\/p>","1.3.3":"<p>Will now use last cached results if there is an error contacting FourSquare<\/p>","1.3":"<p>A second widget is now available to show off your badges<\/p>","1.2":"<p>Made a mistake in updating the SVN<\/p>","1.1":"<p>Fixes the error caused by an incorrectly named folder<\/p>","1.0":"<p>Initial release<\/p>"},"ratings":{"1":"2","2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.1","1.2","1.3","1.3.1","1.3.2","1.3.3","1.3.4","1.3.5","1.3.6","1.3.7","1.3.8","1.3.9","1.4.0","1.4.1","1.4.2","1.4.3","2.0.0","2.0.1","2.0.2","2.0.3","2.0.4","2.0.5","2.0.6"],"block_files":[],"assets_screenshots":{"screenshot-9.png":{"filename":"screenshot-9.png","revision":"1539150","resolution":"9","location":"plugin"},"screenshot-5.png":{"filename":"screenshot-5.png","revision":"1539150","resolution":"5","location":"plugin"},"screenshot-7.png":{"filename":"screenshot-7.png","revision":"1539150","resolution":"7","location":"plugin"},"screenshot-11.png":{"filename":"screenshot-11.png","revision":"1539150","resolution":"11","location":"plugin"},"screenshot-10.png":{"filename":"screenshot-10.png","revision":"1539150","resolution":"10","location":"plugin"},"screenshot-13.png":{"filename":"screenshot-13.png","revision":"1539150","resolution":"13","location":"plugin"},"screenshot-6.png":{"filename":"screenshot-6.png","revision":"1539150","resolution":"6","location":"plugin"},"screenshot-12.png":{"filename":"screenshot-12.png","revision":"1539150","resolution":"12","location":"plugin"},"screenshot-4.png":{"filename":"screenshot-4.png","revision":"1539150","resolution":"4","location":"plugin"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"1539150","resolution":"2","location":"plugin"},"screenshot-3.png":{"filename":"screenshot-3.png","revision":"1539150","resolution":"3","location":"plugin"},"screenshot-8.png":{"filename":"screenshot-8.png","revision":"1539150","resolution":"8","location":"plugin"},"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1539150","resolution":"1","location":"plugin"}},"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":"API Stats","7":"Venues widget options","8":"Badges widget options","9":"Venues widget example showing recent checkins","10":"Venues widget example showing history","11":"Badges widget example","12":"Venues shortcode example","13":"Badges shortcode example"}},"plugin_section":[],"plugin_tags":[2306,30874,3162,168,162],"plugin_category":[43,49,56],"plugin_contributors":[90379],"plugin_business_model":[],"class_list":["post-15517","plugin","type-plugin","status-closed","hentry","plugin_tags-badges","plugin_tags-checkin","plugin_tags-foursquare","plugin_tags-sidebar","plugin_tags-widget","plugin_category-customization","plugin_category-maps-and-location","plugin_category-social-and-sharing","plugin_contributors-nzguru","plugin_committers-nzguru"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/foursquareapi.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/foursquareapi\/trunk\/screenshot-1.png?rev=1539150","caption":"Install process step 1"},{"src":"https:\/\/ps.w.org\/foursquareapi\/trunk\/screenshot-2.png?rev=1539150","caption":"Install process step 2"},{"src":"https:\/\/ps.w.org\/foursquareapi\/trunk\/screenshot-3.png?rev=1539150","caption":"Install process step 3"},{"src":"https:\/\/ps.w.org\/foursquareapi\/trunk\/screenshot-4.png?rev=1539150","caption":"Install process step 4"},{"src":"https:\/\/ps.w.org\/foursquareapi\/trunk\/screenshot-5.png?rev=1539150","caption":"Install process step 5"},{"src":"https:\/\/ps.w.org\/foursquareapi\/trunk\/screenshot-6.png?rev=1539150","caption":"API Stats"},{"src":"https:\/\/ps.w.org\/foursquareapi\/trunk\/screenshot-7.png?rev=1539150","caption":"Venues widget options"},{"src":"https:\/\/ps.w.org\/foursquareapi\/trunk\/screenshot-8.png?rev=1539150","caption":"Badges widget options"},{"src":"https:\/\/ps.w.org\/foursquareapi\/trunk\/screenshot-9.png?rev=1539150","caption":"Venues widget example showing recent checkins"},{"src":"https:\/\/ps.w.org\/foursquareapi\/trunk\/screenshot-10.png?rev=1539150","caption":"Venues widget example showing history"},{"src":"https:\/\/ps.w.org\/foursquareapi\/trunk\/screenshot-11.png?rev=1539150","caption":"Badges widget example"},{"src":"https:\/\/ps.w.org\/foursquareapi\/trunk\/screenshot-12.png?rev=1539150","caption":"Venues shortcode example"},{"src":"https:\/\/ps.w.org\/foursquareapi\/trunk\/screenshot-13.png?rev=1539150","caption":"Badges shortcode example"}],"raw_content":"<!--section=description-->\n<p>This plugin uses the foursquare&reg; API to retrieve various information and display it in a widget or directly in posts and pages via a shortcode. Information currently available includes ...<\/p>\n\n<ul>\n<li>your recent checkins<\/li>\n<li>your mayorships<\/li>\n<li>your badges<\/li>\n<li>your checkin history<\/li>\n<\/ul>\n\n<p>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)<\/p>\n\n<p>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)<\/p>\n\n<!--section=installation-->\n<p>For an automatic installation through WordPress:<\/p>\n\n<ol>\n<li>Go to the 'Add New' plugins screen in your WordPress admin area<\/li>\n<li>Search for 'foursquareapi'<\/li>\n<li>Click 'Install Now' and activate the plugin<\/li>\n<li>Go to the Settings -&gt; FourSquareAPI admin panel and follow the instructions to connect with foursquare&reg;.<\/li>\n<\/ol>\n\n<p>For a manual upload installation through WordPress:<\/p>\n\n<ol>\n<li>Download the FourSquareAPI zip file from <a href=\"http:\/\/wordpress.org\/extend\/plugins\/foursquareapi\/\">wordpress.org<\/a><\/li>\n<li>Go to the 'Add New' plugins screen in your Wordpress admin area and select the 'Upload' tab<\/li>\n<li>Browse to where you download the zip file<\/li>\n<li>Click 'Install Now' and activate the plugin<\/li>\n<li>Go to the Settings -&gt; FourSquareAPI admin panel and follow the instructions to connect with foursquare&reg;.<\/li>\n<\/ol>\n\n<p>For a manual installation via FTP:<\/p>\n\n<ol>\n<li>Download the FourSquareAPI zip file from <a href=\"http:\/\/wordpress.org\/extend\/plugins\/foursquareapi\/\">wordpress.org<\/a><\/li>\n<li>Unzip to your local drive<\/li>\n<li>Upload the foursquareapi folder to the \/wp-content\/plugins\/ directory on your server<\/li>\n<li>Activate the plugin through the 'Plugins' screen in your WordPress admin area<\/li>\n<li>Go to the Settings -&gt; FourSquareAPI admin panel and follow the instructions to connect with foursquare&reg;.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt>What is foursquare&reg;?<\/dt>\n<dd><p>foursquare&reg; 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.<\/p><\/dd>\n<dt>What is the foursquare&reg; API?<\/dt>\n<dd><p>API stands for \"application programming interface.\" APIs facilitate interaction between different software programs by making it easy for them to share data and resources.<\/p><\/dd>\n<dt>What about the foursquare&reg; API limits?<\/dt>\n<dd><p>foursquare&reg; 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.<\/p><\/dd>\n<dt>Can I get this plugin in a different language?<\/dt>\n<dd><p>Language translations are being added as I am able to do them. If you would like to help by completing a translation, please send <a href=\"http:\/\/codex.wordpress.org\/Translating_WordPress\">gettext PO and MO files<\/a> to me via <a href=\"http:\/\/nzguru.net\/contact-me\">NZGuru.net<\/a> and I will include them in the next update. You can download the latest <a href=\"http:\/\/plugins.svn.wordpress.org\/foursquareapi\/trunk\/lang\/foursquareapi.pot\">POT file from here<\/a>.<\/p><\/dd>\n<dt>How do I use the [foursquare_venues] shortcode?<\/dt>\n<dd><p>Simply place [<code>foursquare_venues<\/code>] in your page or post. You may optionally add any of the following to customize the appearance -<\/p>\n\n<ul>\n<li><code>type=x<\/code> where x is either <code>checkins<\/code>, <code>mayorships<\/code>, or <code>venuehistory<\/code> (default is venuehistory)<\/li>\n<li><code>width=x<\/code> where x is the pixel width of the resulting data (default is 400)<\/li>\n<li><code>map_height=x<\/code> where x is the pixel height of the map (default is 0 meaning do not show map)<\/li>\n<li><code>map_zoom=x<\/code> where x is the initial zoom level for the map (default is 16)<\/li>\n<li><code>timestamp=1<\/code> to show when you visited (default is 0 meaning do not show timestamp, data not available for all types)<\/li>\n<li><code>address=1<\/code> to show address data (default is 0 meaning do not show address data)<\/li>\n<li><code>stats=1<\/code> to show venue stats (default is 0 meaning do not show venue stats)<\/li>\n<li><code>limit=x<\/code> where x is the maximum number of venues to show (default is 0 meaning show all available venues)<\/li>\n<li><code>list=1<\/code> to show venues in a list (default is 0 showing scrollable venues)<\/li>\n<li><code>autoscroll=1600<\/code> speed in milliseconds for scrolling box (default is 0 which disables scrolling, ignored if displaying as a list)<\/li>\n<li><code>id=x<\/code> where x is a unique number allowing you to have multiple shortcodes on the same page (default is 1)<\/li>\n<\/ul><\/dd>\n<dt>How do I use the [foursquare_badges] shortcode?<\/dt>\n<dd><p>Simply place [<code>foursquare_badges<\/code>] in your page or post. You may optionally add any of the following to customize the appearance -<\/p>\n\n<ul>\n<li><code>type=x<\/code> where x is currently only <code>badges<\/code> (default is badges)<\/li>\n<li><code>width=x<\/code> where x is the pixel width of the resulting data (default is 400)<\/li>\n<li><code>map_height=x<\/code> where x is the pixel height of the map (default is 0 meaning do not show map)<\/li>\n<li><code>map_zoom=x<\/code> where x is the initial zoom level for the map (default is 16)<\/li>\n<li><code>timestamp=1<\/code> to show when you visited (default is 0 meaning do not show timestamp, data not available for all types)<\/li>\n<li><code>description=1<\/code> to show the badge description (default is 0 meaning do not show description, data not available for all types)<\/li>\n<li><code>limit=0<\/code> to show all badges (default is 0 meaning show only earned badges)<\/li>\n<li><code>venue=1<\/code> to show venue data (default is 0 meaning do not show venue data, must be enabled to show address and\/or stats)<\/li>\n<li><code>address=1<\/code> to show address data (default is 0 meaning do not show address data)<\/li>\n<li><code>stats=1<\/code> to show venue stats (default is 0 meaning do not show venue stats)<\/li>\n<li><code>list=1<\/code> to show badges in a list (default is 0 showing scrollable badges)<\/li>\n<li><code>autoscroll=1600<\/code> speed in milliseconds for scrolling box (default is 0 which disables scrolling, ignored if displaying as a list)<\/li>\n<li><code>id=x<\/code> where x is a unique number allowing you to have multiple shortcodes on the same page (default is 1)<\/li>\n<\/ul><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.0.6<\/h4>\n\n<ul>\n<li>Added ability to showcase your site on NZGuru<\/li>\n<\/ul>\n\n<h4>2.0.5<\/h4>\n\n<ul>\n<li>Better caching and resizing of images for map<\/li>\n<\/ul>\n\n<h4>2.0.4<\/h4>\n\n<ul>\n<li>Corrected some typos<\/li>\n<\/ul>\n\n<h4>2.0.3<\/h4>\n\n<ul>\n<li>Corrected missing image<\/li>\n<\/ul>\n\n<h4>2.0.2<\/h4>\n\n<ul>\n<li>Added ability include\/exclude private checkins (excluded by default)<\/li>\n<\/ul>\n\n<h4>2.0.1<\/h4>\n\n<ul>\n<li>Changed some class names to avoid template clashes<\/li>\n<li>Changed slider javascript to better use native jQuery<\/li>\n<\/ul>\n\n<h4>2.0.0<\/h4>\n\n<ul>\n<li>Completely rewritten code for better performance<\/li>\n<li>Cleaner layouts matching foursquare<\/li>\n<li>Multi widget capability<\/li>\n<li>Language translations for Swedish, French, and Spanish<\/li>\n<\/ul>\n\n<h4>1.4.3<\/h4>\n\n<ul>\n<li>Fix for checkins not obaying limit<\/li>\n<\/ul>\n\n<h4>1.4.2<\/h4>\n\n<ul>\n<li>Fix for map not displaying when only using shortcodes (previous update failed)<\/li>\n<\/ul>\n\n<h4>1.4.1<\/h4>\n\n<ul>\n<li>Fix for map not displaying when only using shortcodes <\/li>\n<\/ul>\n\n<h4>1.4.0<\/h4>\n\n<ul>\n<li>Added mayorships widget and shortcode<\/li>\n<\/ul>\n\n<h4>1.3.9<\/h4>\n\n<ul>\n<li>Improved cache handling to reduce calls and data storage<\/li>\n<\/ul>\n\n<h4>1.3.8<\/h4>\n\n<ul>\n<li>Fixed Badges shortcode map not working<\/li>\n<li>Added check for an unnamed foursquare venue<\/li>\n<\/ul>\n\n<h4>1.3.7<\/h4>\n\n<ul>\n<li>Fix for Warning: copy() [function.copy]: Filename cannot be empty error<\/li>\n<\/ul>\n\n<h4>1.3.6<\/h4>\n\n<ul>\n<li>Added byline option for widgets<\/li>\n<li>Added shortcode options<\/li>\n<li>Added CSS customization options<\/li>\n<\/ul>\n\n<h4>1.3.5<\/h4>\n\n<ul>\n<li>Fix for require_once error on connecting to foursquare&reg;<\/li>\n<\/ul>\n\n<h4>1.3.4<\/h4>\n\n<ul>\n<li>Corrected conflict with JetPack<\/li>\n<\/ul>\n\n<h4>1.3.3<\/h4>\n\n<ul>\n<li>Added error checking for FourSquare not being contactable<\/li>\n<\/ul>\n\n<h4>1.3.2<\/h4>\n\n<ul>\n<li>Added additional screenshoots<\/li>\n<\/ul>\n\n<h4>1.3.1<\/h4>\n\n<ul>\n<li>Bug fix for missing Zebra_Image.php file<\/li>\n<\/ul>\n\n<h4>1.3<\/h4>\n\n<ul>\n<li>Added a Badges widget<\/li>\n<\/ul>\n\n<h4>1.2<\/h4>\n\n<ul>\n<li>Learning about SVN :(<\/li>\n<\/ul>\n\n<h4>1.1<\/h4>\n\n<ul>\n<li>Corrected issue with folder name<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"The 1st plugin to integrate the foursquare&reg; API into WordPress to show your checkins and badges","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/15517","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=15517"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/nzguru"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=15517"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=15517"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=15517"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=15517"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=15517"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=15517"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}