23 Feb 2023

1) Core engine update - Will no longer throw "dynamic properties are deprecated" warnings on PHP 8.2+
2) PHP-JWT update
3) Generic visuals and class updates

Author: code-boxx

README.md

@@ -35,6 +35,10 @@ Just access `http://your-site.com/` in your browser and walk through the install
 2) Visit https://code-boxx.com/i-was-here-php-attendance-system/ for the full documentation!
 <br><br>
 
+## :star: SUPPORT
+Like this project? Just give it a star. That will indirectly help grow my blog a little bit. :wink:
+<br><br>
+
 ## :newspaper: LICENSE
 Copyright by Code Boxx
 
@@ -54,4 +58,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

assets/HEAD-iwh.jpg

@@ -14,7 +14,7 @@ function save ($cid, $uid, $date, $desc=null, $id=null) {
     // (A2) ADD/UPDATE CLASS
     if ($id==null) {
       $fields[] = "class_hash";
-      $data[] = $this->core->random(12);
+      $data[] = $this->Core->random(12);
       $this->DB->insert("classes", $fields, $data);
     } else {
       $data[] = $id;
@@ -61,14 +61,14 @@ function getAll ($search=null, $page=null) {
 
     // (D2) PAGINATION
     if ($page != null) {
-      $this->core->paginator($this->DB->fetchCol(
+      $this->Core->paginator($this->DB->fetchCol(
         "SELECT COUNT(*) $sql", $data
       ), $page);
     }
 
     // (D3) RESULT
     $sql .= " ORDER BY `class_date` DESC";
-    if ($page != null) { $sql .= $this->core->page["lim"]; }
+    if ($page != null) { $sql .= $this->Core->page["lim"]; }
     return $this->DB->fetchAll(
       "SELECT cl.*, DATE_FORMAT(cl.`class_date`, '".DT_LONG."') `cd`, co.`course_code`, co.`course_name`, u.`user_name` $sql",
       $data, "class_id"
@@ -80,8 +80,8 @@ function getAll ($search=null, $page=null) {
   //  $uid : user id or email
   function attend ($id, $uid) {
     // (E1) VERIFY VALID USER
-    $this->core->load("Users");
-    $user = $this->core->Users->get($uid);
+    $this->Core->load("Users");
+    $user = $this->Users->get($uid);
     if (!is_array($user) || $user["user_role"]!="S") {
       $this->error = "Invalid user";
       return false;
@@ -221,14 +221,14 @@ function getByTeacher ($uid, $date=null, $range=null, $page=null) {
 
     // (J2) PAGINATION
     if ($page != null) {
-      $this->core->paginator(
+      $this->Core->paginator(
         $this->DB->fetchCol("SELECT COUNT(*) $sql", $data), $page
       );
     }
 
     // (J3) GET CLASSES
     $sql = "SELECT cl.*, DATE_FORMAT(cl.`class_date`, '".DT_LONG."') `cd`, co.`course_code`, co.`course_name` $sql ORDER BY `class_date` DESC";
-    if ($page != null) { $sql .= $this->core->page["lim"]; }
+    if ($page != null) { $sql .= $this->Core->page["lim"]; }
 
     // (J4) RESULTS
     return $this->DB->fetchAll($sql, $data, "class_id");
@@ -263,7 +263,7 @@ function getByStudent ($uid, $date=null, $range=null, $page=null) {
 
     // (K2) PAGINATION
     if ($page != null) {
-      $this->core->paginator(
+      $this->Core->paginator(
         $this->DB->fetchCol("SELECT COUNT(*) FROM `classes` cl $sql", $data), $page
       );
     }
@@ -274,7 +274,7 @@ function getByStudent ($uid, $date=null, $range=null, $page=null) {
             LEFT JOIN `attendance` a ON (cl.`class_id`=a.`class_id` AND a.`user_id`=?)
             LEFT JOIN `courses` co ON (cl.`course_id`=co.`course_id`)
             $sql  ORDER BY `class_date` DESC";
-    if ($page != null) { $sql .= $this->core->page["lim"]; }
+    if ($page != null) { $sql .= $this->Core->page["lim"]; }
     array_unshift($data, $uid);
 
     // (K4) RESULTS
@@ -284,8 +284,8 @@ function getByStudent ($uid, $date=null, $range=null, $page=null) {
   // (L) IMPORT CLASS
   function import ($code, $date, $email, $desc) {
     // (L1) CHECK - COURSE CODE
-    $this->core->load("Courses");
-    $course = $this->core->Courses->get($code);
+    $this->Core->load("Courses");
+    $course = $this->Courses->get($code);
     if (!is_array($course)) {
       $this->error = "Invalid course - $code";
       return false;

assets/forgot.jpg

@@ -1,47 +1,52 @@
 <?php
 class CoreBoxx {
-  // (A) PROPERTIES & CONSTRUCTOR
-  public $error = ""; // error message, if any
+  // (A) PROPERTIES
+  public $loaded = []; // modules loaded
+  public $error = "";  // error message, if any
   public $page = null; // pagination data, if any
-  function __construct () {
-    $GLOBALS["_SESS"] = []; // initialize global session variable
-  }
 
-  // (B) MODULES
-  // (B1) LOAD MODULE
+  // (B) CONSTRUCTOR - INITIALIZE GLOBAL SESSION VARIABLE
+  function __construct () { $GLOBALS["_SESS"] = []; }
+
+  // (C) MODULES HANDLER
+  // (C1) IS MODULE LOADED?
+  //  $module : module to check
+  function loaded ($module) { return isset($this->loaded[$module]); }
+
+  // (C2) LOAD MODULE
   //  $module : module to load
-  function load ($module) { if (!$this->loaded($module)) {
+  function load ($module) : void {
+    if ($this->loaded($module)) { return; }
     $file = PATH_LIB . "LIB-$module.php";
     if (file_exists($file)) {
       require $file;
-      $this->$module = new $module($this);
+      $this->loaded[$module] = new $module($this);
     } else { throw new Exception("$module module not found!"); }
-  }}
+  }
 
-  // (B2) IS MODULE LOADED?
-  //  $module : module to check
-  function loaded ($module) {
-    return isset($this->$module) && is_object($this->$module);
+  // (C3) "MAGIC LINK" TO MODULE
+  function __get ($name) {
+    if (isset($this->loaded[$name])) { return $this->loaded[$name]; }
   }
 
-  // (C) FUNCTION MAPPING
-  // (C1) AUTO MAP $_POST OR $_GET TO MODULE FUNCTION
+  // (D) FUNCTION MAPPING
+  // (D1) AUTO MAP $_POST OR $_GET TO MODULE FUNCTION
   //  $module : module to load
   //  $function : function to run
   //  $mode : POST or GET
   function autoCall ($module, $function, $mode="POST") {
-    // (C1-1) LOAD MODULE
+    // (D1-1) LOAD MODULE
     $this->load($module);
 
-    // (C1-2) MAP POST OR GET?
+    // (D1-2) MAP POST OR GET?
     if ($mode=="POST") { $target =& $_POST; }
     else { $target =& $_GET; }
 
-    // (C1-3) GET FUNCTION PARAMETERS
+    // (D1-3) GET FUNCTION PARAMETERS
     $reflect = new ReflectionMethod($module, $function);
     $params = $reflect->getParameters();
 
-    // (C1-4) EVIL MAPPING
+    // (D1-4) EVIL MAPPING
     $evil = "\$results = \$this->$module->$function(";
     if (count($params)==0) { $evil .= ");"; }
     else {
@@ -61,40 +66,40 @@ function autoCall ($module, $function, $mode="POST") {
       $evil = substr($evil, 0, -1) . ");";
     }
 
-    // (C1-5) EVIL RESULTS
+    // (D1-5) EVIL RESULTS
     eval($evil);
     return $results;
   }
 
-  // (C2) AUTO MAP $_POST OR $_GET TO MODULE FUNCTION & API RESPOND
+  // (D2) AUTO MAP $_POST OR $_GET TO MODULE FUNCTION & API RESPOND
   //  $module : module to load
   //  $function : function to run
   //  $mode : POST or GET
-  function autoAPI ($module, $function, $mode="POST") {
+  function autoAPI ($module, $function, $mode="POST") : void {
     $result = $this->autoCall($module, $function, $mode);
     $this->respond($result, null, null,
       $this->DB->lastID!==null ? $this->DB->lastID : null
     );
   }
 
-  // (C3) SAME AS ABOVE, BUT FOR "GET ENTRIES" API FUNCTIONS
+  // (D3) SAME AS ABOVE, BUT FOR "GET ENTRIES" API FUNCTIONS
   //  $module : module to load
   //  $function : function to run
   //  $mode : POST or GET
-  function autoGETAPI ($module, $function, $mode="POST") {
+  function autoGETAPI ($module, $function, $mode="POST") : void {
     $results = $this->autoCall($module, $function, $mode);
     $this->respond($results!==false, null, $results);
   }
 
-  // (D) SYSTEM
-  // (D1) STANDARD JSON RESPONSE
+  // (E) SYSTEM
+  // (E1) STANDARD JSON RESPONSE
   //  $status : 1 or 0, true or false
   //  $msg : system message
   //  $data : optional, data append
   //  $more : optional, supplementary data
   //  $http : optional, HTTP response code (401, 403, 500, etc...)
   //  $exit : stop process, default true
-  function respond ($status, $msg=null, $data=null, $more=null, $http=null, $exit=true) {
+  function respond ($status, $msg=null, $data=null, $more=null, $http=null, $exit=true) : void {
     if ($http!==null) { http_response_code($http); }
     if ($msg === null) {
       if ($status==1) { $msg = "OK"; }
@@ -107,9 +112,9 @@ function respond ($status, $msg=null, $data=null, $more=null, $http=null, $exit=
     if ($exit) { exit(); }
   }
 
-  // (D2) STANDARD ERROR HANDLER
-  function ouch ($ex) {
-    // (D2-1) OUTPUT JSON ENCODED MESSAGE IN API MODE
+  // (E2) STANDARD ERROR HANDLER
+  function ouch ($ex) : void {
+    // (E2-1) OUTPUT JSON ENCODED MESSAGE IN API MODE
     if (defined("API_MODE")) {
       $this->respond(0,
       ERR_SHOW ? $ex->getMessage() : "OPPS! An error has occured.",
@@ -119,7 +124,7 @@ function ouch ($ex) {
       ] : null);
     }
 
-    // (D2-2) SHOW HTML ERROR MESSAGE IN WEB MODE
+    // (E2-2) SHOW HTML ERROR MESSAGE IN WEB MODE
     else if (defined("WEB_MODE")) { ?>
     <div style="box-sizing:border-box;position:fixed;top:0;left:0;width:100vw;height:100vh;z-index:9999;background:#fff;color:#000;padding:30px;font-family:arial">
       <h1 style="font-size:50px;padding:0;margin:0">(╯°□°)╯︵ ┻━┻</h1>
@@ -136,7 +141,7 @@ function ouch ($ex) {
     </div>
     <?php }
 
-    // (D2-3) OUTPUT PLAIN TEXT OTHERWISE
+    // (E2-3) OUTPUT PLAIN TEXT OTHERWISE
     else {
       echo "An error has occured.";
       if (ERR_SHOW) {
@@ -148,51 +153,56 @@ function ouch ($ex) {
     }
   }
 
-  // (E) OTHER CONVENIENCE
-  // (E1) GENERATE RANDOM STRING
+  // (F) OTHER CONVENIENCE
+  // (F1) GENERATE RANDOM STRING
   // $length : number of bytes
-  function random ($length=8) {
-    return bin2hex(random_bytes($length));
-  }
+  function random ($length=8) { return bin2hex(random_bytes($length)); }
 
-  // (E2) PAGINATION CALCULATOR
+  // (F2) PAGINATION CALCULATOR
   //  $entries : total number of entries
   //  $now : current page
-  function paginator ($entries, $now=1) {
-    // (E2-1) TOTAL NUMBER OF PAGES
+  function paginator ($entries, $now=1) : void {
+    // (F2-1) TOTAL NUMBER OF PAGES
     $this->page = [
       "entries" => (int) $entries,
       "total" => ceil($entries / PAGE_PER)
     ];
 
-    // (E2-2) CURRENT PAGE
+    // (F2-2) CURRENT PAGE
     $this->page["now"] = $now > $this->page["total"] ? $this->page["total"] : $now ;
     if ($this->page["now"]<=0) { $this->page["now"] = 1; }
     $this->page["now"] = (int) $this->page["now"];
 
-    // (E2-3) LIMIT X,Y
+    // (F2-3) LIMIT X,Y
     $this->page["x"] = ($this->page["now"] - 1) * PAGE_PER;
     $this->page["y"] = PAGE_PER;
     $this->page["lim"] = " LIMIT {$this->page["x"]}, {$this->page["y"]}";
   }
 
-  // (E3) REDIRECT
-  function redirect ($page="", $url=HOST_BASE) {
+  // (F3) REDIRECT
+  function redirect ($page="", $url=HOST_BASE) : void {
     header("Location: $url$page");
     exit();
   }
 }
 
-// (F) ALL LIBRARIES SHOULD EXTEND THIS CORE CLASS
+// (G) ALL MODULES SHOULD EXTEND THIS CORE CLASS
 class Core {
+  // (G1) LINK MODULE TO CORE
+  public $Core;
+  public $error;
   function __construct ($core) {
-    $this->core =& $core; // Link to core
-    $this->error =& $core->error; // Error message
-    if ($core->loaded("DB")) { $this->DB =& $core->DB; } // Link to database module
+    $this->Core =& $core;
+    $this->error =& $core->error;
+  }
+
+  // (G2) MAKE MODULES LINKING EASIER
+  function __get ($name) {
+    if (isset($this->Core->loaded[$name])) { return $this->Core->loaded[$name]; }
   }
 }
 
-// (G) CORE OBJECT + GLOBAL ERROR HANDLING
+// (H) CORE OBJECT + GLOBAL ERROR HANDLING
 $_CORE = new CoreBoxx();
 function _CORERR ($ex) { global $_CORE; $_CORE->ouch($ex); }
 set_exception_handler("_CORERR");