Manažer módů TNG verze 12 je založen na Manažeru módů, který byl původně vyvinut Brianem McFadyenem, následně zaktualizován Seanem Schwoerem pro práci s Joomla TNG Component a ve verzi 10.0.3 a 10.1 zaktualizován o 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ů. Složka mods může být přejmenována. Manažer módů používá pro práci s názvem složky proměnnou $modspath.
• extensions obsahuje některá rozšíření módů, které jsou instalovány jinými konfiguračními soubory manažeru módů. Složka extensions může být přejmenována. Manažer módů používá pro práci s názvem složky proměnnou $modspath.
• 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.

Pokud je povolena možnost Zobrazit další nástroje pro vývojáře, TNG v12 přidává následující změny:

• kliknutím na název souboru se otevře tabulka parseru pro tento mód
• kliknutím na název souboru cfg se zobrazí soubor cfg na jiné záložce
• tlačítko Podrobnosti v buňce Stav funguje jako přepínač pro rozbalení nebo sbalení zobrazení směrnic souboru ve stavu Instalovat nebo Lze instalovat.

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 a Robinem Richmondem 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 Analýza souboru TNG je volitelná záložka, jejíž zobrazení lze povolit na obrazovce Možnosti, a umožňuje vybrat soubor TNG a zobrazit, které módy jej mění.

Záložka Tabulka parseru je volitelná záložka, jejíž zobrazení lze povolit na obrazovce Možnosti povolením Další nástroje pro vývojáře, a umožní zobrazit, jak je daný mód analyzován Manažerem módů.

Záložka Doporučené aktualizace je volitelná záložka, jejíž zobrazení lze povolit na obrazovce Možnosti, která vám umožní aktualizovat soubory cust_text.php, pokud jste tak neučinili v rámci aktualizace 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.

You can view the Mod Manager article in TNG Wiki to see what enhancements were made in TNG v12.

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
• vytvoří zadanou složku nebo adresář
• identifikuje nové soubory, které mají být vytvořeny. Pokud je soubor označen jako chráněný, nebude odstraněn Odinstalací ani Vyčištěním.
• identifikuje soubory, které mají být zkopírovány do kořenové složky TNG nebo do určené složky. Pokud je soubor označen jako chráněný, nebude odstraněn Odinstalací ani Vyčištěním.

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 (name) - název módu, článek na TNG Wiki a název souboru
• Verze (version) - verze módu, kde první 3 číslice představují nejnižší verzi TNG, ve které mód funguje
• Popis (description) - 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 následně obsahuje příkazy. K cílové sekce lze přidat poznámku.

• Umístění (location) - určuje umístění kódu, který je v souboru měněn. K umístění lze přidat poznámku.
• 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 Částečně nainstalováno, 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ž byste je nejprve odinstalovali. 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. Tlačítko Vymazat se zobrazí pouze v seznamu Vybrat, pokud jsou povoleny oba možnosti vymazání.

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ů. Je doporučeno Před provedením aktualizace TNG doporučujeme odinstalovat všechny nainstalované módy a poté vyčistit všechny částečně nainstalované módy.

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é
• Vybrat - přidáno v TNG v12 - zobrazí se seznam všech modů, které mohou být vybrány bez ohledu na stav a poté pouze vrací tyto módy do seznamu
• Tlačítko Vymazat bude dostupné pouze na seznamu Vybrat, pokud máte aktivní volbu Povolit Vymazat vybrané u částečně nainstalovaných módů. Tato funkce byla přidána hlavně pro vývojáře módů k vyčištění jejich testovacích prostředí.

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.
• Odstranit mezery z názvů souborů 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 Analýza souborů TNG - umožní určit, zda chcete zobrazit záložku Analýza soouborů TNG. Výchozí volbou je Ne, která potlačí zobrazení záložky Analýza soouborů TNG.
• Zobrazit další nástroje pro vývojáře - umožní určit, zda chcete zobrazit záložku Tabulka parseru. Výchozí volbou je Ne, která potlačí zobrazení záložky Tabulka parseru. Tato volba také řídí, zda se na kliknutí na název módu zobrazí tabulka parseru pro daný mod a zda se kliknutím na název konfiguračního souboru zobrazí na nové záložce konfigurační soubor.
• Zobrazit záložku Doporučené aktualizace - umožní určit, zda chcete zobrazit záložku Doporučené aktualizace. Výchozí volbou je Ne, která potlačí zobrazení záložky Doporučené aktualizace. Tato záložka nemusí být zobrazena, pokud jste provedli aktualizaci souboru cust_text.php v rámci aktualizace na TNG v12.

Jiné možnosti

• Povolit Vymazat vybrané pro částečně nainstalované módy - povolí zobrazení tlačítka Vymazat v seznamu vybraných Částečně nainstalovaných módů, 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 v případě, že potřebujete vymazat více modů, aniž byste museli odinstalovat aktuální verze, abyste odstranili předchozí verze módu, když jste zapomněli odinstalovat a vymazat předchozí verze modu před instalací nové verze. Normálně tuto volbu nechte nastavenou na Ne a volbu Ne obnovte po odstranění předchozích verzí módu, které se zobrazují jako částečně nainstalované.
• Povolit Vymazat pro samostatně nainstalované módy - 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 a volbu Ne obnovte po odstranění předchozích verzí módu, které se zobrazují jako nainstalované.
• Povolit smazání podpůrné složky po vymazání modu - umožní zapnutí volby smazání složky (složek) přidružených k módu při mazání módu. Výchozí volbou je Ne. Doporučujeme tuto možnost povolit jen tehdy, pokud chápete nebezpečí vymazání nezamýšlených složek. Věříme, že toto riziko je velmi malé.

Nahoru

Tento nástroj na záložce Analýza souborů TNG, který vytvořil Rick Bisbee, existoval dříve jako opravný mód. Analýza souborů TNG umožňuje vývojářům zkoumat 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 Analýza souborů TNG zobrazena, musíte ji povolit nastavením volby Analýza souborů TNG 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ě).

Top

Tento nástroj je určen hlavně pro vývojáře. Tabulka parseru ukazuje, jak Manažer módů zanalyzoval konfigurační soubor módu (.cfg) zapracováním jeho komponent do tabulky, která pak prochází do dalších skriptů Manažeru módů pro další zpracování. Pokud se vyskytne problém s módem, první místo, které je třeba zkontrolovat, je tabulka parseru, aby se zjistilo, zda jsou správně zachyceny všechny příkazy a argumenty módu.

Tuto záložku můžete použít k výběru módu ze seznamu, jehož tabulku chcete zobrazit, nebo, pokud jste povolili možnost Zobrazit další nástroje pro vývojáře, můžete kliknout na název módu v Seznamu módů a zobrazit tabulku parseru pro tento mód.

Zobrazení této záložky je volitelné. Chcete-li jej použít, vyberte možnost 'Nastavení zobrazení/Zobrazit další nástroje pro vývojáře' na záložce Možnosti. Pokud je volba záložky vypnuta, odkaz na stránce se seznamem nebude také povolen.

Top

Záložka Doporučené aktualizace je volitelná záložka, která může být povolena na obrazovce Možnosti, a umožní vám aktualizovat soubory cust_text.php, pokud jste tak neučinili jako součást aktualizace TNG.

Použití záložky se předpokládá v případě, že mód nemůže být nainstalován, protože hledá nový komentářový řetězec v horní části souborů cust_text.php počínaje TNG v12. Tato volba bude vypnuta po kliknutí na tlačítko Aktualizovat a změně stávajících souborů cust_text.php. Kód kontroluje, zda byly tyto soubory již dříve aktualizovány.