 |
概要 | Discourse Gifs は、コンポーザにボタンを追加し、GIF を検索して最適なものを投稿に簡単に追加できるようにします。 |
 |
リポジトリリンク | https://github.com/discourse/discourse-gifs |
 |
Discourse テーマに初めての方は？ | Discourse テーマの使用に関する初心者向けガイド |
このテーマコンポーネントをインストール
機能
検索すると、関連する GIF の無限スクロールの壁が表示されます：
1つをクリックすると、現在のコンポーザに挿入されます。コンポーザは次のようになります：
これは ReplyGif: Adding reaction GIF easily の古いフォークを基にしているため、@cpradio に感謝します。
主な違いは次のとおりです：
-
GIF の代わりにアニメーション WebP を使用できるため、帯域幅の効率が大幅に向上します。
-
テーマコンポーネントであるため、インストールと更新がはるかに簡単です。
-
Giphy API または Tenor API の選択が可能です。
-
結果の無限スクロール
-
結果の GIF は、ネイティブのビット腐敗保護を使用して Discourse にダウンロードされます。スペースが気になる場合は、既存の設定を使用してこの動作を無効にできます。
-
HTTPS のプロキシを設定するために nginx をいじる必要はありません
Giphy API キーの取得
コンポーネントが機能するには、Dashboard | GIPHY Developers にアクセスして、次のようにクリックする必要があります：
フォームに記入すると、API キーは次のように表示されます：
Tenor API キーの取得
公式の Tenor サイトでそのキーを取得してください：GIF API - Better, Faster & Free | Get Your GIFs with Tenor
その後、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: 「limit infinite search results」が有効になっている場合、この数の最大 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 Guides を参照してください。 |
| tenor country | Tenor: リクエストの2文字の国コード。国コードは 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 プランでご利用いただけます。