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řeřazeny 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é spuště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, takž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ěně) 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í jmé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 konfigurač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 vkládá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 odlišný 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 parametru mají vždy stejný formát:

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

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

Pokud máte CWG, které ještě není v katalogu, nebo jiný předmět, pro který ani katalog neexistuje, a chcete zobrazovat jeho obrázek, je celkem jednoduché jej přidat. Je ale potřeba obrázky uložit někam na web. Zřejmě k tomu bude stačit DropBox nebo podobná služba, ale pochopitelně můžete použít i vlastní webový prostor, kde už máte své vlastní stránky.

Uvádím zde postup, který používám já pro CWG. Fotím si to foťákem z mobilu, kvalita je dostatečná a pak používám freewarové aplikace:

• IrfanView:
  • označit výřez CWG s dostatečným okolím
  • CTRL+C
• GIMP:
  • CTRL+SHIFT+V
  • E (eliptický výběr)
  • označit CWG po okraji (zřejmě to nebude kružnice, ale to nevadí, protože transformací s z toho kružnice stane)
  • SHIFT+T (transformace)
  • nastavit 150×150
  • CTRL+C
  • CTRL+SHIFT+V
  • CTRL+SHIFT+E (starší verze GIMPu používala CTRL+SHIFT+S)
  • jméno CWG s verzí a příponou png (soubor je větší, ale zůstane průhledné pozadí, které mohu vyplnit v HTML jak mě zrovna napadne)
  • uložit, (neukládám datum a poznámku), exportovat, uložit
  • zavřít obě okna GIMPU
  • zkopírovat soubory do na svůj FTP server do samostatného adresáře
  • poznačit k CWG do položky URL vlastního obrázku cestu a jméno souboru

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ískat 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 získal %PocetCWG% CWG  

Pochopitelně uvedený příklad není dogma - jen ukázka, jak to jde také udělat. Podobným způsobem 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ě.

2.3.17.3 (27.8.2019)

• změna:
  • funkce pro údržbu přesunuty do listboxu, aby jich mohlo být více
  • odstranění exportu pro GgStat a závislostí na příslušné knihovně
• oprava:
  • odstranění dočasných souborů maže jen *.jpg a *.png
• nové:
  • zálohování databáze před importem katalogu a její návrat po chybě importu
  • možnost seřadit seznam podle data zařazení do katalogu
  • možnost importovat katalogová SQ a MWG parsováním HTML stránek GeoGadget
  • nová verze databáze, doplnění 2 indexů pro rychlejší vytvoření seznamu všech CWG/SQ/MWG/…

2.3.17 (23.3.2017)

• změna:
  • změněn zdrojový formát XML katalogu CWG
  • po aktualizaci katalogu zobrazuje počet nových CWG v katalogu, přehled je v Offline adresáři
  • zobrazena informace o datu, kdy byly naposledy z katalogu přidány nové CWG
• oprava:
  • při pokusu o přiřazení katalogového CWG k CWG dosud mimo katalog se kontroluje i stát
  • velké obrázky v katalogu jsou pro zobrazení zmenšeny
  • po změně výběru se ignorovalo řazení podle data
• nové:
  • doplněna možnost kontrol dat v databázi
  • možnost ručně převést nekatalogové CWG na katalogové prostým zadáním jeho ID
  • možnost vyhledávat získané předměty podle typu
  • možnost skákat (přesouvat kurzor) v seznamu CWG po nekatalogových CWG

2.2.16 (19.1.2016, staženo 446 x)

• změna: potlačena práce s katalogem SvetGC, není aktualizovaný od roku 2013 a působí to potíže
• oprava: databázová tabulka ne vždy byla vytvořena se sloupcem Country

2.2.15 (13.1.2016, staženo 86 x)

• oprava: při vytváření nové databáze nebyla správně vytvořena tabulka MyCWG
• oprava: vypuštěna závislost na GgStatu
• oprava: při pokusu automatickém přiřazení CWG, která dosud nebyla v katalogu, byly chybně zpracovány i jiné sig itemy než CWG

2.2.14 (22.12.2015, staženo 183 x)

• nové: změna databáze a přizpůsobení novým kategoriím v oficiálním katalogu
• změna: potlačeno automatické ukládání HTML souboru pro GgStat. GgStat dál nepodporuji. Ručně lze sice soubor vytvořit, ale určitě nebude obsahovat nové kategorie CWG a tím ani žádná nová CWG
• změna: načítání vlastní sbírky ze serveru gcm.cz by snad chodit mělo, ale na serveru došlo k mnoha změnám a zatím není nové API k dispozici
• pozn: potlačeno načítání GCM katalogu, čekám na publikování nového API