=== MapPin – Location & Store Locator ===
Contributors: rakibulislamdev
Tags: store locator, map, openstreetmap, leaflet, dealer locator
Requires at least: 5.5
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A lightweight location and store locator plugin for WordPress powered by OpenStreetMap. Add and manage locations easily — no API key required.

== Description ==

**MapPin – Location & Store Locator** is a lightweight and multipurpose location map plugin for WordPress. It uses OpenStreetMap and Leaflet.js, allowing you to display locations effortlessly without relying on Google Maps or requiring a complex API key setup.

Whether you need a store locator, a dealer directory, or a clinic finder, MapPin provides a modern, responsive, and easy-to-configure solution.

= Key Features =

* **OpenStreetMap Powered** — No Google Maps API key required.
* **Unlimited Locations** — Add as many points of interest as you need.
* **Live Search** — Instant search by name, address, region, or country.
* **Smart Filtering** — Includes a country filter dropdown for better UX.
* **Marker Clustering** — Automatically groups nearby markers to keep the map clean.
* **Customizable Markers** — Set unique marker colors for different locations.
* **Dynamic Buttons** — Choose between "Get Directions" or a custom URL with custom text for every location.
* **URL Title Support** — Displays friendly link titles instead of messy, long URLs.
* **Enhanced Custom Fields** — Add extra info like WhatsApp, Facebook, Email, Phone, or Branch Code.
* **Fully Responsive** — Works perfectly on desktop, tablets, and mobile devices.
* **Easy Shortcode** — Use `[mappin_locator]` to display your map anywhere.

= Use Cases =

* Store & Dealer Locators
* Clinic, Hospital, or Pharmacy Directories
* Service Center Maps
* Event Location Finder
* Restaurant or Cafe Finders
* Real Estate Office Locators

= How It Works =

1. Install and activate the plugin.
2. Navigate to **MapPin > Add New** to create your locations.
3. Add custom fields or specific button links if needed.
4. Paste the shortcode `[mappin_locator]` into any page or post.
5. Publish and enjoy your interactive map!

= Third-Party Services =

This plugin loads map tiles from **tile.openstreetmap.org**. Requests to the tile server may include the visitor's IP address as part of normal web requests.

* OpenStreetMap Terms of Use: https://wiki.osmfoundation.org/wiki/Terms_of_Use
* OpenStreetMap Privacy Policy: https://wiki.osmfoundation.org/wiki/Privacy_Policy

= Developer =

Built with ❤️ by Rakibul Islam.
* LinkedIn: https://bd.linkedin.com/in/rirakeeb

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin panel.
2. Go to **Plugins > Add New**.
3. Search for **MapPin – Location & Store Locator**.
4. Click **Install Now**, then **Activate**.

= Manual Installation =

1. Download the plugin zip file.
2. Go to **Plugins > Add New > Upload Plugin**.
3. Upload the zip file and click **Install Now**.
4. Activate the plugin.

== Frequently Asked Questions ==

= Do I need a Google Maps API key? =
No. MapPin uses OpenStreetMap, which is free and requires no API key.

= Can I customize the map appearance? =
Yes. You can configure colors and map behavior through the MapPin settings page.

= Is it mobile-friendly? =
Yes. The layout is fully responsive and works smoothly on all devices.

= Is it translation ready? =
Yes. The plugin is fully translation-ready.

== Screenshots ==

1. Frontend map view with location list and search tools.
2. Admin location management list.
3. Modern Add/Edit location interface.
4. Map configuration settings.
5. Custom fields setup.

== Changelog ==

= 1.0.0 =
* Initial release.
* OpenStreetMap & Leaflet.js integration.
* Marker clustering and live search.
* Custom fields and dynamic button support.
* Fully responsive UI/UX.

== Upgrade Notice ==

= 1.0.0 =
Initial release of MapPin – Location & Store Locator.