111 lines
3.3 KiB
PHP
111 lines
3.3 KiB
PHP
<?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;
|
|
}
|
|
}
|