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	2 Jan 2023
	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	n/a
Author(s)	Warren S Gilbert
Homepage	Unused Media
Mod Support	Support for Warren Gilbert's mods
Contact Developer
Latest Mod	14.0.0.10 for TNG 13.0 and above; 12.0.0.2 for TNG 12.0 and above; 10.1.0.3 for TNG 10.1 and above; 10.0.0.2 for TNG 10.0; 9.2.0.1 for TNG V9.2; 9.0.0.1 for TNG V9.0; 8.1.3 for TNG V8; 3.0 for TNG V7
Min TNG V	7.0.0
Max TNG V	14+
Files modified	See TNG Modules Involved
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. Automated installation has been tested on TNG versions 7.1.3 to 13.0.0
A backup of the TNG modules involved

Automated Installation

Download the appropriate distribution for your TNG version from the download links in the status area in the upper right.
Extract the unused_media.zip to your admin/mod_folder (V7) or mods (v8 or later).
Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install the unused_media.cfg.

Custom text additions

The config file includes the English, French, Danish and Dutch language custom texts.

For other languages you can modify the config file to add the custom text or manually add to whatever language you like.

Custom config

If you do not already have a customconfig.php file, create a file named customconfig.php containing only the php opening and closing tags: -

<?php
?>

and copy it to your site in the same folder as the config.php file (usually the TNG root).

Revision History

Version	Date	Contents
14.0.0.10	2 Jan 2023	Added a Dutch translation, courtesy of Rob Severijns
13.0.0.9	19 Apr 2022	Ensure folder list file is created when needed. Other bug fixes
13.0.0.8	20 May 2021	Added a French translation, courtesy of Michel Kirsch
13.0.0.7	8 May 2021	Added a Danish translation, courtesy of Brett
13.0.0.6	20 Oct 2020	Fix code causing php notices
13.0.0.4	15 Oct 2020	Remove deprecated php function (get_magic_quotes_gpc)
13.0.0.3	13 Oct 2020	Updated for TNG 13 new Admin layout
12.0.0.2	7 Sep 2018	Fix bug causing non-creation of a required file
12.0.0.1	3 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	2 May 2018	Updated for changes in TNG v12
10.1.0.3	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	28 Jan 2015	Updated to replace mysql calls with tng (mysqli) calls.
10.0.0.2	10 May 2014	Fix to work when a folder holds more than one media type.
10.0.0.1	24 Feb 2014	Fix a bug when media is in a subfolder.

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.

In the event of a problem

Try using the Mod Manager Remove capability
Or copy the backup versions of the TNG modules involved.

Visualization of this mod

Side effects

As with most source code modifications, these changes will likely be overwritten during your next TNG revision upgrade and will need to be re-implemented. (Using the Mod Manager to remove the mod before the upgrade and re-installing the mod after the upgrade greatly simplifies this process).

TNG Modules Involved

TNG V14

as for TNG V13 (below), but also:
adds custom text to languages/Dutch/cust_text.php and languages/Dutch-UTF8/cust_text.php

TNG V13

as for TNG V12 (below), but also:
adds custom text to languages/Danish/cust_text.php, languages/Danish-UTF8/cust_text.php, languages/French/cust_text.php, languages/French-UTF8/cust_text.php

TNG V12, V11, V10, V9, V8

modifies the following TNG modules 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
adds custom text to languages/English/cust_text.php and languages/English-UTF8/cust_text.php

TNG V7

In TNG V7, this mod:

modifies the following TNG modules customconfig.php, admin/media.php, admin/editmedia.php, admin/newmedia.php, admin/ordermediaform.php, admin/photoimport.php, admin/thumbnails.php, and English/media_help.php
adds custom text to English/cust_text.php