andreaskastl/openweatherapi

在前端显示基于 wetter.com openweather API 的选定位置的天气预报

维护者

详细信息

github.com/andreaskastl/openweatherapi

源代码

问题

安装: 14

依赖项: 0

建议者: 0

安全性: 0

星星: 0

关注者: 1

分支: 0

开放问题: 0

语言：HTML

类型：typo3-cms-extension

3.2.0 2022-05-01 15:50 UTC

Requires

Replaces

  • typo3-ter/openweatherapi: 3.2.0

GPL-2.0-or-later 44d88f95444fcaa4ba172d0b1314c77f4a3647ed

weathertypo3foreacastopenweatherapi

This package is auto-updated.

Last update: 2024-09-29 06:02:52 UTC

README

简介

基于 api.wetter.com (openweather API) 显示选定位置的天气预报。

请注意

  • 此扩展基于 wetter.com 直接提供的免费 XML API。
  • Wetter.com 不再向新客户提供 XML API。网站上的管理界面已不再可用。API 端点似乎仍然对现有订阅有效。
  • 如在此处宣布 https://www.wetter.com/apps_und_mehr/website/api/ (2020年12月)：wetter.com 通过 Rapid API 提供了新的 REST API。此扩展尚不支持此新的 REST API。

管理

安装

需要将扩展安装为任何其他 TYPO3 CMS 扩展。获取扩展

  1. 从扩展管理器获取：按下 检索/更新 按钮，搜索扩展密钥 openweatherapi 并从存储库导入扩展。
  2. 从 typo3.org 获取：您可以从 https://extensions.typo3.org/extension/openweatherapi/ 获取当前版本，无论是下载 t3x 还是 zip 版本。然后在扩展管理器中上传文件。

扩展包含一些需要包含和配置的 TypoScript 代码。

  1. 切换到您站点的根页面。
  2. 切换到 模板模块 并选择 信息/修改。
  3. 点击链接 编辑整个模板记录 并切换到 包含 选项卡。
  4. 在 包含静态（来自扩展） 字段中选择 Openweather API - Weather Forecast。

用户手册

创建插件内容元素

要在页面上显示天气预报

  1. 切换到 页面视图模块
  2. 创建新页面或选择现有页面
  3. 创建一个新的 内容元素，在 “新内容元素向导” 中向下滚动到 插件 部分，并选择 “天气预报”
  4. 切换到 插件 选项卡，并根据您的 wetter.com API 订阅输入所需的字段
    1. 项目名称
    2. API 密钥
    3. 城市代码
  5. 保存 新的插件配置。
  6. 切换到前端并验证插件是否正常工作。

请注意

  • 当您第一次打开带有插件的页面或更改页面后，将执行对 wetter.com 的 API 调用并获取数据。
  • 当您或另一位用户再次加载同一页面时，不会再次执行 API 调用，因为内容已在 Typo3 CMS 中缓存。
  • 在页面缓存过期后（例如 24 小时后），将再次调用 API。您可以在页面记录中编辑页面记录并切换到 "行为" 选项卡，以调整缓存行为和 API 重新加载。在 "缓存/缓存有效期" 字段中选择适当的设置。

配置

自定义模板

要自定义前端输出，定义自己的模板并在模板模块的常量部分中覆盖模板路径： plugin.tx_openweatherapi.view.templateRootPath

要自定义日期/时间格式，覆盖模板模块设置部分中的 Typoscript 设置： plugin.tx_openweatherapi.settings.strftime = %A, %d.%m.%Y