GeoGet

Complete geocaching solutions

User Tools

Site Tools


user:skript:finalverification

Differences

This shows you the differences between two versions of the page.


Previous revision
user:skript:finalverification [2021/05/02 19:12] (current) mikrom
Line 1: Line 1:
 +====== FinalVerification ======
 +Plugin pro jednoduchou a pohodlnou evidenci a zobrazení, které kešky, kdy, a jakým způsobem byly (ne)ověřeny s možností použít vlastní poznámku.
  
 +===== Autor =====
 +|**[[http://www.geocaching.com/profile/?u=bobobubo|bobobubo]]**, **[[bobobubo@seznam.cz|Bobobubo]]**|  ~~PAYPAL business="bobobubo@seznam.cz" message="Prispevek na plugin: FinalVerification"~~  |
 +
 +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 [[mailto:bobobubo@seznam.cz|email]] a domluvíme se na jiném způsobu, třeba převodu na účet.//
 +
 +===== Automatická instalace =====
 +~~GEOGET_INSTALL~~
 +
 +/*===== Diskuze =====
 +  * Diskuze o tomto skriptu se nachází na stránkách [[http://www.geocaching.cz/forum/************|Geocaching.cz]].
 +*/
 +
 +===== Popis =====
 +Plugin se skládá hned z několika skriptů:
 +  * {{:user:skript:finalverification:finalverification.png?nolink|}} skript pro volbu určení (ne)ověření kešek
 +  * {{:user:skript:finalverification:finalverification_filter.png?nolink|}} skript připravených patřičných filtrů
 +  * {{:user:skript:finalverification:finalverification_convert.png?nolink|}} skript pro konverzi starého formátu TAGů na nový - který není po instalaci přímo dostupný z panelu pluginů
 +  * skript exportu seznamu do HTML výstupu, kde je ověření rovněž zahrnuto
 +
 +Po instalaci jsou vybrané pluginy k dispozici jak na panelu pluginů GG, tak i listingu keše.
 +
 +{{:user:skript:finalverification:panel_gg.png?nolink|}}
 +
 +{{:user:skript:finalverification:listing.png?nolink|}}
 +
 +==== Ovládání ====
 +
 +=== - Automatické vložení ===
 +Vyvoláním skriptu {{:user:skript:finalverification:finalverification.png?nolink|}} se spustí nejprve automatická detekce "ověřovátka" v listingu kešky. Je-li nějaké nalezeno, objeví se výzva s volbami zadání data, atributu a poznámky. Nalezené ověřovátko je okamžitě zobrazeno na potvrzovacím tlačítku OK.
 +
 +{{:user:skript:finalverification:frm_auto.jpg?nolink|}}
 +
 +Rozpoznána jsou běžná standardní ověřovátka, po vzoru pluginu //**[[user:skript:checker|Checker]]**// od autora **//Mikrom//**. Jsou to tedy:
 +  * Evince
 +  * Geocheck
 +  * Geochecker
 +  * Hermanský
 +  * Certitudes
 +  * Komurka
 +  * Gccounter
 +
 +Pokud je výše zmiňovaný plugin [[user:skript:checker|Checker]] nainstalovaný, lze jej pro ověření finálních souřadnic volat i z tohoto místa (objeví se jeho ikonka {{:user:skript:finalverification:checker.png?nolink}} vlevo od tlačítka OK), a na základě výsledku ověření se rozhodnout o následných krocích.
 +
 +=== - Ruční vložení ===
 +Pokud nebylo žádné "ověřovátko" detekováno, nabídne se možnost jeho ručního zadání. Se stejnými doplňujícími informacemi, jako u automatické detekce.
 +
 +{{:user:skript:finalverification:frm_manu.jpg?nolink|}}
 +
 +Volba nabízí uložení jednoho z těchto ověření:
 +  * bylo použito kontroverzní ověření na Fináři
 +  * řešení se nacházelo přímo v listingu //(kde mohl být i chyták, že?)//
 +  * jiný způsob ověření //(např. finálky získané v terénu, na vyluštěném tlf. čísle, přítel na telefonu a pod.)//
 +  * neověřeno //(finálky nebylo možné ověřit)//
 +
 +//- Těmito volbami je de facto dána i váha správnosti vyluštěných finálek pro vlastní odlov.//
 +
 +Kliknutím na vybrané ověření se toto zobrazí na potvrzovacím tlačítku OK. Jako výchozí je nastaveno “neověřeno”.
 +
 +=== - Společné možnosti ===
 +Ovládání kalendáře je standardní, takže si lze kliknutím na rok urychlit práci se zadáním staršího data.
 +
 +{{:user:skript:finalverification:frm_kale.jpg?nolink|}}
 +
 +Výchozí datum je vždy, po otevření nabídky pro zadání ověření (automaticky i ručně), nastaveno na "dnešní". Datum patří mezi položky, které lze dodatečně editovat. V tom případě se po spuštění skriptu {{:user:skript:finalverification:finalverification.png?nolink|}} nastaví kalendář na již uložené datum.
 +V obou případech (automatickém i ručním) není nutné datum zadávat. K tomu slouží patřičné zatržítko. Například v případě, kdy není známo (zapomenuto, kdy bylo vyluštěno), nebo je keška neověřena... V případě evidence dne vyluštění (ne ověření), bude pravděpodobně zadáno i u neověřených kešek.
 +
 +Další vlastnost, kterou lze určit (společnou volbou pro automatické i ruční zadávání), je **atribut**. Například způsob luštění, náročnost luštění, o jaké datum se jedná... více viz. dále - kapitola **Atributy**. Atributy je prakticky možné využít k čemukoli, nebo je nepoužívat vůbec (nastavení //bez atributu//).
 +
 +Poslední položkou, kterou lze s ověřením uložit je krátká poznámka k ověření. Např. u koho byla ověřena keška s ověřením „jinak“, apod. Velikost poznámky je sice neomezená, ale měla by sloužit opravdu jen jako pomůcka. GG disponuje vlastní poznámkou. Důvodem stručnosti je i export do GPS –čím kratší, tím lepší…
 +
 +Pro zadávání lze vybrat více kešek, ukládání však probíhá jedna po druhé. Kód keše i s jejím jménem je vždy zobrazen v záhlaví okna. Např.: **//GC3KEK6 > Pani kluci//** pro keš [[http://www.geocaching.com/geocache/GC3KEK6_pani-kluci|Pani kluci]] (viz. předchozí obrázky).
 +
 +=== - Změna ověření ===
 +Plugin počítá i se situací, kdy může dojít k dodatečnému vložení, smazání, nebo i změně ověřovátka v listingu keše. Pro tento případ disponuje funkcí //Změna ověření// {{:user:skript:finalverification:arrow-circle-double-135_16.png?nolink|}}. Je k dispozici po spuštění skriptu {{:user:skript:finalverification:finalverification.png?nolink|}} nad keškou s již zadaným ověřením, v levém dolním rohu, a v principu funguje stejně, jako při zadávání. Nejprve tedy automaticky zkontroluje přítomnost (a v případě existence i typ) ověřovátka v listingu. Případné nalezené ověřovátko zobrazí na potvrzovacím tlačítku OK. Pokud však není žádné ověřovátko nalezeno, objeví se nabídka ručního výběru, stejně, jako při zadávání. V obou případech je provedení skriptu oznámeno zmizením ikonky funkce //Změnit ověření// {{:user:skript:finalverification:arrow-circle-double-135_16.png?nolink|}}. Změna je uložena až po potvrzení tlačítkem OK. Lze ji odmítnout zavřením okna pomocí //Zavřít// {{:user:skript:finalverification:redo.png?nolink|}}.
 +
 +Před  spuštěním
 +
 +{{:user:skript:finalverification:frm_re_auto1.jpg?nolink|}}
 +
 +Po spuštění nalezeno...
 +
 +{{:user:skript:finalverification:frm_re_auto2.jpg?nolink|}}
 +
 +...nebo nenalezeno
 +
 +{{:user:skript:finalverification:frm_re_manu.jpg?nolink|}}
 +
 +=== - Poznámka ===
 +Se zobrazením poznámky ve sloupci je možné naložit takto:
 +  * vypnout
 +  * indikovat - zobrazením ikonky {{:user:skript:finalverification:note4.png?nolink|}}
 +  * zobrazit - zobrazit text
 +  * zobrazit i indikovat - kombinace předchozího
 +
 +Obsahuje-li ověření poznámku, je její zobrazování ve sloupci v textové podobě dost nepraktické. Nejrychlejší způsob, jak ji zobrazit, je spustit skript {{:user:skript:finalverification:finalverification.png?nolink|}} nad vybranou keškou, a přečíst si ji tady. Opravdu by měla sloužit jen jako doplněk - pomůcka.
 +
 +=== - Mazání ===
 +Samozřejmostí je možnost uložené informace ověření **smazat** {{:user:skript:finalverification:paste.png?nolink|}}. Lze tak učinit spuštěním skriptu {{:user:skript:finalverification:finalverification.png?nolink|}} nad vybranou keškou s již zadaným ověřením.
 +
 +==== Atributy ====
 +Na předchozích obrázcích je patrné, že atributy na nich se liší. Jejich vzhled, ikonku pro každý z obou atributů, je možné zvolit dle vlastního uvážení z několika předem definovaných. Zpravidla je lze použít párově, a jejich parametry přiřazení (abecední znaky) pro [[user:menu:pluginy:spravce_pluginu|konfiguraci pluginu]] jsou v následující tabulce.
 +
 +Seznam použitelných atributů:
 +
 +^  A  ^  B  ^  C  ^  D  ^  E  ^  F  ^  G  ^  H  ^
 +|  {{:user:skript:finalverification:ok16.png?nolink|}}  |  {{:user:skript:finalverification:cross-script.png?nolink|}}  |  {{:user:skript:finalverification:light-bulb.png?nolink|}}  |  {{:user:skript:finalverification:pen16.png?nolink|}}  |  {{:user:skript:finalverification:user--pencil.png?nolink|}}  |  {{:user:skript:finalverification:users.png?nolink|}}  |  {{:user:skript:finalverification:leaf.png?nolink|}}  |  {{:user:skript:finalverification:leaf-red.png?nolink|}}  |
 +^  I  ^  J  ^  K  ^  L  ^  M  ^  N  ^  O  ^  P  ^
 +|  {{:user:skript:finalverification:home.png?nolink|}}  |  {{:user:skript:finalverification:direction.png?nolink|}}  |  {{:user:skript:finalverification:quill.png?nolink|}}  |  {{:user:skript:finalverification:hammer.png?nolink|}}  |  {{:user:skript:finalverification:eye.png?nolink|}}  |  {{:user:skript:finalverification:lifebuoy.png?nolink|}}  |  {{:user:skript:finalverification:balloon.png?nolink|}}  |  {{:user:skript:finalverification:pin.png?nolink|}}  |
 +^  Q  ^  R  ^  S  ^  T  ^  U  ^  V  ^  W  ^  X  ^
 +|  {{:user:skript:finalverification:lock.png?nolink|}}  |  {{:user:skript:finalverification:lock-unlock.png?nolink|}}  |  {{:user:skript:finalverification:flag-checker.png?nolink|}}  |  {{:user:skript:finalverification:magnifier.png?nolink|}}  |  {{:user:skript:finalverification:sealing-wax.png?nolink|}}  |  {{:user:skript:finalverification:snowman-hat.png?nolink|}}  |  {{:user:skript:finalverification:umbrella.png?nolink|}}  |  {{:user:skript:finalverification:alarm-clock-select-remain.png?nolink|}}  |
 +
 +Výběr se provádí v nastavení [[user:menu:pluginy:spravce_pluginu|konfigurace pluginu]], viz. kapitola **nastavení**.
 +Pro vlastní zadávání jsou pak k dispozici tři volby:
 +  * **//bez atributu//**
 +  * **//1. atribut//** (např.: {{:user:skript:finalverification:ok16.png?nolink|}} datum ověření, {{:user:skript:finalverification:user--pencil.png?nolink|}} vyluštěno osobně, {{:user:skript:finalverification:home.png?nolink|}} šlo vyluštit doma, {{:user:skript:finalverification:quill.png?nolink|}} lehké luštění...)
 +  * **//2. atribut//** (např.: {{:user:skript:finalverification:pen16.png?nolink|}} datum vyluštění, {{:user:skript:finalverification:users.png?nolink|}} vyluštěno kolektivně, {{:user:skript:finalverification:direction.png?nolink|}} nutné luštit v terénu, {{:user:skript:finalverification:hammer.png?nolink|}} těžké luštění...)
 +  * **//3. atribut//** (např.:  {{:user:skript:finalverification:lifebuoy.png?nolink|}} pomoc ownera - prostě stejně jako u 1. a 2. atributu jakýkoliv "vlastní" význam)
 +
 +==== Filtry ====
 +Pro pohodlnější a rychlejší práci s takto označenými keškami je připravené i filtrování.
 +
 +{{:user:skript:finalverification:frm_filter.jpg?nolink|}}
 +
 +Natavení filtru nedovolí stav, kdy není zvolena žádná položka (nedojde tak k zakázanému stavu). Principiálně nelze nad filtry pluginu použít funkci [[user:navody:efektivne|filtrované hledání]].
 +
 +==== Export ====
 +Informace, zda byla vůbec keška nějakým (a jakým) způsobem ověřena, je důležitá i v terénu. Proto je k dispozici také export **//HTML list FinalVerification//**.
 +Vzdálenost a směr u keší i waypointů je vypočítána buď od referenčního bodu nastaveném v GG, nebo od první kešky v zobrazeném seznamu. V druhém případě je pak v exportovaném souboru označena jako //výchozí bod výpisu//. Způsob výpočtu je nastavitelný v [[user:menu:pluginy:spravce_pluginu|konfiguraci pluginu]].
 +
 +{{:user:skript:finalverification:export2.png?nolink|}}
 +
 +/*
 +==== Ukázka ====
 + V případě potřeby je možno tuto sekci vymazat a neuvádět ji.
 +Pokud je to možné a vhodné, měl by popis obsahovat i snímky obrazovek - jak vypadají ovládací dialogy skriptu, jak vypadají výstupy exportu a podobně.
 +*/
 +
 +===== Nastavení a konfigurace =====
 +/* V případě potřeby je možno tuto sekci vymazat a neuvádět ji. */
 +
 +==== Nastavení ====
 +{{:user:skript:finalverification:plg_setup.jpg?nolink|}}
 +
 +Výchozí konfiguraci pluginu lze změnit jeho nastavením [[user:menu:pluginy:spravce_pluginu|standardním způsobem]]. Jak pro vizualizaci (prefix **visual**) a zadávání (prefix **cfg**), tak i export do HTML (prefix **exp**). Jde o položky:
 +
 +  * **visual_ATRB** - zobrazování ikonky atributu (**zapnuto** / vypnuto)
 +  * **visual_NOTE** - zobrazení poznámky **ikonkou**, v textové podobě, obojí, nebo nic
 +  * **visual_DATE** - datum **zobrazovat**, nebo nezobrazovat
 +  * **visual_FIX** - společná šířka zobrazovaných ikonek (**fixní** / variabilní)
 +  * **cfg_DATE** - předvolba formuláře: při zadávání vložit datum (**zapnuto** / vypnuto)
 +  * **cfg_ATRB** - předvolba formuláře: bez zadání, **atribut1 @**, nebo atribut2 #
 +  * **cfg_ICOATRBUT** - definice ikonek atributů (**A**, **B**, C, D, E, F, G, H, I, J, K, L, M, **N**, O, P)
 +  * **exp_REFPOINT** - výpočet vzdáleností a směru (od prvního bodu exportu / od **referenčního** bodu GG)
 +
 +//(výchozí hodnoty jsou tučně)//
 +
 +==== Instalace ====
 +V případě, že v seznamu ještě neexistuje, vytvoří se při instalaci na právě používaném seznamu automaticky sloupec **?........................Datum** (**.** = mezera) pro [[user:navody:tagy|TAG]] //**FinalVerification**//. Současně se přiřadí vizualizační skript pro přehledné zobrazení informací o ověření. Do ostatních konfigurací sloupců (tedy do jiné sady než je právě používána) je nutno přidat sloupec a přiřadit vizualizační skript [[user:navody:tagy|standardním způsobem]]. Doporučení pro záhlaví sloupce je //"**?**" 24 mezer a "**Datum**"//, šířka sloupce //**145**//, zarovnání vpravo - pro fixní šířku ikonek. Pak je dosaženo vzhledu na obrázku níže.
 +
 +{{:user:skript:finalverification:seznam.png?nolink|}}
 +(jde o fiktivní záznamy v testovací databázi)
 +
 +Při odinstalování je ze seznamu odstraněn sloupec pro [[user:navody:tagy|TAG]]  **//FinalVerification//** z aktuálně používané sady sloupců a nabídnuta možnost ponechat v databázi uložená data ověření ([[user:navody:tagy|TAG]] **//FinalVerification//**).
 +
 +Každá hodnota v Kategorii [[user:navody:tagy|TAG]]u **//FinalVerification//**  má jednoduchou podobu, která je svou strukturou __čitelná i v GPS__.
 +
 +<wrap em>**//@evince-1.6.2001~Poznámka//**</wrap>
 +
 +Na první pozici je znak indikující jaký má záznam atribut (<wrap em>**-**</wrap> bez určení, <wrap em>**@**</wrap> atribut 1, <wrap em>**#**</wrap> atribut 2, <wrap em>**&**</wrap> atribut 3). Následuje název ověřovátka. Dále <wrap em>datum</wrap> mezi oddělovači <wrap em>**-**</wrap> a <wrap em>**~**</wrap>. Na samém konci je případná <wrap em>poznámka</wrap>.
 +
 +Tím již není zajištěno grafické zobrazení i v listingu generovaném GG po dvojkliku na kešku. Dle informačního šumu by ale mělo jít v budoucnu podobu tohoto listingu ovlivnit už přímo v GG.
 +
 +==== Konverze dat (TAG) ====
 +Pokud byl instalován **plugin verze 2.1.4 a nižší**, je třeba provést konverzi dat. Na aktuální databázi je při instalaci provedena konverze automaticky. Pro případ, že je plugin **//FinalVerification//** využíván i na dalších databázích, je součástí instalace i skript **DBFix** {{:user:skript:finalverification:finalverification_convert.png?nolink|}}, kterým lze provést tuto konverzi dat i dodatečně. Stačí spustit skript nad vybranou databází, a vše je provedeno automaticky. Pokud databáze neobsahuje starou strukturu tagů, nic se nestane - skript se ukončí bez jakéhokoli zásahu do databáze.
 +
 +{{:user:skript:finalverification:plugin_menu.png?nolink|}}
 +
 +/*
 +===== Poznámky, známé problémy =====
 +<WRAP round todo>
 +**Plánuje se:**
 +  * doplnění filtrů o oba atributy
 +</WRAP>
 +*/
 +
 +===== Stažení =====
 +<WRAP round download>
 +Stáhnout aktuální verzi: ~~DOWNLOAD finalverification-*.gip highest~~
 +</WRAP>
 +
 +==== Seznam dostupných verzí ====
 +{{filelist>finalverification:*.gip&style=table&tableheader=1&tableshowdate=1&sort=mtime}}
 +
 +===== Seznam změn =====
 +** 4.2.1 (2015/10/29) **
 +  * novinka: možnost vložení atributů i bez zadaného data
 +  * novinka: přidán třetí atributů
 +  * novinka: rozšířen výběr ikonek atributů
 +
 +<hidden onHidden=":!: **Zobrazit změny ve starších verzích**" onVisible="Skrýt změny ve starších verzích">
 +** 4.1.4 (2015/03/05) **
 +  * novinka: možnost změnit ověřovátko při zachování ostatních dat (atribut, datum, poznámka)
 +  * novinka: pro export HTML volba referenčního/výchozího bodu - přiblížení se standardům GG
 +  * novinka: možnost nastavení společné šířky zobrazovaných ikonek - fixní nebo variabilní
 +  * novinka: možnost výběru ikonek pro atributy (z několika předdefinovaných)
 +  * novinka: indikace automaticky nalezených ověřovátek (při editaci všech typů ověření)
 +  * novinka: doplnění filtrů o atributy
 +
 +** 3.2.6 (2015/02/23) **
 +  * novinka: aplikována spolupráce s pluginem [[user:skript:checker|Checker]]
 +  * novinka: doplněna "drobná" poznámka
 +  * novinka: doplněn atribut (např. pro datum)
 +  * novinka: přidán skript **DBFix** {{:user:skript:finalverification:finalverification_convert.png?nolink|}} pro případný převod dat v dalších databázích (instalace to provede jen na aktuální databázi)
 +  * změna: odstraněno omezení pouze na mysterky
 +  * změna: změněna podoba uložených informací z ohledem na export do GPS (požadavek)
 +  * oprava: opraven design ikonek v seznamu (odstraněny vznikající otřepené okraje)
 +
 +** 2.1.4 (2015/02/11) **
 +  * novinka: zakomponování informace "datum ověření" (vyluštění)
 +  * novinka: automatická detekce nejpoužívanějších ověřovátek
 +  * oprava: vyfiltrované kešky jsou do seznamu načteny bez waypointů
 +  * oprava: oznámení, že keš není mysterkou až po otevření okna pluginu a vybrání ověření
 +
 +** 1.0.3  (2015/02/01) **
 +   * Úvodní verze
 +</hidden>
 +
 +{{tag>author_Bobobubo skript ggp ggv zobrazeni}}