Persist test results

README.md

@@ -13,6 +13,8 @@ Szkielet komponentu Joomla 6 do gromadzenia pytań testowych.
 - frontendowy widok pytań filtrowany po symbolu arkusza egzaminacyjnego,
 - frontendowy widok testu na podstawie wybranego zestawu pytań,
 - dwuetapowe rozpoczęcie testu z loginem użytkownika i możliwością przedłużenia czasu,
+- zegar odliczający czas testu i automatyczne zakończenie po jego upływie,
+- zapisywanie wyników testów i zaznaczonych odpowiedzi w bazie danych,
 - pozycję menu „Arkusz egzaminacyjny” z opcjonalnym symbolem arkusza,
 - listę wyboru dostępnych symboli arkuszy na stronie klienckiej,
 - możliwość rozwiązania arkusza i wyświetlenia wyniku oraz odpowiedzi poprawnych i zaznaczonych,
@@ -26,6 +28,6 @@ Szkielet komponentu Joomla 6 do gromadzenia pytań testowych.
 
 ## Instalacja
 
-W Joomla wybierz **System → Install → Install from Folder** i wskaż ten katalog. Manifestem instalacyjnym jest `com_testquestions.xml` (wersja 1.15.1).
+W Joomla wybierz **System → Install → Install from Folder** i wskaż ten katalog. Manifestem instalacyjnym jest `com_testquestions.xml` (wersja 1.17.0).
 
 Po instalacji komponent jest dostępny w panelu administratora jako **Pytania testowe**.

administrator/components/com_testquestions/sql/install.mysql.utf8mb4.sql

@@ -73,3 +73,19 @@ CREATE TABLE IF NOT EXISTS `#__testquestions_set_questions` (
   PRIMARY KEY (`set_id`, `question_id`),
   KEY `idx_question_id` (`question_id`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;
+
+CREATE TABLE IF NOT EXISTS `#__testquestions_results` (
+  `id` int unsigned NOT NULL AUTO_INCREMENT,
+  `set_id` int unsigned NOT NULL,
+  `participant_name` varchar(255) NOT NULL DEFAULT '',
+  `extra_time` smallint unsigned NOT NULL DEFAULT 0,
+  `correct_count` smallint unsigned NOT NULL DEFAULT 0,
+  `total_count` smallint unsigned NOT NULL DEFAULT 0,
+  `percentage` decimal(5,2) NOT NULL DEFAULT 0.00,
+  `answers` longtext NULL,
+  `created` datetime NOT NULL,
+  `created_by` int unsigned NOT NULL DEFAULT 0,
+  PRIMARY KEY (`id`),
+  KEY `idx_set_id` (`set_id`),
+  KEY `idx_created` (`created`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;

administrator/components/com_testquestions/sql/uninstall.mysql.utf8mb4.sql

@@ -1,4 +1,5 @@
 DROP TABLE IF EXISTS `#__testquestions_set_questions`;
 DROP TABLE IF EXISTS `#__testquestions_sets`;
 DROP TABLE IF EXISTS `#__testquestions_subjects`;
+DROP TABLE IF EXISTS `#__testquestions_results`;
 DROP TABLE IF EXISTS `#__testquestions_questions`;

administrator/components/com_testquestions/sql/updates/mysql/1.15.2.sql

@@ -0,0 +1 @@
+-- No database changes required for version 1.15.2.

administrator/components/com_testquestions/sql/updates/mysql/1.16.0.sql

@@ -0,0 +1 @@
+-- No database changes required for version 1.16.0.

administrator/components/com_testquestions/sql/updates/mysql/1.16.1.sql

@@ -0,0 +1 @@
+-- No database changes required for version 1.16.1.

administrator/components/com_testquestions/sql/updates/mysql/1.16.2.sql

@@ -0,0 +1 @@
+-- No database changes required for version 1.16.2.

administrator/components/com_testquestions/sql/updates/mysql/1.16.3.sql

@@ -0,0 +1 @@
+-- No database changes required for version 1.16.3.

administrator/components/com_testquestions/sql/updates/mysql/1.17.0.sql

@@ -0,0 +1,15 @@
+CREATE TABLE IF NOT EXISTS `#__testquestions_results` (
+  `id` int unsigned NOT NULL AUTO_INCREMENT,
+  `set_id` int unsigned NOT NULL,
+  `participant_name` varchar(255) NOT NULL DEFAULT '',
+  `extra_time` smallint unsigned NOT NULL DEFAULT 0,
+  `correct_count` smallint unsigned NOT NULL DEFAULT 0,
+  `total_count` smallint unsigned NOT NULL DEFAULT 0,
+  `percentage` decimal(5,2) NOT NULL DEFAULT 0.00,
+  `answers` longtext NULL,
+  `created` datetime NOT NULL,
+  `created_by` int unsigned NOT NULL DEFAULT 0,
+  PRIMARY KEY (`id`),
+  KEY `idx_set_id` (`set_id`),
+  KEY `idx_created` (`created`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;

com_testquestions.xml

@@ -4,7 +4,7 @@
     <creationDate>2026-10-14</creationDate>
     <author>Komponent</author>
     <license>GNU General Public License version 2 or later</license>
-    <version>1.15.1</version>
+    <version>1.17.0</version>
     <description>COM_TESTQUESTIONS_DESCRIPTION</description>
     <element>com_testquestions</element>
     <namespace path="src">Komponent\Component\Testquestions</namespace>

components/com_testquestions/language/en-GB/com_testquestions.ini

@@ -21,7 +21,9 @@ COM_TESTQUESTIONS_SET_DURATION="Czas trwania testu"
 COM_TESTQUESTIONS_SET_NOT_FOUND="Nie znaleziono wybranego zestawu testowego."
 COM_TESTQUESTIONS_SELECT_SET="Wybierz zestaw pytań"
 COM_TESTQUESTIONS_SHOW_SET="Pokaż zestaw"
+COM_TESTQUESTIONS_YOUR_ANSWER="Twoja odpowiedź"
 COM_TESTQUESTIONS_PARTICIPANT_NAME="Login lub nazwa użytkownika"
 COM_TESTQUESTIONS_EXTRA_TIME="Przedłużenie czasu"
 COM_TESTQUESTIONS_START_TEST="Rozpocznij test"
 COM_TESTQUESTIONS_SET_START_HINT="Wybierz zestaw, wpisz login lub nazwę użytkownika i zatwierdź rozpoczęcie testu."
+COM_TESTQUESTIONS_TIMER_REMAINING="Pozostały czas"

components/com_testquestions/media/egzamin.css

@@ -18,6 +18,18 @@
     margin: auto;
 }
 
+.com-testquestions #test-timer-container {
+    position: fixed;
+    left: 2rem;
+    bottom: 2rem;
+    z-index: 1050;
+    margin: 0;
+    padding: 0;
+    background: transparent;
+    border: 0;
+    box-shadow: none;
+}
+
 .com-testquestions .timer-text {
     position: absolute;
     top: 50%;

components/com_testquestions/src/Model/SetModel.php

@@ -70,4 +70,29 @@ class SetModel extends BaseDatabaseModel
                 ->order('sub.title ASC, s.title ASC')
         )->loadObjectList();
     }
+
+    public function saveResult(string $participantName, int $extraTime, array $result): bool
+    {
+        $db = Factory::getContainer()->get('DatabaseDriver');
+        $setId = $this->getSetId();
+        $user = Factory::getApplication()->getIdentity();
+
+        if ($setId < 1 || trim($participantName) === '') {
+            return false;
+        }
+
+        $row = (object) [
+            'set_id' => $setId,
+            'participant_name' => trim($participantName),
+            'extra_time' => max(0, $extraTime),
+            'correct_count' => (int) ($result['correct'] ?? 0),
+            'total_count' => (int) ($result['total'] ?? 0),
+            'percentage' => (float) ($result['percentage'] ?? 0),
+            'answers' => json_encode($result['items'] ?? [], JSON_UNESCAPED_UNICODE),
+            'created' => Factory::getDate()->toSql(),
+            'created_by' => $user ? (int) $user->id : 0,
+        ];
+
+        return (bool) $db->insertObject('#__testquestions_results', $row);
+    }
 }

components/com_testquestions/src/View/Set/HtmlView.php

@@ -30,6 +30,14 @@ class HtmlView extends BaseHtmlView
             && $input->post->getInt('set_id', 0) > 0;
         $this->results = $this->buildResults($this->items);
 
+        if ($this->results) {
+            $this->getModel()->saveResult(
+                $input->post->getString('participant_name', ''),
+                $input->post->getInt('extra_time', 0),
+                $this->results
+            );
+        }
+
         return parent::display($tpl);
     }
 

components/com_testquestions/tmpl/set/default.php

@@ -46,11 +46,20 @@ use Joomla\CMS\Factory;
             <?php if ($this->set->image) : ?><div class="foto_pyt"><img src="<?php echo htmlspecialchars($this->set->image, ENT_QUOTES, 'UTF-8'); ?>" alt="" loading="lazy"></div><?php endif; ?>
             <?php if ($this->set->test_content) : ?><div class="test-set-content"><?php echo $this->set->test_content; ?></div><?php endif; ?>
         </header>
+        <?php if (!$this->results && ((int) $this->set->duration + $extraTime) > 0) : ?>
+            <div class="timer-container mb-4" id="test-timer-container" data-duration="<?php echo ((int) $this->set->duration + $extraTime) * 60; ?>" aria-live="polite">
+                <svg width="120" height="120" viewBox="0 0 120 120" aria-hidden="true">
+                    <circle cx="60" cy="60" r="54" fill="none" stroke="#dfe3e7" stroke-width="8"></circle>
+                    <circle id="test-timer-ring" class="progress-ring__circle" cx="60" cy="60" r="54" fill="none" stroke="#4a86cf" stroke-width="8" stroke-linecap="round"></circle>
+                </svg>
+                <div id="test-timer-text" class="timer-text">--:--</div>
+            </div>
+        <?php endif; ?>
         <?php if ($this->results) : ?>
             <div class="alert alert-success test-result"><strong><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_RESULT'); ?>:</strong> <?php echo (int) $this->results['correct']; ?> / <?php echo (int) $this->results['total']; ?> (<?php echo htmlspecialchars((string) $this->results['percentage'], ENT_QUOTES, 'UTF-8'); ?>%)</div>
         <?php endif; ?>
         <?php if ($this->items) : ?>
-            <form action="<?php echo htmlspecialchars($_SERVER['REQUEST_URI'], ENT_QUOTES, 'UTF-8'); ?>" method="post">
+            <form action="<?php echo htmlspecialchars($_SERVER['REQUEST_URI'], ENT_QUOTES, 'UTF-8'); ?>" method="post" id="test-form">
             <?php foreach ($this->items as $number => $item) : ?>
                 <article class="testquestion mb-4">
                     <div class="pyt"><div class="question-header"><span class="question-number"><?php echo ($number + 1) . '.'; ?></span><div class="question-text"><?php echo $item->question; ?></div></div></div>
@@ -58,7 +67,7 @@ use Joomla\CMS\Factory;
                     <?php if ($item->question_type === 'open') : ?>
                         <div class="<?php echo $this->results ? ($this->results['items'][$item->id]['correct'] ? 'odpup' : 'odpu') : 'odp'; ?>">
                             <?php if ($this->results) : ?>
-                                <strong><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_ENTER_ANSWER'); ?>:</strong>
+                                <strong><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_YOUR_ANSWER'); ?>:</strong>
                                 <?php echo htmlspecialchars($this->results['items'][$item->id]['selected'] ?: '—', ENT_QUOTES, 'UTF-8'); ?>
                             <?php else : ?>
                                 <label for="set-answer-<?php echo (int) $number; ?>"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_ENTER_ANSWER'); ?></label>
@@ -96,3 +105,48 @@ use Joomla\CMS\Factory;
         <?php endif; ?>
     <?php endif; ?>
 </div>
+<?php if ($this->started && !$this->results && ((int) $this->set->duration + $extraTime) > 0) : ?>
+<script>
+document.addEventListener('DOMContentLoaded', function () {
+    const container = document.getElementById('test-timer-container');
+    const text = document.getElementById('test-timer-text');
+    const ring = document.getElementById('test-timer-ring');
+    const form = document.getElementById('test-form');
+
+    if (!container || !text || !ring || !form) {
+        return;
+    }
+
+    const total = parseInt(container.dataset.duration, 10);
+    const circumference = 2 * Math.PI * 54;
+    let remaining = total;
+    let submitted = false;
+
+    ring.style.strokeDasharray = circumference + ' ' + circumference;
+
+    const update = function () {
+        const minutes = Math.floor(remaining / 60);
+        const seconds = remaining % 60;
+        const ratio = remaining / total;
+        text.textContent = String(minutes).padStart(2, '0') + ':' + String(seconds).padStart(2, '0');
+        ring.style.strokeDashoffset = circumference * (1 - remaining / total);
+        ring.style.stroke = ratio <= 0.1 ? '#dc3545' : (ratio <= 0.2 ? '#fd7e14' : '#4a86cf');
+
+        if (remaining <= 0 && !submitted) {
+            submitted = true;
+            form.submit();
+        }
+    };
+
+    update();
+    const interval = window.setInterval(function () {
+        remaining -= 1;
+        update();
+
+        if (submitted) {
+            window.clearInterval(interval);
+        }
+    }, 1000);
+});
+</script>
+<?php endif; ?>

egzamin.css

@@ -154,6 +154,18 @@ div.odpup
     gap: .25rem;
 }
 
+.com-testquestions #test-timer-container {
+    position: fixed;
+    left: 2rem;
+    bottom: 2rem;
+    z-index: 1050;
+    margin: 0;
+    padding: 0;
+    background: transparent;
+    border: 0;
+    box-shadow: none;
+}
+
 .com-testquestions .question-number {
     flex: 0 0 auto;
     white-space: nowrap;