xddesigners / silverstripe-mapbox
将Mapbox添加到Silverstripe页面
2.0.4
2018-10-31 14:21 UTC
Replaces
- bramdeleeuw/silverstripe-mapbox: 2.0.4
README
将Mapbox地图添加到您的Silverstripe页面。
安装
通过在您的composer.json中引入该模块或运行以下命令来简单安装模块:
composer require "xddesigners/silverstripe-mapbox"
然后,将控制器扩展添加到您想要显示地图的页面,并配置基本属性
HomePagecontroller:
extensions:
- XD\MapBox\MapBox
XD\MapBox\MapBox:
access_token: 'YOUR_MAPBOX_ACCESS_TOKEN'
style: 'YOUR_MAPBOX_STYLE'
配置
地图可以被配置,并且可以选择配置一个图标,语法遵循leaflet配置,您可以通过任何选项传递给它,这里都是可以传递的。所有设置选项将组合成一个json对象。
XD\MapBox\MapBox:
map_options:
dragging: false
zoomControl: false
scrollWheelZoom: false
icon_options:
iconUrl: 'path/to/the.icon'
iconSize:
- 50
- 50
iconAnchor:
- 25
- 50
要使地图居中于某个位置,您需要将方法mapBoxMarkers()
添加到包含MapBox扩展的模型中。该方法需要返回一个包含至少一个位置的数组,以在地图上居中地图。如果使用多个标记,可以将配置设置fit_bounds_to_markers
设置为true,以便所有标记都显示在地图上。
对于使用扩展的模型,提供了一个界面,只需将implements UseMapBox
添加到您的类中,以强制执行该方法。
许可证
版权(c)2016,XD设计师,保留所有权利。
保留所有权利。
在满足以下条件的情况下,允许重新分配和使用源代码和二进制形式,无论是否修改:
- 源代码的重新分配必须保留上述版权声明、本条件列表和以下免责声明。
- 二进制形式的重新分配必须在不修改的情况下复制上述版权声明、本条件列表和以下免责声明,包括但不限于文档和/或其他与分发一起提供的材料。
- 未经Bram de Leeuw的书面同意,不得使用其姓名来推广或认可由此软件派生出的产品。
本软件由版权所有者和贡献者“按原样”提供,并放弃任何明示或暗示的保证,包括但不限于适销性和针对特定目的的适用性保证。在任何情况下,均不对任何直接、间接、偶然、特殊、示范性或后果性的损害(包括但不限于替代商品或服务的采购;使用、数据或利润的损失;或业务中断)承担责任,无论是否已通知此类损害的可能性,即使在本软件的潜在损害可能性已告知的情况下。