Przejdź do zawartości

Sprawności: Różnice pomiędzy wersjami

Z OpenGeoWiki
Sprawności - init
 
m Poprawa stylistyki, gramatyki, dodanie info o osobach zajmujących się sprawnościami.
 
(Nie pokazano 4 wersji utworzonych przez 2 użytkowników)
Linia 1: Linia 1:
{{Do edycji}}
Celem powstania Sprawności było danie kolejnego impulsu naszej zabawie do rozwoju poprzez proponowanie nowych wyzwań użytkownikom. Wyzwań związanych ze zdobywaniem sprawności czy też pięciem się po szczeblach kolejnych poziomów. Dla wzmocnienia efektu wprowadzony został też element rywalizacji, w postaci tabeli znajdującej się na stronie każdej sprawności, w której użytkownik może sprawdzić jak radzi sobie na tle innych użytkowników z daną sprawnością.


1. Wstęp
System sprawności w serwisie Opencaching.pl został wprowadzony przez '''TriPPera''' 27 kwietnia 2017 roku. Od września 2026 roku za jego rozwój i utrzymanie odpowiada '''Bartek111'''.
- Zamiast medali, zaproponowałem pojęcie Sprawności
(medale wydały mi się zbyt napuszone, sprawności zaś kojarzą się z harcerstwem, więc moim zdaniem są bliższe naszej zabawie)


- Poniżej, często używane jest pojęcie Silnika Sprawności (w skrócie silnik). Pod tym pojęciem, rozumiem rozwiązanie programistyczne mające zapewnić obsługę nowej funkcjonalności: Sprawności. Opis możliwości silnika, znajdziecie poniżej w rozdziale 3.
== Funkcjonalność z perspektywy użytkownika ==


- celem powstania Sprawności było danie kolejnego impulsu naszej zabawie do rozwoju poprzez proponowanie kolejnych wyzwań użytkownikom. Wyzwań związanych ze zdobywaniem kolejnych sprawności czy też pięciem się po szczeblach kolejnych poziomów poszczególnych sprawności. Dla wzmocnienia efektu wprowadzony został też element rywalizacji, w postaci tabeli znajdującej się na stronie każdej sprawności, w której użytkownik może sprawdzić jak radzą sobie inni użytkownicy z daną sprawnością.
=== Strona "Moje statystyki" ===
* na stronie "Moje statystyki" znajduje się sekcja Sprawności, a w niej ikonki zdobytych przez użytkownika sprawności
* tuż pod ikonkami znajduje się link: [Pokaż szczegóły zdobytych sprawności ...] prowadzący do strony, z dużymi ikonami sprawności, z podziałem na kategorie
* po najechaniu myszką na ikonkę, pojawia się, na dymku, informacja na temat danej sprawności
* ikonki otoczone są obwódką, jej kolor grubość oraz postęp zależy od tego na jakim etapie znajduje się zdobywanie danej sprawności
* ikonki wyświetlają się w stałej kolejności
* jeżeli użytkownik nie rozpoczął jeszcze zdobywania danej sprawności, jej ikonka nie będzie się wyświetlała
* ikonki mogą wyświetlać się w odcieniach szarości. Oznacza to, że zdobywca jest na pierwszym progu


=== Strona "Szczegóły Zdobytych Sprawności" ===
* użytkownikowi wyświetlają się jedynie te kategorie do których należy przynajmniej jedna zdobyta przez użytkownika sprawność
* kolejność kategorii jest stała
* nad ikonami sprawności znajdują się informacje o aktualnym poziomie (nazwy poziomów opisano w sekcji „Silnik”) oraz o postępie do kolejnego poziomu, wraz z informacją, ile punktów brakuje do osiągnięcia wymaganego progu
* pod ikoną znajduje się nazwa sprawności oraz informacja o liczbie skrzynek, które należy jeszcze zalogować, aby zdobyć kolejny poziom
* ikony sprawności otoczone są „obwódką – progresem” w odpowiednim kolorze i o odpowiedniej grubości (im wyższy poziom tym obwódka grubsza)
* po kliknięciu na nazwę sprawności, wchodzimy na stronę danej sprawności


=== Strona "Sprawności" ===
Strona składa się z czterech części
* ikona oraz podstawowe informacje dotyczące sprawności
* miejsce przeznaczone na informacje o sprawności, np. zasady jej zdobywania. Jeśli sprawność jest związana z konkretnym regionem, może się tam również znaleźć krótka informacja promująca dany region. W tej sekcji mogą być także prezentowane dane pobierane z bazy danych. W przypadku sprawności wojewódzkich umieszczone zostały informacje o liczbie aktywnych skrzynek, topowych skrzynkach oraz skrzynkach tygodnia.
* statystyki związane z daną sprawnością, podzielone na dwie tabele:
** tabela po lewej stronie zawiera listę poszczególnych poziomów sprawności. Przy każdym poziomie wyświetlana jest liczba osób, które go zdobyły („Licznik zdobyć”) oraz data ostatniego zdobycia. Poziom aktualnie osiągnięty przez użytkownika jest wyróżniony szarym kolorem.
** po kliknięciu na dany poziom, tabela z prawej strony wyświetli listę użytkowników, którzy go zdobyli
* informacja o autorze grafiki, opisu oraz kto opiekuje się sprawnością


2. Opis kolejnych stron - funkcjonalność z perspektywy użytkownika
== Silnik Sprawności ==
 
* '''Konfiguracja z poziomu bazy danych''' – kategorie i sprawności konfiguruje się bezpośrednio w bazie danych. Dodanie nowej kategorii lub sprawności nie wymaga modyfikacji kodu.
2.1 Strona: „Moje Statystyki”
* '''Kategorie sprawności''' – sprawności są podzielone na kategorie, których liczba jest dowolna. Nazwy kategorii można zmieniać w dowolnym momencie.
 
* '''Definicje sprawności''' – w ramach każdej kategorii można zdefiniować dowolną liczbę sprawności. Parametry każdej sprawności można zmieniać w dowolnym momencie.
- na stronie: "Moje statystyki" pojawiła się nowa sekcja: Sprawności. W niej znajdują się miniaturki zdobytych przez użytkownika sprawności.
* '''Grafika sprawności''' – każda sprawność musi mieć przypisaną grafikę (ikonę), która stanowi jej reprezentację wizualną.
 
* '''Poziomy sprawności''' – każda sprawność może mieć dowolną liczbę poziomów. Każdemu poziomowi można przypisać własną nazwę, którą można zmieniać w dowolnym momencie.
- tuż pod miniaturkami znajduje się link: [Pokaż szczegóły zdobytych sprawności ...] prowadzący do strony, z dużymi ikonami sprawności, z podziałem na kategorie
* '''Progi poziomów''' – dla każdego poziomu definiuje się próg wymagany do osiągnięcia kolejnego poziomu.
 
* '''Grafika poziomu''' – każdy poziom może mieć własną grafikę. Jeśli ją zdefiniowano, jest ona wyświetlana zamiast grafiki przypisanej do całej sprawności.  
- po najechaniu myszką na miniaturę, na dymku pojawia się informacja na temat danej sprawności
* '''Kolory poziomów''' – każdy poziom ma przypisany kolor w ramach danej sprawności. Obecnie przewidziano 10 kolorów. Ich wygląd można zobaczyć między innymi w tabeli poziomów po lewej stronie na stronie „Sprawność”.   
 
* '''Obsługa różnej liczby poziomów''' – poszczególne sprawności mogą mieć różną liczbę poziomów, np. 3 lub 20. Silnik sprawności zapewnia spójną kolejność kolorów niezależnie od liczby poziomów. Jeśli poziomów jest więcej niż dostępnych kolorów, kolory powtarzają się, również na sąsiednich poziomach. Kolor stanowi dodatkową wskazówkę wizualną informującą użytkownika o aktualnym poziomie sprawności.
- miniaturki otoczone są obwódką, jej kolor grubość oraz postęp zależy od tego na jakim etapie znajduje się zdobywanie danej sprawność
* '''Obwódki postępu''' – wokół ikon sprawności wyświetlane są obwódki obrazujące postęp do kolejnego poziomu. Im bliżej użytkownik znajduje się progu wymaganego do awansu, tym bardziej obwódka się zamyka.
 
* '''Kolor i grubość obwódki''' – kolor obwódki wskazuje poziom sprawności, natomiast jej grubość zwiększa się wraz z osiąganiem kolejnych poziomów.
- miniaturki wyświetlają się w stałej kolejności
* '''Zapamiętywanie progu kolejnego poziomu''' – w momencie zdobycia kolejnego poziomu zapisywana jest wartość progu wymaganego do osiągnięcia następnego poziomu. Dzięki temu późniejsza zmiana progu w definicji sprawności nie wpływa na wymaganie, które zostało już zapisane dla użytkownika. Przykład: jeśli próg wymagany do osiągnięcia 6. poziomu wynosi 320, a następnie zostanie zmieniony na 400, użytkownik, dla którego wcześniej zapisano próg 320, nadal dąży do osiągnięcia wartości 320. Rozwiązanie to zapobiega tzw. '''problemowi króliczka''' – sytuacji, w której użytkownik jest blisko osiągnięcia kolejnego poziomu, ale zmiana progu nagle oddala go od celu. Takie zachowanie mogłoby prowadzić do frustracji i obniżenia motywacji użytkownika.
 
[[Kategoria:Słownik]]
- jeżeli użytkownik nie rozpoczął jeszcze zdobywanie danej sprawności, jej miniaturka nie będzie się wyświetlała
[[Kategoria:Opencaching PL]]
 
- miniaturki mogą wyświetlać się w szarościach. Oznacza to, że zdobywca jest na pierwszym progu
 
 
 
2.2 Strona: Szczegóły Zdobytych Sprawności
 
- na stronie znajdują się 3 kategorie. Użytkownikowi wyświetlają się jedynie te kategorie do których należy przynajmniej jedna zdobyta przez użytkownika sprawność. Reszta kategorii pomimo, że jest zdefiniowana, nie zostanie wyświetlona.
 
- kolejność kategorii jest stała
 
- nad ikonami sprawności znajduje się informacje o:  poziomie (więcej o nazwach poziomów w sekcji silnik) i „postępie/ile wynosi próg następnego poziomu”
 
- pod ikoną jest nazwa sprawności oraz jaki jest następny cel
 
- ikony sprawności otoczone są „obwódką – progresem” w odpowiednim kolorze i o odpowiedniej grubości (im wyższy poziom tym obwódka grubsza)
 
- po kliknięciu na nazwę sprawności, wchodzimy na stronę danej sprawności
 
 
 
2.3 Strona: Szczegóły Zdobytych Sprawności
 
- strona składa się z trzech części
 
- w pierwszej części znajdują się: ikona oraz podstawowe informacje dotyczące sprawności
 
- w drugiej części znajduje się miejsce na informację na temat sprawności (np. zasady zdobywania, jeżeli zaś sprawność związana jest z regionem, może się tam znaleźć także krótka informacja promująca dany region). Tutaj też mogą się znaleźć dane wyciągnięte z bazy danych. W przypadku sprawności wojewódzkich, umieściłem: liczbę aktywnych skrzynek, topowe skrzynki oraz skrzynki tygodnia
 
- w trzecią część przewidziałem na statystyki związane z daną sprawności. Znajdują  się tam dwie tabele.
 
- po lewej stronie jest tabela z poszczególnymi poziomami, wraz z informacją przez ile osób dany poziom został już zdobyty (Licznik zdobyć) wraz z ostatnią datą zdobycia. Poziom na którym znajduje się użytkownik, został wyróżniony kolorem.
 
- po kliknięciu na dany poziom, po prawej stronie w tabeli pojawi się tabela z użytkownikami którzy zdobyli dany poziom; pozycja użytkownika została wyróżniona kolorem
 
 
3. Silnik Sprawności
 
- kolejne kategorie i sprawności konfiguruje się z poziomu bazy. Aby dodać nową sprawność (czy też kategorię) nie trzeba modyfikować kodu.
 
- sprawności podzielone są na kategorie. Może być dowolna ilość kategorii. Ich nazwy można zmieniać w dowolnym momencie
 
- w ramach danej kategorii można zdefiniować dowolną liczbę sprawności. Ich parametry można zmieniać w dowolnym momencie
 
- do sprawności należy przypisać grafikę (ikonę), tak aby miała swoją reprezentację graficzną
 
- każda ze sprawności może mieć dowolną liczbę poziomów, każdy z poziomów może mieć własną nazwę. Nazwę poziomu można zmienić w dowolnym momencie.
 
- każdemu z poziomów definiuje się próg, po którym następuje przeskoczenie na następny poziom
 
- każdy z poziomów może mieć własną grafikę. Jeżeli tak jest, to wtedy ta grafika jest wyświetlana na danym poziomie, zamiast grafiki przypisanej do sprawności.  
 
- każdy z poziomów ma własny kolor w kontekście danej sprawności. Obecnie zostało zaproponowanych 10 kolorów. Jak wyglądają, można między innymi zobaczyć w tabeli poziomów (po lewej na stronie „Sprawność”).  Ich liczba i wygląd może ulec jeszcze zmianie.
 
- tak jak wspomniałem liczba poziomów może być różna dla każdej ze sprawności. Mogą się pojawić sprawności z 3 poziomami, a mogą i takie które będą miały ich przykładowo 20. Silnik zadba o to aby, odpowiednio zarządzać kolorami w ten sposób aby ich kolejność zawsze była taka sama, bez względu na liczbę poziomów (w przypadku 20 poziomów, siłą rzeczy kolory mogą się powtarzać dla sąsiednich poziomów). Kolor ma być jedną z informacji dla użytkownika na jakim się poziomie się znajduje dana sprawność
 
- wokół ikon sprawności rysowane są obwódki postępu. Im bliżej użytkownik jest przeskoczenia na następny poziom, tym bardziej obwódka się zamyka.
 
- kolor oraz grubość obwódki świadczą o tym na jakim poziomie znajduje się dana sprawność (im grubsza obwódka tym wyższy poziom)
 
- wraz ze zdobyciem następnego poziomu, odkładana jest informacja ile wynosi następny próg bieżącego poziomu. Oznacza to, że nawet jeśli zmienimy wysokość progu w definicji sprawności to nie przekłada się to na na próg widoczny przez użytkownika. Innymi słowy, jeżeli próg przeskoczenia na 6 poziom wynosi 320, a my zmieniamy go na 400, to użytkownik pomimo tego nadal dąży do 320 (tzw problem króliczka, którego już prawie mamy, a on nam ucieka – to może nieźle sfrustrować użytkownika)

Aktualna wersja z 27 paź 2026, 08:05

Celem powstania Sprawności było danie kolejnego impulsu naszej zabawie do rozwoju poprzez proponowanie nowych wyzwań użytkownikom. Wyzwań związanych ze zdobywaniem sprawności czy też pięciem się po szczeblach kolejnych poziomów. Dla wzmocnienia efektu wprowadzony został też element rywalizacji, w postaci tabeli znajdującej się na stronie każdej sprawności, w której użytkownik może sprawdzić jak radzi sobie na tle innych użytkowników z daną sprawnością.

System sprawności w serwisie Opencaching.pl został wprowadzony przez TriPPera 27 kwietnia 2017 roku. Od września 2026 roku za jego rozwój i utrzymanie odpowiada Bartek111.

Funkcjonalność z perspektywy użytkownika

Strona "Moje statystyki"

  • na stronie "Moje statystyki" znajduje się sekcja Sprawności, a w niej ikonki zdobytych przez użytkownika sprawności
  • tuż pod ikonkami znajduje się link: [Pokaż szczegóły zdobytych sprawności ...] prowadzący do strony, z dużymi ikonami sprawności, z podziałem na kategorie
  • po najechaniu myszką na ikonkę, pojawia się, na dymku, informacja na temat danej sprawności
  • ikonki otoczone są obwódką, jej kolor grubość oraz postęp zależy od tego na jakim etapie znajduje się zdobywanie danej sprawności
  • ikonki wyświetlają się w stałej kolejności
  • jeżeli użytkownik nie rozpoczął jeszcze zdobywania danej sprawności, jej ikonka nie będzie się wyświetlała
  • ikonki mogą wyświetlać się w odcieniach szarości. Oznacza to, że zdobywca jest na pierwszym progu

Strona "Szczegóły Zdobytych Sprawności"

  • użytkownikowi wyświetlają się jedynie te kategorie do których należy przynajmniej jedna zdobyta przez użytkownika sprawność
  • kolejność kategorii jest stała
  • nad ikonami sprawności znajdują się informacje o aktualnym poziomie (nazwy poziomów opisano w sekcji „Silnik”) oraz o postępie do kolejnego poziomu, wraz z informacją, ile punktów brakuje do osiągnięcia wymaganego progu
  • pod ikoną znajduje się nazwa sprawności oraz informacja o liczbie skrzynek, które należy jeszcze zalogować, aby zdobyć kolejny poziom
  • ikony sprawności otoczone są „obwódką – progresem” w odpowiednim kolorze i o odpowiedniej grubości (im wyższy poziom tym obwódka grubsza)
  • po kliknięciu na nazwę sprawności, wchodzimy na stronę danej sprawności

Strona "Sprawności"

Strona składa się z czterech części

  • ikona oraz podstawowe informacje dotyczące sprawności
  • miejsce przeznaczone na informacje o sprawności, np. zasady jej zdobywania. Jeśli sprawność jest związana z konkretnym regionem, może się tam również znaleźć krótka informacja promująca dany region. W tej sekcji mogą być także prezentowane dane pobierane z bazy danych. W przypadku sprawności wojewódzkich umieszczone zostały informacje o liczbie aktywnych skrzynek, topowych skrzynkach oraz skrzynkach tygodnia.
  • statystyki związane z daną sprawnością, podzielone na dwie tabele:
    • tabela po lewej stronie zawiera listę poszczególnych poziomów sprawności. Przy każdym poziomie wyświetlana jest liczba osób, które go zdobyły („Licznik zdobyć”) oraz data ostatniego zdobycia. Poziom aktualnie osiągnięty przez użytkownika jest wyróżniony szarym kolorem.
    • po kliknięciu na dany poziom, tabela z prawej strony wyświetli listę użytkowników, którzy go zdobyli
  • informacja o autorze grafiki, opisu oraz kto opiekuje się sprawnością

Silnik Sprawności

  • Konfiguracja z poziomu bazy danych – kategorie i sprawności konfiguruje się bezpośrednio w bazie danych. Dodanie nowej kategorii lub sprawności nie wymaga modyfikacji kodu.
  • Kategorie sprawności – sprawności są podzielone na kategorie, których liczba jest dowolna. Nazwy kategorii można zmieniać w dowolnym momencie.
  • Definicje sprawności – w ramach każdej kategorii można zdefiniować dowolną liczbę sprawności. Parametry każdej sprawności można zmieniać w dowolnym momencie.
  • Grafika sprawności – każda sprawność musi mieć przypisaną grafikę (ikonę), która stanowi jej reprezentację wizualną.
  • Poziomy sprawności – każda sprawność może mieć dowolną liczbę poziomów. Każdemu poziomowi można przypisać własną nazwę, którą można zmieniać w dowolnym momencie.
  • Progi poziomów – dla każdego poziomu definiuje się próg wymagany do osiągnięcia kolejnego poziomu.
  • Grafika poziomu – każdy poziom może mieć własną grafikę. Jeśli ją zdefiniowano, jest ona wyświetlana zamiast grafiki przypisanej do całej sprawności.
  • Kolory poziomów – każdy poziom ma przypisany kolor w ramach danej sprawności. Obecnie przewidziano 10 kolorów. Ich wygląd można zobaczyć między innymi w tabeli poziomów po lewej stronie na stronie „Sprawność”.
  • Obsługa różnej liczby poziomów – poszczególne sprawności mogą mieć różną liczbę poziomów, np. 3 lub 20. Silnik sprawności zapewnia spójną kolejność kolorów niezależnie od liczby poziomów. Jeśli poziomów jest więcej niż dostępnych kolorów, kolory powtarzają się, również na sąsiednich poziomach. Kolor stanowi dodatkową wskazówkę wizualną informującą użytkownika o aktualnym poziomie sprawności.
  • Obwódki postępu – wokół ikon sprawności wyświetlane są obwódki obrazujące postęp do kolejnego poziomu. Im bliżej użytkownik znajduje się progu wymaganego do awansu, tym bardziej obwódka się zamyka.
  • Kolor i grubość obwódki – kolor obwódki wskazuje poziom sprawności, natomiast jej grubość zwiększa się wraz z osiąganiem kolejnych poziomów.
  • Zapamiętywanie progu kolejnego poziomu – w momencie zdobycia kolejnego poziomu zapisywana jest wartość progu wymaganego do osiągnięcia następnego poziomu. Dzięki temu późniejsza zmiana progu w definicji sprawności nie wpływa na wymaganie, które zostało już zapisane dla użytkownika. Przykład: jeśli próg wymagany do osiągnięcia 6. poziomu wynosi 320, a następnie zostanie zmieniony na 400, użytkownik, dla którego wcześniej zapisano próg 320, nadal dąży do osiągnięcia wartości 320. Rozwiązanie to zapobiega tzw. problemowi króliczka – sytuacji, w której użytkownik jest blisko osiągnięcia kolejnego poziomu, ale zmiana progu nagle oddala go od celu. Takie zachowanie mogłoby prowadzić do frustracji i obniżenia motywacji użytkownika.