hutlim/silverstripe-addressable

SilverStripe 地址和地理编码模块

安装: 18

依赖项: 0

建议者: 0

安全: 0

类型:silverstripe-module

1.0.0 2013-02-10 02:23 UTC

This package is auto-updated.

Last update: 2024-09-28 05:46:57 UTC


README

Build Status

Addressable 模块为对象添加地址字段,并支持自动地理编码。

维护者联系方式

要求

  • 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 在保存时将地址转换为经纬度,并将其保存到 LatLng 字段中。