Admin Page

Overview

The Admin Page is the control center for Collaboration Champion, allowing Jira administrators to configure and manage the gamification settings for their organization.

Accessing the Admin Page

Log in to Jira with administrator credentials.

Navigate to the Jira settings menu.
Look for "Apps" or "Manage apps" in the left sidebar.
Find "Collaboration Champion" in the list of installed apps.
Click on "Configure" or "Settings" to access the Admin Page.

Configuration Steps

1. Organization Setup

Enter your Organization ID.
Input the API Token for authentication.
Click "Validate" to ensure the credentials are correct.

2. Team Selection

View a list of all teams in your organization.
Select which teams will participate in the gamification.
Option to include all teams or choose specific ones.

3. Level Configuration

Define up to five levels for user progression.
For each level, set:
Level name (e.g., "Novice", "Expert")
Points required to reach this level
Upload or select a badge icon for the level

4. Point System Customization

Adjust point values for various Jira activities:
Issue creation
Issue assignment
Commenting
Status updates
Priority changes
Mentions
Worklog entries

5. Leaderboard Settings

Choose whether to display team leaderboards, individual leaderboards, or both.
Set the refresh rate for leaderboard updates.

6. Reset Options

Ability to reset all user points (use with caution).
Option to reset specific team or individual scores.

Saving and Applying Changes

After making any changes, click "Save Configuration" to apply the new settings.
A confirmation dialog will appear to ensure you want to proceed with the changes.

Troubleshooting

If changes don't appear immediately, try refreshing the Jira instance.
Check the app's log files for any error messages if configurations fail to save.

Remember, changes made in the Admin Page will affect all users of Collaboration Champion across your Jira instance. Always communicate significant changes to your team before implementing them.