This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

WP Placespeak Connect

Description

PlaceSpeak Connect is a geographic digital identity authentication application programming interface, or GeoID API. It allows third party applications and websites to verify the location of its users. PlaceSpeak Connect tests a user’s address or location against a predetermined area of interest, producing geographically relevant results.

This plugin allows organizations to use PlaceSpeak connect in conjunction with the WordPress commenting system to geo-verify commenters, without the need to write any code.

Requirements

Your domain must use HTTPS in order for the plugin to work. Communication with the PlaceSpeak server happens according to the OAuth2 authorization protocol, and OAuth2 requires that network communication happen over encrypted HTTPS (which is just a good idea anyway).

Features

  • Admin can add apps using app key, app secret, and a standard redirect_uri
  • “Connect With PlaceSpeak” button available as shortcode or as part of a commenting form
  • Commenters that authorize PlaceSpeak will also have verification information, names, and region labels relative to app saved as meta information with comment
  • Allows admin to store user information in WP_USERS table or custom placespeak_user table

Usage

Creating a PlaceSpeak Connect app and connecting it to WordPress

To use PlaceSpeak Connect to verify your WordPress commenters, you must first create one or more new API “apps” within PlaceSpeak, and update the WordPress plugin to be aware of them.

  1. If you don’t have one, create a new (free) user account on PlaceSpeak.com.
  2. If you don’t have one, create a new (free) organization account on PlaceSpeak.com. (Currently this requires clicking on the Start a Consultation link and following through to the organization creation step.
  3. In your organizational dashboard, click on the PlaceSpeak Connect tab, and create a new API client instance (better documentation for this step to come).
  4. In your WordPress admin interface, go to Settings > PlaceSpeak
  5. Copy the Redirect URL from the top of the page. Back in PlaceSpeak, paste the URL into the Redirect URI field in the settings page for your new API app, and press save.
  6. Copy and paste the app key and app secret from PlaceSpeak into the Add New PlaceSpeak App form in WordPress. Also give the app a name (presumably the same one you used when creating it in PlaceSpeak).

Note that you can choose to have PlaceSpeak verification information added directly onto the normal WordPress users table, or you can set the plugin to save that information is a separate table.

Using PlaceSpeak connect to verify commenters

  1. Create a new page or post. Ensure commenting is turned on.
  2. From the Select PlaceSpeak App dropdown in the editor, choose the app you just added.
  3. Save your post and view it. There should now be an optional button for verifying PlaceSpeak users who submit a comment.

Using PlaceSpeak connect to verify form submissions

In addition to the standard PlaceSpeak commenting function, WP-PlaceSpeak-Connect can work with form plugins. Currently this has only been tested with Contact Form 7.

The usage with forms is the same as for regular post comments.

  1. Install the Contact Form 7 plugin.
  2. Create a new page or post.
  3. From the Select PlaceSpeak App dropdown in the editor, choose the app you just added.
  4. Save your post and view it. There should now be a button for verifying PlaceSpeak users who fill out the form.

Future features under consideration

  • Single Sign On with PlaceSpeak account into WordPress
  • Automatic listing of all available PlaceSpeak Connect API apps for your organization (instead of entering them manually).

Installation

  1. Upload the plugin files to the /wp-content/plugins/wp-placespeak-connect directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Use the Settings->WordPress screen to configure the plugin (see Usage) section for details.

Note: if you previously installed this plugin from Github (i.e. versions < 1.2) you must de-activate and uninstall that version of the plugin before installing this version.

FAQ

Installation Instructions
  1. Upload the plugin files to the /wp-content/plugins/wp-placespeak-connect directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Use the Settings->WordPress screen to configure the plugin (see Usage) section for details.

Note: if you previously installed this plugin from Github (i.e. versions < 1.2) you must de-activate and uninstall that version of the plugin before installing this version.

Contributors & Developers

“WP Placespeak Connect” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.2.9

*Minor fixed to resolve plugin failing on WP Multisites sub-sites

1.2.8

*Deleting the database table when a blog is deleted.
*Fix: Removes the tables when the plugin is deleted on multisites

1.2.7

*Network Activate now works for WP multisite installs. For both previous and new sites.

1.2.6

*Uninstalling now deletes all data tables and options for WP multisite installs

1.2.5

*Uninstalling now deletes all data tables and options related to the plugin

1.2.4

*Removed dependency on template header

1.2.3

*Fixed site_url issue causing the plugin to fail on WP Multisites

1.2.2

  • Fixed bug in comment submission.

1.2.1

  • Initial re-organization to begin to bring code into plugin directory subversion standards.

1.2

  • Multiple internal improvements to adhere to WordPress plugin directory standards.

1.1.4

  • Prevents access to PHP files via the browser.

1.1.3

  • More useful error message when server to server communication fails.

1.1.2

  • Another bug fix for “Failed opening required … wp-load.php” error on Windows Server.

1.1.1

  • Bug fix for “Failed opening required … wp-load.php” error on some servers.