Skip to main content

The Admin Panel

The Admin Panel is your command center. This is where you create quizzes, manage your image library, and monitor active game sessions.

TriviaFlow uses a modern, dark-mode compatible interface (powered by django-unfold) to make content management as pleasant as possible.

🔐 Accessing the Panel​

By default, the admin panel is accessible at:

https://quiz.your-domain.com/admin/

Log in with the superuser account you created during the Docker Installation.

📚 Managing Quizzes​

The "Quizzes" section is where you will spend most of your time.

Creating a Quiz​

  1. Navigate to Game Management > Quizzes.
  2. Click Add Quiz.
  3. Title & Description: Give your quiz a catchy name.
  4. Questions (Inline): You can add questions directly on the same page.
    • Text: The question displayed on the big screen.
    • Duration: Time in seconds (Default: 20s).
    • Options (A-D): The four possible answers.
    • Correct Option: Select which one is the winner.
    • Images: Link an image from the library (see below).
Power User Workflow

Instead of creating questions one by one, use the Import feature to upload entire quizzes at once!

Import / Export (Backup)​

TriviaFlow has a robust backup system built-in.

  • Export: Select one or more quizzes in the list view, choose "Export selected Quizzes (ZIP)" from the actions menu, and click "Go". You will download a ZIP file containing the data and all associated images.
  • Import: Click the "Import Quiz" button in the toolbar. Upload a valid TriviaFlow ZIP file, and it will recreate the quiz, questions, and images instantly.

đŸ–ŧī¸ The Media Library​

Unlike simple quiz apps, TriviaFlow uses a Centralized Image Library.

  • Concept: You upload an image once (e.g., "Company Logo") and can use it in multiple questions across different quizzes.
  • Management: Go to Media & Content > Image Library.
  • Cleanup: If you delete an image from the library, it is automatically removed from the server's hard drive to save space.
Two Types of Images

For every question, you can define:

  1. Question Image: Displayed while the timer is running (e.g., "What movie is this scene from?").
  2. Resolution Image (Optional): Displayed after the time is up (e.g., showing the movie poster with the title).

🕹ī¸ Session Monitoring​

Under Game Management > Sessions, you can see every currently running game lobby.

  • Room Code: The 4-6 character code players use to join.
  • Playlist: Shows which quizzes are queued for this session.
  • Active: If you uncheck "Active", the lobby closes and players are disconnected.
Do not edit active sessions manually

While you can change values (like the current question index) here, it is highly recommended to use the Game Master Dashboard for controlling the game flow. Editing raw database values during a live game can lead to desynchronization.