|||
-|-|-|
| 概要 | プロフィールにユーザーのListenBrainzのリスニングを表示するDiscourseプラグイン
| リポジトリリンク | \u003chttps://git.sr.ht/~phw/discourse-listenbrainz\u003e
| インストールガイド | Discourseにプラグインをインストールする方法
機能
このDiscourseプラグインを使用すると、ユーザーはListenBrainzからの最近のリスニングをユーザープロフィールに表示できます。ユーザーは、最も最近のリスニングまたはListenBrainzプロフィールの一般的な統計情報を表示することを選択できます。
ListenBrainzは、音楽の再生状況を追跡し、リスニング習慣に関する洞察や推奨事項を提供するオンラインサービスです。このプロジェクトは完全にオープンソースであり、すべてのデータをオープンデータとして公開しています。
このプラグインは現在MusicBrainzコミュニティフォーラムで使用されていますが、他の音楽関連コミュニティにとっても興味深いものになる可能性があります。
設定
管理者設定
ListenBrainzプラグインは、Discourseの管理者インターフェースで設定できます。次のオプションが利用可能です。
-
listenbrainz enable: ユーザーがプロフィールにListenBrainzステータスを表示できるようにします。デフォルト: 有効。
-
listenbrainz username matches discourse: Discourseユーザーのユーザー名が通常ListenBrainzユーザー名と一致する場合は、これを有効にします。ユーザーは引き続き別のListenBrainzユーザー名を設定できますが、Discourseユーザー名が事前入力されます。このオプションは、主にMetaBrainzコミュニティフォーラムで使用することを目的としています。デフォルト: 無効。
-
listenbrainz poster icon: ユーザーが各投稿でユーザー名の横にListenBrainzプロファイルへのリンクを表示できるようにします。デフォルト: 有効。
-
listenbrainz_onebox_enabled: ListenBrainzプロファイルページへのURLのOneboxサポートを有効にします。デフォルト: 有効。
-
listenbrainz_onebox_range: ListenBrainz Oneboxの統計時間範囲。デフォルト: 今月。
ユーザー設定
各ユーザーは、ListenBrainzアクティビティがプロフィールに表示されるかどうかを制御できます。ユーザーはプロフィール設定でこれを設定できます。次の設定が利用可能です。
-
Show ListenBrainz information in my user profile: 有効にすると、ユーザーのListenBrainzプロフィールの詳細が記載されたインフォボックスが、ユーザーのユーザーカードとユーザープロフィールに表示されます。インフォボックスの内容は、以下のオプションで設定できます。デフォルト: 無効。
-
ListenBrainz username: ユーザーのListenBrainzユーザー名。ユーザーのListenBrainz詳細を表示するには、これを設定する必要があります。サイトでlistenbrainz username matches discourseが有効になっている場合、これはDiscourseユーザー名にデフォルト設定されます。それ以外の場合、デフォルトは空です。
-
Show a link to my ListenBrainz profile next to my Discourse username: 有効にすると、ユーザーのListenBrainzプロファイルへのリンクが、各投稿のユーザー名の横に表示されます。このオプションは、サイトでlistenbrainz poster iconが有効になっている場合にのみ利用可能です。デフォルト: 無効。
-
Display: ListenBrainzインフォボックスに表示されるコンテンツを設定します。次のオプションが利用可能です。
-
Most recent listen: ユーザーの現在再生中のトラックまたは最も最近再生されたトラックを表示します。
-
User profile statistics: リスニング回数、最も再生されたトラック、最も再生されたリリースのアートワークなど、ユーザーのListenBrainzプロフィールの一般的な統計情報を表示します。
-
Most recent listen with fallback to user profile statistics: 最近のリスニングを表示しようとしますが、利用できない場合はユーザープロフィールの統計情報にフォールバックします。これはデフォルト設定です。
-
-
Time range: ユーザープロフィールの統計情報が生成される時間範囲を選択します。デフォルト: 今月。
-
Fallback to larger time range if there are no listens in the selected range: 有効にすると、選択した時間範囲にリスニングがない場合、プロフィールの統計情報ビューは自動的により大きな時間範囲にフォールバックします。たとえば、「今週」を選択したが、現在の週にリスニングが記録されていない場合、統計情報は「今月」を表示するようにフォールバックします。デフォルト: 有効。
-
Show recent listen not older than: ユーザーの最後の再生トラックが指定された時間よりも古い場合は表示しません。デフォルト: 24時間。
TODO
未解決の問題や計画されている機能については、公式のissue trackerを参照してください。