ACF: Google Map Extended

Description

This plugin creates a new field for Advanced Custom Fields (ACF)
extending the functionality of the built-in Google Map field with several handy features:

• Saves map center. You can center your maps wherever you want and indicate that you want to save that place as map center. This can be handy, if you want your front-end map to show some specific place in the center of the map (not necessary the location marker).
• Saves zoom level.
• Disables (optionally) map zooming with a scrollwheel. Sometimes you can get annoyed with your maps starting to zoom, when you scroll the post in the admin area. This feature comes handy here.
• Shows location coordinates. It is easy to get any place’s location coordinates (latitude and longitude) with this plugin by setting a marker to the place you need using user friendly map interface.
• Compatible with the data format of the Google Map field coming with ACF. See F.A.Q. for details.
• Saves all maps shown at a page in the global array. This is a bonus for programmers. See F.A.Q. for details.

The plugin makes use of the Google Maps API version 3.
The plugin doesn’t use an API key and is therefore operating under the restrictions of the free Google Maps API,
which should be more than enough for most websites.

Compatibility

This ACF field type is compatible with:

• ACF 4
• ACF 5 (PRO version)
• Google Map field coming with ACF 4/5. See F.A.Q.

Translations

The plugin is translated to:

• French
• German
• Netherlands
• Russian
• Ukrainian

There is a POT file under the lang directory holding all translation strings, so it should be pretty easy to translate to other languages.

Website

https://code.fish

Please Vote and Enjoy

Your votes really make a difference! Thanks.

License

This plugin is licensed under the GPLv2. See https://www.gnu.org/licenses/gpl-2.0.html

Screenshots

Installation

1. Download the source
2. Extract the archive into the plugin folder in your WordPress installation (usually /wp-content/plugins/ directory)
3. Activate the plugin through the ‘Plugins’ menu in WordPress
4. Make sure to also have Advanced Custom Fields plugin installed.

FAQ

Q. How do I use this plugin?

A. This plugin mimics the behavior of the Google Map field coming with the woderful Advanced Custom Fields plugin made by Elliot Condon.
Make sure you read the documentation for the original field first.
In order to benefit from the extended functionality set the field type to Google Map Extended, when you create a new custom field with ACF.
If you do everything correctly, you will see a togglable ‘Map data’ label below your map when editting a post/page with your custom fields.

To get the map data in the front-end code, simply request the field value with ACF API call and you will get the latitude, longitude, address, map center and map zoom.

<?php
  $values = get_field('*****FIELD_NAME*****');
  $lat = $values['lat'];
  $lng = $values['lng'];
  $address = $values['address'];
  $map_center_lat = $values['center_lat'];
  $map_center_lng = $values['center_lng'];
  $map_zoom = $values['zoom'];
?>

Q. Can I upgrade the Google Map fields I had created using just ACF with this plugin?

A. Yes, you can. First, you should delete the built-in Google Map fields you want to upgrade in the corresponding field groups under Custom Fields.
Then you should create replacement Google Map Extended fields with the same Field Name.
Once done and field group saved, you can refresh the back-end pages making use of ACF Google Map fields and enjoy the extended functionality.

Q. Can I change the map’s look/behavior in the back-end using JavaScript?

A. Yes. All maps are saved to the global array called acf_gme_maps. The array contains instances of acf_gme class and is indexed with the field IDs. You can use all class methods or get direct access to the map through map property.
acf_gme[‘acf-field-acf_extended_map-564232b63c93e’].map.setZoom(10)
This code will set the map’s zoom to 10.

Q. How do I get the plugin to show a map on the website?

A. You should do some front-end coding to do that, as this plugin (likewise Advanced Custom Fields itself) gives you the back-end features only and stores the data in your website’s database.
Please see code examples at ACF website.

Reviews

actual not working

AkaruMaster May 26, 2017

Not working now – security google map problem?

IT needs API update, not working right now.

gruntek December 9, 2016 1 reply

Google now require API. Your plugin need an update.

Almost there.

broodi September 3, 2016

Had to uninstall because it throws javascript errors. This killed the ability to upload media OR change the permalink. Too bad this is a cool plugin. I’ll keep an eye-out for an update.

The must-have of the ACF Google Maps Field

Ivan Privalov September 3, 2016 4 replies

Great plugin. Thank you. I’ve being ‘Listening’ the Google Zoom events and updating the additional Map Zoom select drop-box previously, but your solution is so much better. Thank you!

A More Powerful ACF Google Maps Field

Kevin Hoffman September 3, 2016

Fantastic plugin that adds much-needed functionality to the ACF Google Map field. I appreciate that the array of key-value pairs is saved in exactly the same way as the default Google Map field, but with the addition of values for zoom, center_lat, and center_lng: array( 'address' => '', 'lat' => '', 'lng' => '', 'zoom' => '', 'center_lat' => '', 'center_lng' => '', ) Ultimately this data allows you to recreate the exact Google Map that the user creates in WP Admin on the front-end of your site – something that simply isn’t possible with the default ACF Google Map field. Keep up the great work!

Does what it say

ThemeChimps September 3, 2016

I was looking exactly how to save map zooming and here it comes. Nice!

Contributors & Developers

Changelog

1.0.1

• Fix minor UI bugs
• Language: Updated POT file
• Language: Updated Netherlands translation
• Language: Updated Russian translation
• Language: Updated Ukrainian translation
• Language: Added French translation
• Language: Added German translation

1.0.0

• Initial Release