德累斯顿教堂 / nkc-address
TYPO3 扩展,用于展示来自 NAPI 的人员和机构
Requires
- fluidtypo3/vhs: ^6.1 || ^7.0
- nordkirche/nkc-base: ^12.4
- typo3/cms-core: ^12.4
Requires (Dev)
- typo3/coding-standards: ^0.7.1
README
该扩展提供插件,用于在网站上展示德累斯顿教堂 API(人员和组织)的内容。
-
人员
- 列表视图/搜索结果
- 详细视图(名片)
- 搜索表单
- 助手:通过 ID 跳转到名片
-
机构
- 列表视图/搜索结果
- 详细视图(名片)
- 搜索表单
- 助手:通过 ID 跳转到名片
-
地图展示
- 带有地图下方的列表
- 独立展示,不带列表
依赖关系
该扩展基于
nordkirche/nkc-base ^12.4
nordkirche/nk-google-map ^12.4
fluidtypo3/vhs ^6.1 || ^7.0
TYPO3 ^12.4
安装
由于安装过程中需要安装所有依赖项,因此通过 composer 安装该扩展。
composer req nordkirche/nkc-address
请随后将扩展的静态模板绑定到您的 TypoScript 模板中。
配置
请参阅 nordkirche/nkc-base 的文档,以启用对 NAPI 的访问。
在静态 TypoScript 中存在大量配置,可以根据自己的需求进行调整,例如为地图展示设置图标路径。对于 TYPO3 集成者,大多数内容应能自行解释。
一般而言,配置可以在 TypoScript 和插件中同时进行。请注意,如果插件配置具有值,则将覆盖 TypoScript 配置。
扩展的模板具有非常基础的标记,以展示扩展的潜力。要展示的内容非常复杂,因此标准的布局几乎没有意义。
PSR-14 事件
存在 PSR-14 事件,用于调整 NAPI 查询和数据输出。
重要提示
请确保在 TYPO3 配置中禁用调试选项
$GLOBALS['TYPO3_CONF_VARS']['FE']['debug'] = 0;
否则,在 TYPO3 的 JSON 响应中会添加缓存提示,并且地图标记将无法加载。
如果要在列表视图中生成静态 Google 地图,必须在 TYPO3 中包含以下 TypoScript 配置
config.forceAbsoluteUrls = 1
这确保了与 EXT:nkc_base 一起提供的图标通过资产目录链接。
重大变更
从版本 12.4 开始,所有动作都有自己的插件实例,因为 TYPO3 不再支持可切换的控制器动作。迁移时,有一个升级向导可用。
搜索表单的模板标记已更改,因为现在在搜索表单中使用 Fluid 表单元素,以避免 cHash 错误和缓存问题。
发现错误了吗?
请通过 github https://github.com/Nordkirche/nkc-address 报告错误。