• Stars
    star
    118
  • Rank 299,007 (Top 6 %)
  • Language
    PHP
  • Created over 12 years ago
  • Updated about 4 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Google Maps field type for Custom Metaboxes and Fields for WordPress

CMB2 Field Type: Google Maps

Description

Google Maps field type for CMB2.

The pw_map field stores the latitude/longitude values which you can then use to display a map in your theme.

Installation

You can install this field type as you would a WordPress plugin:

  1. Download the plugin
  2. Place the plugin folder in your /wp-content/plugins/ directory
  3. Activate the plugin in the Plugin dashboard

Or you can use WP-CLI to install from GitHub.

wp plugin install --activate https://github.com/mustardBees/cmb_field_map/archive/master.zip

Google API Key

You'll need to generate a Google API key with both "Maps JavaScript API" and "Places API" enabled.

There are three options for specifying the Google API key:

  1. Pass the api_key field parameter. Not recommended as you'll have to do this for each map field.
  2. Define the key in your wp-config.php file.
  3. Hook in your own key retrieval logic using the pw_google_api_key filter.

Usage

pw_map

Save a location on a map. Example:

$cmb->add_field( array(
	'name' => 'Location',
	'desc' => 'Drag the marker to set the exact location',
	'id' => $prefix . 'location',
	'type' => 'pw_map',
	// 'split_values' => true, // Save latitude and longitude as two separate fields
) );

Extra Parameters:

  • split_values Save the latitude/longitude values into two custom fields, they will be stored as $id . '_latitude' and $id . '_longitude'.

Screenshot

Image