Raffles

Raffle Administration Documentation

Overview

The Raffle Administration system provides a complete interface for managing raffles, tracking entries, and selecting winners. This documentation covers the functionality available in the admin dashboard.

Raffle Management

Viewing Raffles

The main raffles dashboard displays all created raffles in a table with the following information:

• ID

• Title

• Required Role

• Number of Entries

• Status (Active/Inactive)

• Action buttons for management

Creating a New Raffle

To create a new raffle:

1. Click the Create Raffle button at the top right of the raffles dashboard

2. Complete the form with the following information:

   • Title: The name of the raffle

   • Description: Detailed information about the raffle

   • Required Role: Minimum user role required to participate

   • Active: Toggle to enable/disable the raffle

   • Passwords: Access codes that users need to enter to participate

3. Click Save to create the raffle

Editing a Raffle

To edit an existing raffle:

1. Click the Edit button on the desired raffle row

2. Modify any fields as needed

3. Click Save to update the raffle

Deleting a Raffle

To delete a raffle:

1. Click the Delete button on the desired raffle row

2. Confirm the deletion when prompted

Warning: Deleting a raffle will remove all associated entries and cannot be undone.

Role-Based Access Control

Raffles can be restricted to users with specific roles. The available roles are:

Role	Access Description	Visual Indicator
Admin/Moderator	Access to all raffles	Purple badge
Affiliate	Access to all raffles	Blue badge
Subscriber	Access to Subscriber and User raffles	Green badge
User	Access to User raffles only	Gray badge

Password Management

Each raffle can have multiple passwords that participants use to enter. To manage passwords:

• Add Password: Click the "Add Password" button in the raffle form to add a new password field

• Remove Password: Click the delete button next to a password to remove it

• Edit Password: Modify the text in the password field

Raffle Entries

Viewing Entries

To view entries for a specific raffle:

1. Click the View Entries button on the desired raffle row

2. The entries page displays a table with:

   • Entry ID

   • User information (with avatar)

   • Password used

   • Entry timestamp

Entry Statistics

The entries page provides key statistics at the top:

• Total Entries: The total number of submissions

• Unique Participants: The number of individual users who have entered

• Unique Passwords: The number of different passwords that have been used

• Avg. Entries/User: The average number of entries per participant

Exporting Entries

To export the list of participants:

1. Click the Export Entries button at the top of the entries page

2. A text file will be downloaded containing the list of participant usernames

Winner Selection

Rolling a Winner

To select a random winner:

1. Navigate to the entries page for the raffle

2. Click the Roll Winner button in the winner selection section

3. An animation will display as the system randomly selects a winner

4. Once complete, the winner's information will be displayed

Winner Log

After selecting a winner, you can add them to the winner log:

1. Click Add to Winner Log after rolling a winner

2. Enter the prize value and any additional notes

3. Click Save to record the winner

The winner log keeps a record of all raffle winners and their prizes, which can be accessed from the admin dashboard.