||||
-|-|
| 摘要 | Discourse Gifs 在编辑器中添加了一个按钮,允许你搜索 GIF 并轻松地将最合适的 GIF 添加到你的帖子中。
| 仓库链接 | https://github.com/discourse/discourse-gifs
|初次使用 Discourse 主题? | Discourse 主题使用初学者指南
安装此主题组件
功能
搜索后,你会看到一个无限滚动的相关 GIF 墙:

点击其中一个 GIF,它将被插入到你当前的编辑器中,效果如下:

此组件主要基于 ReplyGif: 轻松添加反应 GIF 的一个旧分支,因此感谢 @cpradio。
主要区别在于:
-
它可以使用动画 WebP 而不是 GIF,因此在带宽效率上更高。
-
它是一个主题组件,因此安装和更新要容易得多。
-
提供 Giphy API 或 Tenor API 的选择。
-
结果支持无限滚动
-
生成的 GIF 使用我们原生的比特腐烂保护机制下载到 Discourse。如果担心存储空间,可以使用现有设置禁用此行为。
-
无需调整 nginx 来设置 HTTPS 代理
获取 Giphy API 密钥
为了使组件正常工作,你需要访问 Dashboard | GIPHY Developers 并点击如下所示的按钮:
填写表单后,API 密钥将显示为:
获取 Tenor API 密钥
在 Tenor 官方网站获取该密钥:GIF API - 更好、更快、免费 | 使用 Tenor 获取你的 GIF
之后,访问 Discourse 中的主题组件页面并填写设置,例如:
设置
| 名称 | 描述
|-|
| api provider | 我们应该使用哪个 GIF 提供商?
| giphy api key | GIPHY: API 密钥
| giphy file format | GIPHY: 使用的图像格式。WEBP 文件较小,加载更快,而 GIF 提供与旧浏览器的兼容性。
| giphy content rating | GIPHY: 搜索结果的内容评级。更多信息请参见 https://developers.giphy.com/docs/optional-settings#rating 。
| giphy locale | GIPHY: 搜索使用的语言。用于根据地区内容定制搜索。设置为你的默认论坛区域设置。
| limit infinite search results | 限制用户无限滚动时返回的 GIF 结果数量,以防止 API 速率限制。
| max results limit | Tenor & GIPHY: 当启用“限制无限搜索结果”时,我们将搜索直到获得此最大数量的 GIF 结果。每次 API 调用检索 24 个结果,例如 240 最大限制:240 / 24 = 10 次 API 调用。
| tenor api key | Tenor: V2 API 密钥。获取说明可在 Discourse Meta - Discourse Gifs 中找到。
| tenor client key | Tenor: (可选) 客户端指定的表示集成的字符串
| tenor file detail | Tenor: 使用的图像格式
| tenor content filter | Tenor: Tenor 结果的内容安全级别。更多信息请参见 Tenor API 指南 。
| tenor country | Tenor: 请求的两位字母国家/地区代码。可在 Wikipedia - ISO_3166-1 中找到你的国家代码。
| tenor locale | Tenor: 搜索使用的语言。可以提供国家代码(可选)以区分方言。
| 翻译 | 默认值
|-|
| gif.modal_title | 搜索 GIF
| gif.query | 关键词
| gif.insert | 插入所选图片
| gif.composer_title | 搜索 GIF
| gif.no_results | 在上面的输入框中输入关键词以搜索 GIF。
| gif.bad_api_key | 无效的 $api_provider API 密钥。站点管理员,请检查你的密钥和/或你的 $api_provider 账户。
| gif.error_rate_limit | 我们已达到 $api_provider API 速率限制。请稍候再试。如果问题持续存在,请联系你的站点管理员。
| gif.error_search_too_long | 请将搜索查询缩短至 50 个字符以内,然后重试。
由我们托管? 主题组件在我们的 Standard、Business 和 Enterprise 计划中均可用。











