Viro Filter Map & Store Locator

Viro Filter Map & Store Locator is a next-generation Store Locator for WordPress, designed to be blazing fast and visually stunning out-of-the-box.
Unlike older plugins that rely on heavy libraries like jQuery, Viro Filter Map & Store Locator is built with Vanilla Javascript and the native WordPress REST API.
This guarantees instant loading times, smooth map interactions, and zero conflicts with your theme or page builders.

With its modern CSS Grid layout, it perfectly adapts to any device, offering a native app-like experience to your users.
Add your locations, assign categories, and let your customers find your physical stores, offices, or distributors effortlessly.

🌟 Free Features

• OpenStreetMap Integration: Free, reliable, and requires no complicated API keys to start.
• Modern Grid Layout: A clean UI with filters on the left, the map on top, and a responsive grid of location cards below.
• Instant Filtering: Users can search by name/address or filter by categories instantly without reloading the page.
• Advanced Filter Logic: Choose between Faceted Search (recommended), strict AND, or strict OR logic to perfectly match your category structure.
• Custom Map Height: Full control over your layout. Set a custom maximum map height in pixels directly from the settings to prevent layout stretching on large directories.
• App-like Map Popups: Beautiful map markers that open modern, edge-to-edge image popups with contact details.
• Click-to-Call & Email: Integrated quick links for phone numbers and email addresses.
• Gutenberg & Page Builder Ready: Just drop the [virofpl_locator] shortcode anywhere (works perfectly with Elementor, Divi, Beaver Builder, etc.).
• Zero Bloat: No jQuery, no heavy assets. Pure performance.

🚀 Need More Power? Discover the PRO Version!

If you are an agency, a franchise, or simply need advanced features, Viro Filter Map & Store Locator PRO takes your map to the next level:
* Google Maps & Mapbox Support
* Automatic Coordinate Finder (1-Click address to Lat/Lng conversion)
* Custom Map Pins (Upload your own icons)
* Advanced Pagination (Load More button or Numeric)
* CSV Mass Importer (Create hundreds of locations in 1 click)
* 1-Click Migration from WeLaunch Store Locator
* Multiple Premium Layouts

External Services

This plugin connects to a third-party service to display the map:

OpenStreetMap map tiles
* Purpose: The map background (the “tiles”) is loaded from the OpenStreetMap tile servers on the pages that contain the [virofpl_locator] shortcode, unless the “No Map (List Only)” option is selected.
* Data Sent: The visitor’s browser requests the map tiles directly from tile.openstreetmap.org, which receives the visitor’s IP address, browser user agent and the address of the page (referrer). No cookies are set and no other data is sent.
* Service Provider: OpenStreetMap Foundation.
* Tile Usage Policy: https://operations.osmfoundation.org/policies/tiles/
* Privacy Policy: https://wiki.osmfoundation.org/wiki/Privacy_Policy

All the other files (Leaflet library, styles and map pins) are bundled with the plugin: nothing is loaded from external CDNs.

1. Upload the plugin files to the /wp-content/plugins/viro-filter-map-store-locator directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the ‘Plugins’ screen in WordPress.
3. Go to the new “Locations” menu in your WordPress admin panel and add your store locations.
4. (Optional) Create Categories to group your locations.
5. Go to “Locations -> Settings” to configure your default map coordinates and colors.
6. Insert the shortcode [virofpl_locator] into any page or post to display your map.

1. 

   screenshot-1.png - Frontend view: The modern, responsive Store Locator with interactive map and grid.

2. 

   screenshot-2.png - Frontend view: The beautiful, app-like popup on the map.

3. 

   screenshot-3.png - Backend: The clean and simple settings panel.

4. 

   screenshot-4.png - Backend: Adding a new location with custom details.

5. 

1.0.0

• Initial release.
  A blazing fast, modern Store Locator for WordPress.

1.0.1

• Fix: Fixed invisible standard pointer for OpenStreetMap (Leaflet) maps.

1.1.0

• Feature: Added advanced Filter Logic options (Faceted Search, strict AND, strict OR).
• Feature: Added Map Height control (px) to prevent layout stretching on directories with many filters.
• Tweak: Minor UI improvements in the settings panel.

1.1.1

• Compatibility with WordPress 7.1

1.2.0

• Fix: The map now works in block themes (Full Site Editing): data and colors were lost because the theme renders the page before the scripts are registered.
• Fix: A coordinate written with a comma (45,07) no longer stops the whole map; commas are now accepted and converted.
• Fix: Location names, addresses and links are escaped, so quotes or HTML in a name can no longer break the list or the popups. Website links accept only http and https.
• Fix: Emails and website URLs are saved with the proper WordPress sanitization.
• Fix: The default filter logic is now “Faceted” everywhere, as shown in the settings page.
• Fix: The script version now matches the plugin version, so browsers load the updated files.
• Tweak: The map pin is bundled with the plugin instead of being loaded from unpkg.com.
• Tweak: Map popup styles no longer affect other Leaflet maps on the site; the locator uses the theme font.
• Tweak: Empty categories are hidden from the filters; sub-categories of any depth are shown under their top-level group.
• Tweak: Accessibility: cards can be opened with the keyboard, checkboxes show the keyboard focus, the search field has a label and the number of results is announced to screen readers.
• Tweak: Search ignores accents (“citta” finds “Città”) and waits for a pause in typing; clicks on phone, email and website links no longer move the map.
• Tweak: Faster API: categories and images are loaded without one query per location.
• Tweak: If the PRO version is active, the free version stays idle to avoid conflicts.