How To Use — Matokeo
This guide explains step-by-step how to download the template, enter scores, upload via the Upload page, how to complete the reCAPTCHA checkbox, and how to proceed to view results, edit report headers, download single or bulky reports, and use analytics.
TRUSTED SITE — REGISTERED WITH BRELA
Download Template
Excel (.xls, .xlsx) — structured headers
1
1. Download the template
Choose the form level (Form 1–2 or Form 3–4) in the "Download Template" area and click "Download Excel Template". The file includes headers: S/No, Full Name, Sex, and each subject with Mid Term and Terminal columns.
2
2. Fill scores in Excel
Open the downloaded file in Excel or LibreOffice. Fill S/No, Full Name, Sex, and for each subject enter Mid Term and Terminal scores. Keep the header row intact. Save as .xls or .xlsx. Use numeric values for score cells; leave blanks for missing marks.
1, John Doe, M, 12, 14, 10, 11, ...
Tips
- Keep the header row unchanged.
- Use numeric values only for Mid Term and Terminal cells.
- Leave blank cells for missing marks; processing will mark them as incomplete.
3
3. Upload the file
Return to the Upload page (index.php). Choose your file or drag & drop it into the drop area. The client validates file type and size (max 20 MB). Before submitting, complete the reCAPTCHA checkbox on the form (a simple click) to prove you are human. Then click "Upload & Process".
4
Processing results
After upload the server computes averages, totals, aggregates, grades and ranks. Missing or non-numeric cells are marked as incomplete and reflected in Remarks.
How to complete reCAPTCHA (client/browser)
Simple client-side step
The reCAPTCHA widget appears as a checkbox or small badge on the form. Click the checkbox to place a tick; sometimes you will be asked to select images. Once ticked, the form is ready to submit. This prevents automated/bot submissions.
Quick checklist
- Locate the reCAPTCHA checkbox on the form (near the submit button).
- Click the checkbox; follow any simple image selection prompts if shown.
- When the checkbox shows a tick, the form is ready to submit.
4. View results
Search • Filter • Sort • Compact / Full
After processing you are redirected to View Results. Use search, division and remarks filters, sort by rank/aggregate/total, and switch between Compact and Full modes. Export or open Single/Bulky reports from there.
5. Edit report headers
Customize report headers and discipline items
Use the Editor to change report headers (school name, council, year, subjects, discipline items). After saving the session is cleaned but processed_results and report_meta are preserved.
6. Download reports (Single & Bulky)
Single report • Bulky report
Single Report exports one student report. Bulky Report generates reports for the whole school at once. Choose PDF or Excel if available on the backend.
Frequently Asked Questions (FAQ)
Can I upload multiple files at once?
The system processes one uploaded file at a time. For multiple reports, combine students into a single file or use Bulky Report after processing.
I made a mistake in scores. How do I fix it?
Edit the Excel file and re-upload, or use the editor tools if the backend provides row editing.
Does reCAPTCHA require internet connectivity?
Yes. reCAPTCHA requires network access for the widget. If offline, the widget will not function and submissions will fail.
How do I get help with the Excel template?
Email support@kazihuduma.com or use WhatsApp. We can send a sample file or help fix formatting issues.
Where is student data stored?
Processed results are stored in the server session temporarily. For long-term storage, export reports or use a backend database configured by your administrator.