NodeBB: Points

Additional metrics for User Profiles. It's like experience in video games. Plugin is good for gamification of your board.

• Ranking Calculation
• Themes
  • Profile View
  • Topic View
• TODO
• Changelog
  • v1.2.0 - 10.05.2015
  • v1.1.0 - 10.05.2015
  • v1.0.0 - 26.04.2015

Ranking Calculation

Ranking calculator is a function, that should accept 2 parameters - settings and raw points. Settings could vary from one calculator to another. Calculator must return object with properties listed below:

• rank [Number] - user rank, level
• rankProgress [Number] - amount of points on current level
• rankTotal [Number] - amount of points needed to level-up
• total [Number] - raw amount of points

Themes

Plugin populates both: Profile and Topic views. Search for points property in corresponding entities.

Profile View

If you want points in Profile, do very basic changes to your theme:

Example: Vanilla Theme, /account/profile.tpl, edit template in package directory - node_modules

<div class="text-center account-stats">

    <div class="inline-block text-center">
        <span class="human-readable-number" title="{reputation}">{reputation}</span>
        <span class="account-bio-label">[[global:reputation]]</span>
    </div>

    <div class="inline-block text-center">
        <span class="human-readable-number" title="{postcount}">{postcount}</span>
        <span class="account-bio-label">[[global:posts]]</span>
    </div>

    <div class="inline-block text-center">
        <span class="human-readable-number" title="{profileviews}">{profileviews}</span>
        <span class="account-bio-label">[[user:profile_views]]</span>
    </div>

    <!-- IF points -->
    <div class="inline-block text-center">
        <span class="human-readable-number" title="{points}">{points}</span>
        <span class="account-bio-label">Points</span>
    </div>
    <!-- ENDIF points -->
    
</div>

Topic View

Every post will have additional field: points. If you want to use client-side ranking calculation, you could require ranking helper via forum/points/ranking and don't forget to add points settings to your topic.tpl, add this line: <!-- IMPORT partials/variables/points_settings.tpl -->

TODO

• Add Gifts: ability to add points through ACP with a notification
• Add Transfers: user can transfer some of his points as a reward for some bounty or help or user generated competition
• Add Points Grid: multipliers or raw values for different categories
• Add Fresh Points: provide information for points that are earned today
• Add Complexity to Point calculation: encourage tags in topic creation
• Add Stuggering animation to overview page
• Add Custom ranking calculators
• Add ACP Panel for raw point rewards
• Add API for raw point rewards
• Add Custom Notifications for levels
• Add Presets for ranking calculation
• Add Sections to Overview page: all time, today, personal.
• Add Utility for initial point calculation
• Add Tests (Mocha/Tape)

Changelog

v1.2.0 - 10.05.2015

• Use Posts filter
• Added Settings to Topic View

v1.1.0 - 10.05.2015

• Rank calculation moved to client-side

v1.0.0 - 26.04.2015

• Very first release