=== MapSamurai Lite ===
Contributors: mapsamurai
Tags: maps, map plugin, store locator, wordpress map, custom maps
Requires at least: 5.0
Tested up to: 6.9
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, mobile-friendly map builder for WordPress. Create store locators and location maps with unlimited locations.

== Description ==

**Build fast, modern store-locator and location maps for WordPress — no Google Maps, no API keys, no clutter.**

Designed for speed, simplicity, and flexibility, MapSamurai Lite includes:

• **Unlimited locations** with instant search & filters  
• **Location Directory** for quickly scanning locations  
• **Fast, responsive frontend** that works on mobile  
• **Shortcodes & blocks** — place maps anywhere 
• **Page builder friendly** for Elementor, Divi, etc.

MapSamurai Lite is built for modern WordPress sites that want fast, flexible maps that simply work.

📚 [View full documentation](https://mapsamurai.com/documentation-lite)
📚 [View the Demo](https://mapsamurai.com/mapsamurai-free-version/)


== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`
Alternatively, you can upload the plugin’s ZIP file via Plugins > Add Plugin in your WordPress admin panel.
2. After installing the plugin, activate the plugin by clicking the “Activate” button, and that’s it! You’re ready to setup your map
3. Navigate to **MapSamurai Lite > Maps** to set up your first map
4. Navigate to **MapSamurai Lite > Map Locations** to start creating locations

To display your map on the frontend, use the shortcode generated at the top of your Map Settings page. It will look like this: `[mapsamurai_map map_id="123" height="600" width="600"]` (you can edit the height and width as needed). Simply copy and paste that shortcode anywhere you'd like your map to appear throughout your site.

All steps are covered in detail in [our documentation](https://mapsamurai.com/documentation-lite)

== Frequently Asked Questions ==

= Why doesn't MapSamurai Lite use Google Maps? =

MapSamurai Lite uses OpenStreetMap instead of Google Maps to avoid API keys, usage limits, and privacy concerns. This makes maps faster to set up, and free from usage-based fees or changing terms.

= Who is this plugin made for? =

MapSamurai Lite is perfect for WordPress Developers and website owners who need to showcase locations on a map. This could be for tour sites, small businesses that wish to add a store locator, event planners, and more. If you need a straightforward way to showcase map locations with rich details and media, then this plugin is a perfect fit.

= What's included on the front-end maps? =

The front end map includes the following features:

• Fully responsive interactive map.
• Unlimited locations with custom content
• Image and video galleries in clean modal popups
• Custom tooltip content: The details that appear when hovering over each location.
• Interactive Location Directory: An organized list of locations for easy search.
• City and zip-code based search

= Can I create more than one map? =
Yes! MapSamurai Lite supports unlimited maps across your site, so build as many as you like! Though this free version is perfect for many mapping solutions, [upgrade to MapSamurai Pro](https://mapsamurai.com) for fully 3D maps, AI generated content, and a ton more features.

= How many locations can I add? =
You can add as many locations as you like to any of your maps, each with their own unique gallery and location details.

= Is MapSamurai Lite beginner friendly? =
MapSamurai Lite is a powerful yet extremely easy to use plugin. After you upload and activate the plugin, anyone can build the map in a few short steps, and adding custom locations is just as simple. To get an idea of how it works, [see our full documentation](https://mapsamurai.com/documentation-lite)

= Is there a Pro version? =
  Yes! [MapSamurai Pro](https://mapsamurai.com) includes dozens of additional features, including an AI-Assistant that cuts workloads in half, map clusters, 3D maps, and so much more!

= Will my data carry over if I upgrade? =
Yes! All locations and settings created in the Lite version will automatically be available if you choose to upgrade.


== Screenshots ==

1. Build fast store locators with no Google Maps or API keys
2. Add rich details, images, and video to every location
3. Manage locations quickly from a clean, beginner-friendly admin UI

== External Services ==

This plugin uses third-party services to display maps and optional video content.

• OpenStreetMap – Loads map tiles when a map is viewed. Sends map coordinates only (no personal data).  
  Terms: https://wiki.osmfoundation.org/wiki/Terms_of_Use  
  Privacy: https://wiki.osmfoundation.org/wiki/Privacy_Policy  

• Vimeo and YouTube (optional) – Used only when an admin adds a video URL. No visitor data is sent by the plugin itself.

== Source Code ==
This plugin includes compiled JavaScript files. All original source files are included. Third-party libraries used: Leaflet.js (BSD), Slick Carousel (MIT), Owl Carousel (MIT), jQuery Easing (BSD).


== Changelog ==

= 1.0.0 =
* Initial release of MapSamurai Lite

== Credits ==

Map rendering powered by [Leaflet.js](https://leafletjs.com)

