microman / kirby-map
地理位置字段 & 地图块:您在网站上使用地图所需的一切
Requires
README
概述
2-in-1 插件:您在网站上设置地图所需的一切。此插件包含两个丰富的功能集
-
🔎 地理位置字段:
- 搜索您的位置并将结果(名称、纬度、经度)输入字段
-
🗺 地图块:
- 内置 Mapbox 实例
- 为以下设置以下值...
- 设计
- (中心)位置
- 缩放
- 插入无限数量的 📍 标记
- 位置
- 图标
- 图标的锚点(
top left
、center center
、bottom right
等) - 图标大小(100% = 原始大小)
- 弹出窗口:文本和位置的水平偏移量
此插件免费使用,并按照 MIT 许可证发布。如果您用于商业目的,或想表示您的感激之情,请通过捐赠支持我。
安装
手动
下载并将插件复制到您的插件文件夹:/site/plugins/
使用 Composer
composer require microman/kirby-map
配置
Kirby Map 使用 Mapbox 进行地理位置和地图视图。出于内部目的,已设置默认令牌。您可能想将其替换为特定用例。
要在您的网站上使用 Mapbox,创建您自己的 访问令牌并将其设置在您的配置文件中:/site/config/config.php
return [ 'microman.map.token' => 'YOUR-TOKEN' ];
地理位置字段
以下是如何在蓝图中使用地理位置字段的示例
myGeoLocation: label: My Geolocation type: geolocation default: name: "Berlin" lat: 13.38333 lng: 52.51667
如何在模板中使用地理位置字段
<?php $mylocation = $page->myGeoLocation()->toLocation() ?> Name: <?= $mylocation->name() ?> Latitude: <?= $mylocation->lat() ?> Longitude: <?= $mylocation->lng() ?>
地图块
使用地图块,您可以设置带有实时预览的地图。要将此块添加到您的蓝图,只需添加一个 blocks
字段
myContent: type: blocks fieldsets: - maps
要自定义默认块蓝图,将位于 /site/plugins/kirby-map/blueprints/blocks/
中的两个文件复制到您的块蓝图文件夹:/site/blueprints/blocks
标记
您可以直接在地图块中添加尽可能多的标记。尝试将标记放置在可见预览中。
如何在模板中使用地图块
地图将在您的块字段内渲染。
默认情况下,块输出开源 Mapbox 实例。
如果您想使用 Google Maps JavaScript API,请将 /site/plugins/kirby-map/lib/examples/google-maps.php
复制并重命名为 site/snippets/blocks/maps.php
别忘了将最后一行中的
[YOUR-API]
替换为您的 Google-API。
致谢
由 Mapbox 提供支持。灵感来自 Sylvain 的 Kirby-Locator
许可证
MIT
你喜欢这个插件吗? 给我买杯☕️