Vlčí a světýlkové odborky
Skautský plugin pro evidenci plnění vlčků a světýlek
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/outly-jan/vlcci-svetylka/archive/refs/heads/claude%2Fskautchlumec-wordpress-plugin-mcvbsz.zipWordPress plugin pro evidenci plnění skautských odborek vlčat a světlušek.
Vyvinutý pro Středisko Chlumec nad Cidlinou.
Co plugin umí
Každý člen oddílu (vlče nebo světluška) může plnit libovolné odborky. Každá odborka má 10 úkolů a ke splnění je potřeba zvládnout alespoň 8 z nich. Plugin vedoucím umožňuje:
- zadávat datum a vedoucího ke každému splněnému úkolu
- hromadně vyplnit více úkolů najednou jedním datem
- přidělit celou odborku bez zadávání dat (pro odborky splněné před zavedením aplikace)
- přehledně sledovat postup každého člena napříč odbourkami
- zjistit, kteří členové mají daný úkol nesplněný (praktické při plánování výprav)
Záložky aplikace
| Záložka | Popis |
|---|---|
| 🏠 Přehled | Přehled členů ve tvé šestce / roji a jejich postup v odborkách |
| ✏️ Plnění | Zadávání splněných úkolů pro konkrétního člena a odborku |
| 👤 Po jménech | Přehled všech členů — jaké odborky kdo plní a jak daleko je |
| 🏅 Po odborkách | Přehled odborek — kteří členové je plní; drill-down na konkrétní úkol a seznam těch, komu chybí |
| 📋 Úkoly | Katalog všech odborek a jejich úkolů (přehled bez plnění) |
| 🧑🤝🧑 Správa členů | Správa seznamu členů ve šestce / roji (přidání, úprava, deaktivace, smazání) |
| ❓ Nápověda | Uživatelský manuál |
Záložky Oddíly a Filtr jsou dostupné pouze administrátorům.
Přístup
Plugin je přístupný pouze přihlášeným uživatelům s rolí vedouc_vlat_a_svtluek nebo administrator. Každý vedoucí vidí pouze šestky / roje, ke kterým je přiřazen v administraci.
Instalace
- Nahraj složku
vlcci-svetylkadowp-content/plugins/. - Aktivuj plugin v administraci WordPressu.
- Vlož shortcode
[vlcci_app]na stránku, kde má aplikace běžet. - V administraci pluginu (menu Vlčí odborky) nastav oddíly, šestky a přiřaď vedoucí.
Shortcodes
[vlcci_app]
Hlavní aplikace pro vedoucí. Zobrazí navigaci se všemi záložkami.
[vlcci_prehled]
Veřejný přehled postup členů (zobrazuje pouze přezdívky, bez jmen). Vhodný pro zveřejnění na webu oddílu.
| Parametr | Výchozí | Popis |
|---|---|---|
oddil_id |
0 (vše) |
Omezí výpis na konkrétní oddíl |
Databázové tabulky
Plugin vytváří tyto tabulky (prefix vo_):
| Tabulka | Obsah |
|---|---|
vo_oddily |
Oddíly (vlčata / světlušky) |
vo_sestky |
Šestky a roje |
vo_vedouci |
Přiřazení vedoucích k šestkám |
vo_deti |
Členové (jméno, příjmení, přezdívka) |
vo_odborky |
Definice odborek |
vo_ukoly |
Úkoly odborek (10 na odborku) |
vo_plneni |
Záznamy o splnění úkolů (datum, vedoucí, poznámka) |
Odborky a jejich úkoly se předvyplní automaticky při aktivaci pluginu. Minimální počet úkolů pro splnění odborky: 8 z 10.
Struktura repozitáře
Repozitář obsahuje dva samostatné WordPress pluginy:
vlcci-svetylka/
├── vlcci-odborky.php # Hlavní soubor pluginu Vlčí a světýlkové odborky
├── deploy-webhook.php # Deploy skript (token nastavit ručně na serveru)
├── images/ # Obrázky odznaků odborek
└── skautska-burza/ # Plugin Skautská burza (viz skautska-burza/README.md)Deploy
Po každém mergi do větve main se automaticky spustí GitHub Actions workflow, který zavolá deploy webhook na serveru:
https://skautchlumec.cz/wp-content/plugins/vlcci-svetylka/deploy-webhook.php?token=TOKENWebhook stáhne z GitHubu:
- aktuální
vlcci-odborky.phpa soubory zimages/(plugin Vlčí a světýlkové odborky, do vlastní složky), - všechny soubory ze složky
skautska-burza/— podle aktuálního obsahu repa, ne podle natvrdo psaného seznamu — a uloží je do sousední složkywp-content/plugins/skautska-burza/.
Pozor:
deploy-webhook.phpna serveru obsahuje tajný token — neupravuj ho přes git, jinak se přepíše naCHANGE_ME. Webhook sám sebe nikdy nestahuje, takže po každé změně jeho kódu (např. teď, kvůli přidání burzy) je potřeba novýdeploy-webhook.phpručně nahrát na server přes FTP — samotný merge domainto nepropíše.