=== Maps Plugin using Google Maps for WordPress - WP Google Map ===
Contributors: milonfci
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=ZBERRKARGNEYA
Tags: Google Maps, map, Maps, map markers, store locator
Requires at least: 2.9
Tested up to: 6.9
Version: 1.9.6
Stable tag: 1.9.6
Requires PHP: 5.3
Text Domain: gmap-embed
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Google Map plugin for WordPress is very Simple, light-weight and Easy to use Google Custom Map with markers in Posts, Pages, Sidebar as shortcode.

== Description ==

WP Google Map is the most powerful and comprehensive solution for integrating Google Maps into your WordPress website. Whether you need a simple location map for your contact page or an advanced store locator with real-time filtering, this plugin provides all the tools you need with a professional and user-friendly interface.

It is fully customizable, responsive, and easy to use with shortcodes and a dedicated map editor.

**[Get WP Google Map Pro version (Starting from $19 only)](https://wpgooglemap.com/pricing?utm_source=gmap-embed&utm_medium=wordpress-plugin&utm_campaign=upgrade-to-pro&utm_content=readme-get-pro)**

== DEMOS ==
* [See all Google Map Demos](https://wpgooglemap.com/demos?utm_source=gmap-embed&utm_medium=wordpress-plugin&utm_campaign=demos&utm_content=readme-demos-list)

== VIDEO TUTORIALS ==
* [Quick Installation Guide](https://www.youtube.com/watch?v=1G2VksP-uX0)
* [Full Setup and Basics](https://www.youtube.com/watch?v=ErRy5lqTPjY)

== DOCUMENTATION & SUPPORT ==
* [Complete Help Manual](https://wpgooglemap.com/documentation?utm_source=gmap-embed&utm_medium=wordpress-plugin&utm_campaign=documentation&utm_content=readme-doc-list)
* [How to identify and fix Map loading problems?](https://wpgooglemap.com/documentation/how-to-debug-or-identify-the-map-loading-problems-in-admin-panel?utm_source=gmap-embed&utm_medium=wordpress-plugin&utm_campaign=documentation&utm_content=readme-troubleshoot-list)

**Note:** According to [Google Documentation](https://cloud.google.com/maps-platform/pricing), you can use Google Maps for **FREE** up to $200 USD credit each month.

== Features of Lite version (FREE) ==
* ✅ Basic Map and Marker support
* ✅ Responsive design for all devices
* ✅ Draggable markers for precise location picking
* ✅ Fully Customizable (Custom width/height)
* ✅ Ability to change zoom level (1-22)
* ✅ Map Language and Regional Area Settings
* ✅ Google Map Autocomplete for easy address entry
* ✅ Advanced Map Control Options (Enable/Disable zoom, pan, map types, etc.)
* ✅ Custom CSS & JS support for advanced styling
* ✅ Custom Marker Icons (Upload your own)
* ✅ Google Map Street View integration
* ✅ Standard Map Types supported (Roadmap, Terrain, Satellite, and Hybrid)
* ✅ Shortcode support for Pages, Posts, and Widgets
* ✅ No coding required! Super easy to use.

== Features of PREMIUM version (PRO) ==
* ✅ Unlimited Maps - Create as many as you need
* ✅ Unlimited Markers - No restrictions on marker count
* ✅ Advanced Store Locator with powerful search options
* ✅ Marker Listing Themes:
    * ✅ Basic List
    * ✅ Basic Table
    * ✅ Advanced Table
    * ✅ Carousel
* ✅ Directions Support:
    * ✅ Legacy Design (Classic layout)
    * ✅ Modern Drawer (Sleek side-panel UI)
* ✅ Real-time Category Filtering for instant results
* ✅ Advanced Category Filtering (Multiple selection logic)
* ✅ Import/Export (JSON & CSV) for easy migration and backups
* ✅ Custom Styled Map Themes (JSON based)
* ✅ Add multiple maps on the same page

== SHORTCODE USAGE ==
Use as shortcode in Post, Page, and Sidebar:
`[gmap-embed id="YOUR_MAP_ID"]`

Use in PHP code:
`<?php echo do_shortcode('[gmap-embed id="YOUR_MAP_ID"]');?>`

== POSSIBLE USE CASES ==
* **Store Locator**: Create a high-performance store locator for retail branches with search and radius filters.
* **Contact Us Page**: Integrate a sleek, responsive map to showcase your office or business headquarters.
* **Real Estate Listings**: Display properties with detailed markers, custom icons, and listing themes.
* **Business Directories**: Create a directory of multiple locations with interactive info windows and images.
* **Travel & Tourism Maps**: Map out tourist destinations, landmarks, and routes with Google Map directions.
* **Event & Venue Mapping**: Showcase multiple event locations for festivals, conferences, or local meetups.
* **Service Area Maps**: Highlight your service coverage areas or pickup points with customizable map styles.

Contact us if you have any problems with installation or anything else.
Email: **milonfci@gmail.com**

== Installation ==

Installing WP Google Map is a breeze:

1. **Upload**: Upload the `gmap-embed` folder to the `/wp-content/plugins/` directory, or install it directly via the WordPress admin search.
2. **Activate**: Activate the plugin through the 'Plugins' menu in WordPress.
3. **API Key**: Go to the plugin settings page and enter your Google Maps API Key (you'll find links to tutorials if you don't have one).
4. **Create Map**: Click on 'Add New' under the 'WP Google Map' menu to create your first map.
5. **Shortcode**: Copy the generated shortcode and paste it into any Post, Page, or Sidebar Widget.

For a detailed walkthrough, see our **[Complete Installation Guide](https://wpgooglemap.com/documentation/wp-google-map-quick-installation?utm_source=gmap-embed&utm_medium=wordpress-plugin&utm_campaign=documentation&utm_content=readme-install-tab)**.

== Upgrade Notice ==

Upgrade WP Google Map Plugin from [here](https://wpgooglemap.com/download-wp-google-map?utm_source=gmap-embed&utm_medium=wordpress-plugin&utm_campaign=upgrade-to-pro&utm_content=readme-upgrade-notice) to get updated features.

== Frequently Asked Questions ==

= How do I get my own Google Map API key? =
You can get an API key from the Google Cloud Console. Follow our **[detailed guide here](https://wpgooglemap.com/documentation/how-to-get-google-map-api-key?utm_source=gmap-embed&utm_medium=wordpress-plugin&utm_campaign=documentation&utm_content=readme-faq)** or watch our **[video tutorial](https://youtu.be/ErRy5lqTPjY?t=23)**.

= How can I create a new Map? =
Go to **WP Google Map** -> **Add New** in your WordPress dashboard. Set your title, location, and markers, then save.

= How do I add a map to my page? =
Simply copy the shortcode (e.g., `[gmap-embed id="123"]`) from the map list page and paste it into your page's content.

= Can I use multiple markers on one map? =
Yes! The Premium version allows you to add unlimited markers per map. The Lite version supports one marker per map.

= How do I enable the Store Locator? =
The Store Locator is a Premium feature. Once you upgrade, you'll see a 'Store Locator' tab in the map editor where you can enable and customize it.

= How do I display a Marker List below the map? =
Marker Listing is a Premium feature that allows you to show a list of all markers in various themes like Basic List, Basic Table, Advanced Table, or Carousel. You can enable it in the 'Marker Listing' tab within the map editor.

= How do I export or import map data? =
Import/Export is a Premium feature that allows you to backup your maps and markers or migrate them to another site. You can find these options under the 'Export' and 'Import' tabs in the WP Google Map settings page.

= Does it support responsive design? =
Absolutely! All maps created with this plugin are 100% responsive and will adapt to any screen size.

## Privacy Policy
WP Google Map uses [Appsero](https://appsero.com) SDK to collect some telemetry data upon user's confirmation. This helps us to troubleshoot problems faster & make product improvements.

Appsero SDK **does not gather any data by default.** The SDK only starts gathering basic telemetry data **when a user allows it via the admin notice**. We collect the data to ensure a great user experience for all our users.

Integrating Appsero SDK **DOES NOT IMMEDIATELY** start gathering data, **without confirmation from users in any case.**

Learn more about how [Appsero collects and uses this data](https://appsero.com/privacy-policy/).

== Screenshots ==

1. **Dashboard**: WP Google Map Quick Setup.
2. **Map Editor**: Interface for creating and configuring your maps.
3. **Marker Settings**: Adding and customizing markers with description, image, and icons.
4. **Marker Listing**: Configuring the Marker Listing Style and related settings.
5. **Store Locator**: Configuring the Store Locator Style and related settings.
6. **Category Settings**: Creating and Modifying the Categories.
7. **Settings**: Export existing Maps & Markers.
8. **Settings**: Importing bulk Maps & Markers data.
9. **Shortcode Copy**: Easy copy-to-clipboard for map shortcodes.
10. **Page Editor**: Serch for shortcode to add the shortcode to a page or post.
11. **Page Editor**: Adding the shortcode to a page or post.
12. **Frontend View**: How the map looks to your visitors.
13. **General Settings**: Plugin-wide configuration options.

== Changelog ==

= 1.9.6 =
* **Quick Fix** Classic widget shortcode preview issue fixed.

= 1.9.5 =
* **Feature:** Added "Advanced Store Locator".
* **Feature:** Added "Category Add/Edit/Tag with Marker UI".
* **Feature:** Added "Marker Listing" with customized position and layout.
* **Feature:** Added "Title/Label Search" for marker listing.
* **Feature:** Added "Soring by Distance and related address fields" for marker listing.
* **Feature:** Added "Customized Animation" for the Markers.
* **Feature:** Added "Modern Direction Drawer UI" with sleek side-panel experience.
* **Feature:** Added "Get Directions" link directly inside Marker InfoWindows.
* **Feature:** Added Sample download links for CSV/JSON imports.
* **UI/UX:** Added modern tab-based Settings UI (General, Advance, Export, Import, Marker).
* **Security:** Enhanced direct file access protection for all core PHP files.
* **Security:** Scheduled security enhancements.

= 1.9.4 =
* Scheduled security enhancements.

= 1.9.3 =
* Early load of textdomain compatibility issue fixed.

= 1.9.2 =
* Settings added for minimum set for Map plugin use.
* On Plugin acitvation redirection disabled.

= 1.9.1 =
* Google Mapi API loading without callback warning fixed
* API key generate via Google Maps Platform implemented
* Appsero client updated to latest version
* Minor bugs fixing

= 1.9.0 =
* Auto-Complete/Auto suggestion option added for direction From/To input field
* Added Distance Unit (Miles and KM) configurable
* UI modified for better experience.
* Google Mapi API loading without callback warning fixed
* API key generate via Google Maps Platform implemented
* Appsero client updated to latest version

= 1.8.9 =
* Copy to clipboard for map shortcode
* Default markers bundle added
* CADATA introduced for frontend


= 1.8.8 =
* New UI screenshots updated in wp.org
* Map Theme option introduced including custom theme JSON.

= 1.8.6 =
* Marker content update issue fixing
* Code optimized with WordPress Standard
* Ajax Datatable js error fixing

= 1.8.5 =
* Code Optimization
* Security enhancement

= 1.8.4 =
* CSRF issue fixing
* Tabs UI update
* Marker Icon preview issue fixing
* DB query and code optimized

= 1.8.3 =
* Ajax Security issues resolved
* Marker Edit page minor bug fixing

= 1.8.2 =
* Clickable marker infowindow introduced.

= 1.8.1 =
* Hot fix: Security issue fixed.

= 1.8.0 =
* Multiple Marker system introduced.
* Complete Admin UI updated for a better experience.
* Datatable introduced for Map and Marker listing.
* Added advanced option for API load restriction, prevent other map API loading with user consent.
* Support page modified for better support.
* Marker Description and Image attachment support implemented.
* Security improvement.

= 1.7.7 =
* Minor bug fixing
* Autoloader class implemented
* Map control options added(disable zoom, disable street view option, disable drag, disable double click zoom, disable pan control)
* Security improvement
* Appsero SDK implement for prompt support to users


= 1.7.6 =
* Google Map Info Window auto focus bug fixed cause by google map last update

= 1.7.5 =
* media_buttons_context deprecated issue resolving
* Review system modification, made standard
* Code re-organize with trait system
* Admin UI updated to more user friendly
* In case of shortcode not found shown a custom message only for logged in admin user
* According to plugin guide updated code and optimized

= 1.7.4 =
* Setup Wizard implementation for user Better experience
* Installation wizard video and blog Help Manual included
* Installation and knowledge base updated
* PHP and JS Source optimized
* Minor bug fixing in Block Editor

= 1.7.3 =
* Custom CSS and JS adding option under settings tab.
* Map direction UI re-designed and made responsive for various themes.
* If short code not found, will show a custom message in front end.
* Settings UI design changed for better user experience.
* Made responsive for cross-platform
* media_buttons_context deprecated issue resolving
* Review system modification, made standard
* Code re-organize with trait system
* Admin UI updated to more user friendly
* In case of shortcode not found shown a custom message only for logged in admin user

= 1.7.2 =
* Map Center position auto detection on drag-drop and re-centering by user.
* LIVE zoom updating and rendering once zoom level changed by user.

= 1.7.1 =
* HTML content support in Google Map InfoWindow
* Added select drop-down in WP Google Map widget instead of text box for ShortCode.
* Disable admin notice for language based google setup.

= 1.7.0 =
* Browser geolocation timeout related problem solved, youtube video updated.

= 1.6.9 =
* Domain SSl related issue fixing for non-ssl websites.

= 1.6.8 =
* Helpful video presentation has been added.

= 1.6.7 =
* Admin notices for google map language and regional area settings made conditional.

= 1.6.6 =
* PHP array related exception handled.

= 1.6.5 =
* Javascript exception handled in Map edit page

= 1.6.4 =
* Map language and Region customization option added.
* Form and field level security enhanced.
* Secured domain added for mail and verification process.
* Support contact mail issue fixed.

= 1.6.3 =
Exception handled for warning message, security enhanced, review giving option added.

= 1.6.2 =
Security feature updated and feedback resolving.

= 1.6.1 =
Shortcode related dynamic title class and id updated and bug fixing.

= 1.6.0 =
Address autocomplete bug fixing.

= 1.5.9 =
Map direction view option changed.

= 1.5.8 =
Create new Map UI changes.

= 1.5.7 =
Security patch updated.

= 1.5.6 =
Helpful video tutorial added.

= 1.5.5 =
Language realted changes and some minor changes in files.

= 1.5.4 =
Dynamic/Customized Marker icon option added, Code related optimization added.

= 1.5.3 =
New version released with payment option updated.

= 1.5.2 =
New version released with bug fixing

= 1.5.1 =
New version released with helpful resources and insitilization of street view.

= 1.5.0 =
New version released with new helpful video

= 1.4.9 =
* Map title on keyup effect added
* Map type wise map rendering live
* Infowindow live changing when updating
* Address related API issue fixing

= 1.4.8 =
* License key and api key updating problem server issue fixed.

= 1.4.7 =
* How to add Google Map in Gutenberg Wordpress editor.

= 1.4.6 =
* Removed update to pro once updated to pro version

= 1.4.5 =
* Plugin Settings option updated

= 1.4.4 =
* LIVE CHAT option added for users.

= 1.4.3 =
* Faq and contact page updated.

= 1.4.2 =
* Bug fixing, Added instant contact form to give best experience and getting suggestion from users.

= 1.4.1 =
* User help manual, FAQ and details description updated, also bug fixed.

= 1.4.0 =
* Settings option updated.

= 1.3.9 =
* Added pro version features and updated shortcode.

= 1.3.8 =
* Google API readme updated, language and donation button added.

= 1.3.7 =
* Google API realted update

= 1.3.6 =
* Google API realted update

= 1.3.5 =
* Google API realted update

= 1.3.4 =
* Direction From field default to empty, Readme file updated with Google Billing warning message.

= 1.3.3 =
* Spanish language files updated.

= 1.3.2 =
* Danish Language Translation support updated.

= 1.3.1 =
* Danish Language Translation support added.

= 1.3.0 =
* German, German (Formal) and Spanish (Spain) Language file updated.

= 1.2.9 =
* Examples button and Donation Button added.

= 1.2.8 =
* Tags updated in readme.txt file.

= 1.2.7 =
* Readme file updated.

= 1.2.6 =
* Translation enabled for some additional text.

= 1.2.5 =
* Installation process explained in details.

= 1.2.4 =
* CSS updated related to map search box

= 1.2.3 =
* Spanish Language support

= 1.2.2 =
* Italian Language Support

= 1.2.1 =
* Direction support Bug fixing

= 1.2.0 =
* Direction support with Google Map

= 1.1.7 =
* Look and Feel changes

= 1.1.6 =
* Added option for creating unlimited maps(the Previous limit was 10)

= 1.1.5 =
*  Widget title giving option added

= 1.1.4 =
*  Added option to disable/enable zoom on mouse scrolling

= 1.1.2, 1.1.3 =
*  Small bug fixes

= 1.1.1 =
*  Menu Position changed and readme.txt updated

= 1.1.0 =
*  Initial Translation support for English(en), Bengali(bn) and German(de)

= 1.0.9 =
*  https or SSl related problem fixing

= 1.0.8 =
*  Initial marker dragging related problem fixing
*  API key trailing blank space removed

= 1.0.7 =
*  Added helpful video both in description and admin panel

= 1.0.6 =
*  Custom map heading class adding option added
*  Map rendering related problem fixing
*  Custom status message showed

= 1.0.5 =
*  Added new helpful video with how to get Free API key

= 1.0.4 =
*  Once plugin activated, goes to plugin settings page directly.

= 1.0.3 =
*  Self API key adding option added


= 1.0.2 =
*  Bug fixes with adding helpful video embedding


= 1.0.1 =
*  Updated screenshots with the FAQ to make easier.


= 1.0.0 =
*  Initial version of WP Google Map Plugin.
