Mod Manager
From TNG Wiki
| Mod Manager | |
|---|---|
| Summary | Allows easy management of TNG modifications. |
| Download link | Mod_Manager_V2.2.zip for TNG V7 only Mod Manager is part of TNG V8 |
| Author(s) | Brian McFadyen |
| Homepage | Mod Manager (This page) |
| Mod Support | TNG Forums |
| Latest Mod | 2.2 |
| Min TNG V | 7.1.0 |
| Max TNG V | 7.1.3 |
| Files modified | manage_mods.php |
| Related Mods | None |
| Notes | Note that the previously included config files for other mods have been removed from the bundle This mod is obsolete with TNG V8 since Brian McFadyen's Mod Manager is now part of TNG |
|
Purpose of the Mod Manager
The TNG Mod Manager is intended to provide a more integrated way to install/remove and manage modifications (mods) to the TNG software package using config files that have been coded to work with the mod manager.
A TNG Mod is small bit of code packaged together into a configuration file, using the file name extension .cfg, that manages all the changes of code needed to implement the particular modification. Simply unzip or extract the .cfg file into the proper Mod directory and the Mod Manager will see it is available to be installed if the file is properly coded. It takes just two clicks to install the Mod and just two clicks to uninstall it if needed. There may be instances where other small changes need to be completed either before or after the installation of the Mod, so please read the TNG Wiki article on the mod.
Advantages
The Mod Manager has the following advantages:
- automates the installation, removal, and management of TNG modifications
- eliminates the need to manually track TNG mods by line number, since the changes are now contained in a config file
- allows tracking stylesheet and configuration changes
Developer
The Mod Manager was developed by Brian McFadyen with testing and suggestions provided by Ken Roy.
The messages issued by the Mod Manager were converted to $text variables by Darrin Lythgoe in TNG V8 to support multiple languages.
Requirements
TNG V8 provides two subfolders:
- mods which are where you are expected to save the .cfg files you extract or unzip from the zip files provided on the TNG Wiki mod pages
- extensions where some of the mod extensions that are installed by other Mod Manager config files will be created.
NOTE even though TNG provides a folder rename capability on the full install to rename the extensions directory, please do not rename this folder at this time. Several mods have hard-coded includes for their code snippets from the extensions folder.
Note that some of the mod config files include changes to styles that are saved in mytngstyle and custom text that is saved in the languages/English/cust_text.php and languages/English-UTF8/cust_text.php.
The following are required for your mods to show an OK to install:
- your cust_text.php files must have a php terminating statement which is the ?> since the mod config files typically specify that line for the verify location before which in needs to insert the code
- your mytngstyle.css file must contain the TNG distributed lines (note that a line feed was inserted for readability in the text below)
/*your custom style goes in this file*/ /*if you're overriding style blocks from genstyle.css, you only need to include the attributes you're overriding, not the whole block*/
Mod Manager TNG V7
Since the Mod Manager is part of TNG V8, the installation instructions have been moved to Mod Manager TNG V7.
Mod Manager Status
For examples of the Mod Manager Status screens and how to interpret the various statuses, see Mod Manager - Interpreting Status
- Ready to Install
- Correctly Installed
- Cleanup Required
- Bad Target indicates possible code change Mod developers should verify that the config file is coded correctly and update the code to be verified appropriately.
- Variation of the same mod will show one as requiring cleaning. You probably should delete the version you are not using to avoid confusion.
- Same code is modified by another mod will show as requiring Cleanup. Mod developers show attempt to fix by changing the location of one of the mods in conflict.
- New Version of Mod will show existing mod as Installed and new one as requiring Cleanup. The correct action is to Remove the existing version, install the new version, and then delete the old version of the mod.
Related Links
- Mod Manager - Installing Config Files
- Mod Manager - Interpreting Status
- Mod Manager - Upgrading regressed mods
For Mod Developers
Other Uses of Mod Manager:
