Display your last Foursquare checkin as a map widget in the sidebar or embedded in a post or page, fully authenticated via OAuth 2.0.
|Author:||Gary Gale (profile at wordpress.org)|
|WordPress version required:||3.9.0|
|WordPress version tested:||4.1.0|
|Added to WordPress repository:||15-04-2012|
Warning! This plugin has not 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.
|Total downloads:||2 907|
Click to start download
This plugin allows you to display your last Swarm checkin as a map widget on the sidebar or embedded via a shortcode in a post or page of your WordPress powered site.
Setting and options include:
- Associate your WordPress powered site with your Foursquare account using OAuth 2.0, which keeps your personal information safe and secure.
- Choose which map provider you want your checkin shown on; you can choose from:
- Add your maps API key(s) for your chosen map provider; HERE, Google, Bing and MapQuest maps all require API keys.
- Choose the width and height of the widget and map on the sidebar. The width and height can be specified either as pixels (
px) or as a percentage.
- Choose the zoom level of the map display.
The strapline text containing the venue name, venue URL and timestamp of your last Swarm checkin can be customised via the plugin's filters. See the Filter Support And Usage section for more information.
The current version of this plugin allows you to associate a single Foursquare account with your WordPress site; associating multiple Foursquare accounts, one per user account is not currently supported.
Installed Plugins: Authentication prompt shown after activating plugin for the first time
Settings and Options: Foursquare Tab; No Client ID or Client Secret entered or saved
Settings and Options: Foursquare Tab; Client ID and Client Secret saved
Foursquare Authentication: Allow or deny plugin access to your Foursquare account
Settings and Options: Foursquare Tab; Successfully authenticated with Foursquare
Settings and Options: Maps Tab; HERE Maps configuration
Settings and Options: Maps Tab; Google Maps v3 configuration
Settings and Options: Maps Tab; Leaflet Maps configuration
Settings and Options: Maps Tab; Bing Maps v7 configuration
Settings and Options: Maps Tab; OpenLayers Maps configuration
Settings and Options: Maps Tab; MapQuest Open Maps configuration
Settings and Options: Shortcode Tab; [wp_quadratum] shortcode enabled
Settings and Options: Shortcode Tab; [wp_quadratum_locality] shortcode enabled, no Factual OAuth Key or Secret entered or saved
Settings and Options: Shortcode Tab; [wp_quadratum_locality] shortcode enabled, Factual OAuth Key and Secret saved
Settings and Options: Defaults Tab
Settings and Options: Colophon Tab
Appearance: Widgets; Sample widget settings
Sample Widget: Google v3, HERE and Leaflet maps
Sample Widget: Bing v7, OpenLayers and MapQuest Open maps
How do I get help or support for this plugin?
In short, very easily. But before you read any further, take a look at Asking For WordPress Plugin Help And Support Without Tears before firing off a question. In order of preference, you can ask a question on the WordPress support forum; this is by far the best way so that other users can follow the conversation. You can ask me a question on Twitter; I’m @vicchi. Or you can drop me an email instead. I can’t promise to answer your question but I do promise to answer and do my best to help.
Is there a web site for this plugin?
I have multiple authors on my site; can I have a widget for each author’s Foursquare account?
In the current version, no. In the current version, you can link a single Foursquare account with your WordPress site (multi-site or network sites may work, assuming each site is for a single user but I haven’t tested this). The plugin is currently designed to support a WordPress site which is used for a personal blog (in other words, exactly the way my site is set up). Future versions of the plugin may support this if people ask for this feature (assuming anyone apart from myself actually uses it!).
Can I change the format of the strapline that appears under the checkin map?
wp_quadratum_strapline filter is for just this purpose. The filter is passed the default strapline as well as the URL to the Foursquare venue checked in at, the name of the venue and the date and time of the checkin as a UNIX timestamp. See the Filter Support And Usage section for more information.
I want to amend/hack/augment this plugin; can I do the same?
Totally; this plugin is licensed under the GNU General Public License v2 (GPLV2). See http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt for the full license terms.
Where does the name WP Quadratum come from?
WP Quadratum is named after both the Latin words quattor, meaning four and quadratum, meaning square.
The current version is 188.8.131.52 (2015.02.05)
- Released 2015.02.05
- Fixed: Updated venue category icon handling to correctly display venue icons
- Changed: Refer to checkins as Swarm checkins and not Foursquare checkins
- Removed: Locally cached category icons
- Released: 2014.07.09
- Fixed: Updated category icon handling in line with Foursquare API changes
- Added: Local black and white cached category icons
- Released: 2014.07.07
- Fixed: Updated Foursquare
DATEVERIFIEDversion parameter to prevent API calls verified prior to
- Released: 2013.11.28
- Fixed: Bug in checking for when the
[wpq_map]shortcodes are enabled.
- Updated: Factual PHP driver to latest version.
- Released: 2013.10.23
- Added: Caching of last good response from the Foursquare API, allowing the plugin to operate if the API is temporarily down.
- Added: New locality shortcodes,
[wpq_locality]as an alias) to allow the last checkin’s venue name, address, region, postal code, coordinates, timezone and/or timezone offset to be embedded in posts or pages.
- Added: New checkin map shortcodes,
[wpq_map]as aliases for the plugin’s
- Added: Ability for the plugin’s shortcodes to be made configurable, on and off.
- Added: Ability to backfill the response of the Foursquare API, via Factual’s reverse geocoder, to cope with cases when a Foursquare venue doesn’t have a complete set of metadata attributes to be used in conjunction with the locality shortcodes.
- Added: New filter,
wp_quadratum_locality, to filter and amend the output of the
- Fixed: Detect and trap an invalid or empty response from the Foursquare API, preventing numerous PHP warnings from polluting a post or page.
- Other: Fully compatible with WordPress v3.7 “Basie”.
- Released: 2013.08.22
- Added: Support for HERE, Leaflet, MapQuest Open and Bing maps.
- Added: All maps API JS now loads in the page footer to speed up overall page loading times.
- Added: Support for a new filter,
wp_quadratum_checkingiving full access to all the Foursquare checkin metadata that the Foursquare API returns.
- Added: Support for specifying the height and width of the map as a percentage as well as in px.
- Fixed: Update the admin ‘Foursquare’ tab to use the new app registration URL. Adjust the help text to reflect the new app registration layout on
- Fixed: Updated Mapstraction support to pull JS code from
github.com/mapstraction/mxnto work around new GitHub content serving policies.
- Removed: Support for filtering out private checkins; the Foursquare API no longer supports this.
- Removed: Support for the CloudMade maps API; this has now been superseded by Leaflet maps.
- Removed: Support for the Nokia maps API; this has now been superseded by HERE maps.
- Removed: Support for authenticating Nokia maps via WP Nokia Auth; Nokia maps are now superseded by HERE maps.
- Removed: Support for the
Widget IDfield from the plugin’s widget; the plugin now uses the WordPress assigned widget instance.
- Other: Transitioned to
- Released: 2012.11.06
- Added: Support for the
- Added: Enqueue non-minified versions of the plugin’s CSS and JS files if
- Other: Updated to latest versions of
- Other: Moved all submodule classes/libraries from the plugin’s root directory to /includes.
- Released: 2012.07.01
- Added: Support for Nokia, CloudMade, Google and OpenLayers maps via Mapstraction
- Added: Split plugin settings and options into Foursquare, Maps, Defaults and Colophon tabs
[wp_quadratum]shortcode to allow a checkin map to be embedded in posts and pages.
- Fixed: Support for Internet Explorer compatibility for Nokia Maps.
Summary: Minor fixes to widget HTML structure
Fixed: Non W3C/HTML4 compliant widget code which caused the map not to be displayed when viewed with Internet Explorer
Summary: Minor fixes to PHP base class.
Fixed: An issue with an old version of WP_PluginBase, the PHP class which WP Quadratum extends.
- First version of WP Quadratum released