GeoGet

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== 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}}