README

一个位置字段，允许您选择位置并在谷歌地图上显示它。您还可以选择多个位置进行分组。

注意：当Craft插件商店推出时，此插件可能成为付费插件。

要求

Craft 3.0 (beta 28)+
PHP 7.0+
Google Maps API密钥

安装

使用Composer安装

composer require dolphiq/craft3-locationpicker

在Craft控制面板的“设置”>“插件”下安装插件
当添加新字段时（例如，“设置”>“字段”>“添加新字段”），将“位置字段”类型可用

创建具有位置字段类型的字段

选择 位置字段 类型
保存字段

使用位置字段类型

将字段添加到字段布局（例如，到部分）
您现在可以通过单击 选择位置 按钮在创建或更新部分时选择位置
单击此按钮时，您将获得一个弹出窗口。输入地址以搜索位置。
您现在将获得一个下拉列表。单击下拉列表中的一个选项以选择位置。
位置将显示在下面的地图上
单击弹出窗口右下角的红色 选择 按钮，以在条目中使用所选位置。
如果您单击取消或关闭弹出窗口，则不会在条目中设置所选位置。

显示一个位置地图的示例用法

在twig模板中显示带有所选位置的谷歌地图

{{ entry.fieldName.getMap() }}

图标字段的属性

获取位置地址（字符串）
```
{{ entry.fieldName.address }}
```
获取位置纬度
```
{{ entry.fieldName.lat }}   
```
获取位置经度
```
{{ entry.fieldName.long }}
```
使用选项数组显示包含位置的地图。有关选项部分，请参阅选项部分
```
{{ entry.fieldName.getMap()|raw }}
```

显示多个位置地图的示例用法

要在同一个地图上显示更多位置（每个位置一个标记），我们使用twig函数 dolphiqMap。假设我们有一个名为 hospitals 的结构，其中每个条目都有一个位置字段。要在twig模板中显示所有位置，请按照以下操作执行：

{% set hospitals = craft.entries.section('hospitals').all() %}
{% set locations = {} %}

{% for hospital in hospitals %}

    {% set locations = locations|merge({(loop.index) : hospital.location}) %}
    
{% endfor %}

{{ dolphiqMap(locations, {width:'100%', height:'500px'})|raw }}

属性和选项

dolphiqMap(locations, options) 函数的属性

属性

地图选项

贡献者 & 开发者

Lucas Weijers - 原始开发者

由Dolphiq提供： info@dolphiq.nl

dolphiq / craft3-locationpicker

维护者

详细信息