Verze Manažeru módů TNG 10.1 je založena na Manažeru módů, který původně vyvinul Brian McFadyen a pro práci s Joomla TNG Component aktualizoval Sean Schwoere. Manažer módů v sobě spojuje Seznam módů a Dávkové instalace z TNG 10.0.3 a poskytuje integrovanější způsob instalace, odstranění a řízení změn softwarového balíku TNG.

Nový Manažer módů nabízí jednoduchý řádkový souhrn stavů módů, který může být rozšířen na zobrazení kompletního popisu a chyb. Seznam souborů, které daný mód ovlivňuje, lze zobrazit přejetím kursorem myši nad znaménkem + ve sloupci Soubory. K rozbalení všech záznamů a zobrazení stavu můžete podobně jako ve starém Manažeru módů použít také tlačítko Rozbalit vše v horním menu. Volba Rozbalit vše je užitečná při filtrování seznamu na stavy Částečně nainstalováno nebo Nelze nainstalovat, takže můžete vidět chyby, které se zde objevují.

Manažer módů je pro snazší přístup přidán na stránku Administrace TNG. Manažer módů vytváří v TNG tyto složky:

• mods obsahuje konfigurační soubory módů a přidružené podpůrné soubory módů
• extensions obsahuje některá rozšíření módů, které jsou instalovány jinými konfiguračními soubory manažeru módů
• classes obsahuje třídy Objektově orientovaného programování (Object Orient Progamming classes), které byly rozděleny a vylepšeny z předchozího souboru managemods.class.php, který vytvořil Sean Schwoere z původní kódu Manažeru módů od Briana McFadyena.

Záložka Seznam módů nyní spojuje předchozí Seznam módů a Dávkové instalace, které do TNG 10.0.3 přidal Rick Bisbee, a umožňuje vykonat stejnou akci pro více módů. Popis a rozšířený stav lze zobrazit pomocí kliknutí na šipku vpravo ve sloupci Stav nebo kdekoli na řádku. Přejetím kurzorem myši nad řádkem se zvýrazní řádek a usnadní se tak výběru stavu pro rozšířené zobrazení. Přejetím kurzoru myši přes znaménko + ve sloupci Soubory se zobrazí seznam souborů, které daný mód mění, vytváří nebo kopíruje.

Záložku Zobrazit protokol přidal do TNG 10.0.3 Ken Roy a zobrazuje protokol manažeru módů, který je nyní oddělen od protokolu administrace. Protokol manažeru módů je přeformátovaný protokol z Manažeru módů vytvořeného Rickem Bisbee v TNG 10.0.3 a srozumitelnost vykonaných akcí zaznamenaných v protokolu je nyní lepší. Zprávy a hlášení byly značně zjednodušeny.

Záložka Možnosti je modifikací záložky přidané Kenem Royem do TNG 10.0.3 a umožňuje měnit některé chování manažeru módů.

Záložka Analyzér je volitelná záložka, jejíž zobrazení lze povolit na obrazovce Možnosti, a umožňuje zobrazit, které módy mění určitý php skript v TNG.

Další informace můžete najít v článku Manažer módů (v angličtině) a v kategorii článků TNG Mod Manager (v angličtině) na TNG Wiki.

Nahoru

Manažer módů prozkoumá složku módů a přečte každý soubor cfg, který najde. Soubory cfg jsou direktivní soubory, které popisují mód, soubory a umístění, které má být modifikováno, a kód, který je při modifikaci použit.

Manažer módů zkontroluje následující:

• zajistí, že je uživatel přihlášen
• prověří umístění a změnu každého kódu
  • zajistí, že lze umístění nalézt
  • zajistí, že cílové místo je jedinečné
  • určí, zda cílové umístění již bylo nainstalováno
• určí nové soubory, které mají být vytvořeny. Pokud nový soubor již existuje, určí jeho verzi.

Nahoru

Manažer módů vrací následující stavy:

• Lze instalovat, pokud mód ještě nebyl nainstalován a cílové umístění je identifikováno, pak je uvedena možnost Instalovat
• Instalováno, pokud již mód byl nainstalován, je uvedena možnost Odinstalovat mód a možnost Upravit parametry, pokud nějaké existují. Módy s editačními parametry jsou identifikovány podle [Možnosti] za stavem Instalováno.
• Částečně instalováno, pokud mód byl částečně nainstalován, je k dispozici tlačítko Vyčistit. Operace Vyčištění se pokusí odstranit vložený kód, obnovit a nahradit kód, a odstranit jakékoli vytvořené nebo zkopírované soubory.
• Nelze nainstalovat, pokud mód nelze instalovat. Rozšíření (zobrazení kompletní informace) stavu poskytne více informací o tom, proč mód nelze nainstalovat.

Příklady obrazovek stavu manažeru módů a jak interpretovat různé stavy najdete na Manažer módů - interpretace stavů (v angličtině)

Nahoru

Syntaxe manažera módů v zásadě zahrnuje:

Sekci záhlaví, která obsahuje

• Název - název módu, článek na TNG Wiki a název souboru
• Verze - verze módu, kde první 3 číslice představují nejnižší verzi TNG, ve které mód funguje
• Popis - obsahuje stručný popis módu, jméno vývojáře a URL článku o daném módu na TNG Wiki.

Cílovou sekci (Target), kde je specifikován soubor, který je opravným módem změněn, a obsahuje tyto příkazy

• Location - určuje umístění kódu, který je v souboru měněn
• Klíčové slovo akce - určuje, zda přepsat (Replace) nebo vložit (Insert) kód před (Before) nebo za (After) toto umístění

Příkaz Nový soubor (New File), který po instalaci módu vytvoří nový soubor

Příkaz Kopírovat soubor (Copy File), který nakopíruje určitý soubor do řídící složky TNG (%copyfile) nebo do podsložky (%copyfile2)

Detailní informace týkající se syntaxe módů najdete v článku Mod Manager Syntax (v angličtině)

Nahoru

Informace o instalaci konfiguračních souborů (v angličtině) k instalaci módů najdete na TNG Wiki.

Informace o interpretaci stavu (v angličtině) najdete na TNG Wiki.

Informace o syntaxi manažeru módů (v angličtině) najdete na TNG Wiki.

Informace pro vývojáře o vytvoření konfiguračních souborů (v angličtině) najdete na TNG Wiki.

Nahoru

Funkce Dávková operace, v TNG 10.0.3 představená jako Dávkové instalace, je nyní součástí Seznamu módů a umožní provést specifické akce týkající se více módů pomocí výběru filtru. Z filtru seznamu stavů musíte vybrat požadovaný stav a kliknutím na Provést zobrazíte dostupná ovládací tlačítka pro vybraný stav. Akce Vymazat je k dispozici pouze pro stav Vyčistit, pokud povolíte příslušnou předvolbu. Doporučujeme ji nastavit na Ne, kromě případů, kdy je potřeba vymazat více módů ve stavu Částečně nainstalováno, jako např. předchozí verze téhož módu. Stejně tak je zde možnost Vymazat instalované módy, která umožní vymazání nainstalovaných módů, aniž by došlo k jejich odstranění. Tato možnost byla přidána, aby bylo možné vymazat předchozí verze téhož módu, pokud jste je zapomněli vymazat před instalací nové verze. Zde opět doporučujeme ponechat možnost jako Ne a povolit ji jen v případě potřeby.

Upozornění: Dávkové operace používejte pouze tehdy, pokud máte zálohu vašich webových stránek a můžete je snadno obnovit v případě, že vlivem dávkových operací dojde k poškození vašich stránek, což se může snadno stát, pokud nevymažete předchozí verze módů.

Možnosti výběrového filtru jsou tyto:

• Vše - zobrazí se úplný seznam všech souborů .cfg ze složky mods. Pokud zvolíte určitý stav, objeví se dostupná tlačítka jednotlivých akcí
• Lze nainstalovat - zobrazí se seznam všech módů, které mohou být
• Nainstalovány - na základě vašeho výběru a kliknutím na tlačítko Instalovat
• Vymazány ze složky mods - na základě vašeho výběru a kliknutím na tlačítko Vymazat
• Instalováno - zobrazí se seznam všech módů, které jsou aktuálně nainstalovány, a mohou být
• Odstraněny - na základě vašeho výběru a kliknutím na tlačítko Odstranit
• Částečně instalováno - zobrazí se seznam všech módů, které jsou částečně instalovány a musí být
• Vyčištěny - na základě vašeho výběru a kliknutím na tlačítko Vyčistit vybrané
• Nelze nainstalovat - zobrazí se seznam všech módů, které nelze nainstalovat z důvodu chybného cílového souboru nebo chybějících souborů, a mohou být
• Vymazány ze složky mods - na základě vašeho výběru a kliknutím na tlačítko Vymazat vybrané

Nahoru

Možnosti vám umožní specifikovat chování manažeru módů.

Možnosti protokolu Manažeru módů

• Název protokolu - umožní vám určit název souboru, který bude použit pro protokol manažeru módů. Výchozí volbou je modmgrlog.txt.
• Maximální počet transakcí - umožní vám určit, kolik transakcí bude zachováváno v protokolu. Výchozí volbou je 200 transakcí.
• Sbalit zobrazení protokolu - umožní vám určit, zda chcete při úvodním zobrazení vidět protokol v zúženém nebo rozšířeném stavu. Výchozí volbou je Ano.
• Přesměrovat na protokol - umožní vám určit, zda chcete být ze Seznamu módů přesměrováni na záložku Zobrazit protokol v případě Pouze chyb nebo Všech transakcí. Výchozí volbou je přesměrování v případě Pouze chyb, která zobrazí protokol pouze v případě, že se vyskytne v průběhu instalace, odinstalace, vyčištění nebo vymazání chyba.
• Do protokolu zapsat celou cestu souborů - umožní vám zapsat Ne, pokud chcete u souborů v protokolu zobrazit pouze relativní cestu. Výchozí volbou je Ano pro zobrazení úplné absolutní cesty.

Možnosti nastavení zobrazení

• Řadit seznamy podle - umožní vám zvolit, podle kterého sloupce bude řazen Seznam módů. Možnosti jsou Název módu a Název konfiguračního souboru. Výchozí volbou je Název módu.
• Použít pevné záhlaví - umožní vám změnit volbu, aby nebylo zobrazeno pevné záhlaví. Tato volba není zřetelná, pokud máte velký monitor a málo módů. Výchozí volbou je Ano pro zobrazení pevného záhlaví. Bez ohledu na nastavení této volby se pevné záhlaví nezobrazí v případě chytrých telefonů (mobilní režim).
• Upravit pevné záhlaví - umožní vám povolit úpravu pevného záhlaví jQuery v případě, že pevné záhlaví není správně zobrazeno. Tato volba je potřeba pouze na určitých monitorech. Výchozí volbou je Ne a nepoužívat javascript jQuery pro úpravu pevného záhlaví.
• Použít pruhy - umožní vám změnit volbu a nepoužít pruhy při zobrazení Seznamu módů. Výchozí volbou je Ano, která použije třídu databackalt k zobrazení barevných pruhů střídavě po počtu N řádků.
• Pruh po tomto počtu řádků - umožní nastavit počet řádků, po kterém se budou střídat barevné pruhy. Výchozí volbou jsou 3 řádky jedné barvy a pak 3 řádky jiné barvy.
• Zobrazit upozornění módu ve stavu - umožní vypnout zobrazení upozornění na chyby v syntaxi. Výchozí volbou je Ano pro zobrazení upozornění. Doporučujeme, abyste toto výchozí nastavení neměnili.
• Zkomprimovat název módu v seznamu módů - umožní odstranit mezery z názvů módů před jejich zobrazením v Seznamu názvů módů. Výchozí volbou je Ne, kdy jsou mezery v názvech módů zobrazeny a tyto názvy pak odpovídají názvům článků na TNG Wiki.
• Zobrazit záložku Analyzér - umožní určit, zda chcete zobrazit záložku Analyzér konfliktu módů. Výchozí volbou je Ne, která potlačí zobrazení záložky Analyzér.

Jiné možnosti

• Povolit Vymazat vybrané u částečně nainstalovaných módů - povolí zobrazení tlačítka Vymazat vybrané na obrazovce Částečně instalované módy, pomocí kterého lze vymazat více módů najednou, jako např. vymazání předchozích verzí modů, které nebyly vymazány před instalací novější verzí. Výchozí volbou je Ne. Tuto volbu doporučujeme povolit pouze, pokud potřebujete vymazat více módů, bez nutnosti odinstalování aktuálních verzí za účelem vymazání předchozích verzí, a za normálních okolností ponechte tuto volbu nastavenou na Ne.
• Povolit Vymazat u samostatně instalovaných módů - umožní zapnutí volby zobrazení tlačítka Vymazat vedle tlačítka Odinstalovat u samostatně instalovaných módů, např. pro vymazání předchozí verze módu, která nebyla vymazána před instalací novější verze. Výchozí volbou je Ne. Doporučujeme, abyste tuto volbu povolili pouze v případě, kdy je potřeba vymazat předchozí verzi módu, bez nutnosti odinstalování aktuální verze za účelem vymazání předchozí verze, a za normálních okolností ponechte tuto volbu nastavenou na Ne.

Nahoru

Tento nástroj na záložce Analyzér, který vytvořil Rick Bisbee, existoval dříve jako opravný mód. Analyzér konfliktu módu umožňuje vývojářům zkoumat vzájemné působení módů navzájem. Situace, kdy dva módy mění stejný úsek programového kódu, má téměř vždy za následek chybu v manažeru módů. Chcete-li, aby byla záložka Analyzér zobrazena, musíte ji povolit nastavením volby Zobrazit záložku Analyzér na Ano.

Analyzér pracuje tak, že prozkoumá všechny módy ve složce mods a vytvoří soupis cílových souborů a úseků programového kódu, který každý mód mění. V levém sloupci uvede názvy dotčených souborů. Po kliknutí na název cílového souboru se na pravé straně zobrazí seznam módů, které tento cílový soubor mění. U každého módu je napravo zobrazen odkaz pro otevření sekce stránky zobrazující aktuální změny, které obsahuje konfigurační soubor manažeru módů. Uživatel může porovnat změny cílového souboru a vidět, kde mohou být skryty potenciální konflikty.

To je užitečné nejen pro nalezení konfliktů mezi dvěma módy, ale také pro poznání, které módy je třeba vyčistit a znovu nainstalovat po přepsání daného cílového souboru.

Vývojáři módů naleznou další informace na TNG Wiki v článku Using the Mod Analyzer (v angličtině).