=== Store Locator WordPress ===
Contributors: agilelogix
Author URI: https://agilelogix.com/
Plugin URI: https://agilestorelocator.com/
Tags:  store locator, location finder,google maps, directions,store finder, geocoding,business locations, google maps plugin, map directions, nearest stores, routes, street view, store locator widget, wp google maps, wp store locator,geolocation
Requires at least: 3.3.2
Tested up to: 7.0
Donate link: https://agilelogix.com/product/agile-store-locator/?utm_source=wordpress-org&utm_medium=plugin&utm_campaign=free-version&utm_content=upgrade-link
Stable tag: 1.7.3
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Agile Store Locator is a premium store finder plugin designed to offer you immediate access to all the best stores in your local area. It enables you to find the very best stores and their location thanks to the power of Google Maps.

== Description ==

[Agile Store Locator](https://agilestorelocator.com/) is a free **WordPress Store Locator Plugin** that helps customers find your stores, dealers, branches, retailers, offices, and service centers using **Google Maps**. Add unlimited store locations, display interactive maps, and let visitors search by address, ZIP code, city, category, or their current location—all without writing code.

Whether you manage a single storefront or hundreds of business locations, Agile Store Locator makes it easy to build a fast, mobile-friendly store finder that works with any WordPress theme. The free version includes powerful features like custom fields, SEO-friendly location pages, and flexible store management, while the Pro version adds CSV import, multiple templates, analytics, advanced customization, search widgets, store registration forms, and many more professional tools.
## 🌟 Key Features & Benefits

### 📍 Unlimited Store Locations
Create a store locator with unlimited stores, dealers, branches, retailers, offices, or service centers. Add detailed information, images, business hours, contact details, and custom markers for every location.

### 🔍 Powerful Store Search
Help visitors quickly find the nearest location by searching with an address, ZIP code, city, store name, category, or their current location. Results can also be sorted by distance or relevance.

### 🗺️ Interactive Google Maps
Display all your locations on responsive Google Maps with marker clustering, directions, Street View, multiple map types, and support for Google Advanced Markers.

### ✍️ Flexible Custom Fields
Store additional information such as business hours, phone numbers, emails, social links, galleries, services, promotions, or any custom data using flexible custom fields.

### 🌐 SEO-Friendly Location Pages
Create dedicated location pages for every store with unique URLs, business information, images, and structured content that helps customers discover your locations through search engines.

### 📱 Mobile-Friendly Design
Deliver a fast and responsive store locator that works perfectly across desktop, tablet, and mobile devices without requiring additional customization.

### 🎨 Easy Map & Layout Customization
Customize map styles, marker icons, colors, zoom levels, languages, labels, and layouts to match your website and brand.

### 🌍 Multiple Languages & RTL Support
Display your store locator in multiple languages with full RTL support, making it suitable for international businesses and multilingual WordPress websites.

### 🔒 Privacy & GDPR Ready
Support GDPR compliance with Google Maps consent options and compatibility with popular cookie consent solutions.

### 🚀 Upgrade to Pro
Unlock even more features including CSV import/export, multiple templates, analytics, store registration forms, search widgets, advanced customization, category management, and many more professional tools.

---
## 🛠️ How It Works

### 1️⃣ Install the Plugin
Install Agile Store Locator from the WordPress Plugin Directory or upload it manually like any other WordPress plugin.

### 2️⃣ Add Your Store Locations
Create your store locations by adding addresses, business details, categories, custom fields, images, and opening hours.

### 3️⃣ Connect Google Maps
Add your [Google Maps API Key](https://agilestorelocator.com/blog/enable-google-maps-api-agile-store-locator-plugin/?utm_source=wordpress-org&utm_medium=plugin&utm_campaign=free-version) to enable maps, address search, directions, and geolocation.

### 4️⃣ Display Your Store Locator
Place the `[ASL_STORELOCATOR]` shortcode on any page or post to instantly display your interactive Store Locator.
---
## 🚀 Unlock More with Agile Store Locator Pro

Upgrade to Agile Store Locator Pro and access powerful tools designed for growing businesses, franchises, retailers, dealers, and enterprises managing multiple locations.

### 📥 [Bulk Import & Export](https://agilestorelocator.com/wiki/can-import-stores-using-excel-sheet/?utm_source=wordpress-org&utm_medium=plugin&utm_campaign=free-version)
Import or export thousands of store locations with CSV files, making it easy to migrate, update, and manage large store networks.

### 🎨 [Multiple Templates & Layouts](https://agilestorelocator.com/wiki/store-locator-templates/?utm_source=wordpress-org&utm_medium=plugin&utm_campaign=free-version)
Choose from multiple professionally designed templates, list layouts, grid layouts, accordion views, and category layouts to match your website.

### 📊 [Store Locator Analytics](https://agilestorelocator.com/wiki/intro-store-locator-analytics/?utm_source=wordpress-org&utm_medium=plugin&utm_campaign=free-version)
Track customer searches, popular locations, top-performing stores, and user activity with built-in analytics and reporting dashboards.

### 🔍 [Store Search Widget](https://agilestorelocator.com/wiki/address-search-widget/?utm_source=wordpress-org&utm_medium=plugin&utm_campaign=free-version)
Let visitors search for nearby stores directly from your homepage, sidebar, landing pages, or any widget area before opening the full Store Locator.

### 📝 [Store Registration Form](https://agilestorelocator.com/wiki/store-registration-form/?utm_source=wordpress-org&utm_medium=plugin&utm_campaign=free-version)
Allow dealers, franchisees, retailers, or business partners to submit new store locations through a customizable registration form with administrator approval.

### ⚙️ [Advanced Customization](https://agilestorelocator.com/wiki/customization-of-store-locator/?utm_source=wordpress-org&utm_medium=plugin&utm_campaign=free-version)
Customize colors, fonts, templates, map styles, search filters, labels, and layouts to perfectly match your website and brand.

### 🌍 [Multiple Languages & RTL Support](https://agilestorelocator.com/wiki/data-wpml/?utm_source=wordpress-org&utm_medium=plugin&utm_campaign=free-version)
Build multilingual Store Locator experiences with full RTL support for international businesses and WordPress websites.

💡 **Perfect for** franchises, dealer networks, retailers, distributors, service centers, healthcare providers, restaurants, real estate agencies, and businesses with multiple locations.

### ⭐ Free Features

#### 📍 Store Management
- Unlimited store locations
- Duplicate stores with one click
- Delete all stores with one click
- Store logos and galleries
- Custom fields
- Multiple business hours
- 12/24-hour time format
- Assign multiple categories
- Store priority management
- SEO-friendly Location Pages
- Store Detail Pages
- CTA buttons
- GDPR Compliance

#### 🔍 Search
- Google Places Autocomplete
- Current location detection
- Nearest store search

#### 🗺️ Google Maps
- Google Maps integration
- Google Advanced Markers
- Marker clustering
- Draggable markers
- Driving directions
- Street View
- Traffic, Transit & Bicycle layers
- Hybrid, Roadmap, Satellite & Terrain maps
- Map language & region support
- Adjustable zoom
- Full-screen maps
- Scroll wheel control

#### 🎨 Customization
- Responsive design
- Full-width layout
- Color customizer
- Font customizer
- InfoWindow customization
- Store list customization
- Placeholder text
- Shortcode overrides

### 🚀 Pro Features

#### 📥 Bulk Import & Store Management
- CSV Import & Export
- Bulk editing tools
- Scheduled synchronization (Cron Jobs)
- Import automation
- Store schedules & opening hours management

#### 🔍 Advanced Search & Filtering
- Radius search
- Distance slider
- Additional filter dropdowns
- Cascading dropdown filters
- Category & sub-category filters
- AND filtering logic
- Search within map bounds
- Country-restricted search
- Search Widget
- Display matching locations while searching
- Store Database Search
- Store by Store Names

#### 📝 Store Registration & Lead Capture
- Store Registration Form
- Lead Forms with nearest store routing

#### 🗺️ Advanced Google Maps
- Advanced Google Maps customization
- Category-specific markers
- Time Switch (Open Now / Business Hours)
- Multiple map templates & styling options

#### 🎨 Premium Templates & Layouts
- 8 premium Store Locator templates
- Grid Layout
- Accordion Layout
- Category Layout
- Profile Layout

#### 📊 Analytics & Insights
- Search analytics
- Store analytics
- Top searched locations
- Most viewed stores

#### 🌍 Enterprise & Integrations
- WooCommerce Multi-Store integration
- REST API integration
- Google Business Profile synchronization
- Multi-language store data support

---

## 🏬 Perfect for Every Business with Multiple Locations

Agile Store Locator helps businesses of every size create interactive Google Maps that make it easy for customers to find stores, dealers, offices, service centers, and business locations. Whether you operate a few locations or thousands worldwide, Agile Store Locator adapts to your business.

### Popular Use Cases

- 🚗 **[Dealer Locator](https://agilestorelocator.com/dealer-locator/)** – Display car dealers, equipment dealers, distributors, and partner networks.
- 🏢 **[Branch Locator](https://agilestorelocator.com/branch-locator/)** – Help customers find bank branches, offices, and business locations.
- 🛍️ **[Retail Store Locator](https://agilestorelocator.com/retailer-locator/)** – Showcase retail stores, shopping centers, and chain locations.
- 🛠️ **[Service Center Locator](https://agilestorelocator.com/service-center-locator/)** – Display repair centers, support locations, and maintenance facilities.
- 🤝 **[Agent Locator](https://agilestorelocator.com/agent-locator/)** – Connect customers with agents, representatives, consultants, and local partners.
- 🏬 **Franchise Locator** – Help customers discover franchise locations across multiple regions.
- 📦 **Warehouse & Distributor Locator** – Display warehouses, fulfillment centers, and distributors.
- 🏥 **Healthcare Locator** – Hospitals, clinics, pharmacies, laboratories, and healthcare providers.
- 🍽️ **Restaurant Locator** – Restaurants, cafés, food chains, and takeaway locations.
- 🏨 **Hotel & Hospitality Locator** – Hotels, resorts, and accommodation providers.
- 🏠 **Real Estate Locator** – Offices, developments, agencies, and property locations.
- 🎓 **Education Locator** – Schools, universities, campuses, and training centers.
- 🏋️ **Fitness Locator** – Gyms, sports clubs, fitness centers, and wellness studios.
- 🛒 **Shopping Mall Locator** – Shopping malls, supermarkets, and convenience stores.
- 🐾 **Pet Store & Veterinary Locator** – Pet shops, veterinary clinics, and animal hospitals.
- ⚖️ **Professional Office Locator** – Legal firms, accounting offices, insurance agencies, and consulting businesses.

And many more. If your business has physical locations, Agile Store Locator helps customers find them quickly using Google Maps and intelligent location search.

---
## 🌍 Global Support & Compatibility

### 🌐 Built for Global Businesses

Agile Store Locator supports multilingual WordPress websites with translations available in multiple languages, including:

- 🇺🇸 English
- 🇩🇪 German
- 🇫🇷 French
- 🇪🇸 Spanish
- 🇮🇹 Italian
- 🇳🇱 Dutch
- 🇵🇹 Portuguese
- 🇸🇦 Arabic (RTL)
- 🇯🇵 Japanese

The plugin also supports **RTL (Right-to-Left)** languages, making it an excellent choice for businesses serving customers around the world.

### 💻 Works with Your Favorite WordPress Tools

Agile Store Locator is designed to work seamlessly with modern WordPress websites and is compatible with:

- WordPress 6.x+
- Elementor
- Divi
- WPBakery Page Builder
- Gutenberg
- Astra Theme
- Avada Theme
- GeneratePress
- Kadence Theme
- Blocksy Theme
- WooCommerce
- GeoDirectory
- Most WordPress themes and plugins

---

## 🎉 Live Demos & Integrations

### 🖥️ Explore Agile Store Locator

See Agile Store Locator in action and discover different layouts, templates, and real-world implementations.

- 🌐 **[Live Store Locator Demo](https://agilestorelocator.com/demos/)**
- 📍 **[Location Pages Demo](https://agilestorelocator.com/features/location-pages/)**
- 🔍 **[Store Search Widget](https://agilestorelocator.com/features/store-search-widget/)**
- 📝 **[Store Registration Form](https://agilestorelocator.com/features/store-registration-form/)**


### Store Locator Templates

- 🎨 [Classic Template](https://agilestorelocator.com/demos/store-locator-demo/)
- 💼 [Professional Layout](https://agilestorelocator.com/demos/store-locator-demo-1/)
- 📂 [Category Layout](https://agilestorelocator.com/demos/store-locator-demo-2/)
- 👤 [Profile Layout](https://agilestorelocator.com/demos/store-locator-demo-3/)
- 🟦 [Grid Layout](https://agilestorelocator.com/demos/store-locator-demo-4/)
- 📋 [Accordion Layout](https://agilestorelocator.com/demos/store-locator-demo-5/)
- 📍 [Minimal Layout](https://agilestorelocator.com/demos/store-locator-demo-6/)

👉 Browse all demos: https://agilestorelocator.com/demos/

---

## 🛒 WooCommerce Multi-Store Integration

Need more than a Store Locator?

Agile Store Locator integrates seamlessly with **[Multi Store Addons for WooCommerce](https://agilestorelocator.com/multistore-woocommerce-addons/)**, allowing you to manage inventory, local pickup, shipping, and store selection directly inside WooCommerce.

### Key Features

- 📦 Local Pickup by Store
- 🏬 Store Selector for WooCommerce
- 🚚 Distance-Based Shipping
- 💰 Table Rate Shipping
- 📍 Store-Based Payment Methods
- 📊 Store Manager Dashboard
- 🛒 Multi-Store Inventory Management
- 🔄 Store List Widgets

For Help, Please create a ticket here, we will reply at our earliest. https://wordpress.org/support/plugin/agile-store-locator

== Frequently Asked Questions ==

= How do I add the Store Locator to a page? =

Simply create a page and add the shortcode:

[ASL_STORELOCATOR]

The Store Locator will automatically display on that page.

= Does Agile Store Locator work with Elementor? =

Yes. Agile Store Locator works with Elementor, Gutenberg, Divi, WPBakery, and virtually all modern WordPress themes.

= Can I create unlimited store locations? =

Yes. You can create and manage unlimited stores, categories, markers, and locations.

= Can I import stores from a CSV file? =

Yes. CSV Import & Export is available in the Pro version, allowing you to import thousands of store locations in minutes.

= Does the plugin support Google Maps? =

Yes. Agile Store Locator uses Google Maps and supports Google Places Autocomplete, Advanced Markers, Marker Clustering, Driving Directions, Traffic Layers, and much more.

= Why isn't Google Address Autocomplete working? =

Usually this happens because:

- Your Google Maps API key is missing or restricted.
- The Places API is not enabled.
- Google Maps is being loaded multiple times.

Read the troubleshooting guide:
https://agilestorelocator.com/wiki/plugins-map-slow-malfunctioning/

= Why do I see "Oops! Something went wrong" on the map? =

This usually indicates that your Google Maps API key is missing, invalid, or doesn't have the required APIs enabled.

Follow our setup guide:
https://agilestorelocator.com/blog/enable-google-maps-api-agile-store-locator-plugin/

= Why is my map loading twice or behaving unexpectedly? =

The most common reason is that Google Maps has been loaded multiple times by your theme or another plugin.

See our troubleshooting guide:
https://agilestorelocator.com/wiki/plugins-map-slow-malfunctioning/

= Does the plugin support marker clustering? =

Yes. Marker Clustering is supported to keep maps fast and organized when displaying large numbers of locations.

= Does Agile Store Locator support category markers? =

Yes. The Pro version allows you to assign unique marker icons to each category.

= Does the plugin support multilingual websites? =

Yes. Agile Store Locator supports multiple languages and RTL (Right-to-Left) languages, making it suitable for international businesses.

= Why isn't GeoLocation working? =

Modern browsers require HTTPS (SSL) before allowing websites to access a visitor's location.

Read more:
https://agilestorelocator.com/blog/ssl-must-geolocation-api-chrome-browser/

= Does Agile Store Locator work with WooCommerce? =

Yes. Agile Store Locator integrates with the Multi Store Addons for WooCommerce plugin, enabling features like Local Pickup, Store-Based Shipping, Store Selector, and Multi-Store Inventory.

Learn more:
https://agilestorelocator.com/multistore-woocommerce-addons/

= Where can I find the documentation? =

Visit our complete documentation and tutorials:

https://agilestorelocator.com/wiki/

== Screenshots ==

1. Store Locator UI
2. FrontView with Infobox
3. FrontView with Direction Panel
4. Manage Stores
5. Map Customization
6. Create New Store
7. Manage Markers
8. Manage Logos
9. Manage Categories
9. ASL Settings



== Installation ==

Installation of this plugin is pretty easy.

1. Upload the extracted plugin folder to the `/wp-content/plugins/` directory of your WordPress installation, or upload it directly from your plugins section in the WordPress admin panel.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. That's it!


== Upgrade Notice ==

== Changelog ==

= 1.7.3 =
- AISEO plugin supported
- Third-party improvements

= 1.7.2 =
- Redesigned the dashboard with guided setup steps, quick actions, improved system information, and monthly search and interaction summaries
- Added dashboard onboarding progress for Google Maps setup, first-store creation, website placement, and locator color customization
- Redesigned the UI Customizer with dedicated CSS and JavaScript, a Template 0 live preview, corrected color mappings, and automatic theme-color updates from the primary color
- Disabled sample store, category, and store-category creation by default on new Pro installations

= 1.7.1 =
- Added configurable custom field placement in the Store Address or Other Details tabs
- Simplified the custom field manager for easier setup and clearer field controls
- Added one-time internal field name generation without renaming saved field keys, conditional choices, and safer field removal
- Added an Internal Page Link custom field with searchable local content and relative URL storage

= 1.7.0 =
- Added marker management, including uploading, editing, deleting, and assigning custom markers to stores
- Added Customize Map controls for map appearance, drawing colors, and frontend map controls
- Added store detail page options for country visibility and custom address formatting
- Improved store detail page styling and fixed admin asset loading

= 1.6.13 =
- Added an optional feedback survey when deactivating the plugin

= 1.6.12 =
- tab transition
- checkbox field issue
- Google Place ID integration


= 1.6.11 =
- Fix locator issue with Multi-Store Checkout

= 1.6.10 =
- UTM links updated

= 1.6.9 =
- Bulk edit Open Hours
- Support text in hours
- Security improvements

= 1.6.9 =
- Bulk edit Open Hours
- Support text in hours
- Security improvements

= 1.6.8 =
- Improvement in map style JSON Error

= 1.6.7 =
- Fixes in map style JSON


= 1.6.6 =
- Fixes in security

= 1.6.5 =
- CSS Fix
- Countries method

= 1.6.4 =
- Fix the WP 6.9 Updates issue

= 1.6.3 =
- Image Google Advanced Marker
- New Place API
- Route API Supported


= 1.6.2 =
- Font Customizer improvement
- Modal Geolocation improvement

= 1.6.1 =
- Fixed the SQL error
- Improvement in the ADA compliance
- Improvement in Color Customizer

= 1.6 =
- Migrated to Bootstrap 5
- Allow logos for the store


= 1.5.4 =
- Rich Editor for custom fields

= 1.5.3 =
- Security updates

= 1.5.2 =
- Security updates

= 1.5.1 =
- Camera Control Disable
- Ability to change store detail slug
- Compatible enhancement with Multi-Store Addon for WooCommerce
- Types of custom field including Gallery


= 1.5 =
- Enabled All Google Advanced Markers
- Import/Export Configuration
- Support for Render Field via [ASL_STORE]
- Fixed translation
- Field Open Hours
- Ignore_priority_with_distance attribute
- Distance_value_full to show full value of distance
- Translation updated

= 1.4.26 =
- Translate text updated
- Improved the get_by_slug

= 1.4.25 =
- Improved Slug for Latin Language
- Country restrict validation
- Fixed the Reload Locator (Multi-Store Addons for WooCommerce)

= 1.4.24 =
- Loading script method changed
- Fonts family adjustment
- SEO plugins compatibility


= 1.4.23 =
Added the Fitbound zoom option
AM/PM can be translated
Fixed the CSS issues

= 1.4.22 =
map_url=3.55


= 1.4.21 =
Changed the Multi-Store Addons
Fixed iOS UI issue
Custom Map issue fixed

= 1.4.20 =
Changed the wp_asl_config value field to type 'text'
Changed the Multi-Store Addons Banners


= 1.4.19 =
Fixed the store details page (Slug URL)


= 1.4.18 =
Compatible with Multi-Store Addons for WooCommerce (version 1.4)


= 1.4.17 =
Full Screen issue fixed
Direction hide fixed

= 1.4.16 =
Compatible with PHP 8.2

= 1.4.15 =
Models Update
Sanitization Improvements
jQuery UI Added with newer version

= 1.4.14 =
Labels Section
Google Advanced Markers
jQuery UI Removed
Menu will appear to Administrator only

= 1.4.13 =
AJAX request administrator validation

= 1.4.12 =
Replaced datatables with new version (1.13.5)
Replaced wp_json_encode with wp_send_json


= 1.4.11 =
KML fixed
compatible with Store Manager for Multi-Store Addons


= 1.4.10 =
Minor Fixes
Add Yoast SEO
Ability to Set the Zoom + Default Coordinates via Map

= 1.4.9 =
attribute validation
removed the deprecated Google events

= 1.4.8 =
Removed the Roboto Fonts due to GDPR
Template Customizer issue fixed


= 1.4.7 =
Remove the Google Fonts from CSS
JS error fix



= 1.4.3 =
Dashboard improved
Simple/Advanced option
ASL-WC Compatible
Grouped opening hours
UI Improvements


= 1.4.1 =
Minor edits
Bug fix

= 1.4 =
UI is revamped
Color Customizer
Font Customizer
KML files are supported
Google Maps customization
Supports Agile Stores Addons for WooCommerce - https://agilestorelocator.com/multistore-woocommerce-addons/
Lead Form to send email to closest store



= 1.3.2 =
Sorting stores are now case insensitive

= 1.3.1 =
Replaced "wp_localize_script" with local variable injection into the template
Added the missing "Open Direction in the New Tab"

= 1.3.0 =
Upgrade the Admin UI
Added Store Detail Pages
Added Remove Direction Option
Added Sort Random Option
Restrict Search now supports multiple countries
Call to action button type
Added Store JSON-LD


= 1.2.4 =
Change item class to sl-item for the list


= 1.2 =
Custom Field Option
10 New Feature added

= 1.1.2 =
New Icons Added
Show Email
Show Open Hours


= 1.1.1 =
Updated Help Guide
Translation Updated
More Compatible

= 1.1.0 =
Added Distance in List and InfoWindow
Multiple Time slots per Day
Updated the Backend of Locator
Some new awesome updates


= 1.0.3 =
Sweetalert conflict
Bootstrap Conflict
Delete All Stores Optin
Maps Language feature
Maps Region feature


= 1.0.2 =
Show Closest Stores first (Sort by distance)
Show Distance from location
Added lat/lng in the Listing
Added shortcode attribute support
Added User Current Location Marker
UI Improved
UI fixes

= 1.0.1 =
* Sweet Alert upgraded to new version
* UI has been updated
* Basic Dashboard with stats is Added
* Translated Added French
* Translated Added Spanish
* Translated Added German
* UI Improvements
* XSS Security improved
* Tested upto with 4.7.3
* Update Coordinates Manually through Add/Edit Store

= 1.0.0 =
* Map Clusters Added
* Change Coordinates as you drag marker
* Fixed Category issue
* Add Marker Clusters
* Initial Release


## 📚 Documentation & Support

For detailed documentation and support, visit the [Agile Store Locator Knowledge Base](http://agilestorelocator.com/wiki/?utm_source=wordpress-org&utm_medium=plugin&utm_campaign=free-version). If you have any questions, feel free to contact our support team at support@agilelogix.com
