=== Treweler Map Builder ===
Contributors: aisconverse
Donate link: https://treweler.com/
Tags: map, mapbox, interactive map, map markers, routes
Requires at least: 5.7
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.03.1
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.en.html

Build responsive Mapbox maps in WordPress with custom markers, popups, routes, 3D styles and advanced Pro tools.

== Description ==
Treweler is a flexible WordPress map builder powered by [Mapbox](https://www.mapbox.com/). Create responsive, interactive maps for travel guides, property listings, business directories, routes, data visualizations and other location-based projects.

Build maps in the familiar WordPress admin area, choose a ready-made or custom Mapbox style, and publish them as full-screen pages or with shortcodes. No coding is required for everyday setup.

= Treweler Free =

Treweler Free provides the essential tools for creating polished interactive maps:

* Create and manage unlimited maps, markers and routes.
* Use Mapbox Standard, classic or custom Mapbox Studio styles, including 3D terrain, buildings and multiple map projections.
* Customize markers and responsive popups with flexible styles, content, images, buttons and click actions.
* Draw routes directly on the map with driving, walking and cycling modes, plus default and hover styles.
* Configure essential map controls, geolocation, language, attribution and preloaders.
* Publish maps as full-screen WordPress pages or place them anywhere with shortcodes.
* Fine-tune presentation with custom CSS classes, additional CSS and JavaScript.

= Treweler Pro =

[Treweler Pro](https://treweler.com/) expands the Free version with advanced tools for directories, data-rich maps and larger projects:

* Organize markers and routes with categories, clustering, templates, custom marker images and text labels.
* Build rich popups with image galleries and reusable custom fields.
* Create Store Locator maps with search, filters, geolocation and distance-based sorting.
* Add interactive tours, information widgets, shapes and detailed country or region boundaries.
* Import markers from Google Sheets and import or export routes in GPX format.
* Share specific map states with permalinks and add advanced map, marker and route interactions.
* Improve large-map performance with optimized markers, dynamic loading and GeoJSON data.

View the [complete Treweler Pro feature list](https://treweler.com/features/), explore [Pro demo maps](https://treweler.com/demo-maps/), and browse the available [Treweler addons](https://treweler.com/addons/). Addons are available exclusively for Treweler Pro.

== Installation ==

= Minimum Requirements =

* WordPress 5.7 or higher
* PHP 7.4 or higher

= Install from WordPress =

1. Open **Plugins > Add New** in your WordPress dashboard.
2. Search for **Treweler Map Builder**.
3. Click **Install Now**, then **Activate**.
4. Open **Treweler > Settings > General** and add your Mapbox Access Token.
5. Save the settings and create your first map.

= Install from a ZIP file =

1. Open **Plugins > Add New** and click **Upload Plugin**.
2. Select the Treweler ZIP file and click **Install Now**.
3. Activate the plugin and add your Mapbox Access Token under **Treweler > Settings > General**.

= Mapbox Access Token =

Treweler uses Mapbox to display maps. Create a [free Mapbox account](https://account.mapbox.com/auth/signup/), copy a token from your [Access Tokens page](https://account.mapbox.com/access-tokens/), and save it under **Treweler > Settings > General**.

== Frequently Asked Questions ==

= Is a Mapbox account required? =

Yes. Treweler uses the Mapbox platform, so a valid Mapbox Access Token is required to display maps.

= Where can I find my Mapbox Access Token? =

Sign in to Mapbox and copy a token from your [Access Tokens page](https://account.mapbox.com/access-tokens/).

= How can I publish a map? =

You can display a map as a full-screen WordPress page or place it in your content using a shortcode.

== Screenshots ==
1. Interactive real estate map with markers and popup.
2. Mountain hiking route with a custom map style.
3. Everest South Col route with a marker popup.
4. 3D city map with night lighting.
5. 3D Paris map with points of interest.
6. World map with a custom map style.
7. Map editor and map settings.
8. Marker editor and marker style settings.
9. Route editor and route drawing modes.
10. Route appearance and color settings.

== Changelog ==
= 1.03.1 - 2026-08-13 =
* Fixed - Minor fixes and improvements.
* Improved - Compatibility with WordPress 7.1.

= 1.03 - 2026-08-11 =
* Updated - Free version based on the current Treweler Pro codebase.
* Updated - Mapbox GL JS 3.17.0 version support.
* Added - Treweler style for Fullscreen, Search and Zoom & Pan map controls.
* Added - Hover styles for Routes.
* Added - Route border style settings.
* Added - Popup visibility breakpoint setting.
* Added - Breakpoint setting to disable marker offset.
* Added - Addons list page.
* Added - Additional JavaScript field.
* Added - Setting for the separate display of standard Compass and Zoom map controls.
* Added - Map antialiasing setting.
* Added - Zoom by gesture setting for maps added using shortcode.
* Added - Fixed popup position.
* Fixed - Minor fixes and improvements.

= 1.02 - 2023-10-26 =
* Added - New Mapbox Standard map style with 3D environment
* Added - Day, Dusk, Dawn and Night light presets for the Mapbox Standard style
* Added - Ability to hide layers for classic and Standard map styles
* Added - Imperial, metric and nautical units for the distance scale control
* Fixed - Minor fixes and improvements

= 1.01 - 2023-08-04 =
* Added - Marker offset on click
* Added - Custom CSS classes for maps
* Added - Popup close icon
* Added - Center map on click
* Added - Marker at the click point on the map
* Added - Opening a link when clicking on a marker
* Fixed - Opening links in the same window for maps inserted with a shortcode
* Changed - Standard Mapbox map styles

= 1.0 - 2022-10-28 =
* Initial release

== Upgrade Notice ==
= 1.03.1 =
Please update to 1.03.1 for improved Free editor stability and WordPress 7.1 compatibility.
