UserPoints User Manual

UserPoints is a Joomla! 4/5 component that awards users points for actions they take on your site. Points can be earned for reading articles, posting in forums, registering, inviting friends, and dozens of other configurable events. Points can also be spent — on raffles, purchasing goods, or cashing out via PayPal — making the system a flexible foundation for gamification, loyalty programmes, and community engagement.

What this manual covers

Section What you will find
Installation & Upgrade Requirements, install steps, update key
Configuration Every component setting explained
Points Rules Creating and managing rules; all rule fields
Managing Users Balances, sync, reset, export
Activities The transaction log, approval, archiving
Levels, Ranks & Medals Setting up progression tiers and badges
Coupon Codes Creating and tracking promotional codes
Raffles Running prize draws with points entry fees
Invite System Referral links, templates, referral bonuses
Modules All ten bundled modules and their parameters
Permissions The full ACL permission matrix
Taking Payments Letting users buy points via PayAge
Integrating with Other Extensions Plugin triggers, API calls, XML rule files
API for Developers Full PHP API reference with code examples

Copyright © 2026 Martin Brampton. All rights reserved.