Hacktribe Docs

# Dashboard Section Guide in the Control Panel

The Dashboard section serves as the central hub for administrators to manage various parts of the system efficiently. This section provides quick access to essential data, including user statistics, activities, system health, and more.

# Table of Contents

  1. Overview
  2. Dashboard Features
  3. General Settings
  4. Role Management
  5. Skill Management
  6. Tag Management
  7. Voting Rounds
  8. Certificates Overview
  9. Best Practices

# Overview

The Dashboard section provides a comprehensive overview of your platform's activities, user engagement, and event management. It allows administrators to manage user roles, monitor active sessions, and gather insights from analytics tools.

# Dashboard Features

# User Statistics

In this section, you can view user-related data such as:

  • Total Users: Displays the count of all registered users except superusers.
  • New Users: Shows the number of users who have joined recently, aggregated by their registration date.
  • User Roles Breakdown: A visual breakdown of user counts by their assigned roles.

# Idea and Project Management

Administrators can track the number of submitted ideas or projects and monitor the progress of these submissions.

  • Idea Count: The total number of submitted ideas.
  • Idea Status: Categorize ideas based on their current status, such as pending, approved, or rejected.
  • Team Assignments: Monitor which users are part of teams and manage team formations.

# Activity Log

The Activity Log feature records significant actions performed by users. You can monitor up to 20 of the most recent activities such as:

  • Idea submissions.
  • Comments posted.
  • Votes cast.
  • Meetings scheduled or canceled.

# Mentor Sessions

Track the availability and bookings of mentor sessions:

  • Available Sessions: The number of open mentor sessions available for booking.
  • Booked Sessions: The count of mentor sessions already booked.

# Umami Analytics Integration

If you have integrated Umami Analytics, the dashboard can display website analytics, including:

  • Countries: Top 10 countries visiting your website.
  • Referrers: Top 10 sources of referrals to your website.
  • Page Views: Daily page view statistics.
  • Website Stats: Summary of total visitors, bounce rate, and other key metrics.

To enable Umami integration, ensure that the following environment variables are configured:

  • UMAMI_USERNAME
  • UMAMI_PASSWORD
  • UMAMI_TEAM_ID
  • UMAMI_BASE_URL

# General Settings

# Accessing General Settings

  1. From the dashboard, click on the General tab.
  2. You can manage basic event or platform settings such as:
    • Event Start/End Dates: Use the date pickers to set when the event begins and ends.
    • Idea Submission Deadlines: Set deadlines for idea or project submissions.
    • Voting Settings: Set the maximum points allowed in the voting process (between 1 and 10 points).

# Validating Changes

Ensure that any changes made adhere to validation rules, e.g., the maximum vote points must be between 1 and 10. If not, the system will display an error message.

# Role Management

The Roles feature allows you to manage user roles and customize role-based access permissions.

# Adding New Roles

  1. Navigate to the Roles section.
  2. Click on the Add New Role button.
  3. Fill in the role details, such as:
    • Role Name
    • Permissions
  4. Click Save to create the new role.

# Editing Roles

  1. In the Roles list, find the role you wish to edit.
  2. Click the Edit button next to the role.
  3. Modify the role details or permissions as required.
  4. Click Save to apply the changes.

To generate a new invite link for a specific role:

  1. In the Roles section, click on the role name.
  2. Scroll down and click on Generate Invite Link.
  3. The system will generate a unique invite link that can be shared with users for role-specific registration.

# Skill Management

The Skills section lets administrators define and manage skills that can be assigned to users or used for categorizing ideas or projects.

  • Add Skills: Create new skills with specific background and font colors for better visualization.
  • Edit Skills: Change existing skills, including their name, color, or related tags.
  • Delete Skills: Remove skills that are no longer relevant.

# Tag Management

# Tag Visibility and Usage

Tags help in categorizing users, ideas, and events.

  • Visible Tags: Tags marked as visible will be available for filtering and user assignment.
  • Used Tags: Tags that are actively used to categorize users, ideas, or projects cannot be hidden or deleted unless they are no longer in use.

You can manage tags from the Tags section in the dashboard.

# Voting Rounds

Voting rounds allow administrators to organize and manage the judging or voting process.

# Creating Voting Rounds

  1. Navigate to the Voting Rounds section.
  2. Click on Add Voting Round.
  3. Set the following:
    • Judges: Assign judges to the round.
    • Ideas: Select the ideas that will be part of this round.
    • Start and End Time: Specify the duration of the voting round.
  4. Save the voting round.

# Managing Voting Rounds

  • Vote Breakdown: View and analyze the votes cast by judges.
  • Edit Round: Modify the details of an existing voting round.
  • Delete Round: Remove a voting round if it is no longer needed.

The system prevents time overlaps for voting rounds, ensuring that no idea is part of multiple rounds at the same time.

# Certificates Overview

The Certificates section allows administrators to manage and generate certificates for participants or winners.

  1. Upload a valid SVG certificate template.
  2. Set the Certificate Issue Date.
  3. Generate certificates for all qualifying users based on their roles or achievements.

The system will create individual certificates and allow users to download them directly from their profiles.

# Best Practices

  • Monitor Activities Regularly: Regularly check the activity log to stay informed about user interactions and event progress.
  • Use Tags and Roles Efficiently: Use tags to categorize users and roles to define permissions clearly.
  • Schedule Mentor Sessions in Advance: Ensure mentor sessions are scheduled and booked in a timely manner for smooth event management.
  • Set Voting Rounds with Clear Timelines: Avoid overlaps by defining clear start and end times for voting rounds.
  • Back Up Certificates: Keep a backup of generated certificates in case of errors or future reference.

By following this guide, administrators can efficiently manage the various aspects of the platform through the dashboard, ensuring smooth operations and enhanced user engagement.

Managing Users →