README

关于

该扩展扩展了现有的 fe_users 记录。添加了一个名为 location 的新类型，具有不同的字段。

字段集被减少到最小。

安装

通过 composer 或扩展管理器按常规安装。除了扩展之外，您还需要一个 Google Map API 密钥。还需要包含提供的静态 TypoScript 模板。有关密钥的更多信息，请参阅 配置。

配置

配置通过常量编辑器完成，其中每个字段都提供进一步的信息。

您需要激活 Google Maps JavaScript API 以显示谷歌地图，并激活 Google Maps Geocoding API 以进行地址地理编码。

使用方法

TYPO3 后台

插入新的前端用户，选择类型 Location 并填写字段。一旦提供地址，将通过 Google Maps API 进行地理编码。一旦提供纬度和经度，编辑表单中将显示谷歌地图。

命令控制器

该扩展提供了一个命令控制器来更新所有现有的前端用户纬度和经度

typo3cms geocode:feuser

命令控制器使用了日志记录，因此可以添加一个记录器来查看发生了什么。

表单完成器

要为通过表单提交的数据启用地理编码，请启用提供的完成器

TYPO3:
    CMS:
        Form:
            prototypes:
                standard:
                    finishersDefinition:
                        GeocodeFrontendUser:
                            implementationClassName: Codappix\CdxFeuserLocations\Domain\Finishers\GeocodeFrontendUserFinisher

之后，在您的表单中使用提供者并利用提供的纬度和经度。如果无法获取它们，两者都将为零。

由于 https://forge.typo3.org/issues/82833 的原因，值始终是字符串。

finishers:
    -
        identifier: GeocodeFrontendUser
    -
        identifier: SaveToDatabase
        options:
            1:
                table: 'fe_users'
                mode: insert
                databaseColumnMappings:
                    lat:
                        value: '{Geocode.lat}'
                    lng:
                        value: '{Geocode.lng}'

目前，只有当提交的表单提供以下字段时，编码才能正常工作：地址、邮编、城市和国家。

如果这对您不起作用，请提供 Pull Request。