プログレスバー

:information_source: 概要 サイトに進捗バーを追加する
:eyeglasses: プレビュー \[todo\]
:hammer_and_wrench: リポジトリ \u003chttps://github.com/Canapin/Discourse-progress-bar\u003e
:question: インストールガイド テーマまたはテーマコンポーネントのインストール方法
:open_book: Discourseテーマは初めてですか? Discourseテーマを使用するための初心者ガイド

このテーマコンポーネントをインストール

Discourse Progress Bar

説明

このコンポーネントは、サイトの利用可能なアウトレットにプログレスバーを追加します。

:information_source: スクリプトを使用して、ペイロード {\"name\":\"current_value\",\"value\":\"[yourNewValue]\"} を指定して /admin/theme/[theme_component_ID]/setting に PUT リクエストを送信することで、プログレスバーの値を自動的に更新する場合に最適です。

プログレスバーは、次のアウトレットに収まるように最適化されています。

  • above-main-container
  • above-site-header
  • before-header-panel
  • below-site-header
  • before-sidebar-sections

使用例

このコンポーネントは、コミュニティ資金提供によるフォーラムの寄付の進捗状況を公開するために開発されました。

Ko-fi の Webhook を使用したカスタムスクリプトにより、寄付ごとにプログレスバーが動的に更新されました。

プログレスバーがあることで、コミュニティにとって非常に :flexed_biceps: モチベーションになりました。
以前はピン留めされたトピックのみが使用され、寄付目標は数か月かけて達成されていました。
プログレスバーを導入したことで、過去数年間、寄付目標は数日で達成されるようになりました! :exploding_head:

このプログレスバーは、明らかに他の目的にも使用できます。ぜひ、何に使用しているか教えてください!

スクリーンショット

:desktop_computer: デスクトップ

above-main-container

before-sidebar-sections

above-site-header

before-header-panel (デスクトップのみ)

below-site-header

:mobile_phone: モバイル

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 ducks9 of 15 rubber ducks を表示します。デフォルト: {percentage}%
hide_when_full 満杯になったときにプログレスバーを非表示にする。デフォルト: false
outlet_name プログレスバーが表示されるサイト上の場所。推奨されるアウトレット: above-main-containerabove-site-headerbefore-header-panelbelow-site-headerbefore-sidebar-sections。デフォルト: above-main-container
display_on_mobile モバイルデバイスでプログレスバーを表示する。デフォルト: true
display_on_homepage ホームページでプログレスバーを表示する。デフォルト: true
url_must_contain プログレスバーが表示されるURL。デフォルト: `/latest
progress_bar_color 有効なCSS background 値。例:
#FC0FC0
rgb(252,15,192)
var(--tertiary)
linear-gradient(0deg, white 0%, var(--tertiary) 100%)
注:空の場合、赤 (0%) から緑 (100%) までの動的な色が使用されます。デフォルト: var(--tertiary)

謝辞

コードに関する一般的なヘルプとアドバイスを @Arkshine に感謝します :v:

「いいね!」 10