=== Treweler Map Builder ===
Contributors: aisconverse
Donate link: https://treweler.com/
Tags: map, mapbox, interactive map, map markers, travel map, map embed, store locator, world map, gpx, routes, boundaries, interactive tour
Requires at least: 5.7
Tested up to: 6.8
Requires PHP: 7.2
Stable tag: 1.02
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.en.html

The Treweler plugin is a multifunction map builder. Its purpose is to help you create an interactive map for your personal or business project.

== Description ==
The [Treweler](https://treweler.com/)  plugin is a flexible and multifunction WordPress map builder based on the Mapbox web mapping platform. Its purpose is to help you create a custom map for your personal or business project. This combination of plugin functionality and Mapbox map customization provides limitless possibilities when creating a way to describe the world around us.

== ⭐ Treweler Free Features ==

These features are available in the free version of the plugin, which can be downloaded from this page. Upgrade to [Treweler Pro](https://treweler.com/) to get access to all plugin features and premium support.

= 🌎 Map Features =

* Fully integrated and compatible with WordPress and Mapbox platforms.
* Create and manage any number of maps in a few clicks.
* Display full-screen maps using any WordPress page.
* Publish your map in any place using shortcode functionality and settings.
* Great choice of pre-installed map styles.
* Mapbox Standard map style with 3D environment.
* Day, Dusk, Dawn and Night light presets for the Mapbox Standard style.
* Ability to create your own style using Mapbox Design Studio.
* Ability to hide layers for classic and custom map styles.
* The initial geographical center and zoom level.
* Using the same map with different initial point and zoom settings.
* Setting the display of standard map controls such as Distance Scale, Fullscreen, Search, Zoom & Pan, Geocoder and Geolocation.
* Imperial, metric and nautical units for the distance scale control.
* Manage the display of the required Mapbox logo and text attribution.
* Сhanging the language of text labels on maps.
* The “Geolocation” control to manually obtain the user’s current location.
* Add a custom progress preloader with logo and text information that will appear once the entire map is loaded.
* Add title, description and logo to make your maps unique.
* Enable 3D terrain and 3D buildings for your Mapbox Studio style.
* 3D projection of the globe and 7 additional map rpojections.
* Custom CSS classes.
* Center map on click.
* Display marker at the click point on the map.

= 📍 Markers & Popups =

* Add any number of markers to your maps.
* Ability to add a marker to multiple maps.
* Great choice of built-in marker styles with a wide range of settings.
* Enable marker popups and customize their styles and behavior.
* Customize the opening and visibility of marker popups.
* Google Material icons support.
* Center marker on a click.
* Marker offset on click.
* Popup close icon.
* Opening custom link when clicking on a marker.

= ↩️ Routes =

* The ability to manage any number of routes and their styles.
* Draw a route using the draw tools and route match modes (driving, walking, cycling).
* Customize the following route line styles: color, width, opacity, dash and gap.
* Ability to add a route to multiple maps.

== 🚀 Treweler PRO ==

These features are only available with a [Treweler Pro](https://treweler.com/) license. Upgrade to Pro version to get access to all plugin features and premium support.

= 🌎 Map Features =

* Restrict the zoom range of the map.
* The initial pitch and bearing.
* Restrict map panning to coordinates or completely disable it.
* Displaying a single world or multiple copies of the world.
* Add a custom overlay color on the main map.
* The ability automatically display the user’s current location at the initial map loading.
* Place additional information or interesting facts on the map, using information widgets.
* Determination of the user’s geolocation.
* Display user’s geolocation marker.

= 📍 Markers & Popups =

* Enable marker clusters to display a large number of markers on your map.
* Activate the lightbox photo galleries to describe marked places in more detail.
* Upload your own images in any graphic format as custom markers.
* Marker templates builder.
* Custom fields builder for pupups and marker locators.
* Customize marker text labels for clearer navigation.
* Group markers together using categories and related functionality.

= 🚩 Interactive Tours =

* Ability to switch between markers and areas.
* Two animation options: Jump or Fly.
* Control the flight speed, flight curve and zoom level.
* Enable or disable the display of popups when focusing on a marker during the tour.
* Four possible tour controls positions.
* Control markers offset by choosing any of the four possible directions.

= 🧭 Routes =

* Import a route in GPX file format.
* Group routes together using categories and related functionality.

= ⛳ Countries & Regions Boundaries =

* Build and customize any combination of countries or regions.
* Countries boundaries presets (Entire World, by Continents, by United Nations regions, by World Bank Regions, by Subregions, and any custom combination).
* Admin 1 and admin 2 regions boundaries for the following countries: Australia, Canada, France, Germany, Italy, Spain, United Kingdom, USA.
* Polygon fill color and opacity settings (initial state, hover state, selected state, custom state).
* Polygon stroke color and opacity settings.
* Action on click settings (none, open link).
* Hover settings (none, popup with region name, popup with region name and custom value).

= 📡 Marker Locator =

* Sidebar with a list of markers.
* Detailed description of the marker in the sidebar.
* Сustom fields for the list of markers and for a detailed description of the marker in the sidebar.
* Events on click for markers and sidebar cards.
* Custom filters and filtering.
* Display map markers within the user’s vicinity.
* Display map markers in the vicinity of the area on the map that the user chooses.
* Determined user’s position automatically, set manually by clicking on the map, or by using an intuitive address search with auto-completion.
* Custom styles for the geolocation marker.
* Option to show only necessary controls on the map (address search, automatic geolocation icon, sort by distance).
* Option to place controls in a preferred corner of the map.
* Sorting locations by distance.
* Custom values for sorting by distance.
* Setting default value for sorting by distance.
* Setting distance sorting in either kilometers or miles.
* Intuitive address search with auto-completion.
* Left or right position of the sidebar.
* Option to close the locator sidebar by default.

= 🔖 Filters & Filtering =

* Adding any number of custom filters to the map sidebar.
* Filtering based on custom field values.
* Filtering by marker category.
* Filtering by distance (kilometers or miles).
* Adjusting the order of filters in the sidebar.
* Displaying the filter panel when clicking on the button or immediately when loading the map.
* Button to reset all filters.

= ✏️ Shapes & Drawing Tools =

* Add any number of shapes to your maps.
* Add a shape to multiple maps.
* Add lines by using the Line tool.
* Add other varieties of shapes using the Polygon tool.
* Add circles with the Circle tool.
* Use the Bezier tool to draw and edit bezier curves.
* Customize shapes by the following list of style settings: fill color and opacity, stroke color and opacity, stroke width, dash and gap.

= 📌 Marker Templates Builder =

* Making a large number of markers in the same style by creating a marker template.
* Marker style templates.
* Marker popup and image gallery templates.
* Marker text label templates.
* Marker custom fields templates for popups and marker locators.
* Change any marker setting while keeping the rest of the template settings.

= 🏗️ Custom Fields Builder =

* Expand your marker popup information with custom fields builder.
* Create any number of custom fields.
* Adding custom fields to marker templates.
* Use the following types of custom fields: text & title, link, email, phone, separator, button, line, number, true/false, multiselect, custom HTML, categories.
* Edit custom fields text information, and change their style and order.
* Default and custom values.
* Audio player shortcode for the “Custom HTML” custom field.

= 📥 Marker Importer =

* Import markers and their associated data from Google Sheets.
* Create multiple imports, each linked to separate Google spreadsheet.
* Select a particular page within the spreadsheet from which the data will be imported.
* Import data for both standard and custom marker field.
* Choose from different rules to remove existing markers when importing new data.

== Installation ==

= Minimum Requirements =

* WordPress version 5.7 or higher
* PHP version 7.2 or higher
* MySQL version 5.5 or higher

= Automated Installation =

Since you already downloaded the plugin zip file, you can manually upload and install it through the plugin’s admin screen. To add the plugin using the built-in plugin installer:

1. Login to your WordPress admin panel.
1. Navigate your way to the **Plugins** menu and click **Add New**.
1. Click the **Upload Plugin** button at the top of the screen, and select the zip file from your computer.
1. Click the **Install Now** button.
1. When installation is complete, you’ll see “Plugin Installed Successfully.” Click the **Activate Plugin** button at the bottom of the page.

= Manual Installation =

In rare cases, you may need to install a plugin by manually transferring the files onto the server. This is recommended only when absolutely necessary, such as when your server is not configured to allow automatic installations. This procedure requires you to be familiar with the process of transferring files using an FTP client.

1. Unzip the previously downloaded plugin zip archive. You should see a single folder named after the plugin.
1. Connect to your WordPress server with your FTP client.
1. Copy the plugin folder to the wp-content/plugins folder in your WordPress directory. This installs the plugin to your WordPress site.
1. Navigate to your **Plugins** menu in the WordPress admin panel and locate the newly uploaded plugin in the list.
1. Click the plugin’s **Activate** link.

= Mapbox Access Token =

The first thing you should do after installing and activating the plugin is to add the **Mapbox Access Token** to the main plugin settings.

To get a token you should register on the [Mapbox Website](https://account.mapbox.com/auth/signup/) and create a new token on your [Access Tokens Page](https://account.mapbox.com/access-tokens/). For information regarding management of the Mapbox Access Tokens, [please read this article](https://docs.mapbox.com/help/getting-started/access-tokens/).

After you have created an Access Token, go to the **Treweler** menu in the admin panel, click the **Settings**, open the **General** tab and paste a token to the Access Token filed. Click the **Save Changes** button to save the settings.

Now you can create maps and publish them on the pages of your website.

== Frequently Asked Questions ==

= Installation Instructions =

After you have downloaded the plugin zip file, you can upload and install it through the WordPress admin panel or by manually transferring the files onto the server. Please go to the "Installation" tab on this page to read the full installation instructions.

== Screenshots ==
1. Piva Lake Interactive Guide.
2. Treweler Pro. Everest South Col Route.
3. General map settings.
4. Marker style settings.
5. Marker ballon style settings.
6. Marker popup settings.
7. Route drawing modes and style settings.
8. Additional CSS settings.
9. Treweler Pro. United States Counties Interactive Boundaries.
10. The Largest Cities In Italy.
11. Treweler Pro. Austria Store Locator.
12. Treweler Pro. Utah County Households Interactive Boundaries.
13. Disentis Village Map.
14. Treweler Pro. New York Interactive Tour.
15. Treweler Pro. USA States Population Interactive Boundaries.

== Changelog ==
= 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.02 =
Please update to 1.02 or above for the latest stability improvements.