Download the PHP package brynforum/top-posters without Composer
On this page you can find all versions of the php package brynforum/top-posters. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download brynforum/top-posters
More information about brynforum/top-posters
Files in brynforum/top-posters
Package top-posters
Short Description Top posters widget for Flarum: shows the most active members of the past month and all time, on the forum index. Mobile-responsive (collapsed accordion on small screens, expanded on desktop). Configurable list lengths and headings.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package top-posters
brynforum/top-posters
A Flarum extension that adds top-posters leaderboards to the forum index. Shows the most active members of the past month and all time, side-by-side on desktop, stacked-and-collapsible on mobile.
Built and used in production by BrynForum.
Features
- Two leaderboards: "This Month" (last 30 days) and "All Time". Each can be hidden independently.
- Configurable list length per leaderboard (1 – 50).
- Editable headings — translate or rebrand without touching code.
- Exclude staff — checkbox to drop administrators and/or moderators from the rankings.
- Mobile-first: collapses to a tap-to-expand summary on phones, fully visible on tablets/desktops. Pure CSS — no
window.resizelistener needed. - Cache-friendly: public,
GET-only endpoint with no per-user data. Pair with brynforum/api-cache for one DB query per TTL window instead of per page-load.
Installation
Enable Top Posters under Admin → Extensions.
Configuration
Admin → Top Posters:
| Setting | Default | Notes |
|---|---|---|
| Show "This Month" board | on | Hide the monthly leaderboard. |
| Show "All Time" board | on | Hide the all-time leaderboard. |
| "This Month" list length | 10 | 1 – 50. |
| "All Time" list length | 10 | 1 – 50. |
| "This Month" heading | Top Posters This Month |
|
| "All Time" heading | Top Posters of All Time |
|
| Exclude administrators | off | Hides users in the built-in Administrators group. |
| Exclude moderators | off | Hides users in any group that holds the discussion.hidePosts permission. |
The "Exclude moderators" check uses a permission, not a group name — so it works the same regardless of whether a forum's mod group is called Mods, Staff, Editors, etc.
API
GET /api/brynforum/top-posters?period=month&limit=10
GET /api/brynforum/top-posters?period=all&limit=10
Public, no auth. Returns:
The query excludes:
- private posts (
is_private = 1) - hidden posts (
hidden_at IS NOT NULL) - unapproved posts (
is_approved = 0) - spam-flagged posts (
is_spam = 1) - post types other than
comment(so discussion-renames etc. don't inflate)
Ties on post_count break by username ascending (case-insensitive), so the order is stable across requests.
Recommended cache rule
If you also run brynforum/api-cache, add:
| Field | Value |
|---|---|
| Path pattern | #^/api/brynforum/top-posters$# |
| TTL | 600 (10 minutes — sensible default) |
| Scope | public |
That collapses the leaderboard SQL to once per ten minutes regardless of how many widget renders hit the endpoint.
Mobile responsiveness
The two cards render in a flex row on desktop (>= 768 px) and stack on mobile. On mobile, the body of each card is hidden behind a tap-to-expand header. The state is purely CSS-driven, so resizing a desktop window down behaves correctly without a JS resize listener.
Replacing afrux/top-posters-widget
This extension is intentionally similar in purpose to afrux/top-posters-widget. The differences:
| afrux | brynforum | |
|---|---|---|
| Layout | Right-side widget area (needs afrux/forum-widgets-core) |
Inline above discussion list |
| Mobile | Hidden inside the widget panel | Accordion, always visible above the fold |
| Periods | This Month only | This Month + All Time (each toggleable) |
| Configurable list length | No | Yes (1 – 50, per board) |
| Staff exclusion | Yes | Yes |
| Dependencies | afrux/forum-widgets-core |
Flarum core only |
If you switch from afrux, disable the old widget first to avoid duplicate boards.
Contributing
Issues and PRs welcome. Keep changes small and focused; file an issue before any large PR.
License
MIT © BrynForum
