Admin Media Search

From TNG_Wiki
Jump to: navigation, search

In TNGv12 and beyond, this mod uses the new guidelines for TNG v12+ cust_text.php files
If you are using TNGv12+, and any cust_text.php file in this mod is marked with a Bad Target error, you need to update your cust_text.php files before you can install this mod. [Show instructions]

If you upgraded to TNGv12+, and did not update your cust_text.php files as instructed in the upgrade readme script, then you must use the TNG Mod Manager to update them. To do so:

  1. Go to Mod Manager, and select its "Recommended Updates" tab.
    (If the "Recommended Updates" tab is not visible, then go to the Mod Manager Options tab, select "Display Settings", and turn on the "Recommended Updates" tab.)
  2. Click the "Update" button in the "Recommended Updates" tab.
    Installed mods do not interfere with the update, and if you already have (or think you may have) run this update, it will not hurt for you to run it again.

[See details in the TNGv12 Change Impacts Article][Hide the instructions]

Admin Media Search
Summary Optimizes the Admin >> Media >> Search results table a bit, adds hyperlinks to linked people, adds search & display options, and sort options.
Mod Updated 4 May 2018
Download link
TNG 12.0
TNG 11.0
TNG 10.1.0
Download stats
Author(s) Robin Richmond
Homepage Robin Richmond's Genealogy Database
Mod Support My Mod Support form or TNG Community Forums
Contact Developer My Mod Support form
Latest Mod &
Min TNG V 10.1
Max TNG V at least 12.0
Files modified
admin_media.php, English cust_text.php
Related Mods

Purpose of the Mod

To add several features to the Admin Media Search page to make it a bit more useful.

[Show Details]

The changes include:

  • The search form:
    1. Draws a box around the search form (using a fieldset HTML tag) to help distinguish the search form from the action buttons below the form.
    2. Changes the "File Ext" text field in the search form to a "File Type" drop-down list.
    3. A search option that allows the user to select media items with or without thumbnails.
    4. The following display options:
      • Display the file path,
      • Display Geocodes (which are always displayed in the pristine version, even though they are rarely present,
      • Display the MediaID and/or MediaKey, and
      • Define the number of Results Per Page (defaulting to the global site setting).
    5. Provides checkboxes to select a sort key among Description (which is the pristine setting), MediaID, MediaKey, and FilePath
  • The search results (in addition to those implied by the search options listed above):
    1. Shortens the Geocode heading and data labels, in order to make the column narrower.
    2. Adds the filename extension (the FORM field from the database) to the "Title,Description" column of the search results table, if the File Path column is not displayed.
    3. Adds a Tree column when more than one tree is searched, like most other Admin programs.
    4. In the "Linked To" column, the medialinks (other than links to citations) are hyperlinks to the relevant objects.
    5. Adds a message when a thumbnail file is missing.
    6. Allows the "Linked To" column to wrap.
  • Printing considerations
    1. Suppresses printing of numerous parts of the page, including the search form, the Action and Select columns, and the page navigation buttons.
[Hide Features]

Compatibility With Other Mods

This mod is fully compatible with Unused Media, Private Media Mod, and Admin Media Predefined Search.

Related Mods

  • This mod saves data that can be used by the optional Show Mod Names utility mod, but it is not dependent on that mod.
  • Admin Media Predefined Search also adds some features to the Admin Media Search, but it is most useful for a particular situation; that is, when an admin needs to reassign Media Items to a different collection.


This mod uses the standard installation procedure. [Show Installation Details]


  • A working TNG installation.
  • An installed current version of the Mod Manager.
  • You should backup files listed in the panel on the right.


  1. Remove and delete previous version of this mod.
  2. Backup the files updated by this mod. They are listed in the panel at the upper right.
  3. Download the .zip file, Extract its .cfg file to the mods folder.
  4. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files.


  1. Try using the Mod Manager Remove capability
  2. Contact me through My Mod Support form.
[Hide Details]


Admin >> Media >> Search BEFORE
Admin media search-before.png
Admin >> Media >> Search AFTER,

with most of the display options unchecked.

Admin media search-after1-v9.png
Admin >> Media >> Search AFTER,

with the display options checkedith the column-display checkboxes selected

Admin media search-after2-v9.png
Admin >> Media >> Search AFTER,

focusing on the File Type drop-down selection box

Admin media search-after4.png

Version History

Mod Version TNG Version Date Note 12.0+ 4May2018 No functional changes; made compatible with TNGv12. 10.1 - 11.1.2 17Dec2017

- Added the size of the Bodytext field to the filepath column if it is being displayed, and to the "Title, Description" column otherwise
- Rather than say "Thumbnail specified but missing", shows the thumbnail filepath.
- Moved the embedded style sheet to css/genstyle.css 10.1 - 11.1+ 10May2017
  1. Added the ability to sort by description, filepath, mediaID, or mediaKey, selected through checkboxes on the search form.
  2. Made ShowModNames optional and pulled the .rrnoprinter style class into an embedded style sheet to remove a mod dependency. download 10.1 - 10.1.3 21 Feb 2016 Added thumnbnail search option, and missing thumbnail message. Displays media key.

Also now depends on Show Mod Names v2+. 10.1 - 10.1.1 12Jul2015 Made this mod compatible with Rick Bisbee's new Showfolio Mod by tweaking a code fragment. No other changes. 10.1 - 10.1.1 5Jun2015 Made this mod compatible with Chris Moss's new Private Media Mod. No changes other than the inclusion of the new Private Media flag created by Private Media Mod. 10.1 - 10.1.1 11May2015 - Added showfilename and showgeocode parameters to display or suppress columns
- Added abbreviations for latitude and longitude.
- Added tree column
- Added hyperlinks to all linked objects, including places
- Added no-space breaks in the filename column to allow the path to wrap a bit.
- Allowed the linked object names to wrap, but specified a minimum column width. 10.1 30Dec2014 No functional changes, just changed database references for TNG v10.1 compatibility. download 9.0.0 - 26 Dec 2014 Fixed a bug that was preventing the program from recognizing when the collection was changes, and from changing the collection Add/Edit buttons and fields in response. 9.0.0 - 11Dec2014 No functional changes; no visualization changes. Cleaned up mod directives for the TNGv10.3 alpha release. Added better annotation to the code changes. Eliminated a duplicate checkbox in the search. Places cust_text insertions at the end of cust_text.php instead of at the beginning. 9.0.0 - 08 May 2014 Initial release.

Sites using this mod

If you download and install this mod, please add your site to the table below.

URL User Note Mod-Version TNG-Version User-language
Robin Richmond's Genealogy Database Robin Richmond Mod developer 12.0 English
Total Family History Scott Bennett Private Site (For right now) V9.0.0.1 TNG 10.0.1 - 11.1.2 EN
Wortelboer Genealogy Bernard Wortelboer Public site 11.0.0 NL/EN
De Zoethouten van Woudsend John Zoethout Public site 10.1.0 Dutch/English
Hooley Family Links Rick Hooley Public/Private See Here See Here EN
DJCM.DK Claus Martinussen Public site 12.0 DA/EN
Bisbee Family Connection Rick Bisbee Public site 10.1.2 English
Adler-Wien Herbert Fischer Public site 11.0.0 DE,(EN)
Stamboom Jongman Roel Jongman Public/Private site 10.1.3 NL, DE, EN
Our Family History Paul Barrett Public/Private site 11.1.2 EN
Roots & Relatives Remembered Ron Krzmarzick Public & Private See Here EN,DE,CS,ES
Cole / Tanner Family Tree David Cole Public/Private see here see here English