Skip to main content

​
Overview

As a student in Relaciona, you can join classes using unique invite codes provided by your teachers. Once you join a class, you’ll be able to play games with your classmates and view their profiles (if they choose to share).

​
How to Join a Class

1

Register Your Account

If you haven’t already, create your student account by providing:
  • Username
  • Email address
  • Password
  • Select “Alumno” (Student) as your role
Make sure to select the student role during registration at accounts/views.py:9
2

Log In

Sign in with your username and password. You’ll be redirected to your student homepage after successful login (accounts/views.py:29).
3

Navigate to Join Group

Access the “Join Group” page from your student dashboard.
4

Enter Invite Code

Enter the 6-character invite code (combination of uppercase letters and numbers) provided by your teacher.The system will:
  • Verify the code exists in the database
  • Check if you’re already a member
  • Add you to the class if the code is valid
Invite codes are case-sensitive and automatically converted to uppercase (accounts/views.py:150)
5

Confirmation

You’ll see a success message: “Te has unido con éxito al grupo: [Class Name]”If you’re already in the class, you’ll see: “Ya eres miembro del grupo: [Class Name]“

​
Joining Multiple Classes

Multiple Class Enrollment

Students can join multiple classes! Each class you join:
  • Has its own unique invite code
  • Allows you to play games with those specific classmates
  • Lets you view profiles of students who share their information
  • Is managed by a different teacher (or the same one)

​
After Joining

Once you’ve successfully joined a class:
You can play various minigames with your classmates, including:
  • Face recognition games
  • Name matching games
  • Profile guessing games
  • Spotify song guessing
  • And more!
When you select a game, the system automatically detects your class group (minigames/views.py:39).
You can see profiles of classmates who have enabled the “share_with_class” setting. The system ensures you can only view profiles of students who:
  • Share at least one class with you
  • Have opted to share their profile (accounts/views.py:91-94)
Consider completing your own profile so classmates can get to know you better! See Completing Your Profile for details.

​
Troubleshooting

​
Invalid Code Error

If you receive an error message “El código introducido no es válido”:
  • Double-check the code with your teacher
  • Ensure all 6 characters are correct
  • Make sure there are no spaces before or after the code
  • Verify you’re entering uppercase letters and numbers only

​
Already a Member

If you try to join a class you’re already in, you’ll simply see a confirmation message. This won’t cause any issues with your existing membership.

​
No Classes Found

If you haven’t joined any classes yet:
  • You’ll see a message when trying to access games
  • Make sure to get an invite code from your teacher first
  • Complete the joining process before accessing class features
Keep your invite codes safe! While you can join the same class multiple times without issues, it’s best to keep track of which classes you’ve already joined.

​
Technical Details

For Developers:
  • Invite codes are 6-character unique strings generated from uppercase letters and digits (teachers/models.py:6-8)
  • The join process is handled by the join_group_by_code view (accounts/views.py:144-169)
  • Students are linked to ClassGroup via a ManyToMany relationship (teachers/models.py:17-21)
  • Code validation uses Django’s get_object_or_404 pattern for security

Build docs developers (and LLMs) love

Get started for freeTalk to us