Vzorová šablona pro GgStat, která využívá řadu doplňků a triků pro rozšíření obsahu i funkčnosti statistiky. Část použitých technik je popsána na stránce triky a vychytávky. Aplikování dílčích návodů na vlastní šablonu a sladění všech nastavení je ale dost pracné, proto jsem se rozhodl raději zveřejnit celou vzorovou šablonu. Je odvozena od šablony, kterou používám ve svém profilu. Lehce jsem ji očistil od osobního balastu a vyřadil části, tvořené mým zatím nezveřejněným pluginem. Kvůli přehlednosti a snazším úpravám je šablona rozdělena na více souborů. Začátečníci mohou použít šablonu jak je, pokročilí ji mohou vzít jen jako základ vlastního díla.

• kiReGPS, kiReGPS [at] gmail [dot] com

• Diskuze o Template.extended se nachází na stránkách Geocaching.cz.

• Vše (jednotlivé části šablony a podpůrné pluginy) se nainstaluje jedním balíčkem.
• Statistiky jsou rozděleny na záložky, v rámci záložek na sekce. Sekce je základním stavebním kamenem Template.extended. Konfigurace obsahu statistiky spočívá ve výběru předdefinovaných sekcí a jejich zařazení do seznamů na záložkách. Sekce mohou obsahovat i podsekce, což jsou standardní záhlaví GgStatu.
• Sekce se dají pro lepší přehlednost sbalit a rozbalit. Ve výchozím stavu jsou rozbaleny jen vybrané sekce. Hlavička sekce je rozlišena ikonou podle obsahu.
• Vzhled (barvy grafů a tabulek, rámečky sekcí) je maximálně přizpůsoben integrovaným jednoduchým statistikám od Groundspeaku. “Komu se to nelíbí, ať si…” - ne ne, to ne, ať si to změní.
• Celá šablona je pouze česky.
• Obsah statistik je rozšířen řadou doplňků, často pomocí GgsExpr. Jedna záložka je věnovaná odznakům, generovaným skriptem BadgeGen II, jedna obsahuje GeoPuzzle, na záložce vlastních keší můžete použít výstup z pluginu MyOwnStat.
• Pro generování speciálních seznamů keší, grafů a zajímavých čísel jsou často použity tagy. Kromě standardních i několik speciálních.
• Doplňky vytvářejí řadu proměnných, které lze použít do popisných textů.
• Soubor šablony je rozdělen na větší než malé množství částí. Ale nebojte se, je to kvůli přehlednosti a snadnější správě. Jen v některých z nich bude třeba něco upravit a dokonce i bez jakýchkoliv změn se vám statistika vygeneruje.
• V některých částech je použit odkaz na Project-CG. Snadno tak třeba zjistíme, kde máme v okolí neodlovené keše, které nám chybí do tabulky D/T apod. Při prvním použití je nutné se na Project-GC přihlásit (resp. potvrdit autentizaci přihlášení webu Project-GC na Geocaching.com).

(viz Gord) - předělat na balíček, který zařídí vše potřebné

1. Soubory šablony rozbalte do kořenové složky GgStatu ./script/GgStat.
2. Nainstalujte pluginy GgsExpr, SvetloTma, BadgeGen II, GeoPuzzle a MyOwnStat.
3. Nainstalujte plugin Combine a do něj dávku Doplnění tagů pro Template.extended.
4. Jako šablonu, kterou generujete statistiky, nastavte soubor Template.extended.cz.
5. Proveďte základní nastavení podle následující kapitoly.

Pak už jen stačí spustit generování statistiky a nahrát ji do profilu. A je hotovo!

Zde jen velmi stručně, detailní tabulku s popisem všech souborů zařadit “do přílohy”. Pokud bude sekcí a záložek připraveno víc, než použito, okomentovat. Možná udělat i S|M|L|XL varianty záložek (případně začátečník|FTF lovec|drsnokačer)…?!? Varianty asi jako podadresáře Tabs, kde budou soubory Tab*.cfg stejných jmen a jen se nakopírují.

Šablona předpokládá existenci tůzných tagů. Podle nich se tvoří speciální seznamy keší, vytváří grafy a počítají různá čísla. Kromě standardních tagů GeoGetu a jeho integrálních doplňků (jako tagy Favorites, Elevation, GCVote-median, Vote), použítá šablona i tyto další tagy:

Výstupy použitých pluginů je možné si konfigurovat podle vlastních představ. Jen je třeba dodržet tyto parametry: (konfigurace pluginem?!?)

Vedle úvodního textu je na záložkách grafika. Pro jednoduchost jsou použity odznaky typu, který má souvislost s obsahem záložky. Je samozřejmě možné si odznaky vyměnit za jiné nebo použít jakékoliv jiné obrázky, umístěné na webu. Doporučuji jen dodržet šířku obrázku 100 pixelů. Odkaz na obrázky změnite v souborech s definicí obsahu jednotlivých záložek, tedy v souborech Tabs\Tab.*.cfg.

Šablona je z důvodu přehlednosti a snadnějších úprav rozdělena na více částí. Do samostatných souborů jsou odděleny definiční části šablony, jednotlivé záložky, části generující hodnoty pomocí GgsExpr, apod. Dále v textu jsou označeny části, kde se čekají uživatelské úpravy:

• Části, které je nutné upravit, mají v seznamu značku Nutno upravit.
• Části, které je úprava jen doporučená nebo možná, mají v seznamech značku Doporučeno upravit nebo Možno upravit.
• Do budoucna se uvažuje o nástrojích, které budou šablonu Template.extended konfigurovat klikací způsobem. Části, kde se předpokládá, že budou vznikat jako výsledek konfigurace nástrojem, mají v seznamu značku Upraví se nástrojem. Otazka (Gord): To má znamenat, že plugin soubor vytvoří nebo změní nebo že spustí editor k jeho ruční úpravě uživatelem? Prosím upravit formulaci, aby to bylo zřejmé,
• Do ostatních souborů není potřebné nijak zasahovat. Pokud nevíte přesně co děláte, tak to ostatně ani nedoporučuji.

Všechny soubory, definující vlastní obsah záložek jsou umístěny v podadresáři Tabs.

Protože každá záložka je definovaná právě těmito třemi soubory, je v následujícím popisu uveden jen hlavní soubor záložky. Jména zbylých dvou si čtenář jistě sám odvodí. V je pak uved seznam sekcí, které jsou v záložce (jejich seztnam je tedy v souboru Tab.<jméno záložky>.Sections.cfg).

Sekce je základním stavebním kamenem Template.extended. Každý soubor definuje celou jednu sekci. Všechny soubory sekcí jsou umístěny v podadresáři Sections.

Kromě standardních proměnných GgStatu, popsaných v jeho dokumentaci vytváří Template.extended řadu dalších proměnných. Mnohé z nich šablona používá do grafů, tabulek a zajímavých čísel, mnohé z nich jsou úplné zbytečnosti. Všechny je možné zároveň použít i do vlastních textů. Proměnné jsou rozděleny do skupin:

• %TOTALDISTANCE% - celková vzdálenost od keše ke keši (nejde o proměnnou Template.extended, ale o základní proměnnou GgStatu, zde je uvedena jen z důvodu, že existuje až v poslední verzi GgStat 1.1.36a a není uvedena v dokumentaci dodávané s programem)
• %EarthCirc% - podíl celkové vzdálenosti a obvodu Země
• %MoonDist% - podíl celkové vzdálenosti a vzdálenosti k Měsíci

• %TotalWords% - celkový počet slov
• %TotalWordsThs% - celkový počet slov v tisících
• %PocetBibli% - na kolik Biblí (Kralických) by logy stačily

• %NextMilestone% - číslo příštího stovkového milníku
• %NextBigMilestone% - číslo příštího tisícovkového milníku
• %NextMilestonDays% - počet kalendářních dní do stovkového milníku
• %NextBigMilestonDays% - počet kalendářních dní do tisícovkového milníku
• %NextMilestonCachingDays% - počet kešovacích dní do stovkového milníku
• %NextBigMilestonCachingDays% - počet kešovacích dní do tisícovkového milníku
• %NextMilestoneDate% - datum příštího stovkového milníku
• %NextMilestoneWeekDay% - den v týdnu příštího stovkového milníku
• %NextBigMilestoneDate% - datum příštího tisícovkového milníku
• %NextBigMilestoneWeekDay% - den v týdnu příštího tisícovkového milníku

• %DaysToEndOfYear% - počet dní do konce roku
• %CachesToEndOfYear% - odhad počtu odlovů do konce roku
• %TotalCachesOnEndOfYear% - odhad celkového počtu odlovených keší na konci roku

• %CurrDate% - aktuální datum (tj. datum generování statistiky) ve formátu d.m.rrrr
• %CurrDateTime% - aktuální čas (tj. čas generování statistiky) ve formátu hh:mm
• %CurrDateWeekDay% - aktuální den v týdnu (tj. den generování statistiky)

• %Svetlo% - počet nálezů za světla (nastavuje plugin SvetloTma)
• %Tma% - počet nálezů za tmy
• %PodilSvetla% - podíl nálezů za světla
• %PodilTmy% - podíl nálezů za tmy

• %NumConsFound% - nejdelší období s nálezem (denní streak nálezů)
• %StartConsFound% - jeho datum začátku
• %EndConsFound% - jeho datum konce
• %NumConsEmpty% - nejdelší období bez nálezu
• %StartConsEmpty% - jeho datum začátku
• %EndConsEmpty% - jeho datum konce

• %DisableCount% - počet disable keší z nalezených
• %DisablePerc% - podíl disable
• %ArchiveCount% - počet archivovaných
• %ArchivePerc% - podíl archivovaných
• %PMOCount% - počet Premium Members Only keší
• %PMOPerc% - podíl PMO
• %CountryCount% - počet zemí s nálezy
• %Nad1000m% - počet keší s nadmořskou výškou nad 1 km
• %PodilNad1000m% - podíl nad 1 km
• %NadSnezku% - počet keší s nadmořskou výškou vyšší, než Sněžka
• %AvgFavoritesOnFound% - průměrný počet favoritních bodů na nalezených keších
• %mdCachingPoints% - celkový počet bodů za ulovené keše podle váženého bodování www.macdefender.org
• %CachingKarma% - kešovací karma - tj. podíl logů na založených keších a nálezů
• %CombRatio% - (tohle už je úpná hovadina) podíl počtu nálezů na celkovém počtu kombinací Obtížnost/Terén/Typ keše/Den/Mesíc/Hodina/Den v týdnu/Rok a měsíc založení

• %MyFTFCount% - celkový počet FTF nálezů
• %MySTFCount% - celkový počet STF nálezů
• %MyTTFCount% - celkový počet TTF nálezů
• %FTFIndex% - celkový FTF index
• %FTFInterval% - průměrný interval mezi FTF nálezy v kalendářních dnech
• %FTFIntervalCachingDays% - průměrný interval mezi FTF nálezy v kešovacích dnech
• %NextFTFMilestone% - příští stovkový FTF milník
• %NextFTFMilestoneDate% - očekávané datum příštího stovkového FTF milníku
• %NextFTFMilestoneWeekDay% - den v týdnu očekávaného data FTF milníku
• %BestFTFNum1% - nejvyšší počet FTF za den
• %BestFTFDay1% - datum, kdy byl dosažen
• %BestFTFNum2% - druhý nejvyšší počet FTF za den
• %BestFTFDay2% - datum, kdy byl dosažen
• %BestFTFNum3% - třetí nejvyšší počet FTF za den
• %BestFTFDay3% - datum, kdy byl dosažen
• %BestFTFMonthNum% - nejvyšší počet FTF za měsíc
• %BestFTFMonth% - měsíc, kdy byl dosažen
• %BestFTFYearNum% - nejvyšší počet FTF za rok
• %BestFTFYear% - rok, kdy byl dosažen

• %NumConsFTFMonths% - nejdelší období s FTF nálezem během měsíce (měsíční streak FTF)
• %StartConsFTFMonths% - jeho měsíc začátku
• %EndConsFTFMonths% - jeho měsíc konce
• %NumConsFTFound% - nejdelší období s denním FTF (denní streak FTF)
• %StartConsFTFound% - jeho datum začátku
• %EndConsFTFound% - jeho datum konce
• %NumConsFTFEmpty% - nejdelší období bez FTF
• %StartConsFTFEmpty% - jeho datum začátku
• %EndConsFTFEmpty% - jeho datum konce