All UserPoints settings are in Components → UserPoints → Configuration. The settings are grouped into four tabs: General, Profile, Raffle, and Integration. A fifth tab, Permissions, controls access control and is described in the Permissions page.
When enabled, the frontend Users view is accessible and shows a ranked list of all users. Disable this if you do not want members browsing each other's point totals.
The currency used when users buy points. This field uses the Payage currency selector; the available currencies depend on which Payage payment plugins are installed. Leave blank if you are not using the points-purchase feature.
How many points the user receives for each unit of currency paid. For example, a value of 10 means the user receives 10 points for every £1 (or $1, or €1) spent. Decimal values are accepted.
How many currency units are paid out to a user per point when they cash in points via PayPal. For example, 0.01 means 1p (or 1c) per point. Leave at 0 if cash-out is not offered.
The currency sent to PayPal when users cash out their points (for example, GBP or USD). This is separate from the purchase currency.
The Client ID from your PayPal REST API application, used to authenticate cash-out payouts. Create a REST app at developer.paypal.com and copy the Client ID here.
The PayPal Payouts feature must be explicitly enabled on your REST app in the PayPal developer dashboard before cash-out will work.
The Secret from your PayPal REST API application. Keep this value confidential.
Set to Yes while testing cash-out payments. Set to No for live payments. The sandbox uses test credentials and no real money is transferred.
The largest number of currency units a user can spend in a single purchase transaction. Default is 100. This prevents accidentally large purchases.
Controls how point totals are displayed throughout the site. The options cover different thousands separators and decimal formats:
| Value | Example display |
|---|---|
| 0 | 12345.67 |
| 1 | 12,345.67 |
| 2 | 12345,67 |
| 3 | 12 345,67 |
| 4 | 12346 (rounded) |
| 5 | 12 346 (rounded) |
| 6 | 12,346 (rounded) |
| 7 | 12345 (truncated) |
| 8 | 12 345 (truncated) |
| 9 | 12,345 (truncated) |
An optional ceiling on how many points any single user can hold. Once a user reaches this total, further point awards are silently ignored. Leave blank for no limit.
When enabled, a user's balance can go below zero. This is useful if users can spend points before earning enough, or if points can be deducted as a penalty.
The number of days of activity shown on the control panel dashboard. Default is 30. Increase this to see a longer history at a glance.
When enabled, every rule trigger is recorded in the activity log even when zero points are awarded. Useful for auditing and debugging. When disabled, only non-zero awards are logged.
An optional cap on the total points a user can earn across all rules in a single day. Once the daily cap is reached, further awards are refused until the following day. Leave blank for no daily limit.
Which registration or membership system UserPoints should hook into when awarding points for new user registrations. Some third-party options may not function with current Joomla versions.
| Option | System |
|---|---|
| Joomla! Core | Standard Joomla user registration |
| Jomsocial | JomSocial |
| Community Builder | Community Builder (CB) |
| CBE | Community Builder Enhanced |
| Virtuemart | VirtueMart (customer registration) |
| Hikashop | HikaShop |
| Joomsuite User | Joomsuite User |
| OSE Membership Control | OSE Membership |
| ExtendedReg | ExtendedReg |
| EasySocial | EasySocial |
| EasyProfile | EasyProfile |
If you use a non-standard registration page, enter the Joomla URL to it here (starting with index.php?...). This link is offered on the UserPoints account view when a guest needs to register.
When enabled, the standard purchase form (where the user enters how much to spend) is hidden. Use this when you prefer to display fixed purchase options through the Buy Points module instead of letting users type an arbitrary amount.
Controls whether visitors who are not logged in can view member profile pages:
A text string prepended to the referral ID of users who registered themselves (not via an invitation link). Useful for distinguishing self-registered users in reports. Leave blank for no prefix.
A text string prepended to the referral ID of users who registered through an invitation link. Leave blank for no prefix.
How the unique referral identifier is generated for each user:
The source for user avatar images displayed on profile pages and leaderboards (not all options work at present):
| Option | Source |
|---|---|
| None | No avatar displayed |
| Gravatar | Gravatar (email-based) |
| Kunena | Kunena forum avatar |
| Community Builder | Community Builder profile photo |
| EasyBlog | EasyBlog avatar |
| CBE | Community Builder Enhanced |
| JomSocial | JomSocial profile photo |
| EasySocial | EasySocial avatar |
| EasyProfile (JSN) | EasyProfile avatar |
| Clexus PM | Clexus Private Messenger |
| K2 | K2 user avatar |
| JomWALL | JomWALL avatar |
Where a user's name or avatar links to when clicked (not all options work at present):
| Option | Destination |
|---|---|
| UserPoints | The UserPoints account page |
| Joomla! | The Joomla core user profile |
| Kunena | The Kunena forum profile |
| Community Builder | The CB profile |
| CBE | The CBE profile |
| JomSocial | The JomSocial profile |
| EasyBlog | The EasyBlog author page |
| EasySocial | The EasySocial profile |
| EasyProfile | The EasyProfile page |
| JomWALL | The JomWALL wall |
When enabled, the small UserPoints credit line is removed from the frontend account view.
When enabled, the winner's Joomla username is displayed publicly after a raffle is drawn.
When enabled, the winner's real name (from their Joomla profile) is displayed publicly after a raffle is drawn.
Both options can be enabled independently. If both are disabled, a raffle result is announced without naming the winner.
When enabled, point award notifications are sent as JomSocial private messages instead of email. Requires JomSocial to be installed.
When enabled, an alert for new Uddeim private messages appears on the UserPoints account view. Requires Uddeim to be installed.
When enabled, a Uddeim private message is sent to a user each time they earn or spend points. Requires Uddeim.
The Joomla administrator user whose account is used as the sender of Uddeim notifications. Select from the dropdown list of administrators who have email notifications enabled.