djangocms-darksky-api 0.0.6

链接djangocms和Dark Sky的天气插件。

安装

1. 使用pipenv安装模块

pipenv install djangocms-darksky-api

• 或pip

pip install djangocms-darksky-api

2. 将其添加到您的已安装应用中

    "djangocms_darksky_api",

3. 应用迁移

py manage.py migrate djangocms_darksky_api

4. 在您的设置中包含API密钥（在darksky网站上获取一个）

DJANGOCMS_DARKSKY_API_SETTINGS = {"api_key": "your key here"}

• 或使用环境变量加载它

import os
DJANGOCMS_DARKSKY_API_SETTINGS = {"api_key": os.getenv("DARKSKY_API_KEY", None)}

5. 使用djangocms在您的页面上包含天气插件
6. 

示例

原始结果

轻量模板（查看 & 源）

完整模板（查看 & 源）

错误信息（如果api.darksky.net宕机）

由于darksky API有时会遭受中断，该插件可以在数据集中显示错误信息（“数据当前不可用。”）。

渲染视图的示例

轻量模板

完整模板

杂项

Css

图标（例如 <div class="darksky-icon darksky-rain"></div>）的CSS类形式为darksky-icon darksky-[name]。

[name]可以是以下任何值（参见darksky文档）

• clear-day
• clear-night
• rain
• snow
• sleet
• wind
• fog
• cloudy
• partly-cloudy-day
• partly-cloudy-night

单位

所有值都使用国际单位制（°C、km/h、...）返回，并在模板文件中硬编码。

语言

使用 django.utils.translation.get_language() 和 django.conf.LANGUAGE_CODE 搜索语言。

Dark Sky api 支持的语言可以在其 文档 中找到。

缓存

插件

插件已缓存（与 json 内容的持续时间相同）。

Json

值缓存一小时（这避免了每天在 Dark Sky api 站点上成千上万的查询）。

如果您想更改缓存持续时间，请在 settings.py 中的 DJANGOCMS_DARKSKY_API_SETTINGS 字典中添加一个 cache 条目。

DJANGOCMS_DARKSKY_API_SETTINGS = {
    "api_key": "mysuperapikey",
    "cache": 60 * 60, # one hour
}

或使用环境变量加载它

import os
DJANGOCMS_DARKSKY_API_SETTINGS = {
    "api_key": os.getenv("DARKSKY_API_KEY", None),
    "cache": os.getenv("DARKSKY_CACHE_DURATION", 60 * 60), # return content of DARKSKY_CACHE_DURATION if it exists, or one hour if it doesn't
}

如 Django 文档 中所述：“[超时是] 值应在缓存中存储的秒数。传入 None 作为超时将无限期地缓存值。超时为 0 则不会缓存值。”