Unused Media

Unused Media
Unused Media
Summary	Adds a tab (Unused Media) to the Admin > Media page
Validation	Admin application, validation not attempted
Mod Updated	05 Mar 2025
	TNG 15.0
	TNG 14.0
	TNG 13.0
	TNG 12.0
	TNG 10.1.0
	TNG 10.0
	TNG 9.2.0
	TNG 9.0
	TNG 8.0
	TNG 7.0
Download stats	View download statistics TNG15
Author(s)	Warren S Gilbert
Homepage	Unused Media (This page)
Mod Support	Support for Warren Gilbert's mods
Contact Developer	Support for Warren Gilbert's mods
Latest Mod	15.0.0.1
Min TNG V	7.0.0
Max TNG V	15.0
Files modified	customconfig.php; admin_media.php; admin_editmedia.php; admin_newmedia.php; admin_ordermediaform.php; admin_photoimport.php; admin_thumbnails.php; languages/English/media_help.php; languages/English/cust_text.php and languages/English-UTF8/cust_text.php; languages/Dutch/cust_text.php; languages/Dutch-UTF8/cust_text.php; languages/Danish/cust_text.php; languages/Danish-UTF8/cust_text.php; languages/French/cust_text.php; languages/French-UTF8/cust_text.php
Related Mods
Notes

Purpose of the mod

This mod adds a tab (Unused Media) to the Admin > Media page. It lists files which are present in the media folders on the server, but not registered with TNG.

Developer

This mod was developed by Warren S Gilbert.

Requirements

A working TNG installation.
A backup of all affected files (see the list in the summary to the right)
An installed current version of the Mod Manager.
Both English and English-UTF8 folders be on your site

Revision History

Mod Version	TNG Version	Date	Contents
15.0.0.1	15.0	09 Mar 2025	Updated by Brett. Removed PHP warning. Placed icon in mod folder.
15.0.0.0	15.0	06 Mar 2025	Updated for TNG15 by Brett.
14.0.0.10	14.0	02 Jan 2023	Added a Dutch translation, courtesy of Rob Severijns
13.0.0.9	13.0	19 Apr 2022	Ensure folder list file is created when needed. Other bug fixes
13.0.0.8	13.0	20 May 2021	Added a French translation, courtesy of Michel Kirsch
13.0.0.7	13.0	08 May 2021	Added a Danish translation, courtesy of Brett
13.0.0.6	13.0	20 Oct 2020	Fix code causing php notices
13.0.0.4	13.0	15 Oct 2020	Remove deprecated php function (get_magic_quotes_gpc)
13.0.0.3	13.0	13 Oct 2020	Updated for TNG 13 new Admin layout
12.0.0.2	12.0	07 Sep 2018	Fix bug causing non-creation of a required file
12.0.0.1	12.0	03 Sep 2018	Allow the search to be delayed until values are entered (mod options) Ignore files with specific extensions, files and folders with specific names (mod options) Allow the search to be limited to a single folder (mod options) Write/read mod specific files to extensions folder rather than TNG root. (see More Information, below) Help for this area expanded/re-written for the mod
12.0.0.0	12.0	02 May 2018	Updated for changes in TNG v12
10.1.0.3	10.1	11 Jun 2016	Changed to use preg_replace instead of ereg_replace (function deprecated/removed). Added option to check for "dotfiles" (.DS_Store etc.). Bug fix.
10.1.0.1	10.1	28 Jan 2015	Updated to replace mysql calls with tng (mysqli) calls.
10.0.0.2	10.0	10 May 2014	Fix to work when a folder holds more than one media type.
10.0.0.1	10.0	24 Feb 2014	Fix a bug when media is in a subfolder.

Conflicts and Issues

No known conflicts.

Installation

Uninstall and delete previous version of this mod (if installed)
Download the appropriate zip file as shown in the mod summary in the upper right corner of the page.
Extract the file from the downloaded zip file into the mods folder or FTP the extracted file to your mods folder.
Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install the mod.

In the event of a problem

Try using the Mod Manager Remove capability.
Copy the backup of the affected files back to your TNG directory.
Retry installing mod.
Contact us through the TNG Community Forums.

Uninstalling the mod

If you want to completely Remove (uninstall) this mod and any tables if created, you should

click the Uninstall button to uninstall the mod
click the Delete button to delete the config file from the mods folder.

Upgrade

Uninstall and eventually Delete the current Mod.
Proceed as for an installation with the new Mod.

More Information

With this mod installed, files can be deleted from the server either individually or by deleting selected files.
Files can be excluded from the report and will then be recorded in file 'unusedmedia.txt' in the extensions folder for v12.0.0.1 or later, in the TNG root folder of your site if you are using TNG v8 or later, or the admin folder of your site if you are using TNG v7. If not already present, 'unusedmedia.txt' will be created the first time you choose to exclude a file. The file is optional, and the report will function whether or not it exists.
If you install v12.0.0.1 or later, and have used an earlier version of Unused Media, unusedmedia.txt and unusedmediatemp.txt will be in the TNG root. This version creates them in the extensions folder. unusedmedia.txt contains the names of media to be excluded. If you have excluded files from the report, and wish to continue excluding them, you should move this file to the extensions folder. Otherwise, both files can safely be deleted from the TNG root.
Excluded files are not normally listed, but there is an option for them to be shown, and they can then be included back in the normal report.

Visualization of this mod

Options

Once you have installed the mod, click [Options]

Click Edit options

Row 1 - List any files that you don't want the mod to list. In the example below, all files called "index.html" will be excluded. Separate each of the files you wish to exclude with a comma and then click Update. Note - This is intended to quickly eliminate a number of files that have the same name and do not need to be listed, such as index.html files, which some people place in image folders for added security. You do not need to use this field to list every single file you wish to exclude.
Row 2 - You can exclude complete folders from being searched. In the example below, all "thumbs" folders will not be checked. Separate each of the folders you wish to exclude here with a comma and then click Update. If you want the mod to check "thumbs" folders for any unused thumbnails, delete "thumbs" and click Update.
Row 3 - List any files types that you want the mod to exclude. In the example below, "txt" files and "php" files will not be listed. Separate each of the file types you wish to exclude here with a comma and then click Update.
Row 4 - No search will be carried out unless you enter some search information into the search options if this value is set to "true". By default, this is set to "false" (recommended).
Row 5 - If you set this value to "true", then the Unused Media tab will include a drop-down option to select the specific folder you wish to search. By default, this is set to "false" (recommended).

Searching

When you click on the Unused Media tab in the Media section, all unused media will be listed.

If you want to delete any of the images from your site, you can...

Click on the delete icon, or
Place a tick in the Select column and click Delete Selected

If you want to hide/exclude an image from being listed as unused...

Place a tick in the Select column
Click Exclude Selected

If you want to be reminded of which files you have excluded and are no longer being displayed...

Tick Show excluded files
Click Go

Understanding the icons

This is an image that has already been excluded from being listed as unused. If you click on this icon, the image will be added back into the list (i.e., it will no longer be excluded)
Click on this icon if you want to delete the image from your site