hutlim / silverstripe-addressable
SilverStripe 地址和地理编码模块
1.0.0
2013-02-10 02:23 UTC
Requires
This package is auto-updated.
Last update: 2024-09-28 05:46:57 UTC
README
Addressable 模块为对象添加地址字段,并支持自动地理编码。
维护者联系方式
- Marcus Nyeholt (marcus@silverstripe.com.au)
要求
- SilverStripe 3.0+
文档
快速使用概述
为了将简单的地址字段(地址、郊区、城市、邮编和国家)添加到对象中,只需应用 Addressable
扩展。
Object::add_extension('Object', 'Addressable');
为了将完整地址渲染到模板中,您可以使用 $FullAddress
返回一个简单字符串,或使用 $FullAddressHTML
将地址渲染到 HTML <address>
标签中。
您可以使用 Addressable::set_allowed_states()
和 ::set_allowed_countries()
分别定义一组全局允许的州或国家。这些也可以通过 setAllowedStates()
和 setAllowedCountries()
分别为每个实例设置。
如果提供的值是单个字符串,则该值将被设置为所有新对象的字段,并且用户不会看到一个输入字段。如果值是数组,则用户将看到一个下拉字段。
要为 Addressable
对象添加在地址更改时自动地理编码的功能,简单应用 Geocodable
扩展。
Object::add_extension('Object', 'Geocodable');
这将使用 Google Maps API 在保存时将地址转换为经纬度,并将其保存到 Lat
和 Lng
字段中。