Treweler - Mapbox Map Builder Plugin for WordPress

Treweler is a flexible and multipurpose WordPress plugin built on the Mapbox web mapping platform. Its primary goal is to help you create custom maps for your personal or business WordPress projects. By combining the plugin’s functionality with Mapbox’s customization features, you unlock endless possibilities for effectively visualizing the world around you.

Complete Features List

• General Features
  • Fully integrated and compatible with WordPress and Mapbox platforms.
  • Designed to support a wide range of map types and purposes.
  • Display full-screen maps on any WordPress page.
  • Publish your map anywhere using shortcode functionality and settings.
  • Compatible with most WordPress themes and builders.
  • Optimized for managing a large number of markers.
  • Equipped with performance optimization features for handling large datasets.
  • Ready for translation using .po files.
  • Supports Google Sheets integration for importing data.
  • Allows the creation of custom map styles through Mapbox Studio.
  • Includes a store locator feature with search and filtering capabilities.
  • Ability to customize elements using custom CSS code.
  • Offers permalink settings for sharing specific map states.
  • Demo content.
  • Plugin is well documented for easy setup and use.
• Maps
  • Create and manage any number of maps.
  • Set the initial geographical center and zoom level.
  • Use the same map with different initial point and zoom settings.
  • Restrict the zoom range of the map.
  • Choose from a variety of pre-installed map styles.
  • Use the Mapbox Standard map style with a 3D environment.
  • Apply Day, Dusk, Dawn, and Night light presets for the Mapbox Standard style.
  • Use custom map styles created in Mapbox Design Studio.
  • Hide layers for classic and custom map styles.
  • Set the initial pitch and bearing.
  • Restrict map panning to specific coordinates or completely disable it.
  • Configure the display of standard map controls like Distance Scale, Fullscreen, Search, Zoom & Pan, Geocoder, and Geolocation.
  • Switch between imperial, metric, and nautical units for the distance scale control.
  • Manage the display of the required Mapbox logo and text attribution.
  • Change the language of text labels on maps.
  • Display a single world or multiple copies of the world.
  • Add a custom overlay color on the main map.
  • Automatically display the user’s current location at the initial map loading.
  • Use the “Geolocation” control to manually obtain the user’s current location.
  • Add a custom progress preloader with logo and text that appears while the map is loading.
  • Add title, description, and logo to make maps unique.
  • Use globe and 7 additional map projections.
  • Apply custom CSS classes.
  • Center the map on click.
  • Use URL parameters (permalinks) for map state sharing.
• Markers
  • Add multiple markers to a single map.
  • Display a single marker across several maps.
  • Customize marker appearance with styles like Point, Dot, Balloon, and Triangle.
  • Use Google Material Icons for marker styling.
  • Upload and apply custom marker designs in supported graphic formats.
  • Use “Dot Optimized” and “Custom Optimized” marker styles for enhanced appearance and performance.
  • Create and manage multiple markers efficiently with templates.
  • Group nearby markers into clusters to reduce map clutter.
  • Configure markers to open a specified link when clicked.
  • Add text labels to markers for additional information or identification.
  • Organize markers into categories for easier filtering and management.
  • Set a primary category for each marker for better categorization.
  • Determine the order in which markers appear within the store locator sidebar.
  • Include category parameters in permalinks to filter displayed markers.
  • Apply different styles to markers based on their primary category.
  • Category checkbox color.
  • Highlight featured markers with special styles.
  • Highlight focused markers with special styles.
  • Marker style for search result.
• Popups
  • Enable marker popups and customize their styles and behavior.
  • Choose between light or dark themes.
  • Customize when marker popups open (on hover, on click, always open, or open by default).
  • Activate lightbox photo galleries within popups.
  • Add custom fields to popups using a custom fields builder to display additional information.
  • Add a close icon with selectable light or dark styles.
  • Adjust popup design elements, such as corner radius, image position (top or right), and minimum width and height.
  • Position the popup above the marker or in a fixed map corner.
  • Other minor settings and features.
• Routes
  • Manage an unlimited number of routes, each with individual settings and styles.
  • Organize routes into categories for better management and filtering.
  • Use the draw tools to create routes directly on the map.
  • Select from various route match modes, including no match, driving, walking, and cycling.
  • Import and export routes using the GPX file format.
  • Customize default and hover route line styles with options to adjust color, width, border, opacity, dash pattern, and gap size.
  • Add a single route to multiple maps, enabling reusability across different map projects.
  • Filter routes by categories to improve user experience and manageability.
• Shapes & Drawing Tools
  • Add any number of shapes to your maps.
  • Add a shape to multiple maps.
  • Use the Line tool to draw straight lines between points on the map.
  • Use the Polygon tool to create multi-sided shapes for marking areas.
  • Use the Circle tool to draw circles representing radial areas.
  • Use the Bezier tool to draw and edit Bezier curves for complex shapes.
  • Customize the stroke of shapes with settings for color, opacity, width, and dash/gap lengths.
  • Customize default and hover shape styles with options to adjust color, width, opacity, dash pattern, and gap size.
• Categories
  • Assign categories to markers and routes for organized management.
  • Supports multi-level categories, allowing for parent-child relationships.
  • Enables a category filter on the map, letting users select which categories to display.
  • Allows you to position the category filter on the map, with options like top left, top right, bottom left, and bottom right.
  • Provides different selection methods, where users can either select or disable categories.
  • Supports filtering through URL parameters, making it easy to share or return to specific map views.
• Custom Fields Builder
  • Expand marker popup or store locator information with custom fields.
  • Create any number of custom fields.
  • Add custom fields to marker templates.
  • Use various types of custom fields, including text & title, link, email, phone, separator, button, line, number, true/false, multiselect, custom HTML, categories, and rating.
  • Edit custom fields’ values, and change their style and order.
  • Set default and custom values for custom fields.
  • Use an audio player shortcode in the “Custom HTML” custom field.
  • Access specific settings for each custom field type to further customize their behavior and appearance.
  • Hidden custom fields.
• Marker Templates Builder
  • Create a large number of markers in the same style by designing a marker template.
  • Create comprehensive marker templates that include general marker settings, marker styles, popups, image galleries, text labels, and custom fields.
  • Easily manage multiple marker styles in one place using templates.
  • Add any custom setting to a marker while retaining the rest of the template’s predefined settings.
• Marker Importer
  • Import markers and their associated data from Google Sheets.
  • Create multiple imports, each linked to a separate Google spreadsheet.
  • Select a particular page within the spreadsheet from which the data will be imported.
  • Import data for standard and custom marker fields.
  • Overwrite existing markers with new data from the import.
  • Apply rules to remove existing markers when importing new data.
  • Cron job setting for scheduled import runs.
• Store Locator
  • Simple and extended store locator modes.
  • Sidebar with a list of markers.
  • Detailed marker descriptions in the sidebar.
  • Custom fields for marker cards and detailed marker descriptions.
  • Interactive click events for markers and sidebar cards.
  • Advanced filters and filtering options based on custom fields.
  • Display markers within the user’s vicinity, automatically showing nearby locations for convenience.
  • Display markers near a selected area on the map, allowing users to find locations in a specific region.
  • User positioning: automatically determined, manually set by clicking on the map, or using an intuitive address search with auto-completion.
  • Custom geolocation marker styles.
  • Control the visibility of map features, such as address search, geolocation icon, and distance sorting options.
  • Distance-based sorting of locations, with options for both kilometers and miles.
  • Custom values and default settings for distance sorting.
  • Intuitive address search with auto-completion.
  • Search within the visible map area.
  • Search functionality for markers and locations.
  • Sidebar position options, enabling placement on either the left or right side of the map.
  • Sequential panel positions.
  • Option to close the sidebar by default when the map loads.
  • Adjustable sidebar width.
  • Customizable sidebar image position (top or left).
  • Configuring the sorting of marker cards in the store locator sidebar.
• Filters & Filtering
  • Add an unlimited number of custom filters to the Extended Store Locator map sidebar.
  • Create filters based on custom fields and their values.
  • Filter markers by predefined categories.
  • Apply distance-based filtering with the option to measure in kilometers or miles.
  • Filter markers within the visible map area.
  • Adjust the order of filters in the sidebar.
  • Configure the filter panel to display either immediately upon map load or via a button.
  • Include a button to reset all active filters to their default states.
  • Integrate filters with geolocation features to display results based on the user’s current location.
  • Histogram for Number-type custom field filter.
• Information Widgets
  • Show widgets on the map.
  • Configure up to six different widget positions on the map.
  • Enter a value and provide a description for the widget.
  • Toggle the background display behind the widgets.
  • Set the font color and adjust the font weight for the widget text.
  • Enable a gradient effect on the sides of the map, choose the gradient color, and control the transparency level.
• Interactive Tours
  • Enable interactive tours for maps.
  • 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.
  • Numbered markers.
  • Marker thumbnails for tour navigation.
• Country & Region Boundaries
  • Access to a comprehensive collection of global country and region boundary data with varying levels of accuracy.
  • Build and customize any combination of countries or regions.
  • Predefined country boundaries presets available for Entire World, Continents, United Nations regions, World Bank Regions, Subregions, and custom combinations.
  • Detailed boundary data for Admin 1 (states/provinces) and Admin 2 (counties/districts) regions for Australia, Canada, France, Germany, Italy, Spain, United Kingdom, and USA.
  • Customize polygon fill color and opacity for different states, including initial state, hover state, selected state, and custom state.
  • Set polygon stroke color and opacity to match map styling requirements.
  • Configurable actions upon clicking a region, including none (no action) or opening a link.
  • Customize hover interactions, including none, popup with region name, or popup with region name and custom value.
• Performance
  • Enables the management of a large number of markers.
  • Allows the use of GeoJSON files as a data source, improving map performance by reducing load times.
  • Supports optimized marker styles, such as Dot Optimized and Custom Optimized, which enhance performance by simplifying marker rendering.
  • Groups nearby markers into clusters to reduce clutter and improve readability.
  • Displays a preloader while the map is being prepared.
  • Uses Dynamic Loading to load markers, popups, and store locator cards.
  • Includes various enhancements for optimizing overall map performance.

Addons

• Treweler GeoJSON Addon
• Treweler 3D Models Addon
• Treweler Marker Submission Addon

Changelog ## [1.29] - 30-03-2026 ### Added - Trigger marker-linked objects during tour navigation. - Reset categories when the Clear All button is clicked in the Store Locator. ## [1.28] - 15-12-2025 ### Added - Mapbox GL JS 3.17.0 version support. - Admin settings UI improvements. ### Fixed - Store Locator marker list display issue with disabled filters. - Empty values issue in the Number custom field type. ## [1.27] - 06-10-2025 ### Fixed - Balloon marker icons missing after marker import. - Minor fixes and improvements. ## [1.26] - 19-09-2025 ### Added - Treweler style for Fullscreen, Search and Zoom & Pan map controls. ### Changed - Minor styling adjustments. ## [1.25] - 25-08-2025 ### Added - Import cron job setting for scheduled runs. - Demo content with two sample maps. - Store locator user interface improvements. ### Changed - Minor styling adjustments. ## [1.24.2] - 11-08-2025 ### Fixed - Locator panel freeze with Search Visible Area control enabled by default. - Minor fixes and improvements. ## [1.24.1] - 05-08-2025 ### Fixed - Minor fixes and improvements. ## [1.24] - 31-07-2025 ### Added - Mapbox GL JS 3.14.0 version support. - Coloring the Dot Optimized marker style based on the marker’s primary category color. ## [1.23] - 24-07-2025 ### Added - Mapbox GL JS 3.12.0 version support. - Hover styles for Routes and Shapes. - Marker trigger settings for Routes and Shapes. - Marker thumbnails for tour navigation. - Route border style settings. - Ability to export routes to GPX format - Badges for Number-type custom fields in popups and Store Locator. - Histogram for Number-type custom field filter. - Option to start filter range from zero for Number-type custom field. - Hidden custom fields. - Setting to override default custom field name. - Popup visibility breakpoint setting. - Breakpoint setting to disable marker offset. - Minor fixes and improvements. ### Changed - Search Radius appearance and behavior in Store Locator. #Changelog ## [1.22] - 18-03-2025 ### Added - Treweler Marker Submission Addon support. ### Fixed - Minor fixes and improvements. ## [1.21.1] - 15-03-2025 ### Fixed - Minor fixes and improvements. ## [1.21] - 06-03-2025 ### Fixed - Minor fixes and improvements. ## [1.20] - 17-02-2025 ### Added - Mapbox GL JS 3.10 version support. - Addons list page. - Setting the color of the category checkbox. - Configuring the sorting of marker cards in the store locator sidebar. ## [1.19] - 27-01-2025 ### Added - Mapbox GL JS 3.9.3 version support. - Support for 25 new map text label languages. ### Fixed - Changing language for Standard Mapbox map style. - Minor fixes and improvements. ### Removed - FitBounds for categories in map settings. ## [1.18] - 14-01-2025 ### Added - Treweler 3D Models Addon support. - Additional JavaScript field. - Minor fixes and improvements. ## [1.17] - 03-01-2025 ### Added - Mapbox GL JS 3.8.0 version support. - Fixed popup position. - Treweler GeoJSON Addon support. - Shortcode for embedding a video using a Custom HTML custom field type. - Margin settings for all custom field types. ## [1.16] - 01-09-2024 ### Added - Support for Mapbox GL JS 3.7.0 - Marker styles: "Dot Optimized" and "Custom Optimized" for handling large numbers of markers. - Optimized cluster style for handling a large number of markers. - Clustering radius setting. - Permalink parameters: coordinates, zoom level, categories, and marker ID for full-screen maps. - Support for multi-level category lists. - Primary category setting for markers. - Inverted category selection method. - Category marker style settings. - Featured marker style settings. - Search result marker style setting. - Focused marker style setting. - Search by marker name in the Extended and Simple store locator. - Filter markers within the visible area in the Extended Store Locator. - Option to display the marker details panel next to the marker list. - Store Locator sidebar width setting. - Store Locator sidebar image position setting (top or left). - Two-column sidebar grid for the Store Locator. - Setting for the order of markers in the Store Locator sidebar. - Default sorting of markers by date added in the Store Locator sidebar. - Marker link copy icon in the Store Locator marker details panel. - Option to display the radius area for the Store Locator. - Store Locator mobile layout improvements. - New "Rating" custom field type with filter functionality. - Image setting for the "Text", "Number", "True/False" and "Multiselect" custom field types. - New "Inline" style for the "Text" "Number" custom field type. - New "Table" and "Grid" styles for the "Multiselect" custom field type. - Height and corner rounding settings for the "Button" custom field type. - Setting to restrict "Multiselect" custom field filters to single-option selection. - Setting for the separate display of standard Compass and Zoom map controls. - Map antialiasing setting. - Dynamic loading of markers, popups, and Store Locator cards. - Marker preview image optimization. - Automatic GeoJSON file generation for a large number of markers. - GeoJSON file generation settings. - Dynamic loading settings for HTML markers. ### Fixed - General map performance improvements. - Minor fixes and improvements. ## [1.15.3] - 28-02-2024 ### Fixed - Minor fixes and improvements. ## [1.15.2] - 14-02-2024 ### Added - Mapbox GL JS 3.1.2 version support. ### Fixed - Atmosphere style issue for custom map styles. - Minor fixes and improvements. ## [1.15] - 04-01-2024 ### Added - Mapbox GL JS 3.0.1 version support. - Zoom by gesture setting for maps added using shortcode. ### Fixed - Height of fullscreen maps on mobile devices. - Minor fixes and improvements. ## [1.14] - 25-10-2023 ### Added - Import markers from Google spreadsheets. - New Mapbox Standard map style with 3D environment. - Day, Dusk, Dawn and Night light presets for the Mapbox Standard style. - Ability to hide layers for classic and Standard map styles. - Audio player shortcode for the "Custom HTML" custom field. - Imperial, metric and nautical units for the distance scale control. ### Fixed - Minor fixes and improvements. ## [1.13.30] - 13-10-2023 ### Fixed - Minor fixes and improvements. ## [1.13.28] - 12-10-2023 ### Fixed - Minor fixes and improvements. ## [1.13.27] - 30-09-2023 ### Added - Geolocation control style - Option to close the locator sidebar by default. - Position of the locator sidebar on the right. - Style of the open locator sidebar button. - New "Nautical Chart" custom map style. ### Fixed - Displaying non-latin characters. - Minor fixes and improvements. ## [1.13.22] - 18-07-2023 ### Added - Extended marker locator with a marker sidebar. - Custom filters and filtering. - New custom field types (title, button, line, number, true/false, multi select, custom HTML, categories). - Marker offset on click. - Custom CSS classes for maps. - Popup close icon. - Center map on click. - User geolocation marker. - Marker at the click point on the map. - Opening a link when clicking on a marker. - Additional custom fields settings (text align, text style, margins). - Other minor changes and improvements. ### Fixed - Opening links in the same window for maps inserted with a shortcode. ### Changed - Standard Mapbox map styles. - Tour control styles. ### Removed - Heading, subheading, description, and button for the popup and template settings (replaced with custom fields). - Popup content align (replaced with custom fields settings). ## [1.12] - 01-10-2022 ### Added - 3D projection of the globe. - Map projections support. - Center a marker on a click. ### Changed - Primary font for all plugin elements. ### Fixed - Opening links in a new tab for region boundaries. ## [1.11] - 17-08-2022 ### Added - Country and region boundaries. - Ability to embed a single map with different initial point and initial zoom level settings. - Disable map panning or restrict it to an area. - Display a single world or multiple copies of the world on a map. - Customizable overlay color with opacity above the map. - Mapbox GL JS 2.9.1 version support. ### Fixed - The issue with the validation of restricted Mapbox tokens. - Page title encoding for different languages. ## [1.10] - 10-05-2022 ### Added - Shapes & Drawing Tools. - Mapbox GL JS 2.8.2 version support. ### Fixed - The "Settings" link issue on the WordPress "Plugins" page. ## [1.09] - 11-03-2022 ### Added - Map Store Locator. - Ability to add a route to multiple maps. ### Fixed - Bootstrap conflict for some WordPress themes. - GPX file uploader conflict with the Revolution Slider plugin. - Map clustering stops working when the marker text label field is empty. ## [1.08] - 15-02-2022 ### Added - Mapbox GL JS 2.7 version support. - Ability to add a marker to multiple maps. ### Fixed - WordPress user roles issue. - Blurring map elements, for maps inserted using a shortcode. - Changing the logo size after adding widgets. ## [1.07] - 27-01-2022 ### Fixed - Errors in marker settings when using templates. - Displaying the logo of the map and preloader. ## [1.06] - 24-01-2022 ### Added - Marker templates. ### Fixed - Minor code fixes and improvements. ## [1.05] - 29-12-2021 ### Added - The "Additional CSS" field for adding custom CSS code. - Position settings for map controls. - New "Geolocate" control to manually obtain the user's current location. - The ability automatically obtain the user's current location at the initial map loading. - Manually adding and removing custom fields on the marker settings page. - Default values for custom fields. ### Changed - Plugin main settings page layout. - Map controls settings moved to the "Controls" tab on the map setting page. ### Fixed - Scrolling pages issue in the "Salient" theme. - Icons preview issue for the icon-pickers. ## [1.04] - 16-12-2021 ### Added - Custom fields builder. ### Fixed - Lightbox gallery issue with a single image. ## [1.03] - 01-12-2021 ### Added - Lightbox image gallery for markers. - Link settings for the map logo. - Mapbox GL JS 2.6.1 version support. ### Changed - The active tab is not reset after clicking on the "Publish" or "Update" buttons in the admin panel. - Plugin icon in the WordPress admin menu. - The minimum width of the container for the widget text description. ### Fixed - 404 error issue for maps embedded via shortcode. - Displaying markers on the map if they belong to more than one category. - Translation of text placeholders for the category drop-down list. - Z-index for the category drop-down list. - Right-margin issue for the widget text descriptions. ## [1.02] - 18-11-2021 ### Added - Google Material icons for "Dot" and "Balloon" markers. ### Changed - Custom marker settings moved to the "Marker Styles" settings group. - The layout of settings for "Balloon" markers. - Color-pickers and icon-pickers now open upwards. ### Fixed - Flickering of halo when hovering over "Point" markers. ## [1.01] - 09-11-2021 ### Fixed - Overlapping of elements with clusters. - Minor code fixes and improvements. ## [1.00] - 09-11-2021 ### Initial Release.