How to Configure Challenges and XP Rewards in devActivity
devActivity's Challenge Configuration empowers administrators to create a dynamic and engaging environment for developers by customizing challenges. This guide will walk you through the process of defining goals, setting XP rewards, and applying custom badges.
Access Challenges Configuration
Log in to your devActivity dashboard. Navigate to "Settings" (typically located in the top-right corner of the dashboard), then select "Challenges Configuration" from the settings menu to view the list of available challenges.
Identify and Edit a Challenge
On the Challenges Configuration screen, identify the challenge you wish to configure (e.g., "First Commit Added" under "ONBOARDING CHALLENGES"). Click the "edit" icon (a pencil icon) next to it to open the configuration modal dialog.
Configure Challenge Goal
In the "Configure Challenge Goal" section of the modal, review or select the specific goal criteria for the challenge. For example, for an onboarding challenge, the goal might be "First Commit Added". Other challenges may allow defining variable thresholds for metrics like "XP/Contribution Score" or "Cycle Time".
Configure Challenge Reward
Proceed to the "Configure Challenge Reward" section. Here, you will specify the Experience Points (XP) to be awarded upon completion. You can set a fixed numerical value (e.g., "3 XP") or configure it as a percentage of the user's total monthly earned XP, offering flexible reward structures.
Configure challenge goals, XP rewards, and custom badges in the modal dialog. Optionally Use Custom SVG for Badge
To personalize the challenge's visual representation, activate the "Use custom SVG for Badge" toggle (it is off by default). Once enabled, you can upload a custom SVG file to serve as the challenge's badge. If this option is not used, a default badge will be applied.
Save Your Configurations
After setting the desired goal and reward parameters, click the "Save" button to apply your changes. If you wish to discard any modifications, click "Cancel" to exit the modal without saving.
Frequently Asked Questions
How do I set up a new challenge in devActivity?
While devActivity provides a list of preset challenges, you configure them by navigating to 'Settings' > 'Challenges Configuration', then clicking the 'edit' icon next to the challenge you wish to customize.
How can I adjust the XP reward for a specific challenge?
After opening the challenge configuration modal, locate the 'Configure Challenge Reward' section. Here, you can specify a fixed numerical value for XP or configure it as a percentage of total monthly XP.
Where can I define the conditions or goals for a challenge to be completed?
In the challenge configuration modal, the 'Configure Challenge Goal' section allows you to review or select the specific criteria that must be met for the challenge to be considered complete.
Can I use my own custom image files for challenge badges?
Yes, within the challenge configuration modal, you can activate the 'Use custom SVG for Badge' toggle and upload your own SVG file to personalize the challenge's visual badge.
How do I enable or disable a challenge?
Challenges can typically be enabled or disabled via a toggle switch (not directly shown in the provided media but implied by the configuration flow) on the main 'Challenges Configuration' screen or within the individual challenge's edit modal.
