Installation & Upgrade

Requirements

UserPoints requires:

Requirement Minimum version
Joomla! 5.x or 6.x
PHP 8.2
MySQL 5.7
MariaDB 10.4

Installing UserPoints

Download the UserPoints package from Remository. The package is a single ZIP file that installs the component, all bundled modules, and the core plugins in one operation.

  1. In the Joomla administrator, go to System → Install → Extensions.
  2. Upload the ZIP file using the Upload Package File tab.
  3. Joomla will install the component and display a confirmation message.

The installation script automatically:

  • Creates all required database tables.
  • Installs and publishes all bundled plugins.
  • Installs all bundled modules.

Post-installation steps

After installation, visit Components → UserPoints to open the control panel. Before going live:

  1. Install rule plugins — go to UserPoints → Plugins and upload any rule plugins you have obtained. Each plugin normally adds one or more configurable rules to the system. Publish if you want them activated.
  2. Auto-detect new rules — after uploading software that integrates with UserPoints, including new plugins, click the Auto-detect new rules control panel button. This scans all installed UserPoints plugins and creates matching rule definitions automatically.
  3. Publish rules — visit UserPoints → Rules and publish the rules you want active. Newly detected rules start unpublished. Review the configuration of rules you are using.
  4. Configure the component — review the settings described in the Configuration page.

Upgrading

You can keep UserPoints up to date using the Joomla update manager - see below. Otherwise, upgrading follows the same process as a fresh installation. Install the new package over the existing one; Joomla and the UserPoints installation script apply any required database schema changes automatically.

Before upgrading a production site, take a full file and database backup.

Joomla Update and Key

To receive update notifications in the Joomla update manager, make sure you have the Remository Update Authentication plugin, and publish and configure it with your Update Key. Your key is available on your Remository account profile.