德累斯顿教堂/nkc-address

TYPO3 扩展,用于展示来自 NAPI 的人员和机构

安装: 638

依赖项: 0

建议者: 0

安全: 0

星级: 0

关注者: 2

分支: 2

开放问题: 0

类型:typo3-cms-extension

12.4.1 2024-06-27 12:32 UTC

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 报告错误。