Files
alrahma_sunday_school/app/Models/QuizModel.php
T
2026-05-16 13:44:12 -04:00

111 lines
3.3 KiB
PHP
Executable File

<?php
namespace App\Models;
use CodeIgniter\Model;
class QuizModel extends Model
{
protected $table = 'quiz';
protected $primaryKey = 'id';
protected $useAutoIncrement = true;
protected $returnType = 'array';
protected $useSoftDeletes = false;
protected $protectFields = true;
protected $allowedFields = [
'student_id',
'school_id',
'class_section_id',
'updated_by',
'quiz_index',
'score',
'comment',
'semester',
'school_year',
'created_at',
'updated_at'
];
protected bool $allowEmptyInserts = false;
protected bool $updateOnlyChanged = true;
protected array $casts = [];
protected array $castHandlers = [];
// Dates
protected $useTimestamps = false;
protected $dateFormat = 'datetime';
protected $createdField = 'created_at';
protected $updatedField = 'updated_at';
protected $deletedField = 'deleted_at';
// Validation
protected $validationRules = [];
protected $validationMessages = [];
protected $skipValidation = false;
protected $cleanValidationRules = true;
// Callbacks
protected $allowCallbacks = true;
protected $beforeInsert = [];
protected $afterInsert = [];
protected $beforeUpdate = [];
protected $afterUpdate = [];
protected $beforeFind = [];
protected $afterFind = [];
protected $beforeDelete = [];
protected $afterDelete = [];
/**
* Calculate the average quiz score for a given student, semester, and school year.
*
* @param int $studentId The student's ID.
* @param string $semester The semester (e.g., 'Fall', 'Spring').
* @param string $schoolYear The school year (e.g., '2024-2025').
* @param int|null $classSectionId Optional class section filter.
* @return float|null The average quiz score, or null if no scores are found.
*/
public function getAverageQuizScore(int $studentId, string $semester, string $schoolYear, ?int $classSectionId = null): ?float
{
// Fetch the quiz scores for the given student, semester, and school year
$builder = $this->builder();
$builder->select('score')
->where('student_id', $studentId)
->where('semester', $semester)
->where('school_year', $schoolYear);
if ($classSectionId !== null) {
$builder->where('class_section_id', $classSectionId);
}
// Execute the query and get the results
$query = $builder->get();
$results = $query->getResultArray();
// If there are no scores, return null
if (empty($results)) {
return null;
}
// Calculate the average score (ignore blank/null/non-numeric)
$totalScore = 0.0;
$scoreCount = 0;
foreach ($results as $result) {
$score = $result['score'] ?? null;
if ($score === null || (is_string($score) && trim($score) === '') || $score === '' || !is_numeric($score)) {
continue;
}
$totalScore += (float) $score;
$scoreCount++;
}
if ($scoreCount === 0) {
return null;
}
return $totalScore / $scoreCount;
}
}