Funkce GGmapy lze rozšiřovat pomocí pluginů o další možnosti. Může to být např.

• doplnění dalších map nebo překryvných vrstev
• změna vykreslovaných ikon
• úprava vzhledu
• doplnění filtrování
• a mnoho dalších funkcí, záleží jen na autorovi pluginu

Pluginy jsou v souborech *.ggm.js a případně odpovídajících souborech (*.css, soubory s obrázky, …). Vlastní plugin je napsán v javascriptu a aby bylo možné jej spravovat obvyklým způsobem jako ostatní pluginy do GeoGetu, je vhodné jej distribuovat v *.gip balíčku, který se postará o překopírování souborů do správných adresářů GeoGetu.

Správné umístění souborů pluginu po instalaci:

• *.meta.ini a *.ggi.pas jsou v adresáři DATADIR\script\GgMap\ (toto není nutné pro funkci pluginu, je doporučené pro přehlednost a údržbu pluginů) o správné umístění souborů z instalačního balíčku by se měl postarat instalační script *.ggi.pas
• *.ggm.js a/nebo *.css jsou v adresáři DATADIR\ggmap\plugin\
• všechny ostatní soubory, které plugin potřebuje , jsou v adresáři DATADIR\ggmap\plugin\jméno_pluginu\

Základem správné funkce pluginu je jeho správná inicializace. O tu se stará funkce *_ggm_init(), což je jediná povinná funkce. Ta by měla zejména zajistit inicializaci pluginu, nastavení obslužných funkcí událostí, doplnění položek menu a dalších činností potřebných pro správnou funkci pluginu. Inicializací se v tomto případě rozumí zejména doplnění volání funkcí pluginu v tu správnou chvíli, tedy při nějaké události. (Ve výjimečných případech, kdy inicializace není potřeba, bude tato funkce prázdná, ale existovat musí!)

Aktuální seznam všech možných událostí je v souboru DATADIR\ggmap\plugin\README.txt:

Instalační script je zodpovědný za přenos souborů pluginu do adresáře pluginů GgMapy a také za smazání všech souborů pluginu (tedy i *.meta.ini a *.ggi.pas) při odinstalování pluginu.

Existuje univerzální instalační script (2.65 KiB, 1y ago, 63 downloads), který se za při dodržení několika podmínek pro tvorbu balíčku a pojmenování souborů o vše postará a autor pluginu jej nemusí pracně tvořit a ladit.

Ke správné funkci univerzálního instalačního scriptu je třeba, aby obsah *.gip souboru měl strukturu:

• adresář GgMap
  • soubor JmenoPluginu.meta.ini
  • soubor JmenoPluginu.ggi.pas
  • adresář JmenoPluginu
    • soubor JmenoPluginu.ggm.js
    • nepovinně soubor JmenoPluginu.css
    • nepovinně adresář JmenoPluginu
      • další soubory, které plugin využívá

Další požadavky:

• při kopírování instalačního scriptu je nutné změnit jeho jméno na JmenoPluginu.ggi.pas
• soubor JmenoPluginu.meta.ini obsahuje položku Parent=ggmap_plugin
• soubor JmenoPluginu.meta.ini obsahuje spuštění instalačního scriptu, v sekci [install] položka script=Ggmap\JmenoPluginu.ggi.pas
• soubor JmenoPluginu.meta.ini obsahuje spuštění odinstalačního scriptu, v sekci [uninstall] položka Ggmap\JmenoPluginu.ggi.pas= (script je při instalaci přesunut o adresář výš)

Pokud budou výše uvedené požadavky splněny, pak instalační a odinstalační funkce v instalačním scriptu se postarají o vše potřebné.

Zde jsou uvedeny jednoduché ukázky základních operací.

function cuzk_ggm_init() {
  ggmregister('onmap', cuzk_ggm_run);
};

Funkce v tomto případě obsahuje jediný řádek, který registruje funkci cuzk_ggm_run pro spuštění po inicializaci mapových objektů. (Tato konkrétní funkce zajistí doplnění jedné mapy a jedné překryvné vrstvy do menu map. Plugin cuzk je součástí instalace mapy.)

*.css soubor je vždy v základním adresáři pluginů a má stejné jméno jako plugin.

function jmenoPluginu_ggm_init() {
	loadcss('plugin/jmenoPluginu.css');
}

Pokud má plugin na mapě nějaký ovládací prvek, je vhodné jeho nadřízenému div přidat třídu movable, nejlépe tak, aby vypadal stejně jako ostatní bloky ovládacích prvků, tedy

<div id="..." class="noprint leaflet-control-layers movable">
...
</div>

Pak bude mít jednak jednotný vzhled a zároveň jej bude možné přesouvat po mapě, bude-li nainstalován také plugin Movable. Zde bych doporučil ještě přečíst Pohled pod pokličku, aby to přesouvání určitě fungovalo.