Activities

Every time a rule fires, UserPoints creates an activity record. The activity log is the authoritative record of all point transactions on your site.

Viewing Activities

Go to Components → UserPoints → Activities to browse the full log. Each record shows:

  • The user who earned or spent points.
  • The rule that fired.
  • The number of points awarded (positive) or deducted (negative).
  • The date and time.
  • The status (enabled/disabled, approved/unapproved).
  • An optional key reference and data reference for traceability.

Filtering

Use the search bar and filter dropdowns to narrow the list by user, rule, date range, or status. This is useful when investigating why a user has an unexpected balance.

Approval workflow

If a rule has Auto-Approved turned off, new activity records for that rule are created with approved = 0. The points are not counted in the user's balance until an administrator approves the record. To approve records, select them in the list and click the Approve toolbar button.


Activity States

Each activity record has two independent flags:

Flag Values Meaning
Enabled Yes / No Whether the record is included in the user's point total. Disabling is non-destructive — the record stays in the log but the points are not counted.
Approved Yes / No Whether an administrator has reviewed and approved the award. Only relevant for rules where auto-approval is off.

Toggling Enabled is the preferred way to temporarily remove points from a user's balance without deleting the record.


Combining Activities

Over time the activity log can grow very large. The Combine operation merges many individual activity records for the same user and rule into a single summary record, reducing the number of rows while preserving the total point balance.

Go to Components → UserPoints → Activities and click Combine in the toolbar. Select the date range and rules to combine and confirm. This is a destructive operation — individual transaction details are lost — so run it only on historical data you no longer need to inspect individually.


Archiving Activities

Archive moves older activity records to a separate archive table, keeping the main activity log fast for day-to-day queries. Archived records are still visible via the Archive view (Components → UserPoints → Archive) but are excluded from the live balance calculation.

Do not archive records that are still within the current earning period for any time-limited rules (for example, "once per month" rules), or users may earn points a second time for actions already recorded.


Purging Expired Points

Points awarded by rules with an expiry date are not removed automatically. To remove them:

  1. Go to Components → UserPoints → Users.
  2. Click Purge Expired in the toolbar.

UserPoints deletes all activity records whose expiry date is in the past and then recalculates user balances. This is subject to having the core.purgeexpiredpoints permission.


The Control Panel Activity Feed

The UserPoints control panel (Components → UserPoints) shows the most recent activities as a quick overview. The number of days included is controlled by the Latest Activities Days setting in Configuration.