Discourse 精选用户

:information_source: 摘要 在您的网站顶部以横幅形式展示用户
:eyeglasses: 预览 Theme Creator
: hammer_and_wrench: 代码库 GitHub - NateDhaliwal/discourse-featured-user: Shows a banner at the top of the site to feature a user for a timeframe.
: question: 安装指南 如何安装主题或主题组件
: open_book: 不熟悉 Discourse 主题? Discourse 主题使用入门指南

安装此主题组件

概述

此组件允许管理员在特定时间段内,将用户及其统计数据作为横幅展示在网站顶部。管理员可以选择要显示的统计数据,以及推荐该用户的理由(例如,模范行为、TL4/版主晋升等)。您甚至可以在用户卡片和帖子中用户名的旁边放置一个图标。

屏幕截图

包含所有统计数据的横幅(如果您想要所有数据)

包含部分统计数据的横幅(如果您想要平衡)

不包含统计数据的横幅(如果您想更侧重于描述)

完整描述

这个组件可能是我迄今为止最复杂的一个。它会在页面顶部显示或推荐一个用户。管理员可以配置横幅的显示时长(以日期为准)、要显示的哪些用户统计数据以及伴随横幅的描述(有两个位置,支持 HTML)。

还有一个选项可以在帖子和用户卡片中用户名的旁边显示一个特殊图标(图标名称、颜色和悬停文本都可以配置),如下所示:

帖子(带工具提示[1][2]):

用户卡片(工具提示在此处也适用):

横幅默认仅在主页上显示,但管理员可以将其更改为在所有页面上显示。

此组件可用于宣布新的 TL4、版主等。

:light_bulb: 提示:您可以在横幅文本中使用 \u003ca class=\"mention\"\u003eusername_here\u003c/a\u003e 来创建@提及气泡,而不会通知目标用户,但单击时仍会显示用户卡片。

:warning: 请确保您输入的是正确的用户名而不是名字。不要输入已隐藏其公开个人资料的用户。否则(或这样做)将导致无限加载和大量错误,甚至可能导致速率限制。

:warning: 此组件没有移动端对应版本,只有桌面版本。给您带来不便,敬请谅解。

我重用了用户摘要页面中的 UserStatUserProfileAvatar 组件,这使得开发人员可以轻松重用组件,真是太棒了!

设置(准备好了——有很多)

设置名称 设置说明 默认值
featured_user 您要推荐的用户的用户名 NA
featured_user_banner_text_above 横幅上方的文本,用于描述用户所做的事情(支持 HTML) NA
featured_user_banner_text_below 横幅下方的文本,用于描述用户所做的事情(支持 HTML) NA
featured_user_banner_text_align 横幅文本的对齐方式(左、右或居中) center
auto_resize_banner 自动调整横幅宽度以适应项目数量 false
featured_user_banner_display_start_date 横幅开始显示的日期;格式为 YYYY-MM-DD 1900-01-01
featured_user_banner_display_end_date 横幅停止显示的日期;格式为 YYYY-MM-DD 2100-01-01
featured_user_banner_display_on_homepage 仅在主页上显示横幅。取消选中此项将在所有页面上显示横幅 true
featured_user_banner_border_color 横幅边框的颜色(允许使用 CSS 变量和十六进制代码) var(--primary)
featured_user_banner_border_roundness 横幅边框的圆角半径,单位为 px 3
featured_user_banner_border_thickness 横幅边框的厚度,单位为 px 10
featured_user_show_featured_icon_in_user_card 在用户卡片中用户名的旁边显示一个图标,当用户被推荐时 true
featured_user_featured_icon_in_user_card 要为上述图标显示的图标 award
featured_user_featured_icon_color_on_user_card 上述图标的颜色 var(--gold)
display_total_likes_given 显示用户给出的总点赞数 true
display_total_likes_received 显示用户收到的总点赞数 true
display_total_post_count 显示用户发布的总帖子数 false
display_total_topic_count 显示用户创建的总主题数 false
display_total_read_time 显示用户的总阅读时间 false
display_total_days_visited 显示用户访问的总天数 false
display_gamification_score 显示用户的游戏化分数 false

主题翻译

翻译名称 说明 默认值
user.featured_user_icon 悬停时图标的工具提示文本 “This user has been featured!”

我可能会增强此功能,以支持推荐多个用户,而不仅仅是一个。

如果您遇到任何错误或问题,请在此处发布。我乐于接受您的任何反馈。

希望这对大家有帮助!


  1. 您猜对了——这是 DTooltip! ↩︎

  2. 是的,这是因为空间有点不足……我会想办法解决的。 ↩︎

6 个赞

nifty 组件 - 干得漂亮! :clap:

5 个赞

这里有问题

2 个赞