=== BoatApps Dealer Map ===
Contributors: sosinsky
Tags: dealer, map, locator, directory, svg
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 0.31.2
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Add your dealers and display a searchable map and list without external map services.

== Description ==

BoatApps Dealer Map provides a complete dealer directory with a locally bundled SVG world map. Add as many dealers as you need and place the map and list on any page using a block or shortcode.

Choose each dealer's country and administrative region in a dedicated form. The plugin places an approximate marker automatically. Visitors can search the directory and select countries to filter the dealer list.

= Features =

* Any number of dealers, with no account, license, quota, or time limit required.
* One ready-to-use Light design: a responsive map above the dealer list.
* Search and country filtering, including clicking countries on the map.
* Dealer logo, country, region, city, address, description, website, email, and phone.
* A combined map-and-list block with a live editor preview.
* The [dealer_locator] shortcode, usable on any number of pages.
* Custom headings and an option to hide the heading when embedding.
* Keyboard navigation, visible focus states, and reduced-motion support.
* Localized country names and translation-ready administration.
* No Google Maps, Leaflet, external map API, or geocoding account.

All features included in this package are available without payment. BoatApps Dealer Map Pro is a separate commercial add-on, distributed outside WordPress.org. It provides independent map configurations, map-specific dealer selections, additional layouts and themes, separate map/list blocks, and visual customization. None of that add-on's implementation is included in this package. Both editions support any number of dealers.

Learn more: https://boatapps.eu/dealer-map/

= Embedding =

Use the BoatApps Dealer Map block, or insert:

[dealer_locator]

Optional heading attributes:

[dealer_locator eyebrow="Our network" heading="Find your local dealer"]

[dealer_locator show_heading="no"]

== Installation ==

1. Install and activate BoatApps Dealer Map.
2. Open Dealer Map > Add dealer and enter the dealer name, country, and contact details.
3. Open Dealer Map > Map settings to preview the locator and change its default headings.
4. Add the BoatApps Dealer Map block or [dealer_locator] shortcode to a page.
5. Publish the page.

== Frequently Asked Questions ==

= How many dealers can I add? =

There is no dealer limit. The free plugin works without a subscription or license.

= Are the markers exact street locations? =

No. Markers use the center of the selected administrative region, with a country-center fallback. They are approximate locations, not navigation directions.

= Can I place the locator on several pages? =

Yes. Every instance shows the dealer directory and has independent search and country selection.

= What happens if I remove the plugin? =

Dealer records and settings are preserved to prevent accidental data loss.

= Can I use it without connecting to Freemius? =

Yes. Skip the optional connection during activation. The free dealer directory remains fully functional.

= What changed in 0.31.2? =

The WordPress.org contributor identifier was corrected to the account login `sosinsky`. WordPress.org displays the BoatApps profile name associated with that account.

== Privacy ==

The frontend does not send dealer data, visitor searches, or map interactions to an external service and does not set frontend cookies. All runtime map and location datasets are bundled locally.

The plugin includes the Freemius SDK for optional usage analytics, account management, and discovery of the separate Pro add-on. Administrators can skip connecting to Freemius. If they opt in, Freemius may receive administrator profile, website, product, theme, and plugin information according to the selected permissions. Purchasing or activating Pro requires a separate connection to Freemius. Free updates are distributed through WordPress.org.

Freemius terms: https://freemius.com/terms/
Freemius privacy policy: https://freemius.com/privacy/

== Screenshots ==

1. Complete Light dealer locator with the responsive world map, search, country filtering, and dealer list.
2. Country selection filters both the highlighted map and visible dealer cards without moving the page.
3. Dedicated dealer form with searchable country and administrative-region fields.
4. Free and Pro comparison: unlimited dealers in both editions, with advanced maps and visual customization in Pro.

== Third-party components and source ==

The package includes readable application PHP, JavaScript and CSS, the map-generation script and its locked dependencies in source/, and third-party notices in THIRD-PARTY.txt.

Freemius SDK 2.13.4: https://github.com/Freemius/wordpress-sdk/tree/2.13.4
Tom Select 2.6.2 source and build instructions: https://github.com/orchidjs/tom-select/tree/v2.6.2
country-region-data 4.1.0: https://github.com/country-regions/country-region-data

The bundled dependencies include GPL-3.0, Apache-2.0, MIT, and ISC components. Generated geometry uses public-domain Natural Earth data. See THIRD-PARTY.txt for licenses, source locations, and map build instructions.

== Changelog ==

= 0.31.2 =
* Corrected the WordPress.org contributor identifier to sosinsky so the author profile resolves properly.

= 0.31.1 =
* Linked the Pro information button to the BoatApps product page and the purchase button directly to Freemius checkout.
* Removed the unused Freemius Add-ons menu from the administrator flow.
* Removed the informal administrator credit footer.
* Updated the WordPress.org contributor account to boatapps.

= 0.31.0 =
* Introduced the distinctive BoatApps Dealer Map name and boatapps-dealer-map text domain.
* Removed dealer quotas from the form, menu, publishing, and REST API.
* Simplified Free to one complete Light map-and-list design.
* Moved advanced presentation code to the separately distributed Pro add-on.
* Replaced directly printed style tags with WordPress-managed styles and SVG classes.
* Added a distinctive Freemius helper prefix and aligned licensing/source notices.
* Use WordPress.org language packs for Free translations.

= 0.30.1 =
* Updated branding and the Pro information link.
