Treweler – 适用于 WordPress 的 Mapbox 地图生成器插件

特雷韦勒 是一个灵活且多用途的 WordPress 插件，建立在 Mapbox 网络地图平台上。它的主要目标是帮助您为个人或企业 WordPress 项目创建自定义地图。通过将插件的功能与 Mapbox 的自定义功能相结合，您可以解锁有效可视化周围世界的无限可能性。

完整功能列表

• 一般功能
  • 与 WordPress 和 Mapbox 平台完全集成并兼容。
  • 旨在支持各种地图类型和用途。
  • 在任何 WordPress 页面上显示全屏地图。
  • 使用短代码功能和设置在任何地方发布您的地图。
  • 与大多数 WordPress 主题和构建器兼容。
  • 针对管理大量标记进行了优化。
  • 配备用于处理大型数据集的性能优化功能。
  • 准备好使用 .po 文件进行翻译。
  • 支持集成 Google 表格以导入数据。
  • 允许通过 Mapbox Studio 创建自定义地图样式。
  • 包括具有搜索和过滤功能的商店定位器功能。
  • 能够使用自定义 CSS 代码自定义元素。
  • 提供用于共享特定地图状态的永久链接设置。
  • 插件有详细记录，便于设置和使用。
• 地图
  • 创建和管理任意数量的地图。
  • 设置初始地理中心和缩放级别。
  • 使用具有不同初始点和缩放设置的同一地图。
  • 限制地图的缩放范围。
  • 从各种预装的地图样式中进行选择。
  • 将 Mapbox 标准地图样式与 3D 环境配合使用。
  • 为 Mapbox 标准样式应用白天、黄昏、黎明和夜间光源预设。
  • 使用在 Mapbox Design Studio 中创建的自定义地图样式。
  • 隐藏经典地图样式和自定义地图样式的图层。
  • 设置初始螺距和方位。
  • 将地图平移限制为特定坐标或完全禁用它。
  • 配置标准地图控件的显示，例如距离比例、全屏、搜索、缩放和平移、地理编码器和地理位置。
  • 在英制、公制和航海单位之间切换以控制距离刻度。
  • 管理所需 Mapbox 徽标和文本归属的显示。
  • 更改地图上文本标注的语言。
  • 显示单个世界或多个世界的副本。
  • 在主地图上添加自定义叠加颜色。
  • 在初始地图加载时自动显示用户的当前位置。
  • 使用“地理位置”控件手动获取用户的当前位置。
  • 添加一个自定义进度预加载器，其中包含在地图加载时显示的徽标和文本。
  • 添加标题、描述和徽标，使地图独一无二。
  • 使用地球仪和 7 个额外的地图投影。
  • 应用自定义 CSS 类。
  • 单击时将地图居中。
  • 使用 URL 参数（永久链接）进行地图状态共享。
• 标记
  • 将多个标记添加到单个地图。
  • 在多个地图上显示单个标记。
  • 使用点、点、气球和三角形等样式自定义标记外观。
  • 使用 Google Material Icons 进行标记样式设置。
  • 上传并应用受支持的图形格式的自定义标记设计。
  • 使用“点优化”和“自定义优化”标记样式以增强外观和性能。
  • 使用模板高效创建和管理多个标记。
  • 将附近的标记分组到聚类中以减少地图混乱。
  • 配置标记以在单击时打开指定的链接。
  • 向标记添加文本标签以获取其他信息或标识。
  • 将标记分类，以便于过滤和管理。
  • 为每个标记设置一个主要类别，以便更好地分类。
  • 确定标记在商店定位器边栏中的显示顺序。
  • 在永久链接中包含类别参数以过滤显示的标记。
  • 根据标记的主要类别将不同的样式应用于标记。
  • 类别复选框颜色。
  • 突出显示具有特殊样式的特色标记。
  • 使用特殊样式突出显示焦点标记。
  • 搜索结果的标记样式。
• 弹出窗口
  • 启用标记弹出窗口并自定义其样式和行为。
  • 在浅色或深色主题之间进行选择。
  • 自定义标记弹出窗口打开的时间（悬停时、单击时、始终打开或默认打开）。
  • 在弹出窗口中激活灯箱照片库。
  • 使用自定义字段生成器将自定义字段添加到弹出窗口以显示其他信息。
  • 添加具有可选浅色或深色样式的关闭图标。
  • 调整弹出式设计元素，例如角半径、图像位置（顶部或右侧）以及最小宽度和高度。
  • 将弹出窗口放置在标记上方或固定地图角落。
  • 其他次要设置和功能。
• 路线
  • 管理无限数量的路线，每条路线都有单独的设置和样式。
  • 将路线分类，以便更好地管理和过滤。
  • 使用绘制工具直接在地图上创建路径。
  • 从各种路线匹配模式中进行选择，包括不匹配、驾驶、步行和骑自行车。
  • 使用 GPX 文件格式导入和导出路径。
  • 自定义默认和悬停布线样式，并可选择调整颜色、宽度、边框、不透明度、虚线图案和间隙大小。
  • 将单个路线添加到多个地图，从而实现跨不同地图项目的可重用性。
  • 按类别筛选路由，以改善用户体验和可管理性。
• 形状和绘图工具
  • 将任意数量的形状添加到地图中。
  • 将形状添加到多个地图。
  • 使用线工具在地图上的点之间绘制直线。
  • 使用多边形工具为标记区域创建多边形状。
  • 使用“圆”工具绘制表示径向区域的圆。
  • 使用贝塞尔曲线工具绘制和编辑复杂形状的贝塞尔曲线。
  • 使用颜色、不透明度、宽度和破折号/间隙长度的设置自定义形状的笔触。
  • 自定义默认和悬停形状样式，并提供调整颜色、宽度、不透明度、虚线图案和间隙大小的选项。
• 类别
  • 为标记和路线分配类别以进行有组织的管理。
  • 支持多级类别，允许父子关系。
  • 在地图上启用类别过滤器，允许用户选择要显示的类别。
  • 允许您在地图上定位类别过滤器，并具有左上角、右上角、左下角和右下角等选项。
  • 提供不同的选择方法，用户可以在其中选择或禁用类别。
  • 支持通过URL参数进行过滤，方便共享或返回特定地图视图。
• 自定义字段生成器
  • 使用自定义字段展开标记弹出窗口或存储定位器信息。
  • 创建任意数量的自定义字段。
  • 将自定义字段添加到标记模板。
  • 使用各种类型的自定义字段，包括文本和标题、链接、电子邮件、电话、分隔符、按钮、行、数字、true/false、多选、自定义 HTML、类别和评级。
  • 编辑自定义字段的值，并更改其样式和顺序。
  • 设置自定义字段的默认值和自定义值。
  • 在“自定义 HTML”自定义字段中使用音频播放器短代码。
  • 访问每种自定义字段类型的特定设置，以进一步自定义其行为和外观。
  • 隐藏的自定义字段。
• 标记模板生成器
  • 通过设计标记模板，创建大量相同样式的标记。
  • 创建全面的标记模板，包括常规标记设置、标记样式、弹出窗口、图像库、文本标签和自定义字段。
  • 使用模板在一个地方轻松管理多种标记样式。
  • 将任何自定义设置添加到标记，同时保留模板的其余预定义设置。
• 标记导入器
  • 从 Google 表格导入标记及其相关数据。
  • 创建多个导入，每个导入都链接到单独的 Google 电子表格。
  • 在电子表格中选择要从中导入数据的特定页面。
  • 导入标准和自定义标记字段的数据。
  • 使用导入中的新数据覆盖现有标记。
  • 应用规则以在导入新数据时删除现有标记。
• 商店定位器
  • 简单和扩展的商店定位器模式。
  • 带有标记列表的侧边栏。
  • 侧边栏中的详细标记描述。
  • 标记卡的自定义字段和详细的标记描述。
  • 标记和侧边栏卡片的交互式点击事件。
  • 基于自定义字段的高级过滤器和过滤选项。
  • 在用户附近显示标记，自动显示附近的位置以方便使用。
  • 在地图上显示选定区域附近的标记，允许用户查找特定区域的位置。
  • 用户定位：自动确定，通过单击地图手动设置，或使用具有自动完成功能的直观地址搜索。
  • 自定义地理位置标记样式。
  • 控制地图功能的可见性，例如地址搜索、地理位置图标和距离排序选项。
  • 基于距离的位置排序，提供公里和英里选项。
  • 距离排序的自定义值和默认设置。
  • 具有自动完成功能的直观地址搜索。
  • 在可见地图区域内搜索。
  • 标记和位置的搜索功能。
  • 侧边栏位置选项，可以放置在地图的左侧或右侧。
  • 顺序面板位置。
  • 默认情况下，在地图加载时关闭侧边栏的选项。
  • 可调节侧边栏宽度。
  • 可自定义的侧边栏图像位置（顶部或左侧）。
  • 在商店定位器侧边栏中配置标记卡的排序。
• 过滤器和过滤
  • 将无限数量的自定义过滤器添加到扩展商店定位器地图侧边栏。
  • 根据自定义字段及其值创建筛选器。
  • 按预定义类别筛选标记。
  • 应用基于距离的过滤，并可选择以公里或英里为单位进行测量。
  • 过滤可见地图区域内的标记。
  • 调整边栏中滤镜的顺序。
  • 将过滤器面板配置为在地图加载时立即显示或通过按钮显示。
  • 包括一个按钮，用于将所有活动筛选器重置为默认状态。
  • 将过滤器与地理位置功能集成，以根据用户的当前位置显示结果。
  • 数字类型自定义字段过滤器的直方图。
• 信息小部件
  • 在地图上显示微件。
  • 在地图上配置最多六个不同的微件位置。
  • 输入一个值并提供小组件的描述。
  • 切换控件后面的背景显示。
  • 设置字体颜色并调整控件文本的字体粗细。
  • 在地图的两侧启用渐变效果，选择渐变颜色，并控制透明度级别。
• 互动导览
  • 为地图启用交互式游览。
  • 能够在标记和区域之间切换。
  • 两个动画选项：跳跃或飞行。
  • 控制飞行速度、飞行曲线和变焦级别。
  • 在游览期间聚焦在标记上时启用或禁用弹出窗口的显示。
  • 四个可能的游览控制位置。
  • 通过选择四个可能方向中的任何一个来控制标记偏移。
  • 编号标记。
  • 用于导览导航的标记缩略图。
• 国家和地区边界
  • 访问具有不同准确度的全球国家和地区边界数据的全面集合。
  • 构建和自定义国家或地区的任意组合。
  • 预定义的国家边界预设可用于整个世界、大洲、联合国区域、世界银行区域、次区域和自定义组合。
  • 澳大利亚、加拿大、法国、德国、意大利、西班牙、英国和美国的管理 1（州/省）和管理 2（县/区）区域的详细边界数据。
  • 自定义不同状态的多边形填充颜色和不透明度，包括初始状态、悬停状态、所选状态和自定义状态。
  • 设置面描边颜色和不透明度以匹配地图样式要求。
  • 单击区域时的可配置作，包括无作（无作）或打开链接。
  • 自定义悬停交互，包括无、带有区域名称的弹出窗口或带有区域名称和自定义值的弹出窗口。
• 性能
  • 支持管理大量标记。
  • 允许使用 GeoJSON 文件作为数据源，通过减少加载时间来提高地图性能。
  • 支持优化的标记样式，例如“点优化”和“自定义优化”，通过简化标记渲染来增强性能。
  • 将附近的标记分组到聚类中，以减少混乱并提高可读性。
  • 在准备地图时显示预加载器。
  • 使用动态加载来加载标记、弹出窗口和存储定位卡。
  • 包括用于优化整体地图性能的各种增强功能。

插件

• Treweler GeoJSON 插件
• Treweler 3D 模型插件
• Treweler 标记提交插件

更改日志

## [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.