Mod Manager Batch Updates
|
The Batch Updates is available for TNG V10.0.3 and above. Caution Do not use the Batch Updates in TNG 10.0.3 or the OK to Install filter with Select All in TNG 10.1 if you have obsolete mod cfg files in your TNG mods folder. It could be hazardous to the health of your web site. |
|
| TNG version: | ≥ 10.0.3 |
The Mod Manager Upgrade project has created a Batch Updates process that allows filtering on mod status, selecting All and unchecking specific mods, or only checking specific mods and then clicking the appropriate action button to apply that action to all mods selected.
In order to effectively use the Batch Updates and not create problems for yourself, you should Delete mods that you do not use:
- multiple versions of the same mod. Choose the one you want to use and delete the others.
- mods that conflict with each other but provide the same functionality, such as Google Maps - More Place Levels Mod and Google maps 15 where you should choose the mod you want to use and then delete the other one
Installs
| TNG version: | ≥ 10.0.3 |
Batch installs were introduced in TNG 10.0.3 and are possible for all mods in Ok to Install status.
| TNG version: | ≥ 10.1.0 |
The screen display is slightly different in TNG 10.1 since Batch Updates and Mod List were merged into one screen. The TNG 10.1 has a Lock check box that can be used to return the same filtered status screen after the action is completed.
Caution: The following scenarios will cause you problems:
- If you select two different versions of the same mod, the Batch Updates will process both and could leave your site in an unusable state if they install functions since PHP does not allow duplication of function names.
- If you select mods that are known to conflict with each other, such as Google Maps - More Place Levels Mod and Google maps 15 the Batch Updates will process both mods and leave the 2nd mod in Clean Up status. When you then clean up the Google maps 15 it will clean up the files that it shares with Google Maps - More Place Levels Mod so it will then show in Clean Up status.
Moral of this story is that you should not keep both mods in your TNG mods folder. Choose the one you want to use and delete the other. Likewise you need to delete unused mods so that you do not have two versions in your TNG mods folder at the same time.
Clean Ups
Individual Mod
Mods that show in the Clean Up status after a TNG Upgrade, might include Bad Targets. They are in the Clean Up status because the mod is partially installed. This scenario occurs if you do not remove your mods prior to upgrade, which is not necessary, but overlay TNG modules that are targets of change with the TNG upgrade module.
The Clean Up is necessary in order to remove the partially installed mod. If it contains Bad Targets it will then show in the Unable to Install status after you have done the clean up, which will require that the Mod Developer provide a new version of the mod, or that you check the TNG Wiki, using the URL link in the mod Description to obtain the new version of the mod that applies to this TNG version.
| TNG version: | ≥ 10.1.0 |
In TNG 10.1 and after, you need to expand the status line in order to see the Clean Up button. You can either click the right-arrow or click any place on the line to expand it. While the Delete button is also displayed for partially installed mods, it is there to allow you to remove previous or now obsolete versions of the mod.
Batch
Note: You may want to check the status of your mods in the Mod List prior to using the Batch Updates to perform Clean Up.
In fact, you may want to open a 2nd browser tab for the Batch Updates and as you are reviewing the status in the Mod List, select the mods to be cleaned up in the Batch Updates browser tab
| TNG version: | ≥ 10.1.0 |
You can select mods that are Partially Installed from the Status pull down list. After the list is returned, you can click the Expand All link to see the reasons why the mods are in partially installed status indicating they require Clean Up.
Unable to Install
| TNG version: | 10.0.3 |
The Batch Updates selection of Unable to Install just provides a list of mods that cannot be installed, because they
- contain Bad Targets which typically means the code the mod checks for has changed
- are missing Files which typically means you did not FTP all the components of the mod to your hosting service or did not FTP the folder provided with the mod as a subfolder to the TNG mods folder
You will need to use the Mod List to find out why the mod is showing in Unable to Uninstall status
From the Mod List you can check the TNG Wiki, using the URL link in the mod Description to obtain the new version of the mod that applies to this TNG version.
If the Mod Developer did not provide a URL link to the wiki, you should encourage them to update their mod to include such a link in the mod %description: directive.
Cannot Install
| TNG version: | ≥ 10.1.0 |
Unable to Install was changed to Cannot Install in TNG 10.1. You can select the list of mods that are in the Cannot Install status and once the list is returned, you can click the Expand All link to be able to see the reasons the mods are in Cannot Install status.
From the Mod List you can check the TNG Wiki by clicking the W icon to obtain the new version of the mod that applies to this TNG version.
If a W icon is not shown, you should encourage the Mod Developer to update their mod to include the new %wikipage:mod_article% directive.
Uninstall All
| TNG version: | 10.0.3 |
The Status Filter Installed status can be used to select only the mods that are currently installed. You should Select All to Uninstall all the mods prior to a major TNG upgrade, that is one with a version number change. Note that it is not necessary to Uninstall the mods prior to a minor upgrade since any mod that is still partially installed after the upgrade can be cleaned up.
Uninstall
| TNG version: | ≥ 10.1.0 |
The Remove button was changed to Uninstall in TNG 10.1. You should use the batch update capability to Uninstall all your mods prior to a TNG upgrade. Note that it is not necessary to Uninstall the mods prior to a minor upgrade since any mod that is still partially installed after the upgrade can be cleaned up.
Deletes
Note that Batch Deletes are only possible if the mods are in Ok to Install and Unable to Install status. If you need to delete mods in the Clean Up status, you will need to use the normal Mod List processing.
Delete will always require a Confirmation, since the action is not reversible, other than you FTPing a copy of the mod back to your TNG mods folder.
Related Links
Mod Manager
- Overview
- Why Use It ?
- Installing Config Files
- Batch Updates
- Interpreting Status
- Editing Parameters
- Deleting Mods
Mod Manager Controls
For Mod Developers
- Mod Guidelines
- Mod Manager Syntax
- Creating Config Files
- Config File Creation Example
- Avoiding Mod Conflicts
- Using the TNG File Analyzer
- Mod_Manager_Enhancements_TNG_v12
Technical
Developer Tools
Example Mods
