Nápověda: Manažer módů

Přehled

Pokud jste v TNG noví, Manažer módů je nástroj pro administrátory, který jim umožňuje instalovat, spravovat a odstraňovat úpravy softwarového balíčku TNG, a to buď stažením a instalací "módů" vytvořených ostatními z TNGWiki, nebo vytvořením vlastních módů (a možná také jejich sdílením).

Mód je textový soubor s příponou .cfg napsaný pomocí editoru kódu. Obsahuje "příkazy", které říkají Manažeru módů (MM), jak jeho instalací upravit kód v cílových souborech. Může také kopírovat soubory z doprovodné podpůrné složky nebo dokonce vytvářet nové soubory. -- podrobnosti najdete na stránce TNGWiki Mod Manager (v angličtině).

Nahoru

Seznam módů

Na stránce Administrace TNG zobrazí Manažer módů (MM) seznam všech modů ve složce "mods". Tuto složku můžete přejmenovat v Nastavení >> Základní nastavení >> Umístění a složky.

Pokud jste ještě žádné módy do složky "mods" na vašem webu nenačetli, bude výpis MM prázdný. Ze stránek TNGWiki si můžete stáhnout stovky modů. Přicházejí ve formě souborů zip, které budete muset rozbalit a nahrát do složky "mods" na vašem webu pomocí programu FTP, jako je FileZilla nebo WinSCP, který můžete získat zdarma z internetu

Před zobrazením modů Manažer módů zkontroluje každý z nich, zda je již nainstalován nebo zda jej lze nainstalovat, a hledá chyby, které by bránily jeho instalaci nebo odstranění. Výsledek se zobrazí ve výpisu módu ve sloupci Stav. Podrobnosti zobrazíte kliknutím na ikonu šipky nebo stavový text a poté na tlačítko Podrobnosti.

Všechny uvedené mody mají barevně označený stav instalace:

  • Lze instalovat (bílý) -- MM potvrdil, že všechny příkazy v konfiguračním souboru módu lze nainstalovat bez chyby.
  • Instalováno (zelený) -- všechny komponenty z konfiguračního souboru módu jsou nainstalovány.
  • Částečně instalováno (oranžový) -- některé komponenty módu jsou nainstalovány a některé ne. To se může stát, pokud obnovíte soubor TNG, který byl součástí instalace Modu.
  • Nelze nainstalovat (červený) -- některé konfigurační soubory módu nelze nainstalovat, například proto, že cílový soubor chybí.

Panel filtrů

V horní části seznamu modů je panel filtrů, který omezuje zobrazení na módy s vybraným stavem nebo na Všechny módy nebo pouze ty, které Vyberete. Výběr libovolného filtru kromě Všech zobrazí seznam se zaškrtávacím políčkem pro každý zobrazený mód. Zaškrtnutí jednoho nebo více polí umožňuje další zpracování vybraných módů.

Pokud například vyfiltrujete mody, které jsou ve stavu Lze instalovat a poté stisknete Provést, váš seznam bude obsahovat pouze ty módy, které jsou připraveny k instalaci. Pomocí zaškrtávacích políček ve filtrovaném seznamu můžete vybrat jedno, několik nebo všechny z nich, poté stisknout tlačítko Instalovat a módy se nainstalují hromadně. Všimněte si tlačítek Vybrat vše a Vyčistit vše, která vám pomohou se zaškrtávacími políčky.

Upozornění: Dávkové operace byste měli provádět pouze v případě, že máte dobrou zálohu svých webových stránek a můžete ji rychle obnovit, pokud dávkové operace způsobí nefunkčnost vašeho webu. To se může snadno stát, když neodstraníte předchozí verze modů.

Poznámka: Před upgradem TNG doporučujeme dávkově odinstalovat všechny nainstalované módy a poté dávkově vyčistit všechny zbývající částečně nainstalované módy.

Filtr Vybrat zobrazí všechny módy a přidá zaškrtávací políčka. Vyberte jeden nebo více z nich a stiskněte tlačítko Vybrat. Manažer módů zobrazí pouze vybrané módy. To může být užitečné pro izolaci a testování jednoho módu bez zobrazení nebo zpracování ostatních.

Pokud zaškrtnete políčko Zamknout u jakéhokoli filtrovaného záznamu, zůstane filtrovaný i po obnovení stránky. Zápis zůstane uzamčen, dokud jej nezrušíte nebo nepoužijete jiný filtr.

Sloupce seznamu módů

První tři sloupce jsou samozřejmé. V závislosti na nastavení zobrazení Manažera modů na kartě Možnosti můžete kliknout na Název módu a mód se zobrazí v tabulce parseru. Kliknutím na Název konfiguračního souboru zobrazíte na nové kartě obsah konfiguračního souboru módu.

Pokud sloupec Wiki obsahuje ikonu wiki (W), můžete na ni kliknout a přejít na článek TNGWiki, který obsahuje popis a další informace o módu a také odkaz ke stažení módu.

Pátý sloupec je sloupec Stav. Zobrazuje barevně odlišený stav instalace módu, jak je vysvětleno výše. Kliknutím na text stavu se otevře panel s popisem a příslušnými ovládacími prvky pro správu módu. Pokud je k dispozici tlačítko Podrobnosti, můžete vidět podrobný seznam všech akcí, které byly nebo mají být provedeny pro správu módu. Budou zobrazeny všechny chyby.

Pro pokročilé uživatele jsou chybové zprávy často doprovázeny číslem E. To odkazuje na číslo řádku v souboru MM, kde došlo k chybě. E-čísla v seznamu modů jsou všechna generována souborem classes/modlister.class.php. V blízkosti tohoto čísla řádku se často objeví komentář vysvětlující povahu chyby a návrh možných oprav.

Pokud se nevyskytnou žádné chyby, jednoduše stiskněte příslušný ovládací prvek pro instalaci nebo odinstalování (odstranění) módu.

Některé módy jsou částečně nainstalovány. Když uvidíte tento stav, stiskněte tlačítko Vyčistit a MM odstraní všechny nainstalované součásti. Obvykle vám zůstane čistý mód, který lze znovu plně nainstalovat.

Pokud mód zůstává částečně nainstalován i po několika pokusech o jeho vyčištění, měli byste upozornit vývojáře módu. Chcete-li upozornit vývojáře, klikněte na ikonu Wiki (W) a přejděte na stránku TNGWiki a poté klikněte na odkaz Mod Support. Pokud neexistuje odkaz na podporu, kliknutím sem získáte další pomoc.

Poslední sloupec, Soubory, obsahuje ikonu pro další informace. Umístěte na něj kurzor a vyskakovací okno vám sdělí všechny soubory, které jsou nebo budou upraveny tímto modem.

Hledání další pomoci

Pokud potřebujete další pomoc, ať už se Manažerem módů, nebo s konkrétním módem, můžete provést jednu z následujících akcí:

  • Potřebujete-li pomoc s chybami nebo problémy v Manažeru módů
    • kontaktujte Rick Bisbee zde
    • kontaktujte Ken Roy: zde
  • Potřebujete-li pomoc s nějakým módem
    • kontaktujte vývojáře modu ze stránky TNGWiki spojené s modem
    • přejděte na TNG Fórum a vyhledejte název módu. Pokud nenajdete nic užitečného, můžete si vytvořit účet a zanechat žádost o pomoc na ostatní uživatele.
    • použijte Seznam e-mailových diskuzí a položte otázku. Začněte kliknutím sem.

Nahoru

Editor módů

Editor modů (parametrů) je přístupný ze stránky se seznamy modů. Pokud má nainstalovaný mód upravitelné parametry, uvidíte to ve sloupci Stav v seznamu modů jako -- Instalováno [Možnosti]. Chcete-li upravit parametry módu, otevřete panel Stav a klikněte na tlačítko "Upravit možnosti". Editovatelné parametry jsou uživatelské možnosti módu, například nastavení barvy pro něco.

Chování cílového souboru lze řídit hodnotou parametrů. Uživatel módu může být například požádán, aby zadal počet dní, po které si přeje uchovávat určité soubory protokolu.

Počet parametrů, které může mód použít, není omezen. Každý parametr má výchozí hodnotu zobrazenou na panelu popisu editoru módu vlevo. Panel vpravo obsahuje oblast pro změnu hodnoty parametru. Jsou zde také dvě tlačítka, jedno pro aktualizaci cílového souboru s hodnotou ve vstupním poli a druhé pro resetování parametru na výchozí hodnotu.

Ať už zadáváte řetězce nebo celá čísla, není nutné je uzavírat do uvozovek. Editor módů to zjistí při aktualizaci hodnot.

Nahoru

Zobrazit protokol

V závislosti na uživatelských preferencích na kartě Možnosti se při chybách generovaných během instalace nebo odstranění módu automaticky otevře protokol chyb, takže administrátor může vidět, co se pokazilo. Jinak můžete otevřít protokol a zobrazit podrobnosti o svých operacích.

Řádek protokolu zobrazuje datum a čas, pokus o operaci, název a verzi módu, výsledek a funkcionáře (správce webu), který operaci provedl.

Chcete-li zobrazit podrobnosti, klikněte na řádek protokolu. Otevře se panel. Každý příkaz (začínající znakem %) zobrazuje číslo řádku v konfiguračním souboru módu, kde byl příkaz proveden, a výsledek.

Jak bylo uvedeno dříve, chyby jsou doprovázeny číslem E odkazujícím na číslo řádku v souboru TNG Manažeru módů, kde k chybě došlo. Pokud k tomu došlo během pokusu o instalaci, E-číslo bude odkazovat na soubor classes/modinstaller.class.php. Když tento soubor otevřete s číslem řádku, často uvidíte poblíž komentář vysvětlující chybu a navrhující řešení.

Nápovědu k příkazům a jejich použití naleznete na TNGWiki. Můžete také kliknout na odkaz Syntaxe módů přímo pod záložkami Manažera módů na většině obrazovek MM.

Nahoru

Možnosti

Karta Možnosti otevře obrazovku uživatelských preferencí rozdělenou do tří částí.

V sekci Protokol Manažeru módů můžete zadat preference týkající se souboru protokolu. Pod Název souboru protokolu můžete ve skutečnosti zadat cestu k serveru, abyste umístili svůj protokol mimo oblast webových stránek, která je přístupná z prohlížeče. Výchozí nastavení je umístit jej do kořenového adresáře TNG.

Nastavení zobrazení je místo, kde můžete zobrazit nebo skrýt karty na stránce Manažeru módů.

Jiné vám umožňuje rozhodnout, jak nakonfigurovat schopnost Manažeru módů mazat mody a jejich podpůrné složky.

  • 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é.

Nastavte předvolby, jak potřebujete, a stiskněte tlačítko Uložit.

Nahoru

Analýza souborů TNG

Karta Analýza souborů TNG je volitelná karta, kterou lze povolit na obrazovce Možnosti.

Toto je pokročilý nástroj, který vám umožňuje vybrat soubor TNG a zobrazit, které módy mění nebo změní tento konkrétní soubor TNG. Pokud se soubor neobjeví v seznamu vlevo, znamená to, že na něj necílí žádné mody.

Když vyberete soubor v levém sloupci, zobrazí se v pravém sloupci s názvy a stavem modů, které jej ovlivní. Odtud můžete kliknout na odkaz "Zobrazit úpravu" a zobrazit skutečnou změnu, kterou provede v cílovém souboru. Není v rozsahu tohoto souboru nápovědy probírat příkazy konfigurace módů a jak fungují. Informace naleznete na TNGWiki.

Pokud jste zvolili na kartě Možnosti, Nastavení zobrazení, "Zobrazit akce v analyzátoru modů", uvidíte také odkazy, které vám umožní nainstalovat, odinstalovat nebo smazat mód přímo z této obrazovky, v závislosti na aktuálním stavu.

V horní části seznamu uvidíte panel filtrů s výběry pro Všechny mody, Pouze nainstalované mody nebo Instalované+částečně nainstalované mody. Výběrem Pouze nainstalované mody a kliknutím na Odeslat dotaz omezíte soubory v levém sloupci na ty, které jsou ovlivněny pouze aktuálně nainstalovanými mody.

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

The TNG Wiki provides additional information for the mod developers on Using the Mod Analyzer.

Další informace o Použití analyzátoru módů< /a> poskytuje vývojářům módů TNG Wiki.

Nahoru

Tabulka parseru

Tento nástroj je určen hlavně pro ladění modů. Tabulka parseru ukazuje, jak Manažer módů zanalyzoval příkazy konfiguračního souboru módu (.cfg). Je to zobrazeno ve formě tabulky, přičemž každý řádek představuje příkaz módu. Data uvedená v tabulce jsou předána dalším skriptům manažeru módů k dalšímu zpracování - instalaci, odstranění atd. Pokud se vyskytne problém s módem, je dobré začít s tabulkou parseru, abyste zjistili, zda jsou všechny příkazy a argumenty módu správně zachyceny.

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

Zobrazení této karty je volitelné. Chcete-li jej použít, vyberte na kartě Možnosti "Zobrazit další nástroje pro vývojáře". Pokud je možnost karty vypnutá, bude také deaktivován odkaz na stránce seznamu.

Není v rozsahu tohoto souboru nápovědy probírat příkazy konfigurace módů a jak fungují. Informace naleznete na TNGWiki.

Nahoru

Doporučené aktualizace

Záložka Doporučené aktualizace je volitelná a lze ji povolit na obrazovce Možnosti. Umožňuje aktualizovat soubory cust_text.php, pokud jste tak neučinili v rámci readme aktualizace TNG.

Další informace (v angličtině) naleznete v článku Mod Manager a v kategorie článků TNG Mod Manager na TNG Wiki.

V TNG Wiki si můžete prohlédnout článek Mod Manager jaká vylepšení byla provedena v TNG v12.

Nahoru

Poděkování

Brian McFadyen
  • autor
Sean Schwoere
  • integrace pro Joomla
  • lepší integrace pro instalaci, odebírání a správu módů
Ken Roy
  • vedoucí vývojového týmu, verze 12 - 14
  • vytvořil kartu Zobrazit protokol
  • vytvořil kartu Možnosti
Rick Bisbee
  • vedoucí programátor, verze 12 - 14
  • přidal dávkové zpracování
  • přidal kartu Zobrazit tabulku parseru
  • přidal kartu Analyzovat soubory TNG
  • refaktoroval kód TNG pro údržbu, v14
Jeff Robson
  • beta testovací tým, verze 12
  • přidal kartu Ovlivněné soubory
  • hlavní příspěvky ke stylu
Robin Richmond
  • beta testovací tým, verze 12
  • poskytl kód pro přerušení dlouhých řádků textu bez mezer, který se používá především ve sloupci Stav MM
  • hlavní příspěvky k zobrazení protokolu MM
Michel Kirsh
  • beta testovací tým, verze 14
  • hlavní aktualizace Analýzy souborů TNG
beta testovací tým TNG v14
  • Mogens C. Fenger
  • William Herndon
  • Michel Kirsch
  • Ron Krzmarzick
  • Roger Moffat
  • Jan-Thore Solem