CwgList2 je plugin, kterým je možné udržovat přehled o své sbírce CWG a případně dalších předmětech (TB, GC, Sigitem, …). Plugin také umožňuje vytvářet exporty pro statistiky a přehledové seznamy v textové podobě nebo ve tvaru POI pro GPS.

Plugin je nástupcem CwgList, který přestal vyhovovat zejména po rozdělení oficiálního katalogu a předání jeho správy firmě.

This plugin creates overview CWG (Czech Wood Geocoin) obtained i.e. for the statistics generated by GgStat. CWG is sigitem - Czech specialty. For foreign geocachers plugin will probably not be very useful.

Pokud se Vám doplněk líbí, kliknutím na tlačítko Donate můžete přispět na jeho vývoj.

Nekamarádíte se s PayPalem? Napište mi email a domluvíme se na jiném způsobu, třeba převodu na účet.

Diskuze o tomto skriptu je na Geocaching.cz.

Plugin pro evidenci CWG obsahuje nástroje pro:

• převzetí evidované sbírky ze starší verze pluginu CwgList
• přidání a odebrání CWG do nebo ze sbírky, a to i hromadně pro více označených CWG
• evidenci CWG, která dosud nejsou v žádném z katalogů (jakmile se v něm objeví, budou automaticky přezazeny ze skupiny mimo katalog do skupiny v katalogu
• uchování a zobrazení různých doplňujících informací o CWG, jeho nálezu, výměně …
• export získaných CWG do různých formátů; pro potřeby statistiky v profilu na geocaching.com je možné vytvořit i několik různých tabulek (CWG vyměněná, nalezená, eventová CWG, CWG s obrázky zvířátek, CWG s obrázky staveb, …)

V současnosti plugin umí pracovat s katalogy:

• GeoGadget
• SvetGC
• Maxinoha (katalog není dále udržován)

• pro předchozí verze pluginu byla hlavní keška a z ní se vše odvíjelo; tato verze vychází z CWG (resp. předmětu jako takového, protože vůbec nemusí jít o CWG) a keš je jen jedním z nepovinných údajů, které jsou o něm evidovány
• všechny informace jsou uloženy v samostatné databázi mimo databázi GeoGetu, tím došlo k podstatnému zrychlení práce s katalogem
• vedlejším efektem přepracování je možnost evidovat různé druhy předmětů, uživatel si u každého poznačí jeho typ. Počet typů není omezen a je možné si vytvářet vlastní (já si třeba eviduju seznam všech vlastních CWG, kam jsem je vložil a kdy, mám seznam geovizitek a ostatních osobních předmětů, umím si představit přehled GC/TB, …)
• plugin pracuje s několika servery, na kterých je katalog CWG, uživatel si může definovat, které z nich budou používány a v jakém pořadí (stanovuje tak jejich prioritu)
• k aktualizaci katalogu může docházet automaticky, jakmile plugin zjistí, že má katalog starší než nastavený počet dní (oficiální katalog se aktualizuje každý týden)
• plugin nedokáže exportovat do GgStatu proměnnou s počtem CWG ve sbírce, k tomu je třeba použít GgsExpr (viz poznámka níže)

Na rozdíl od předchozí verze, kde byl plugin rozdělen na dvě části a generování do statistik zajišťovalo samostatné spustění pluginu pro GgStat, v nové verzi je vše v jednom a pokud je to nastaveno, tak při ukončení pluginu se automaticky vygenerují výstupní soubory a není nutné je generovat samostatně.

Plugin se zobrazeným katalogem a vyznačením již získaných CWG

Plugin se zobrazeným jen získaných CWG

Exportovaný seznam v GPS

Export ve statistice v profilu

Ke konfiguraci pluginu slouží standardní konfigurační nástroj GeoGetu dostupný přes menu Pluginy - Správce pluginů - Konfigurace pluginů a obsahuje nastavení jednak pro vlastní evidenci CWG a druhak pro exporty. Každý parametr je komentován, zakže by snad mělo být zřejmé, k čemu slouží a jak jej nastavit.

Plugin při exportu vytváří pro statistiku přímo HTML soubor nebo soubory, takže v template stačí pomocí příkazu vložit na příslušné místo ten správný soubor. Export tohoto souboru může být spuštěn automaticky při ukončení pluginu (konfigurační parametr OUT_AUTOSAVE, spouští se jen v případě, že došlo k nějaké změnně) nebo ručně příslušným tlačítkem.

Ukázkový kus Template souboru může vypadat třeba takto:

Header Získaná CWG
INCLUDE .\script\CwgList2\CwgList.html

Nebo v případě využítí více tabulek:

Header CWG získaná z keší
INCLUDE .\script\CwgList2\CwgListZkese.html
Header CWG získaná výměnou
INCLUDE .\script\CwgList2\CwgListVymena.html

Všechny konfigurační parametry pro výstup CWG do profilu mají jmnéno začínající OUTHTML_. Zmíním se tu jen o hlavních nebo možná trochu nejasných nastaveních, ostatní jsou snad jasné z komentáře v donfiguračním souboru u každého z nich.

Parametr	Význam
OUTHTML_TYPES	Parametr obsahuje seznam typů předmětů, které budou brány v úvahu. Pozor na velikost písmen, cwg znamená CWG z katalogu, kategorie cwg, CWG znamená CWG, která zatím nejsou v katalogu.
OUTHTML_GRP	Parametr obsahuje seznam skupin oddělených čárkami. Pro každou skupinu je vytvořena samostatná tabulka včetně tlačítek na změnu řazení CWG. Do tabulky budou zařazena CWG, která mají nastavenou Skupinu. Nepleťte si tuto skupinu s kategorií, parametr OUTHTML_TYPES.
OUTHTML_SORT1	Nad tabulkou s CWG budou tlačítka, která umožní změnu řazení zobrazených CWG. Protože řazení používá Javascript, který je serverem geocaching.com blokován, je funkční jen v případě, že statistky nejsou uloženy přímo na serveru, ale jsou do profilu vkladány z vlastního serveru, například pomocí tagu object.
OUTHTML_CARD_CONTENT1	Definuje obsah karty s CWG. Například OUTHTML_CARD_CONTENT='Z keše:NAME,IMG,CACHE,DATE |Výměna:IMG,DATE'; generuje pro dvě skupiny odlisný obsah (nač mít na kartě CWG získaných mimo keše prázdné ID keše?) Na pořadí hodnot závisí pořadí, v jakém budou příslušné prvky uvedeny na kartě. NAME=jméno CWG, IMG je obrázek CWG, CACHE=ID keše, DATE=datum získání CWG

1) Uvedené parametry mohou být definovány rozdílně pro každou skupinu (generovanou tabulku). Bez ohledu na jméno a obsah prametru mají vždy stejný formát:

Jmeno 1. skupiny:hodnota | Jméno 2. skupiny:hodnota…

Jméno skupiny může být vynecháno (PARAMET='hodnota'), pak bude hodnota použitá pro všechny skupiny.

U hodnot, které určují velikost (ve formátu css), je třeba uvádět i jednotky, například OUTHTML_CARD_HEIGHT='Z keše:140px|Výměna:90px';

Původní verze pluginu byla spouštěna z GgStatu, takže mohla jako výstupní hodnotu předávat GgStatu i počet získaných CWG (exportovala proměnnou %POCETCWG%), který pak GgStat mohl vypisovat.

O nové verzi pluginu, a navíc ještě o nějaké další databázi, GgStat nemá a nemůže mít nejmenší tušení. Pokud chceme počet CWG používat v Template souboru, musíme jej zístat tak, aby byl k dispozici GgStatu. Řešením je použít v template GgsExpr, pomocí kterého si z databáze CwgList.db3 můžeme spočítat co je třeba, exportovat to do příslušné proměnné a proměnnou pak v template použít podobně jako v předchozí verzi.

Abych byl trochu konkrétnější: do Template souboru na vhodné místo doplníme něco takovéhoto:

PLUGIN script\GgStat\GgsExpr.exe
DB ./script/CwgList2/CwgList.db3
PRECISION 0
SQLSTART
  SQL_SQL  SELECT count(Name) FROM MyCWG WHERE Category IN ('CWG','cwg','cle','ceg','swg','sle','seg')
  SQL_CMD COLUMN EVALOUTVAR PocetCWG %1%
SQLEND
PLUGINEND

Kdekoli dál v Template souboru pak už definovanou proměnnou můžeme použít třeba příkazem:

HTML Celkem jsem ziskal %PocetCWG% CWG  

Pochopitelně uvedený příklad není dogma - jen ukázka, jak to jde také udělat. Podobným způspobem můžete získat i jiné hodnoty než jen celkový počet CWG.

• katalogy CWG neobsahují stejné informace, nejsou na nich totožné seznamy CWG a přítomnost obrázku CWG v jednom katalogu neznamená jeho přítomnost v jiném katalogu. Proto je možné v konfiguraci určit, které katalogy budou použity a v jakém pořadí

• při abecedním řazení je u všech exportů Ch chápáno jako 2 samostatná písmena
• tlačítka pro řazení karet s CWG v HTML vloženém do statistiky fungují jen pokud je HTML soubor mimo web geocaching.com. Je tomu tak proto, že řazení je realizováno Javascriptem, který Groundspeak blokuje, resp. jej ze zdrojového kódu stránky odstraní. Pokud HTML soubor do profilu vložíte z jiného serveru např. pomocí tagu <object>, bude řazení pracovat správně

• občas někdo hlásí, že v popisu POI v GPS nemá vypsaný seznam CWG. Příčina zatím není odhalena, ale zdá se, že je někde problém ve spolupráci s POILoaderem. Často pomůže, když gpx soubor je ve vnořeném adresáři a POILoader zpracovává nadřízený adresář. Občas někomu pomůže přepnutí POILOaderu do manuálního režimu, … V každém případě je seznam součástí vytvořeného *.poi souboru, ale někdy GPS seznam prostě nezobrazuje. Problém je diskutován v tomto vlákně.

• nefungují skupinové úpravy, příčinou jsou systémové problémy s Listboxem v režimu pro označení více řádků
• není realizováno napojení na webové služby se správou sbírek. V plánu to je, ale administrátoři mají své práce dost, tak zatím odkládám

• oprava: zacyklení při sestavování dat pro export na gcm, pokud nebyla použita ladicí knihovna
• oprava: import CWG s verzí 10 a více

• nové: export dat na gcm.cz
• změna: jména jsou z katalogu jsou načítána bez úvodních mezer (v katalogu je chybně např. nick “ Skauti ze Skritkova”, id=6328)
• změna DB: doplněn sloupec s datem zeřazení CWG do katalogu, potřebuje to export do gcm.cz
• oprava: neuložené datum v případě nálezu CWG v keši (při opravě už to bylo správně)

• nové: import dat z gcm.cz, úprava databázové struktury
• oprava: GUI: při přidávání CWG mimo katalog bylo chybně předvyplněno ID, což někdy znamenalo problém s uložením do sbírky
• oprava: GUI: při přidávání 1. CWG mimo katalog nebyla v nabídce Typu předmětu možnost CWG mimo katalog
• oprava: pro combobox převod databázového jména keše z UTF do ANSI
• oprava: odkaz na obrázek CWG, které není v katalogu (nebyl změněn při změně serveru)

• změna: HTML export: styl pro zobrazení řadících tlačítek je možné nastavit v konfiguračním souboru
• oprava: převod ze staré verze: při převodu je vynechána informace o katalogu poznamenaná u jména CWG v souboru s CWG mimo keše
• oprava: převod ze staré verze: chybně přebíraný mesíc menší než 10 zadaný bez úvodní nuly
• oprava: GUI: u CWG, která mají místo ID keše jiný text, se již nezobrazuje navíc pomlčka
• oprava: GUI: při uložení změn po upozornění na neuložené změny (tedy ne tlačítkem Uložit, ale až při přesunu z CWG s neuloženými změnami na jiné) již nedochází ke zmatenému přepisu řádku v seznamu s CWG, případně jeho zdvojení
• oprava: HTML export: pokud není CWG získáno v keši, negeneruje se odkaz na neexistující keš
• oprava: HTML export: pro některé CWG nebyl vygenerován odkaz na profil majitele CWG
• oprava: HTML export: správné řazení prvků na kartě tak, jak je definováno v konfiguraci

• změna: přejmenování souborů na Cwg*2*, aby bylo zřejmé, že jde o nástupce CwgList Doporučuju všechny soubory smazat a udělat novou instalaci a nastavit původní hodnota do konfigurace.
• nové: HTML export: možnost nastavit řazení jinak než podle jména (NAME, DATE, CACHE)
• nové: TXT export: obsahuje ID keše, kde bylo CWG nalezeno
• změna: POI export: trochu upraven výstup
• změna: GUI: implicitní datum je katuální den
• změna: HTML export: změna implicitně zobrazovaných hodnot na kartě, teď všechny
• oprava: chybná obsluha CWG, která obsahují znak |
• oprava: chybné číslo verze hlášené na různých místech pluginu
• oprava: GUI: při rychlém listování seznamem už nedojde k hlášení o neuložených změnách
• oprava: HTML export: text přetékající rám karty se už nezobrazuje

• uvodní veřejná verze