Skip to content

The-Java-Bootcamp/jpa-classroom-wiki

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 

Repository files navigation

Java Pro Classroom — Teacher Guide


Overview

Java Pro Classroom is your teacher dashboard inside WordPress. It lets you create classroom sections, manage your student roster, publish lessons for grading, and track student progress — all connected to the Java Pro Academy platform your students use.

There are four pages: Classrooms, Roster, Units, and Grades.


Classrooms

A classroom is a section you create for a group of students. You can have multiple classrooms — one per semester, one per class period, or however your school organises its groups. Each classroom has its own roster, its own published units, and its own grade records.

Creating a classroom

Click + New Classroom in the top right. Enter a class name (e.g. CS 101) and an optional section label (e.g. Period 1). Click Create Classroom.

Editing a classroom

Click Edit on any classroom row to update the name or section. The change takes effect immediately — no page reload needed.

Deleting a classroom

Click Delete to permanently remove a classroom. This is only available if no students have submitted any work. Deletion cannot be undone.

Archiving a classroom

If students have already submitted work, Delete is replaced by Archive. Archiving removes you as the instructor but preserves all student data. Use this at the end of a semester when you no longer need active access but want to keep the records.


Roster

The roster shows every student enrolled in a classroom along with their status and enrolment date.

Inviting a student

Select a classroom from the dropdown, then fill in the student's first name, last name, and email address. Click Add to Classroom.

Existing account — if the student already has a Java Pro Academy account they are enrolled immediately. They receive a notification email. Their name in the roster comes from their existing profile — whatever name you enter is not used.

New account — if the student has no account, one is created automatically with a temporary readable password (e.g. Blue-Tiger-82). They receive a single email containing their login credentials and classroom information. They can log in straight away.

Student statuses

Status Meaning
Enrolled Student has an account and is active in the classroom
Pending Invite sent but student has not registered yet
Declined Student declined the invite

Editing a student's name

Click Edit on any student row to update their first or last name. This updates their name across the entire platform — the roster, the grades table, their dashboard greeting, and everywhere else their name appears. There is one name per student, stored centrally.

Removing a student

Click Remove to take a student off the roster. Their grades and submissions are preserved — only the roster entry is deleted. If they need to be re-added later, invite them again by email.

Things to know

  • A student can only be enrolled in one classroom per course at a time. If you try to add a student who is already in another classroom for the same course, the invite will be blocked with a message telling you which classroom they are in.
  • Grades are scoped to the enrolment date. If a student submitted work before being added to this classroom, those submissions will not appear in your Grades view. This prevents work done in another classroom from bleeding into yours.

Units

A unit is a lesson from the Java Core course. Publishing a unit enables lab and interview grading for that lesson — students can submit their work and you can see their scores in Grades. Only published units appear in the Grades dropdown.

Publishing a unit

Select a classroom from the dropdown. Check the checkbox next to any lesson to publish it. A confirmation modal appears asking for an optional due date. You can also choose to notify students by email. Click Publish Unit to confirm.

Both the lab and interview are published together. A unit is only fully published when both are active.

Unpublishing a unit

Uncheck a published unit. Existing student scores are not affected.

Unit statuses

Status Meaning
Published Both lab and interview are enabled
Partial Only one of lab or interview is active
Not Published Unit is not available for grading

Notifying students

When publishing, check Notify students by email to send each enrolled student an email with the unit name, due date (if set), and a link to their dashboard. The email comes from you.

Switching classrooms

Each classroom tracks its own published units independently. Switching the classroom dropdown reloads the unit list for that classroom.


Grades

Select a classroom and a published unit to see a full grade breakdown for every student.

Grading breakdown

Component Points Notes
Lab 30 Multiple attempts allowed — best score is kept
Interview 60 One attempt only — locked after first submission
Completion 10 Awarded when both lab and interview are submitted
Total 100

Score calculation

Lab and interview scores are stored as percentages (0–100%). Points are calculated as:

  • Lab points = (lab % ÷ 100) × 30
  • Interview points = (interview % ÷ 100) × 60
  • Completion = 10 if both submitted, otherwise 0

Student statuses

Status Total Score Meaning
Pass 80 or above Student is on track
At Risk 60 – 79 Student needs attention
Fail Below 60 Student is struggling
In Progress Lab submitted, interview not yet done
Not Started No submissions yet

Summary bar

The top of the Grades page shows a summary across all students: total count, how many are passing, at risk, and below 60. This gives you an at-a-glance view of class health before looking at individual rows.

Sending a grade summary

Click Send Grade on a student row to email them their current scores for the selected unit. The email includes lab, interview, completion, and total score along with their status. This button is only available once the student has submitted at least one thing.

Overriding a grade

Click Override on a student row to manually set a lab or interview score. Enter a value between 0 and 100 and click Save. The override takes effect immediately and the student's total is recalculated. This button is only available once the student has submitted at least one thing.

Exporting grades

Click Export CSV to download all student grades for the selected unit as a spreadsheet.

Weak skills

Click the arrow next to a student's name to expand their weak skill areas. This shows which interview concepts they are struggling with, how many times they attempted each one, and their mastery level — developing, proficient, or struggling.


How the student experience works

Understanding what your students see helps you support them better.

Lab — students complete coding exercises inside the lesson page and click Run to check their work. They can attempt the lab as many times as they like. Only their best score counts.

Interview — students answer multiple-choice questions at the end of the lesson. When they finish, they see their score and a Submit to Instructor button. This button appears only once. After submitting, it is replaced by Review Answers which lets them go back and study the explanations — but they cannot change their answers.

Submit to Instructor — clicking this button sends the student's interview answers and score to the platform. The grades appear in your Grades view immediately. Students who have already submitted will not see the Submit button again, even if they refresh the page.


Student names

Every student has one name across the entire system, stored in their account profile. This name appears:

  • In your Roster
  • In the Grades table
  • In their own dashboard greeting
  • In grade summary emails they receive

When you edit a student's name in the Roster, it updates everywhere automatically. The student sees the new name the next time they load any page.


Frequently asked questions

A student says they cannot see the Submit button. They have already submitted for this lesson. The button is intentionally hidden after the first submission. They can still click Review Answers to study the explanations.

A student's grades show as Not Started but they say they submitted. Their submission was made before they were added to your classroom. Grades are scoped to the enrolment date. Contact support if you need to override their score manually.

I cannot delete a classroom. Student submissions exist for this classroom. Use Archive instead — your access is removed but no data is lost.

A unit is missing from the Grades dropdown. Go to Units and publish it first. Only fully published units (both lab and interview active) appear in the Grades dropdown.

I invited a student but got a message saying they are already enrolled. A student can only be in one classroom per course. Check the other classrooms to find where they are enrolled, or remove them from there first.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors