=== 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.0 Requires PHP: 7.4 Stable tag: 1.03 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 - 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 = Please update to 1.03 for the latest compatibility, interface and stability improvements.