Skip to content

The leaderboard ranks members by how many quotes they posted this week, this month or all time.

Add [bp_quotes_leaderboard] to any page or post.

Attribute Default Options Description
period week week, month, all Last 7 days, last 30 days, or all time
scope site site, group Whole site, or one group
group_id 0 A group ID The group to rank when scope="group". For a private or hidden group, only its members (and site moderators) see the list
count 10 1 to 100 Number of members shown
show_avatar true true, false Show member avatars

Examples:

[bp_quotes_leaderboard period="month" count="5"]
[bp_quotes_leaderboard period="all" scope="group" group_id="12"]
  1. Go to Appearance - Widgets.
  2. Add the BuddyPress Quotes - Leaderboard widget to a sidebar.
  3. Set the Title, Period (This week, This month or All time), Number of users (1 to 50) and Show avatars.

The widget ranks the whole site. For a group leaderboard, use the shortcode.


Each member decides whether they appear.

  1. Go to Settings - Email in your profile.
  2. Find the Quote leaderboard row: “Show my quote activity on leaderboards and to other members”.
  3. Choose No to hide, Yes to show, then save.

Hidden members are left out of the counts and the ranks.


A Quotes tab on member profiles (total quotes, image and color counts, group and personal quotes, and a 30-day chart) is built in but switched off. Developers can switch it on. See the Hooks Reference.


Points and badges from myCred, GamiPress or BadgeOS do not change leaderboard ranks. The leaderboard counts quotes only.


The Overview and Activity Log tabs show the last 30 days: quotes posted, image backgrounds, color backgrounds (solid colors and gradients) and active members. The Activity Log tab adds a daily chart and a Logged Quotes list of every logged quote, 20 per page, newest first. Filter it by background type or search by member, group or quote text, and click a quote to open it. Log entries stay for as long as the quote exists.