microman/kirby-map

地理位置字段 & 地图块:您在网站上使用地图所需的一切

资助包维护!
其他

安装: 573

依赖关系: 0

建议者: 0

安全: 0

星级: 30

关注者: 3

分支: 2

公开问题: 0

语言:Vue

类型:kirby-plugin

1.1.1 2023-12-05 08:59 UTC

This package is auto-updated.

Last update: 2024-09-08 14:19:39 UTC


README

概述

2-in-1 插件:您在网站上设置地图所需的一切。此插件包含两个丰富的功能集

  • 🔎 地理位置字段:

    • 搜索您的位置并将结果(名称、纬度、经度)输入字段
  • 🗺 地图块:

    • 内置 Mapbox 实例
    • 为以下设置以下值...
      • 设计
      • (中心)位置
      • 缩放
    • 插入无限数量的 📍 标记
      • 位置
      • 图标
      • 图标的锚点(top leftcenter centerbottom 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'
];

地理位置字段

Geolocation field

以下是如何在蓝图中使用地理位置字段的示例

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() ?>

地图块

Map block

使用地图块,您可以设置带有实时预览的地图。要将此块添加到您的蓝图,只需添加一个 blocks 字段

myContent:
  type: blocks
  fieldsets:
    - maps

要自定义默认块蓝图,将位于 /site/plugins/kirby-map/blueprints/blocks/ 中的两个文件复制到您的块蓝图文件夹:/site/blueprints/blocks

标记

您可以直接在地图块中添加尽可能多的标记。尝试将标记放置在可见预览中。

Map block marker

如何在模板中使用地图块

地图将在您的块字段内渲染。

默认情况下,块输出开源 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

你喜欢这个插件吗? 给我买杯☕️