| 概要 | サイトに進捗バーを追加する | |
| プレビュー | \[todo\] | |
| リポジトリ | \u003chttps://github.com/Canapin/Discourse-progress-bar\u003e | |
| インストールガイド | テーマまたはテーマコンポーネントのインストール方法 | |
| Discourseテーマは初めてですか? | Discourseテーマを使用するための初心者ガイド |
このテーマコンポーネントをインストール
Discourse Progress Bar
説明
このコンポーネントは、サイトの利用可能なアウトレットにプログレスバーを追加します。
スクリプトを使用して、ペイロード {\"name\":\"current_value\",\"value\":\"[yourNewValue]\"} を指定して /admin/theme/[theme_component_ID]/setting に PUT リクエストを送信することで、プログレスバーの値を自動的に更新する場合に最適です。
プログレスバーは、次のアウトレットに収まるように最適化されています。
above-main-containerabove-site-headerbefore-header-panelbelow-site-headerbefore-sidebar-sections
使用例
このコンポーネントは、コミュニティ資金提供によるフォーラムの寄付の進捗状況を公開するために開発されました。
Ko-fi の Webhook を使用したカスタムスクリプトにより、寄付ごとにプログレスバーが動的に更新されました。
プログレスバーがあることで、コミュニティにとって非常に
モチベーションになりました。
以前はピン留めされたトピックのみが使用され、寄付目標は数か月かけて達成されていました。
プログレスバーを導入したことで、過去数年間、寄付目標は数日で達成されるようになりました! ![]()
このプログレスバーは、明らかに他の目的にも使用できます。ぜひ、何に使用しているか教えてください!
スクリーンショット
デスクトップ
above-main-container
before-sidebar-sections
above-site-header
before-header-panel (デスクトップのみ)
below-site-header
モバイル
above-main-container および below-site-header
before-sidebar-sections
above-site-header
設定
| 設定 | 説明 |
|---|---|
| content_before | プログレスバーの上に表示されるテキスト(HTML可)。デフォルト: \u003cstrong\u003e寄付の進捗\u003c/strong\u003e |
| content_after | プログレスバーの下に表示されるテキスト(HTML可)。デフォルト: 空 |
| progress_bar_width | プログレスバーのラッパーの幅。デフォルト: 50% |
| progress_bar_height | プログレスバーの高さ。デフォルト: 10px |
| max_value | プログレスバーの最大値。デフォルト: 300 |
| current_value | プログレスバーの現在の値。デフォルト: 150 |
| value_display | プログレスバーの隣に表示される値の表示形式。利用可能なプレースホルダー: {current}、{max}、{percentage}。例:{percentage}% は 33% を表示します。{current} of {max} rubber ducks は 9 of 15 rubber ducks を表示します。デフォルト: {percentage}% |
| hide_when_full | 満杯になったときにプログレスバーを非表示にする。デフォルト: false |
| outlet_name | プログレスバーが表示されるサイト上の場所。推奨されるアウトレット: above-main-container、above-site-header、before-header-panel、below-site-header、before-sidebar-sections。デフォルト: above-main-container |
| display_on_mobile | モバイルデバイスでプログレスバーを表示する。デフォルト: true |
| display_on_homepage | ホームページでプログレスバーを表示する。デフォルト: true |
| url_must_contain | プログレスバーが表示されるURL。デフォルト: `/latest |
| progress_bar_color | 有効なCSS background 値。例:#FC0FC0rgb(252,15,192)var(--tertiary)linear-gradient(0deg, white 0%, var(--tertiary) 100%)注:空の場合、赤 (0%) から緑 (100%) までの動的な色が使用されます。デフォルト: var(--tertiary) |
謝辞
コードに関する一般的なヘルプとアドバイスを @Arkshine に感謝します ![]()







