Add automatic test countdown timer

README.md

@@ -11,6 +11,9 @@ Szkielet komponentu Joomla 6 do gromadzenia pytań testowych.
 - filtrowanie listy pytań po kategorii,
 - przełącznik widoku listy: same pytania albo pytania z odpowiedziami,
 - 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,
 - 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,
@@ -19,11 +22,11 @@ Szkielet komponentu Joomla 6 do gromadzenia pytań testowych.
 - opcjonalne zdjęcie wybierane z Media Managera,
 - publikowanie, filtrowanie i usuwanie pytań w panelu administratora,
 - tworzenie zestawów pytań w panelu administratora i przypisywanie do nich pytań,
-- czas trwania, treść i obraz zestawu testowego,
+- czas trwania w minutach (suwak), treść i obraz zestawu testowego,
 - tabela `#__testquestions_questions` tworzona podczas instalacji.
 
 ## Instalacja
 
-W Joomla wybierz **System → Install → Install from Folder** i wskaż ten katalog. Manifestem instalacyjnym jest `com_testquestions.xml` (wersja 1.12.3).
+W Joomla wybierz **System → Install → Install from Folder** i wskaż ten katalog. Manifestem instalacyjnym jest `com_testquestions.xml` (wersja 1.16.0).
 
 Po instalacji komponent jest dostępny w panelu administratora jako **Pytania testowe**.

administrator/components/com_testquestions/forms/set.xml

@@ -6,7 +6,7 @@
         <field name="subject_id" type="sql" label="COM_TESTQUESTIONS_SUBJECT" required="true" query="SELECT id, title FROM #__testquestions_subjects WHERE published = 1 ORDER BY title ASC" key_field="id" value_field="title" translate_query="false">
             <option value="0">COM_TESTQUESTIONS_SELECT_SUBJECT</option>
         </field>
-        <field name="duration" type="number" label="COM_TESTQUESTIONS_SET_DURATION" description="COM_TESTQUESTIONS_SET_DURATION_DESC" min="0" max="1440" filter="integer" />
+        <field name="duration" type="range" label="COM_TESTQUESTIONS_SET_DURATION" description="COM_TESTQUESTIONS_SET_DURATION_DESC" min="0" max="120" step="1" default="0" filter="integer" />
         <field name="test_content" type="editor" label="COM_TESTQUESTIONS_SET_TEST_CONTENT" buttons="true" filter="safehtml" height="150" />
         <field name="image" type="media" label="COM_TESTQUESTIONS_SET_IMAGE" directory="images/testquestions" preview="tooltip" />
         <field name="description" type="textarea" label="COM_TESTQUESTIONS_SET_DESCRIPTION" rows="4" filter="raw" />

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

@@ -59,7 +59,7 @@ COM_TESTQUESTIONS_UNCATEGORIZED="Bez kategorii"
 COM_TESTQUESTIONS_SET_SHOW_DETAILS="Pokaż odpowiedzi"
 COM_TESTQUESTIONS_SUBJECTS="Przedmioty"
 COM_TESTQUESTIONS_SET_DURATION="Czas trwania testu (minuty)"
-COM_TESTQUESTIONS_SET_DURATION_DESC="Podaj czas trwania testu w minutach."
+COM_TESTQUESTIONS_SET_DURATION_DESC="Ustaw czas trwania testu w minutach za pomocą suwaka."
 COM_TESTQUESTIONS_SET_TEST_CONTENT="Treść testu"
 COM_TESTQUESTIONS_SET_IMAGE="Obraz testu"
 COM_TESTQUESTIONS_SUBJECT="Przedmiot"

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

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

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

@@ -0,0 +1,3 @@
+UPDATE `#__testquestions_sets`
+SET `duration` = `duration` * 60
+WHERE `duration` > 0;

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

@@ -0,0 +1,3 @@
+UPDATE `#__testquestions_sets`
+SET `duration` = ROUND(`duration` / 60)
+WHERE `duration` > 0;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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/tmpl/questions/default.php

@@ -47,8 +47,6 @@ HTMLHelper::_('behavior.multiselect');
             <tr>
                 <th scope="col" class="w-1"><?php echo HTMLHelper::_('grid.checkall'); ?></th>
                 <th scope="col"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_COLUMN_QUESTION'); ?></th>
-                <th scope="col" class="w-10"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_COLUMN_TYPE'); ?></th>
-                <th scope="col" class="w-10"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_COLUMN_CORRECT'); ?></th>
                 <th scope="col" class="w-10"><?php echo \Joomla\CMS\Language\Text::_('JSTATUS'); ?></th>
                 <th scope="col" class="w-10"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_COLUMN_ID'); ?></th>
             </tr>
@@ -67,16 +65,14 @@ HTMLHelper::_('behavior.multiselect');
                             <?php if ($item->question_type === 'open') : ?>
                                 <div><strong><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_FIELD_OPEN_PATTERN'); ?>:</strong> <?php echo $item->answer_open; ?></div>
                             <?php else : ?>
-                                <div><strong>A:</strong> <?php echo $item->answer_a; ?></div>
-                                <div><strong>B:</strong> <?php echo $item->answer_b; ?></div>
-                                <div><strong>C:</strong> <?php echo $item->answer_c; ?></div>
-                                <div><strong>D:</strong> <?php echo $item->answer_d; ?></div>
+                                <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">A:</strong><span><?php echo $item->answer_a; ?></span><?php if ((int) $item->correct_answer === 1) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?></div>
+                                <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">B:</strong><span><?php echo $item->answer_b; ?></span><?php if ((int) $item->correct_answer === 2) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?></div>
+                                <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">C:</strong><span><?php echo $item->answer_c; ?></span><?php if ((int) $item->correct_answer === 3) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?></div>
+                                <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">D:</strong><span><?php echo $item->answer_d; ?></span><?php if ((int) $item->correct_answer === 4) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?></div>
                             <?php endif; ?>
                         </div>
                     <?php endif; ?>
                 </th>
-                <td><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_TYPE_' . strtoupper($item->question_type)); ?></td>
-                <td><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_ANSWER_' . chr(64 + (int) $item->correct_answer)); ?></td>
                 <td><?php echo HTMLHelper::_('jgrid.published', $item->published, $i, 'questions.', true, 'cb'); ?></td>
                 <td><?php echo (int) $item->id; ?></td>
             </tr>

administrator/components/com_testquestions/tmpl/set/edit.php

@@ -12,6 +12,7 @@ HTMLHelper::_('behavior.formvalidator');
         <?php echo $this->form->renderField('title'); ?>
         <?php echo $this->form->renderField('subject_id'); ?>
         <?php echo $this->form->renderField('duration'); ?>
+        <output id="set-duration-value" class="form-text mb-3"></output>
         <?php echo $this->form->renderField('test_content'); ?>
         <?php echo $this->form->renderField('image'); ?>
         <?php echo $this->form->renderField('description'); ?>
@@ -33,10 +34,10 @@ HTMLHelper::_('behavior.formvalidator');
                                 <?php if ($question->question_type === 'open') : ?>
                                     <div><strong><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_FIELD_OPEN_PATTERN'); ?>:</strong> <?php echo $this->escape($question->answer_open); ?></div>
                                 <?php else : ?>
-                                    <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">A:</strong><?php if ((int) $question->correct_answer === 1) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?><span><?php echo $question->answer_a; ?></span></div>
-                                    <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">B:</strong><?php if ((int) $question->correct_answer === 2) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?><span><?php echo $question->answer_b; ?></span></div>
-                                    <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">C:</strong><?php if ((int) $question->correct_answer === 3) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?><span><?php echo $question->answer_c; ?></span></div>
-                                    <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">D:</strong><?php if ((int) $question->correct_answer === 4) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?><span><?php echo $question->answer_d; ?></span></div>
+                                    <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">A:</strong><span><?php echo $question->answer_a; ?></span><?php if ((int) $question->correct_answer === 1) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?></div>
+                                    <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">B:</strong><span><?php echo $question->answer_b; ?></span><?php if ((int) $question->correct_answer === 2) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?></div>
+                                    <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">C:</strong><span><?php echo $question->answer_c; ?></span><?php if ((int) $question->correct_answer === 3) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?></div>
+                                    <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">D:</strong><span><?php echo $question->answer_d; ?></span><?php if ((int) $question->correct_answer === 4) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?></div>
                                 <?php endif; ?>
                             </div>
                         </details>
@@ -70,10 +71,10 @@ HTMLHelper::_('behavior.formvalidator');
                                 <?php if ($question->question_type === 'open') : ?>
                                     <div><strong><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_FIELD_OPEN_PATTERN'); ?>:</strong> <?php echo $this->escape($question->answer_open); ?></div>
                                 <?php else : ?>
-                                    <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">A:</strong><?php if ((int) $question->correct_answer === 1) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?><span><?php echo $question->answer_a; ?></span></div>
-                                    <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">B:</strong><?php if ((int) $question->correct_answer === 2) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?><span><?php echo $question->answer_b; ?></span></div>
-                                    <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">C:</strong><?php if ((int) $question->correct_answer === 3) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?><span><?php echo $question->answer_c; ?></span></div>
-                                    <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">D:</strong><?php if ((int) $question->correct_answer === 4) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?><span><?php echo $question->answer_d; ?></span></div>
+                                    <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">A:</strong><span><?php echo $question->answer_a; ?></span><?php if ((int) $question->correct_answer === 1) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?></div>
+                                    <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">B:</strong><span><?php echo $question->answer_b; ?></span><?php if ((int) $question->correct_answer === 2) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?></div>
+                                    <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">C:</strong><span><?php echo $question->answer_c; ?></span><?php if ((int) $question->correct_answer === 3) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?></div>
+                                    <div class="d-flex gap-2 align-items-start"><strong class="flex-shrink-0">D:</strong><span><?php echo $question->answer_d; ?></span><?php if ((int) $question->correct_answer === 4) : ?><span class="text-success flex-shrink-0">✓</span><?php endif; ?></div>
                                 <?php endif; ?>
                             </div>
                         </details>
@@ -101,3 +102,20 @@ document.addEventListener('DOMContentLoaded', function () {
     });
 });
 </script>
+<script>
+document.addEventListener('DOMContentLoaded', function () {
+    const duration = document.getElementById('jform_duration');
+    const output = document.getElementById('set-duration-value');
+
+    if (!duration || !output) {
+        return;
+    }
+
+    const updateDuration = function () {
+        output.textContent = duration.value + ' min';
+    };
+
+    duration.addEventListener('input', updateDuration);
+    updateDuration();
+});
+</script>

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.12.3</version>
+    <version>1.16.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

@@ -17,3 +17,13 @@ COM_TESTQUESTIONS_MENU_ITEM_TITLE="Arkusz egzaminacyjny"
 COM_TESTQUESTIONS_MENU_ITEM_DESCRIPTION="Wyświetla pytania z wybranego arkusza egzaminacyjnego."
 COM_TESTQUESTIONS_MENU_TEST_SYMBOL_DESC="Opcjonalnie wybierz symbol arkusza, który ma być wyświetlany po wejściu z menu."
 COM_TESTQUESTIONS_ENTER_ANSWER="Wpisz odpowiedź"
+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/language/en-GB/com_testquestions.sys.ini

@@ -1,3 +1,6 @@
 COM_TESTQUESTIONS="Pytania testowe"
 COM_TESTQUESTIONS_MENU_ITEM_TITLE="Arkusz egzaminacyjny"
 COM_TESTQUESTIONS_MENU_ITEM_DESCRIPTION="Wyświetla pytania z wybranego arkusza egzaminacyjnego."
+COM_TESTQUESTIONS_SET_MENU_ITEM_TITLE="Zestaw testowy"
+COM_TESTQUESTIONS_SET_MENU_ITEM_DESCRIPTION="Wyświetla test na podstawie wybranego zestawu pytań."
+COM_TESTQUESTIONS_SET_SELECT="Zestaw pytań"

components/com_testquestions/src/Model/SetModel.php

@@ -0,0 +1,73 @@
+<?php
+
+namespace Komponent\Component\Testquestions\Site\Model;
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Factory;
+use Joomla\CMS\MVC\Model\BaseDatabaseModel;
+
+class SetModel extends BaseDatabaseModel
+{
+    protected function getSetId(): int
+    {
+        $application = Factory::getApplication();
+        $menu = $application->getMenu()->getActive();
+        $menuSetId = $menu ? (int) $menu->getParams()->get('set_id', 0) : 0;
+
+        return $application->getInput()->getInt('set_id', $menuSetId);
+    }
+
+    public function getSet()
+    {
+        $db = Factory::getContainer()->get('DatabaseDriver');
+        $setId = $this->getSetId();
+
+        if ($setId < 1) {
+            return null;
+        }
+
+        return $db->setQuery(
+            $db->getQuery(true)
+                ->select(['s.*', 'sub.title AS subject_title'])
+                ->from($db->quoteName('#__testquestions_sets', 's'))
+                ->leftJoin($db->quoteName('#__testquestions_subjects', 'sub') . ' ON sub.id = s.subject_id')
+                ->where('s.id = ' . $setId)
+                ->where('s.published = 1')
+        )->loadObject();
+    }
+
+    public function getItems()
+    {
+        $db = Factory::getContainer()->get('DatabaseDriver');
+        $setId = $this->getSetId();
+
+        if ($setId < 1) {
+            return [];
+        }
+
+        return $db->setQuery(
+            $db->getQuery(true)
+                ->select(['q.id', 'q.question_type', 'q.question', 'q.answer_a', 'q.answer_b', 'q.answer_c', 'q.answer_d', 'q.answer_open', 'q.correct_answer', 'q.image'])
+                ->from($db->quoteName('#__testquestions_set_questions', 'sq'))
+                ->innerJoin($db->quoteName('#__testquestions_questions', 'q') . ' ON q.id = sq.question_id')
+                ->where('sq.set_id = ' . $setId)
+                ->where('q.published = 1')
+                ->order('sq.ordering ASC, q.id ASC')
+        )->loadObjectList();
+    }
+
+    public function getSets()
+    {
+        $db = Factory::getContainer()->get('DatabaseDriver');
+
+        return $db->setQuery(
+            $db->getQuery(true)
+                ->select(['s.id', 's.title', 'sub.title AS subject_title'])
+                ->from($db->quoteName('#__testquestions_sets', 's'))
+                ->leftJoin($db->quoteName('#__testquestions_subjects', 'sub') . ' ON sub.id = s.subject_id')
+                ->where('s.published = 1')
+                ->order('sub.title ASC, s.title ASC')
+        )->loadObjectList();
+    }
+}

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

@@ -0,0 +1,78 @@
+<?php
+
+namespace Komponent\Component\Testquestions\Site\View\Set;
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Factory;
+use Joomla\CMS\MVC\View\HtmlView as BaseHtmlView;
+
+class HtmlView extends BaseHtmlView
+{
+    protected $set;
+    protected $items;
+    protected $sets;
+    protected $results;
+    protected $started;
+
+    public function display($tpl = null)
+    {
+        $this->getDocument()->getWebAssetManager()->registerAndUseStyle(
+            'com_testquestions.exam',
+            'media/com_testquestions/egzamin.css'
+        );
+        $this->set = $this->get('Set');
+        $this->items = $this->get('Items');
+        $this->sets = $this->get('Sets');
+        $input = Factory::getApplication()->getInput();
+        $this->started = $input->getMethod() === 'POST'
+            && $input->post->getString('participant_name', '') !== ''
+            && $input->post->getInt('set_id', 0) > 0;
+        $this->results = $this->buildResults($this->items);
+
+        return parent::display($tpl);
+    }
+
+    protected function buildResults(array $items)
+    {
+        $input = Factory::getApplication()->getInput();
+
+        if ($input->getCmd('task') !== 'check' || $input->getMethod() !== 'POST') {
+            return null;
+        }
+
+        $answers = (array) $input->post->get('answers', [], 'array');
+        $results = [];
+        $correct = 0;
+
+        foreach ($items as $item) {
+            $selected = isset($answers[$item->id]) ? trim((string) $answers[$item->id]) : '';
+            $isCorrect = false;
+
+            if ($item->question_type === 'open') {
+                $patterns = preg_split('/\s*\|\s*/', (string) $item->answer_open, -1, PREG_SPLIT_NO_EMPTY);
+                foreach ($patterns as $pattern) {
+                    if (mb_strtolower(trim($pattern), 'UTF-8') === mb_strtolower($selected, 'UTF-8')) {
+                        $isCorrect = true;
+                        break;
+                    }
+                }
+            } else {
+                $isCorrect = (string) $item->correct_answer === $selected;
+            }
+
+            if ($isCorrect) {
+                $correct++;
+            }
+
+            $results[$item->id] = ['selected' => $selected, 'correct' => $isCorrect];
+        }
+
+        return [
+            'items' => $results,
+            'correct' => $correct,
+            'total' => count($items),
+            'percentage' => count($items) ? round(($correct / count($items)) * 100, 2) : 0,
+        ];
+    }
+}

components/com_testquestions/tmpl/set/default.php

@@ -0,0 +1,150 @@
+<?php
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Factory;
+?>
+<div class="com-testquestions egzamin">
+    <?php if (!$this->started) : ?>
+    <form action="<?php echo htmlspecialchars($_SERVER['REQUEST_URI'], ENT_QUOTES, 'UTF-8'); ?>" method="post" class="mb-4">
+        <label for="test-set" class="form-label"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_SELECT_SET'); ?></label>
+        <div class="input-group">
+            <select id="test-set" name="set_id" class="form-select egzamin" required>
+                <option value=""><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_SELECT_SET'); ?></option>
+                <?php foreach ($this->sets as $set) : ?>
+                    <option value="<?php echo (int) $set->id; ?>" <?php echo $this->set && (int) $this->set->id === (int) $set->id ? 'selected' : ''; ?>><?php echo htmlspecialchars(($set->subject_title ? $set->subject_title . ' — ' : '') . $set->title, ENT_QUOTES, 'UTF-8'); ?></option>
+                <?php endforeach; ?>
+            </select>
+        </div>
+        <div class="mt-3">
+            <label for="participant-name" class="form-label"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_PARTICIPANT_NAME'); ?></label>
+            <input type="text" id="participant-name" name="participant_name" class="form-control" required>
+        </div>
+        <div class="mt-3">
+            <label for="extra-time" class="form-label"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_EXTRA_TIME'); ?></label>
+            <select id="extra-time" name="extra_time" class="form-select" >
+                <option value="0">0 min</option>
+                <option value="5">5 min</option>
+                <option value="10">10 min</option>
+                <option value="15">15 min</option>
+                <option value="30">30 min</option>
+            </select>
+        </div>
+        <input type="submit" class="egzamin" value="<?php echo htmlspecialchars(\Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_START_TEST'), ENT_QUOTES, 'UTF-8'); ?>">
+    </form>
+    <?php endif; ?>
+    <?php if (!$this->started) : ?>
+        <?php if (!$this->set && $this->sets) : ?><div class="alert alert-info"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_SET_START_HINT'); ?></div><?php endif; ?>
+    <?php elseif (!$this->set) : ?>
+        <div class="alert alert-info"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_SET_NOT_FOUND'); ?></div>
+    <?php else : ?>
+        <header class="test-set-header">
+            <?php if ($this->set->subject_title) : ?><div class="text-muted"><?php echo htmlspecialchars($this->set->subject_title, ENT_QUOTES, 'UTF-8'); ?></div><?php endif; ?>
+            <h1><?php echo htmlspecialchars($this->set->title, ENT_QUOTES, 'UTF-8'); ?></h1>
+            <?php $extraTime = Factory::getApplication()->getInput()->post->getInt('extra_time', 0); ?>
+            <?php if ((int) $this->set->duration > 0) : ?><div class="small text-muted"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_SET_DURATION'); ?>: <?php echo (int) $this->set->duration + $extraTime; ?> min</div><?php endif; ?>
+            <?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" 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>
+                    <?php if ($item->image) : ?><div class="foto_pyt"><img src="<?php echo htmlspecialchars($item->image, ENT_QUOTES, 'UTF-8'); ?>" alt="" loading="lazy"></div><?php endif; ?>
+                    <?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_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>
+                                <input type="text" id="set-answer-<?php echo (int) $number; ?>" name="answers[<?php echo (int) $item->id; ?>]" class="form-control">
+                            <?php endif; ?>
+                        </div>
+                    <?php else : ?>
+                        <ol type="A" class="answer-list">
+                        <?php foreach (['answer_a', 'answer_b', 'answer_c', 'answer_d'] as $answerIndex => $answerField) : ?>
+                            <?php $isSelected = $this->results && $this->results['items'][$item->id]['selected'] === (string) ($answerIndex + 1); ?>
+                            <?php $isCorrectAnswer = $this->results && (string) $item->correct_answer === (string) ($answerIndex + 1); ?>
+                            <li class="<?php echo $isSelected && $this->results['items'][$item->id]['correct'] ? 'odpup' : ($isSelected ? 'odpu' : ($isCorrectAnswer ? 'odpp' : 'odp')); ?>">
+                                <label><input type="radio" name="answers[<?php echo (int) $item->id; ?>]" value="<?php echo $answerIndex + 1; ?>" <?php echo $isSelected ? 'checked' : ''; ?>><strong><?php echo chr(65 + $answerIndex); ?>.</strong> <span class="answer-text"><?php echo $item->$answerField; ?></span></label>
+                            </li>
+                        <?php endforeach; ?>
+                        </ol>
+                    <?php endif; ?>
+                    <?php if ($this->results) : ?>
+                        <div class="mt-2 <?php echo $this->results['items'][$item->id]['correct'] ? 'text-success' : 'text-danger'; ?>">
+                            <?php echo $this->results['items'][$item->id]['correct'] ? '✓ ' . \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_ANSWER_CORRECT') : '✗ ' . \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_ANSWER_INCORRECT'); ?>
+                            <?php if ($item->question_type === 'closed') : ?> — <?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_CORRECT_ANSWER'); ?>: <?php echo chr(64 + (int) $item->correct_answer); ?><?php else : ?> — <?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_CORRECT_PATTERN'); ?>: <?php echo htmlspecialchars($item->answer_open, ENT_QUOTES, 'UTF-8'); ?><?php endif; ?>
+                        </div>
+                    <?php endif; ?>
+                </article>
+            <?php endforeach; ?>
+                <input type="hidden" name="set_id" value="<?php echo (int) $this->set->id; ?>">
+                <input type="hidden" name="participant_name" value="<?php echo htmlspecialchars(Factory::getApplication()->getInput()->post->getString('participant_name', ''), ENT_QUOTES, 'UTF-8'); ?>">
+                <input type="hidden" name="extra_time" value="<?php echo (int) $extraTime; ?>">
+                <input type="hidden" name="task" value="check">
+                <?php echo \Joomla\CMS\HTML\HTMLHelper::_('form.token'); ?>
+                <?php if (!$this->results) : ?>
+                    <input type="submit" class="egzamin" value="<?php echo htmlspecialchars(\Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_FINISH_TEST'), ENT_QUOTES, 'UTF-8'); ?>">
+                <?php endif; ?>
+            </form>
+        <?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;
+        text.textContent = String(minutes).padStart(2, '0') + ':' + String(seconds).padStart(2, '0');
+        ring.style.strokeDashoffset = circumference * (1 - remaining / total);
+
+        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; ?>

components/com_testquestions/tmpl/set/default.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<metadata>
+    <layout title="COM_TESTQUESTIONS_SET_MENU_ITEM_TITLE">
+        <message>COM_TESTQUESTIONS_SET_MENU_ITEM_DESCRIPTION</message>
+    </layout>
+    <fields name="request">
+        <fieldset name="request">
+            <field name="set_id" type="sql" label="COM_TESTQUESTIONS_SET_SELECT" required="true"
+                query="SELECT id AS value, title AS text FROM #__testquestions_sets WHERE published = 1 ORDER BY title"
+                key_field="value" value_field="text" />
+        </fieldset>
+    </fields>
+</metadata>