DQR · offline mode · QA

Offline mode: QA test guide

DQR app (QA build, Android or iPhone) · classroom display at dqr-qa-web.azurewebsites.net

How to set up offline mode on the phone and the classroom computer, teach a lesson with no internet, and upload the answers afterwards. Follow the steps in order.

i

How offline mode works

The phone and the classroom computer each download the class’s lessons while there is internet. In class, neither needs the internet: the computer shows the lesson from its saved copy, and the phone scans the question’s QR code and the pupils’ cards. The answers upload when the internet is back.

1. Before classInternet on
DQRinternet ondownloaddownload12
  1. Phone: turn on Enable offline. The class’s lessons download (a cloud-with-a-tick icon appears beside each).
  2. Computer: on the DQR website, click Turn on offline mode and sign in with the same account. It downloads the same lessons into the browser (the bar says Offline mode on · N lessons ready).
2. In classNo internet needed
no internet on either devicescan the question’s QRthen scan the pupils’ cardstype the phone’s code here (e.g. CYBPX3)123
  1. Phone: open the lesson and tap Scan. It shows the website and a six-character code.
  2. Computer: type that code into Enter your quiz code. The lesson opens from the browser’s saved copy, with a QR code next to the question.
  3. Phone: point the camera at that QR (it checks both show the same question), then scan the pupils’ cards. Answers are saved on the phone.
3. After classInternet back
DQRinternet backanswers uploadPending → Uploading… → Connected1
  1. Phone: once it has internet, the answers upload by themselves (tap Upload at the top right if it shows). The label goes Pending → Uploading… → Connected, and the results are in DQR as normal.

The label at the top right of the phone

ConnectedInternet on, nothing waiting to upload.
OfflineNo internet. Downloaded lessons still work.
PendingNo internet, and answers are saved on the phone waiting to upload. Tapping it shows the details and tries to upload in case the internet is back.
UploadInternet is back and answers are waiting. Tap it to send them now (they also go by themselves when the app next reaches DQR).
Uploading…Sending the answers. It goes back to Connected when done.

Where the computer keeps the lessons

The computer saves the lessons in the web browser (Chrome or Firefox), on that computer. Nothing is installed. They stay there after the browser is closed or the computer restarts, and nobody needs to be signed in to the browser. Use the same browser and the same normal window to sync before class and to teach.

These won’t have the lessons (sync again in the browser you will teach from):

After the browser is closed, the bar says Sign in to sync. Saved lessons still open without signing in; sign in only to download new or changed lessons. The computer never stores pupil names or answers.

1

Before you start

Both devices
  1. Phone: install the latest DQR QA build (TestFlight on iPhone, or the APK you were sent on Android).
  2. Account: the QA app uses its own test server, so your normal DQR login won’t work in it, and there are no shared QA test accounts. Create your own in the app (you can use the same email as your normal account; it’s a separate account with its own password). On the sign-in screen tap Sign Up, enter your name, your real email address and a password (at least 6 characters), then tap Send Verification Code. Enter the code from the email and tap Create Account. Your new account already has a Demo Class with 30 test pupils. (Need a second account? Many email providers accept yourname+dqr2@… as a separate address.)
  3. Lessons: assign a few quizzes to Demo Class: Quizzes → open a quiz → Assign → Demo Class. Pick ones with follow-up questions if you can, for example Year 2 Demo, Year 4 Demo, Introduce zero, Count in 2s, Multiples of 10 and Doubles. Assign more the same way if you run out.
  4. Pupil cards: on a second screen (another laptop, tablet or phone, not the classroom computer), open dqr.eedi.com/test. It shows a set of test pupil cards. Open it while you still have internet; it keeps working once the internet is off, as long as you don’t reload it.
  5. Computer: use Google Chrome in a normal window (not Incognito).
  6. Both devices have internet to start with.
Test pupil cards page with A B C D, shuffle and plus/minus buttons at the top right
1.1 · dqr.eedi.com/test: test pupil cards
Using the test cards: click A, B, C or D at the top right to turn every card to that answer (pick two or more letters to mix them), ⇄ to give random answers, and + / − to show more or fewer cards. Clicking a card turns it to the next answer. Change the answers between questions so each one gets different results.
If the phone asks for camera access, allow it.
2

Phone: turn offline on and download lessons

Phone · online
  1. Settings → Offline → switch Enable offline on (if it is already on, leave it).
  2. Classes → your class. Each upcoming lesson shows a spinner, then a cloud-with-a-tick icon beside its date. This can take a minute.
  3. If any lesson has no icon after a minute, go to Settings and tap Download all lessons, then check again.
Settings, Offline section with Enable offline, Download all lessons and Remove all downloads
2.1 · Settings → Offline
Demo Class with a cloud-check icon beside each assigned date
2.2 · Each downloaded lesson gets a small cloud-with-a-tick icon
You should see: every upcoming lesson has the cloud-with-a-tick icon, and the label at the top right says Connected.
3

Computer: turn on offline mode

Computer · online
  1. Open dqr-qa-web.azurewebsites.net. It is the normal home page, with one extra bar under the code box.
  2. Click Turn on offline mode and sign in with the same QA account as the phone.
  3. Wait while the bar counts up (Syncing lesson 1 of N…) until it finishes.
Home page with the offline bar: Teach from this computer without internet, Turn on offline mode
3.1 · The home page with the offline bar
Turn on offline mode sign-in box
3.2 · Sign in once
Bar showing Syncing lesson 2 of 6
3.3 · While syncing
Bar showing Offline mode on, 5 lessons ready, with Sync and Turn off
3.4 · Finished (your number will differ)
You should see: Offline mode on · N lessons ready, where N matches the number of upcoming lessons in your class.
4

Switch the internet off on both devices

Both devices
  1. Phone: turn on Airplane mode (Wi-Fi and mobile data both off).
  2. Computer: turn Wi-Fi off or unplug the network cable.
  3. Computer: reload the DQR page.
Home page with no internet: code box only and the bar saying no internet
4.1 · With no internet the page keeps just the code box and the bar
You should see: the label at the top right of the phone says Offline; the computer page still opens and the bar ends with · no internet.
Important: from here until step 7, neither device has internet.
5

Teach a full lesson with no internet

Both devices · offline

Open the lesson on both devices

  1. Phone: Classes → your class → open an unfinished lesson. It opens straight away.
  2. Phone: tap Scan. The phone shows Scan the question on the computer, with the website and a six-character code. (The code is also on the Display button at the top of the lesson.)
  3. Computer: type that code into Enter your quiz code and press the arrow. The lesson opens full screen, with the question QR on the right.
  4. Phone: point the camera at the QR code beside the question on the computer. The pupil-card scanner opens by itself.
Downloaded lesson on the phone with Display and Scan
5.1 · The lesson on the phone: its code is on the Display button
Scan the question on the computer: go to the site, enter code, scan QR
5.2 · Tap Scan: the code, then the QR
Pupil card scanner with Done
5.3 · Then the pupil scanner
Offline display: dark layout, question and answers, QR on the right, Previous, Next, Main, Follow-up and Close lesson at the bottom
5.4 · The computer looks like the normal online display, plus the QR and a slim control bar

Scan and move through the lesson

  1. Phone: point the camera at the test cards on the second screen until they are counted, then tap Done. The answers show on the phone.
  2. Computer: click Next ›. Test cards: change the answers. Phone: Scan → question QR → cards → Done. Repeat for at least 3 questions.
  3. Follow-up question: on a question that has one, click Follow-up 1 on the computer, then tap Scan on the phone and scan the QR. The phone switches to the follow-up.
  4. Scanning the same question twice: without clicking Next on the computer, tap Scan again and scan the same QR. The phone asks Already scanned: tap Cancel. Then try again and choose Scan again: the scanner opens.
  5. Restart: halfway through, close the app fully and open it again. Open the same lesson: it continues where you were and your answers are still there.
  6. Phone: Finish lesson.
You should see: each scan goes from the question QR straight into the pupil scanner, answers survive the restart, and the lesson finishes with no internet.
6

Still offline: find the finished lesson

Phone · offline
  1. Phone: close the app fully and open it again (still in Airplane mode).
  2. Classes → your class → Results. The lesson you just finished is listed. Open it: your scanned answers are there.
  3. Look at the label at the top right: it now says Pending, because answers are waiting to upload.
  4. Tap Pending. The summary opens and says Answers waiting to upload.
Offline class page with Upcoming and Results tabs
6.1 · Results also works offline
Connection summary: Offline, downloads on this device, saved work
6.2 · Tap the label at the top right for this summary
You should see: the finished lesson with its answers, and Pending at the top right.
7

Reconnect and upload

Phone · online
  1. Turn Airplane mode off and stay in the app.
  2. Open any screen (for example go back to Classes). As soon as the app reaches DQR, the answers start uploading by themselves: the label shows a spinner with Uploading…, then Connected.
  3. If the label says Upload instead, tap it to send the answers. If it still says Pending, tap it once.
  4. Open the lesson’s results: every answer you scanned is there.
  5. Computer: turn Wi-Fi back on and reload the page. The bar goes back to Offline mode on · N lessons ready.
You should see: Uploading… then Connected, and all answers in the results.
Good to know: a D card scanned on a question with only A–C answers is shown as invalid and is not saved. That is correct.
8

Edge cases

Both devices
  1. Lesson never opened before, no internet: Airplane mode on → open a downloaded lesson you have not taught. It opens from the download with no error.
  2. Internet drops mid-lesson: with internet, open a lesson and scan once. Turn Airplane mode on and keep teaching: the app carries on from the download. Turn it off again: the answers upload.
  3. No computer available: use this when there is no classroom computer showing the lesson (for example the projector is broken, or you read the question out). In a lesson tap Scan → Scan pupils without the computer: it skips the question-QR check and opens the pupil scanner for the question showing on the phone, so make sure the phone is on the right question. Try it on a main question and on a follow-up question: after Done, the answers are saved against the question that was on the phone.
  4. Lesson started online, finished offline: with internet, open a downloaded lesson, teach one question and scan it. Then turn the internet off on both devices, open the same lesson on the computer with the phone’s code, and carry on: scanning the computer’s question QR works and the lesson continues.
  5. Remove one download: a lesson’s ••• → Remove download: the icon disappears. Then ••• → Download for offline: spinner, then the icon is back.
  6. Remove everything, then download everything: Settings → Remove all downloads → confirm. Then tap Download all lessons: every upcoming lesson downloads again.
  7. Wrong code on the computer: computer offline, type ABCDEF → it says the lesson is not downloaded on this computer.
  8. One setting for both devices: with internet, turn Enable offline off on the phone → reload the computer page: Offline mode is off. Click Turn on on the computer → close and reopen the phone app: Enable offline is on again.
  9. Computer, after closing the browser: close Chrome completely and open the DQR page again. The bar shows N lessons ready on this computer and Sign in to sync. Sign in: it syncs the lessons again.
Display menu showing the computer site and code
8.1 · Display → No internet also shows the code
Sign in to sync dialog on the computer
8.2 · Signing in again on the computer
!

Known limitations