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

Přehled

TNG Manažer módů, který původně vyvinul Brian McFadyen a pro práci s Joomla TNG Component aktualizoval Sean Schwoere, je určen k poskytnutí ucelenějšího způsobu instalování, odstraňování a správě modifikací TNG software, který s tímto manažerem dokáže pracovat. Aktualizace v TNG V9 provedli Bart Degryse a Ken Roy. Manažer módů je pro snazší přístup připojen ke stránce Administrace TNG. Manažer módů přidává do 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ů

Dávkovou instalaci přidal do TNG 10.0.3 Rick Bisbee a umožňuje vykonat stejnou akci pro více módů. Popup okno s popisem přidal Jeff Robison.

Možnosti přidal do TNG 10.0.3 Ken Roy a umožňuje měnit některé chování manažeru módů.

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ů pro snadnější čitelnost akcí přeformátoval Rick Bisbee.

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

Nahoru

Operace

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

Stav

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í bylo určeno, pak je uvedena možnost Instalovat
  • Instalováno, pokud mód byl nainstalován, je uvedena možnost Odstranit mód a možnost Upravit parametry, pokud nějaké existují
  • Vyčistit, 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 vytvořený soubor.
  • Nelze nainstalovat, pokud mód nelze instalovat. Tato zpráva bude předcházet jinou zprávu, která 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ů

Nahoru

Syntaxe módů

The Mod Manager syntax basically includes:

Sekce 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ílové sekce (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

Konfigurační soubory

Instalování módů

Informace o použití konfiguračních souborů k instalaci módů najdete na TNG Wiki.

Interpretace stavu

Informace o interpretaci stavu najdete na TNG Wiki.

Syntaxe konfiguračních souborů

Informace o syntaxi konfiguračních souborů najdete na TNG Wiki.

Vytvoření konfiguračního souboru

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

Nahoru

Dávková instalace

Dávková instalace umožní provést specifické akce týkající se několika módů pomocí výběru filtru. Z filtru seznamu stavů vyberte požadovaný stav a kliknutím na Provést zobrazíte dostupná ovládací tlačítka pro vybraný stav. Pro stav Vyčistit není k dispozici akce Odstranit, takže pro odstranění módů ve stavu Vyčistit musíte použít záložku Seznam 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
  • Vyčistit - zobrazí se seznam všech módů, které mohou být
    • Vyčištěny - na základě vašeho výběru a kliknutím na tlačítko Vyčistit
  • 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

Nahoru

Možnosti

Možnosti vám umožní specifikovat chování manažeru módů v případě

Seznamu dotčených souborů

  • Zobrazit seznam dotčených souborů - umožní vám zvolit, zda chcete v tabulce seznamu módů zobrazit seznam dotčených souborů. Výchozí volbou je Ano.
  • Zobrazit v seznamu nové soubory - zobrazí nové soubory vytvořené módem. Výchozí volbou je Ano.
  • Zobrazit v seznamu kopírované soubory - zobrazí soubory, které jsou kopírovány módem. Výchozí volbou je Ano.
  • Zobrazit seznam ve sloupci - zobrazí seznam dotčených souborů ve zvoleném sloupci. Výchozí volbou je sloupec Název konfiguračního souboru.
  • Zobrazit seznam jako - umožní vám zvolit, zda chcete seznam zobrazit jako tabulku nebo jako hodnoty oddělené čárkou. Výchozí volbou je Tabulka.
  • Zobrazit seznam v Dávkové instalaci - umožní vám zvolit, zda chcete seznam zobrazit na záložce Dávková instalace ve vyskakovacím okně. Výchozí volbou je Ano.

Protokolu manažeru módů

  • Zaznamenávat akce manažeru módů - umožní vám zvolit, zda chcete zaznamenávat potvrzení a akce manažeru módů. Výchozí volbou je Ano.
  • 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 řádků - umožní vám určit, kolik řádků bude zachováváno v protokolu. Výchozí volbou je 2000.

Jiné

  • Řadit seznamy podle - umožní vám zvolit, podle kterého sloupce bude řazen Seznam módů a Dávková instalace. Výchozí volbou je Název konfiguračního souboru.
  • Vynechat potvrzení - umožní vám zvolit, zda chcete vynechat zobrazení obrazovky Potvrzení v Seznamu módů. I když zvolíte Ano, Potvrzení bude stále zapisováno do protokolu. Výchozí volbou je Ne.
  • Vynechat zprávy o akcích - umožní vám zvolit, zda chcete vynechat zobrazení obrazovky Zpráva o akci v Seznamu módů. I když zvolíte Ano, Zpráva o akci bude stále zapisována do protokolu. Výchozí volbou je Ne.