Vaikų Kelias - Edukacijos Platforma

Pilnai funkcinė WordPress LMS platforma skirta lietuvių kalbos mokymuisi. Sistema sujungia registracijas, grupių valdymą, pamokas ir tvarkaraščius.

🎯 Pagrindinės Funkcijos

1. Registracijos Sistema

• 6 žingsnių registracijos forma
• Vaiko informacija (vardas, gimimo data, klasė)
• Tėvų kontaktai ir santykis
• Lietuvių kalbos lygis
• Pamokų tipo ir dažnumo pasirinkimas
• Papildoma informacija ir sutartymas sutikimas
• AJAX form submission su HTML email pranešimu admin

2. Admin Panel (wp-admin)

Meniu:

• Registracijos - Laukiančių registracijų valdymas
• Mokiniai - Student priskyrimas grupėms
• Mokytojai - Mokytojų kūrimas ir grupių priskyrimas
• Grupės - Grupių CRUD
• Pamokos - Pamokas su TinyMCE editor ir publikavimo workflow
• Tvarkaraštis - Savaitės tvarkaraščio valdymas su Zoom linkomis
• Nustatymai - Būsimi nustatymai

Darbo Srautas:

1. Administrator priima registracijas Registracijos skiltyje
2. Sistema automatiškai sukuria WP vartotoją su vk_student role
3. Administrator priskiria studentą grupei Mokiniai skiltyje
4. Studentas pamatys priskirtas grupes, pamokos ir tvarkaraščius savo dashboard

3. Mokinių Dashboard ([vk_dashboard])

• Mano grupė - Priskirtos grupės info
• Pamokos - Pamokas su modal viewer (TinyMCE HTML content)
• Tvarkaraštis - Savaitės tvarkaraščio su Zoom linkais

4. Mokytojų Dashboard

• Mano grupės - Priskirtos grupės sąrašas
• Mano pamokos - Sukurtos pamokas su status (draft/published)
• Tvarkaraštis - Tik savo grupių tvarkaraščis

5. Admin Dashboard (priešais vk_admin role)

• Laukiančios registracijos su approve/reject mygtukai
• Ypatumų kartojimas dėl studijų ir mokytojų

📦 Instalacija

Reikalavimai

• WordPress 6.0+
• PHP 7.4+
• MySQL 5.7+

Instalacijos Žingsniai

1. Kopijuoti pluginą

   cp -r vaikukelias-platform /path/to/wordpress/wp-content/plugins/

2. Aktyvuoti WP Pluginų skiltyje

   • Eiti į WP Admin → Plugins
   • Rasti "Vaikų kelias platforma"
   • Spausti "Activate"

3. Matyti Registracijos Puslapį

   • Sukurti naują puslapį
   • Perrašyti [vaikukelias_registration] shortcode
   • Publikuoti

4. Matyti Dashboard

   • Sukurti naują puslapį
   • Perrašyti [vk_dashboard] shortcode
   • Publikuoti ir pasidalinti URL

🔑 Rolės ir Leidimai

• Administrator - Pilna WP admin prieiga, gali valdyti visą sistemą
• vk_admin - Dashboard admin role, nuo WP admin
• vk_teacher - Mokytojo rolė, turi matyti savo grupes ir pamokas
• vk_student - Studento rolė, mato tik savo grupes ir pamokos

Saugumo Nustatymai

• Non-administrators are blocked from accessing wp-admin - nukreipiani į /dashboard
• Visii AJAX requests naudoja nonce verification
• Formulės fields sanitizuojami HTML injection apsaugai
• Database queries uses prepared statements SQL injection apsaugai

📊 Duomenų Bazė

Pluginas kuria 5 lenteleles:

wp_vk_registrations     - Registracijos (pending/approved status)
wp_vk_groups            - Mokymo grupės
wp_vk_lessons           - Pamokas (su TinyMCE turiniu)
wp_vk_schedule          - Savaitės tvarkaraščio
wp_vk_student_groups    - M:N relationship tarp studentų ir grupių

🎨 Spalvu Schema

Platforma naudoja 4 spalvų temą:

• Rožava (#E84C7F) - Primary buttons ir focus states
• Žalia (#41AD4A) - Success/published states
• Geltona (#FFD700) - Warning/draft states
• Mėlyna (#0099D8) - Info/schedule elements

🔧 Konfiguracija

Registracijos Puslepio Timezonės

Form.php - Keisti hardcoded timezone listas:

'timezone' => [
    'Europe/Vilnius',
    'Europe/London',
    // ...
]

Pamokai Redaktuoti

Lessons.php - TinyMCE configuration:

wp_editor($lesson->content, 'lesson_content', [
    'teeny' => false,
    'media_buttons' => true,
    'wpautop' => true
]);

📱 Responsive Design

• Desktop (1024px+) - 2-column layout su sidebar
• Tablet (768px-1023px) - 1-column layout su collapsible sidebar
• Mobile (<768px) - Full width su stacked navigation

🐛 Troubleshooting

Registracijos Forma Neparodo

• Patikrinti ar [vaikukelias_registration] shortcode yra puslapyje
• Patikrinti browser console dėl JS errors
• Patikrinti ar jQuery yra enqueued

Dashboard Neprasninga Pasirodę

• Patikrinti ar [vk_dashboard] shortcode yra teisingame puslapyje
• Patikrinti ar vartotojas yra logged in
• Patikrinti browser console dėl AJAX errors

Email Nesiuncią

• Patikrinti ar WP mail function veikia (test plugin)
• Patikrinti server logs dėl SMTP errors
• Nustatyti SMTP plugin (WP Mail SMTP arba panašus)

Students Nematei Pamokas

• Patikrinti admin Mokiniai skiltyje ar studentas priskirtas grupei
• Patikrinti ar grupei priskirta pamoka ir pamokas published
• Patikrinti student_id vs group_id connection

📝 Plėtojimas Ateityje

• [ ] Notifications sistema (email/SMS bei in-app)
• [ ] Pamokas responses/submissions nuo studentų
• [ ] Grading system
• [ ] Progress tracking dashboard
• [ ] Peer interactions (forums, comments)
• [ ] File uploads student submissions-ams

📄 Licencija

Closed source - For educational purposes

👨‍💻 Palaikymas

Jei turite klausimas arba radote bugą, prašome pranešti.

Versija: 1.13
Paskutinis Update: 2024
Author: Vaikų kelias