WP_Places

Description

If you find you regularly write blog posts about (local?) places you might want to provide info such as hours, phone number, address to your users. However, this can be difficult to keep current. Fortunately Google offers an API called Google Places API Web Service. Google Place API Web Service allows you to Add up-to-date information about millions of locations.

WP_Places Plugin requires a Google Places API Web Service Key. However, at the time of writing the API key is free and provides up to 1,000 requests per 24 hour period. If you verify your identity (by providing Google a Credit Card) they will increase your daily request per 24 hours to 150,000.

Once Installed, WP_Places takes name and location and displays a DIV containing Business Name, Address, Hours, Phone Number, Website.

The following shortcodes are available:

  • [wp_places name] displays the Google Places name
  • [wp_places formattedAddress] displays the address in the regionally standardized way
  • [wp_places phoneNumber] displays the phone number in the regionally standardized way
  • [wp_places hours] displays the hours of operation in a list
  • [wp_places website] displays the website
  • [wp_places priceLevel] returns the pricing level as prescribed in google places API
  • [wp_places rating] returns the average rating as prescribed in google places API
  • [wp_places lat] lattitude
  • [wp_places lng] longitude
  • [wp_places openNow] returns 1 if open
  • [wp_places openNowText] returns “Open Now” if open
  • [wp_places permanentlyClosed] returns 1 if permanently closed
  • [wp_places photos] returns photos if google supplies them
  • [wp_places reviews] returns a UL list of reviews if google supplies them

To filter how long to cache the google reply there is a filter:

add_filter( ‘wp_places_transient’, ‘wp_places_update_transient’, 10, 1 );
wp_places_update_transient( $time ) {
// return a value in seconds for how long to cache.
return 86400; // one day
return 604800 // one week
}

Installation

  1. Upload the plugin files to the /wp-content/plugins/WP_Places 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 page on the WP_Places page to add your Google Places API Web Services Key.
  4. When writing a post about a business, add the business name and address to the WP_Places field.

Reviews

Fantastic.

After searching for plugins that might help with “Google My Business” details and finding nothing suitable I was losing all hope. A bit more reading lead me to realise I needed “Google Places” data instead – but there was still the problem of having to learn about the API to obtain the correct data from a json file. Again, I started to lose all hope as the api stuff seemed far too complicated.

The solution – this plugin “WP_Places”.

Thanks for creating it Gary.

Awesome, and great for non-blog sites too!

This is an amazing little plugin! Very easy to use with simple shortcodes.

I use it on my business websites, and how great to be able to show at a glance that the business is currently open.

It’s also nice that it brings in the Google Places information, not just something hardcoded. It forces me to keep Google Places up-to-date.

Thanks!!

Perfection

I only use the shortcodes, but this tool has been flawless for me. I had one issue, which really wasn’t an issues but a request I had, I contacted the dev and he resolved within 24 hours. Great tool superior support.

Read all 7 reviews

Contributors & Developers

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

Contributors

Translate “WP_Places” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

2.1.1

  • Adds a filter for transient time.

2.1.0

  • Enables google auto-complete on the input form on posts.
  • Adds a dismissible admin notice on CPT creation if Google Places API has not been set up.
  • Defaults to adding the metabox to posts and pages for quicker place association after initial set up.

2.0.6

  • Fixes bug related to losing google place ID.

2.0.5

  • ¯_(ツ)_/¯

2.0.4

  • Adds support for including in CPT.

2.0.0

  • massive refactoring that will allow quicker fixes going forward.

1.1.18

  • user tagsdomino pointed out an error with preg_replace in PHP7 and proposed using str_replace. Thanks! tagsdomino.

1.1.17

  • Store meta data for lat/lon
  • Reversed course on serializing transient thanks to @salcode
  • Proposing we appoint @salcode lifeguard of twitter

1.1.16

  • Serialized response array so transients don’t duplicate calls to the google places api within short amounts of time

1.1.15

  • Fixed a mis-spelling
  • Updated tested up to version number

1.1.14

  • Fixed a bug that caused posts to be display empty when google ID is not set.

1.1.13

  • Fixed a whole heap of array references that were throwing PHP notices.

1.1.12

  • Fixed an error that showed locations as closed in some edge cases
  • Handles & in location name with special thanks to bartdyer for a simple solution

1.1.11

  • Handled situation where API response did not have all data set
  • Quieted down a bunch of PHP Notices

1.1.10

  • Fixed logic in hours when location doesn’t provide hours

1.1.9

  • Added Text ouput shortcode for Open Now [wp_places openNowText] (thanks Bart!)

1.1.8

  • Fixed logic where no photos/reviews would throw error

1.1.7

  • added shortcode for reviews and images

1.1.6

  • on activation enable embed div display

1.1.5

  • added column view to all posts
  • added transient to prevent repeated shortcode use from causing repeat queries
  • fixed longitude shortcode
  • fixed hours display shortcode

1.1.4

  • fixed bone-headed mistake that hid the div

1.1.3

  • shortcodes made live
  • fixed spelling errors

1.1.2

  • Fixed labels again
  • Shortcodes setup
  • Added toggle for displaying the embedded DIV

1.1.1

  • CSS is no longer hard-coded
  • Fixed confusing label on new menu page

1.1.0

  • Added menu page specifically for WP_Places
  • checked to see if content has multiple paragraphs before inserting content at the beginning of the 2nd paragraph

1.0.6

  • moved default location to the end of the 1st paragraph after frantically realizing embedding at the beginning meant that social sharing was funky

1.0.5

  • removed confusing menu stub

1.0.4

  • Now shows within the posts section the location name that was returned from Google
  • “Open Now” status is working.

1.0.3

  • I misspleeeldead services in teh 1.0.2 release
  • Fixed image location url

1.0.2

  • Fixed confusing field name

1.0.1

  • Fixed launching with no settings visibility

1.0

  • Initial Launch!