I Was Here – PHP Student Attendance System (Free Download)

I Was Here is a simple PHP Student Attendance Management System. This is not a “we have a lot of features that you will never use” system, but a basic one to help smaller schools to get started quickly.

 

TABLE OF CONTENTS

 

 

DOWNLOAD & NOTES

First, here are the download links and a quick “setup guide” for the impatient folks who don’t have the patience to read through everything.

 

LICENSE & DOWNLOAD

I-Was-Here is released under the MIT License. You are free to use it for personal and commercial projects, and modify it as you see fit. On the condition that the software is provided “as-is”. There are no warranties provided and “no strings attached”. Code Boxx and the authors are not liable for any claims, damages, or liabilities.

Download I-Was-Here | GitHub | SourceForge

 

REQUIREMENTS

  • LAMP/WAMP/MAMP/XAMPP
  • Apache Mod Rewrite
  • PHP MYSQL PDO Extension
  • At least PHP 8.0

 

INSTALLATION

Just access http://your-site.com in your browser and walk through the installer.

 

 

HOW TO USE

So far so good? Let us now go through a quick crash course on how to use I Was Here.

 

Fullscreen Mode – Click Here

 

 

I WAS HERE FAQ

I-Was-Here is “not working”? Here are a few of the common problems and how to “fix” them.

 

I DELETED ALL ADMIN ACCOUNTS

recover.php
require "lib/CORE-Go.php";
$_CORE->load("Users");
$_CORE->Users->save("NAME", "EMAIL", "PASSWORD", "A");

Just create an “account recovery” script to create a new account (or update an existing one). Run and delete this afterward.

 

CHANGED DOMAIN OR PATH

  • Update HOST_BASE in lib/CORE-Config.php. Make sure to include the path (with a trailing slash) if not deployed at the base URL. E.G. http://site.com/storageboxx/
  • Delete the existing .htaccess file.
  • Create init.php.
    • require "lib/CORE-Go.php";
    • $_CORE->Route->init();
  • Access http://site.com/init.php, this will automatically regenerate the .htaccess file.
  • Delete init.php.
  • Clear the service worker and browser cache if you want to be “totally safe”.

 

PAGES ARE NOT RESOLVING OR SHOWING PROPERLY

  • Make sure that MOD_REWRITE is enabled in Apache.
  • Make sure that AllowOverride is set properly in Apache.
  • If using https://, make sure that your SSL cert and virtual host are properly set.
  • In Mac/Linux, make sure that Apache/PHP has permission to read the files and folders.

Here is a quick “working example” of a test site on my WAMP server:

httpd.conf OR httpd-vhosts.conf
<VirtualHost site.com:443>
  DocumentRoot "D:\http"
  ServerName site.com:443
  SSLEngine On
  SSLCertificateFile "C:/xampp/apache/conf/ssl.crt/server.crt"
  SSLCertificateKeyFile "C:/xampp/apache/conf/ssl.key/server.key"
  <Directory "D:\http">
    Options Indexes FollowSymLinks Includes ExecCGI
    AllowOverride All
    Require all granted
  </Directory>
</VirtualHost>

 

MANUAL INSTALLATION

  • Create a database and import all lib/SQL-*.sql in ascending order.
  • Open lib/CORE-Config.php, update the settings to your own.
    • The host settings.
    • Database settings.
    • If you want to develop mobile apps, consider enabling CORS.
    • Set your own JWT secret key, and the issuer to your domain or company name.
  • Run $_CORE->Route->init() to create .htaccess.
  • Create your own admin user. See “deleted all admin accounts” above.
  • Update index.php.
    • require __DIR__ . DIRECTORY_SEPARATOR . "lib" . DIRECTORY_SEPARATOR . "CORE-Go.php";
    • $_CORE->load("Route");
    • $_CORE->Route->run();

 

 

NOT WORKING. DON’T KNOW WHY.

Open the developer’s console, reload the page and see the error message.

 

QUICK REFERENCE

This section is for the developers, a quick walkthrough of the general system structures.

 

FOLDER STRUCTURE

  • assets/ Public images, Javascript, CSS, etc…
  • lib/ Core engine and library files.
    • API-AAA.php The API endpoints. Will be deployed at http://site.com/api/AAA/.
    • CORE-CCC.php Core engine files. Try not to mess with these.
    • LIB-LLL.php Library files.
    • SQL-SSS.php SQL database files. Can actually delete these after installation.
  • pages/ HTML pages and template.
    • A-AAA.php Admin pages.
    • T-TTT.php Teacher pages.
    • S-SSS.php Student pages.
    • PAGE-PPP.php General pages.
    • MAIL-MMM.php Email templates.
    • TEMPLATE-TTT.php HTML page template.

 

THE FRAMEWORKS

I Was Here is built:

 

DATABASE TABLES

USERS & PASSWORD

users
Field Description
user_id Primary key, auto-increment.
user_name Full name.
user_email Email, unique.
user_role Admin, Teacher, Student, Inactive.
user_password Password, encrypted.
password_reset
Field Description
user_id Primary and foreign key.
reset_hash Automated password reset security hash.
reset_time The time when the reset request is made.

 

SYSTEM

settings
Field Description
setting_name Primary key.
setting_description Description of the setting.
setting_value The value of the setting.
setting_group Setting group.

  • 0 – “Hidden” system settings and definitions.
  • 1 – User changeable settings.

 

 

COURSES

courses
Field Description
course_id Primary key, auto-increment.
course_code Course code, unique.
course_name Name of the course.
course_desc A short description of the course.
course_start Course start date.
course_end Course end date.
courses_users
Field Description
course_id Primary and foreign key.
user_id Primary and foreign key.

 

CLASSES & ATTENDANCE

classes
Field Description
class_id Primary key, auto-increment.
user_id Teacher-in-charge. Foreign key.
couse_id Course ID. Foreign key.
class_date Date and time of the class.
class_desc Short description of the class.
attendance
Field Description
class_id Primary and foreign key.
user_id Primary and foreign key.
sign_date Timestamp, when the attendance is taken.

 

DEVELOPING “I WAS HERE”

As simple as it may be, going through the entire system is still going to take some time. So instead of “explaining line-by-line”, here is a condensed version of “how to quickly customize and upgrade”.

 

CORE BOXX LIBRARY REFERENCE

For most of the core modules, you can refer to the Core Boxx reference library.

 

STEP 1) CREATE/MODIFY DATABASE TABLES

Add new tables or views. Modify the existing ones as required.

 

 

STEP 2) ADD/UPDATE SYSTEM MODULE

lib/LIB-Report.php
class Report extends Core {
  function getStudentAttend ($id) {
    return $this->DB->fetchAll(
      "SELECT * FROM `attendence` WHERE `user_id`=? ORDER BY `sign_date` DESC",
      [$id]
    );
  }
}

To add a new module:

  • Create lib/LIB-Module.php.
  • Define class Module extends Core.
  • Add functions inside.

In this example, we added a new report module – lib/LIB-Report.php and class Report extends Core. That’s all. This new module can now be loaded via $_CORE->load("Report") and the function can be accessed via $_CORE->Report->getStudentAttend().

 

STEP 3) ADD/UPDATE API ENDPOINT (OPTIONAL)

lib/API-Report.php
// (A) ADMIN ONLY
if (!isset($_SESS["user"]) || $_SESS["user"]["user_role"]!="A") {
  $_CORE->respond(0, "No permission or session expired", null, null, 403);
}

switch ($_REQ) {
  // (B) INVALID REQUEST
  default:
    $_CORE->respond(0, "Invalid request", null, null, 400);
    break;
 
  // (B) GET STUDENT ATTENDANCE
  case "getStudentAttend":
    $_CORE->autoGETAPI("Reports", "getStudentAttend");
    break;
}}

To add an API endpoint:

  • Core Boxx has an API structure of http://site.com/api/MODULE/REQUEST.
  • lib/API-report.php will create an API endpoint at http://site.com/api/report.
  • $_REQ is the requested service REQUEST segment of the URL.

So for this example, we can send $_POST["id"] = 123 to http://site.com/report/getStudentAttend/ to get the attendance report for student 123. The API will reply with a JSON-encoded string.

 

STEP 4) ADD/UPDATE HTML CSS JAVASCRIPT

  • Add your new pages in pages/.
    • For admin pages, add pages/A-name.php.
    • For teacher pages, add pages/T-name.php.
    • For student pages, add pages/S-name.php.
    • For example, pages/A-report.php can only be accessed by administrators from http://site.com/a/report.

That’s about it. Just reverse engineer and copy from the existing libraries, API, and pages… You will see the development pattern here.

34 thoughts on “I Was Here – PHP Student Attendance System (Free Download)”

  1. Can you list the number of students in a class and add a note field next to it when the student is away? Add these two functions in the next update

      1. No idea. I have more than 500 tutorials/articles to update on this and other sites. A few features I have in mind – Email/push notifications for absentees, calendar/time table, staff/student card with NFC login, etc…

  2. My site is on HTTPS, but the PWA installer still won’t load. I’m using CRHOME. I believe I have to enable something to work?

      1. I didn’t understand. do you want the data to log into the system or server, or are you asking if I can log into the script normally?

    1. I would just like to know in which file and in which line of your script I add the code to leave the date in Brazilian Portuguese format. Please help me

      1. There are too many to list… Run through all page/PAGE-*.

        P.S. I shall keep this as a feature request, and add a “simple way to update all date formats” in the future. Good luck.

      2. Friend, I know it’s in some PHP script file and there are several, however, I need to know at least what code or command line I need to look for. please be more clear

  3. I’m facing errors in the installation, I already fixed everything that asked for the steps

    could you do the installation for me if i pass my server data?

  4. Hi,
    i’m trying to run this project on a Ubuntu Server 20.04 with Apache2, PHP 8.0 and MySQL.
    The installer finishes without error, but after that, nothing works (404 Not Found for https://…/login)
    The database is populated, so i don’t quite know where to look for the error.
    Any help would be appreciated!
    Thanks in advance!
    Jonas

    1. EDIT – Whoever encounters the same problem in the future, it’s either:

      1) MOD_REWRITE is enabled, but AllowOverride is not properly set.
      2) SSL issues. Apache is not serving the pages and/or static assets properly.

      Will try to add more checks, but fingers crossed. PHP has limited or no access to these Apache settings.

  5. can you help me to send sms or emails to the absents?
    If we have the phone #, email, and status of the attendance, this shouldn’t be a problem, right?

  6. its really great work and a very good job
    thanks a lot

    but I face a problem
    it show a massige
    ” Unable to create database – SQLSTATE[HY000]: General error: 1007 Can’t create database ‘iwashere’; database exists”
    please guide me
    thanks again

    1. If it is a new installation, just delete the database and reinstall. Also, redownload the latest build. It should be easier for updates in the future.

  7. Michele Fioretti

    Helllo , I have error 404 only on export attendance as csv. The remain function already works. Can yo have suggestions ? Thanks in advances.
    Can provide me example api call for register attendance of a student ? Thanks in advances.

    1. 1) Not getting 404 on my test server. The export CSV points to http://YOUR-SITE.COM/admin/export-attend and resolves to pages/ADMIN-export-attend.php as intended.
      2) Page updated, see reference above.

  8. Hi, when I run Iwashere with php -S 127.0.0.1:8000 it works fine but as soon as I upload it redirects to localhost/login and I get a 404 message. I am using 18.04 php ver 7.2.24 Apache2 ver 2.4.29. I cleared the.htaccess file and it didn’t work.

Leave a Comment

Your email address will not be published. Required fields are marked *