AUP plugin for NorrCompetition

1. Getting Started

AUP Plugin provides integration between NorrCompetition and AltaUserPoins (AlphaUserPoints) and let to assign AUP points for actions performed in NorrCompetition (NC). The AUP for NorrCompetition distributive pack includes an integration plugin and rules kit and comes in two versions: for AltaUserPoints (by nordmograph) and for original AlphaUserPoints component (by Bernard Gilly, now managed by PamperME network)

  • plg_competition_aup.zip - version for AltaUserPoints (fork)
  • plg_competition_aupp.zip - version for original AlphaUserPoints

2. Installation

The installation package of AUP Plugin for NorrCompetition includes a plugin and rules kit in one file. You don't need to extract rules from the archive and then to import in AltaUserPoints manually.

2.1. Download and install the plugin

Get latest version of the distribution pack from NorrNext site and proceed to install it as typical Joomla extension. Go to Administrator panel > Extensions > Install extensions and install plg_competition_aup.zip or plg_competition_aupp.zip package.

An integration plugin will be automatically enabled after installation. All rules will be imported to AUP automatically after the installation of the package. There is no need to import each rule manually as it is typical for AUP rules. In case you still want to

2.2. Download Key tab

NorrCompetition Notifications Download Key tab
NorrCompetition Notifications Download Key tab

This feature allow to get an update of the plugin via back-end in few clicks. Set your download key to enable the update using Joomla! Update System. You can find the key in your NorrCompetition subscription on the NorrNext website.

If you set the key for the first time or have changed it, please click on the Update Key button to save it for Joomla! Update System.

Read official tutorial: How to enable one-click update for NorrNext commercial extensions

List of Rules

  • Name: View Active Competition
  • XML name: view_competition_active.xml
  • Function name: plgaup_nc_view_competition_active
  • Description: Assign points to user for view of active competition


  • Name: View Completed Competition
  • XML name: view_competition_completed.xml
  • Function name: plgaup_nc_view_competition_completed
  • Description: Assign points to user for view of completed competition


  • Name: Vote for Participant
  • XML name: vote_user.xml
  • Function name: plgaup_nc_vote_user
  • Description: Assign points to user for a vote


  • Name: Voter to Participant
  • XML name: vote_submitter.xml
  • Function name: plgaup_nc_vote_submitter
  • Description: Assign points to submitter of participant voted for


  • Name: View Participant in Completed Competition
  • XML name: view_participant_completed.xml
  • Function name: plgaup_nc_view_participant_completed
  • Description: Assign points to user for view of participant in completed competition


  • Name: View Participant in Active Competition
  • XML name: view_participant_active.xml
  • Function name: plgaup_nc_view_participant_active
  • Description: View Participant in Active Competition


  • Name: Viewer to Participant in Active Competition
  • XML name:
  • Function name: plgaup_nc_view_participant_active_submitter
  • Description: Assign points to submitter for view of his participant in the active competition


  • Name: Viewer to Participant in Completed Competition
  • XML name:
  • Function name: plgaup_nc_view_participant_completed_submitter
  • Description: Assign points to submitter for view of his participant in the completed competition


AUP rules for NorrCompetition
Set of AUP rules for NorrCompetition

Configuring the rule

Go to AUP back-end panel. When you open any rule to edit, you’ll see settings divided on 3 tabs.

Details tab

  • ID: (non-edit)
  • Category: you can select category from the list to which your rule will be assigned to.
  • Rule name: name of your rule
  • Description: Description of your rule
  • Plugin type: By default it is NorrCompetition
  • Unique function name: Function name given by default. You can change it (not recommended)
  • User level: Set up which user group this rule is for. By default it is Public.
  • Points: Attrib x points to this rule. Add symbol “minus” if you need to subtract. (i.e. -1.00)
  • Fixed points (No / Yes): Choose if points are fixed or unknown
  • Percentage (No / Yes): Use percentage
  • Expires: Enter a specified date to limit the use of points earned by this rule for all users or choose a period to limit the use of points earned by this rule for each activity generated by this rule. e.g. If a date is specified, the set of points earned by each user by this rule will no longer be valid after that date (useful for contest). If a period is selected, then each user can take advantage of its points earned by this rule until the end of the period (example: to be used with the rule Buy Points With Paypal as a subscription)
  • Display activity (No / Yes): Display this activity on frontend listing (profile and activities lists)
  • Published (No / Yes): Status of the rule.
  • Auto approved (No / Yes): Auto approved
  • Method: Choose the method to assigns points
    • Only once per user
    • Once a day per user
    • Once a day for a single user on all users
    • Once per week per user
    • Once per month per user
    • Once per year per user
    • Whenever (default)
  • Link up: Link up another rule

Message Tab

  • Display message (No / Yes): Select should the message be displayed.
  • Message: Enter a custom message to be displayed on the frontend after assigning or removing points. Leave blank if you want the default message. You can using the tag {username} and the tag {points} if you want showing the username and the number of points in the message.

E-mail notification

  • Email notification (No / Yes): Sending a message to the user as soon as it wins or spent points
  • Subject: You can using the following tags {username} {points} and {newtotal} if you want showing the username, the number of points added or removed and the new total of points of this user in the subject.
  • Message body: You can using the following tags {username} {points} {newtotal} and {datareference} if you want showing the username, the number of points added or removed and the new total of points of this user in the body message. {Datareference} is used to show the reason (e.g. Rule custom points)
  • Format: E-mail format. If you choose HTML, you can insert in body text some HTML tags available for e-mail.
  • Send copy to Admin(s): Allows Admin(s) to receive a BCC e-mail

Enabling rules in NorrCompetition

We just been installed and configured rules at AUP side and now it’s time to enable AUP mode in NorrCompetition. There are global settings, but it’s possible to enable AUP plugin for custom competitions. Go to Administrator Panel > Components > NorrCompetition > Options and click on “Competition” tab. Then find Integration options in the bottom of screen:

  • AUP Integration - Enable the processing of specific AUP rules for this competition. Please install NorrCompetition AUP Plugin to handle the rules.
AUP Integration options in NorrCompetition

Set to “Yes” if you want AUP rules to be processed everywhere. If you need manual selection and enable AUP rules for specified competitions, you can override these settings in custom competition. Go to edit mode of the competition and click on “Basic options” tab. You will find Integration Options in the bottom which have 3 options: Use Global, Yes and No. So, you can enable, disable AUP rules for the competition or use global settings.

AUP Integration options in competition edit mode - NorrCompetition

It might be useful in case if you want to exclude some competitions of being processed by AUP rules. All is done. Now you can assign AUP points to users for actions they performing in NorrCompetition.