Admin Media Search
Admin Media Search | ||
---|---|---|
Summary | Adds numerous features to Admin>>Media>>Search, including new run-time search and display option. Perhaps most significantly, it adds hyperlinks to all objects shown in the "Links To" (i.e. medialinks) column. | |
Validation | ||
Mod Updated | 17 Nov 2023 | |
Download link | 14.0.0.15e.zip
See the Revision History for older versions | |
Download stats | ||
Author(s) | Robin Richmond | |
Homepage | this page | |
Mod Support | My Mod Support form | |
Contact Developer | My Mod Support form | |
Latest Mod | 14.0.0.15e | |
Min TNG V | 10.1 | |
Max TNG V | 14.0.4 | |
Files modified | admin_media.php, English cust_text.php, admin_genconfig.php, admin_updateconfig.php
Installs: js/rradminmediasearch_config.js, rradminmediasearch_config.php | |
Related Mods | ||
Notes | Depends on Mod_Settings_Blocks |
Purpose of the Mod
This distinctly complex mod is intended to make the Admin>>Media>>Search form more powerful and useful. To a significant degree, you can think of this mod as turning the search form into a report generator. The mod implements many features. (The features listed here are flagged with ‡ if they can be controlled by mod settings.)
- In the search form:
- The search string can be a regular expression.
- You can control which database fields to search.‡
- You can select several optional columns for the results table.‡
- There are results table sort options.‡
- You can control the number of results per page.
- In the search results
- The Tree name is shown in a new column when more than one tree is searched (as in other Admin programs).
- When there is a thumbnail path value, but the file is missing, the message "(missing)" is displayed in the thumbnmail column.
More Features
- Search form:
- An HTML fieldset border is drawn around the search form to help distinguish the search form from the action buttons below the form.
- The "File Ext" text field has been changed to a "File Type" drop-down list.
- New search options include:
- Radio buttons that limit the search to media items with thumbnails, or without them.
- A checkbox that limits the search to items that have bodytext.‡
- Checkboxes to select optional result values: Geocodes, the file path, the MediaID, and/or the Mediakey.‡
- Some fields utilize single-character "field button" shortcuts, but only if the Field Buttons mod is installed.
- Search results
- The geocodes and file path are displayed in their own columns if they are selected in the search form.‡
- (In TNGv12 only) When the file path has not been selected for display, the file extension (the 'FORM' attribute) is displayed in the "Title,Description" column.‡ (In TNGv13, the native TNG code shows the entire file path in the "Title,Description" column)
- The mediaid and mediakey share a column when they are selected in the search form.
- Invalid image filename
- Missing file
- The filename extension (well, really, the 'FORM' attribute) for non-images (based on a mod option)
- Other features
- The TNG "Inner Menu" (just below the tab menu) now contains a drop-down menu that provides handy links to information about the mod and a direct link to the mod settings editor. I call this menu an Inner Mod Menu, and most of my mods now add Inner Mod Menus to the programs that they alter significantly.
Finer Details:
- The "Linked to" column is allowed to wrap, thus allowing the "Title,Description" column to wrap less.
- Long mediakey values such as filenames are displayed as short links that pop up the full value.
- When the Geocodes column is displayed, it uses abbreviations so that it is narrower than the native Geocoordinates column.
- Under the assumption that, when you print the Admin>>Media>>Search page, you are focusing on the search results, several parts of the web page are omitted when the Admin>>Media>>Search page is sent to a printer. Among the areas excluded from printing are the search form, the Action and Select columns, the page navigation buttons, and the action buttons above the results table. To print these parts of the page, you can do a screen capture and print the resulting screenshot image.
- The reset button resets all of the new search form options to the values they had when the page was loaded, not to the defaults they would have in a new browser session.
Mod Options
This mod's customizable settings are defined and edited in a Mod Settings Block at Admin>>Setup>>General Settings, in the subform Mod Settings Blocks. The settings and their effects are described and shown here.
You can easily ignore each group, change all of its settings at once (in a couple of ways), or edit individual settings.
I'll focus on group 1 to illustrate details.
Here's what you see if you click both the "See Native Behavior" and "See Recommended Behavior" buttons.The descriptions give you a glimpse of how the settings would affect the Admin>>Media>>Search behavior, without requiring you to look at and make decisions about each option. If you just want to make sure that the program takes on the native or recommended behavior, you still don't have to deal with the the detailed HTML form. Instead, you can just click "Apply" and ignore those details.
Here are the form fields for group 1, after they are opened by by the 'Show Settings' button. Unfortunately, the Mod Settings Block program cannot tell you whether the option values are set to the native settings, to the recommended settings, or to custom settings. (I've looked into doing that, but it would probably take too much time to implement.) But still, the point is that you don't have to deal with all of the settings individually. Instead, you can say, in effect, 'Don't bother me with the details".Other Mods
Compatibility
This mod is fully compatible with the only other mods that affect admin_media.php - Unused Media, Private Media Mod, and Admin Media Predefined Search.
Related Mods
- The Mod Settings Blocks mod packages this mod's options into what I call a "Mod Settings Block", which is a set of form fields that formatted and labeled so that it stands out among other options in an Admin>>Setting form. Mod Settings Blocks is a prerequisite for this mod; it must be installed before this mod can be installed.
- Admin Media Predefined Search, is dependent on this mod. When Admin Media Predefined Search is installed Admin Media Search generates an intentional "Bad target" error in the Mod Manager, with a note saying that Admin Media Predefined Search must be installed first.
- Media Bodytext (not published yet) Changes some features of admin_editmedia.php and showmedia.php - especially with respect to BodyText values.
Files Installed
- rradminmediasearch_config.php - An Include file containing bulk of the code for this mod's Mod Options Block.
- js/rradminmediasearch_config.js - Javascript for this mod's Mod Options Block
Installation
This mod's language strings are defined, distributed and files in its mod subfolder rather than in its .cfg file. TNG programs affected by this mod then load language strings from those mod subfolder files rather than from cust_text.php files. This non-standard technique for handling language strings has several advantages, including that
- It loads language strings only into the pages that need them rather than into all TNG pages, and
- It simplifies the process of defining and editing translations.
This non-standard technique should be invisible to you unless you want to define a translation or override any of this mod's string values.
Read more about this technique, the simplified translation process, and the procedure for defining site-specific overrides to its language strings.
[Show Standard Installation Process]
Requirements
- A working TNG installation.
- An installed current version of the Mod Manager.
- You should backup files listed in the panel on the right.
Procedure
- Remove and delete previous version of this mod.
- Backup the files updated by this mod. They are listed in the panel at the upper right.
- Download the .zip file, Extract its .cfg file to the mods folder.
- Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files.
Problems?
- Try using the Mod Manager Remove capability
- Contact me through My Mod Support form.
Visualizations
1. Admin>>Media>>Search BEFORE
|
2. Admin>>Media>>Search AFTER, with most of the run-time display options unchecked, and with the options that display extra information in the thumbnail column unchecked.
|
3. Admin>>Media>>Search AFTER, with a few run-time options.
|
4. Admin>>Media>>Search AFTER, with a few other options.
In the search form, as indicated by the red outlines
In the results table, as indicated by the green outlines
|
5. The Inner Mod Menu in the Admin Media Search page
This shows the Inner Mod Menu when two mods that affect Admin>>Media>>Search have been installed - Admin Media Search and its companion mod Admin Media Predefined Search. For both mods, the Inner Mod Menu provides hyperlinks to
The Admin Media Search menu also links to a popup summary of what the mod does. That popup is shown in this screenshot. |
6. Mod Options
This mod has quite a few options. Its Mod Settings Block tries to simplify the process of managing the mods settings by defining two group of setting. Each group applies to a particular aspect of the Admin Search Pag, and fr each group, you can
|
Styles
My mods generally do not add style rules to genstyle.css because
- genstyle.css has SO MANY rules already,
- The rules added by most mods affect only one or two programs, and just take up space in genstyle.css for other programs, and
- Keeping mod-generated rules separate helps to avoid classname conflicts between mods.
Some of my mods define stand-alone .css files, but most of my mods (like this one) define an inline style sheet. If you want to override any of these rules, you can add supplemental rules to your template's mytngstyle.css file, or to the bottom of your genstyle.css. The mod implements a JQuery document.ready trick to allow you to override my inline style rules this way. That trick is described in a Technical Note in my TNG Wiki home page. (Note that it is easy to miss the minor "Internal Style Sheets" heading that is the destination of this link, since the content of the section is hidden, and it is immediately followed by a major heading.)
Language Strings
As noted above, this mod's language strings are defined, distributed and files in its mod subfolder rather than in its .cfg file. TNG programs affected by this mod then load language strings from those mod subfolder files rather than from cust_text.php files. This non-standard technique for handling language strings has several advantages, including that
- It loads language strings only into the pages that need them rather than into all TNG pages, and
- It simplifies the process of defining and editing translations.
This non-standard technique should be invisible to you unless you want to define a translation or override any of this mod's string values.
Read more about this technique, the simplified translation process, and the procedure for defining site-specific overrides to its language strings.
Revision History
Mod Version | TNG Version | Date | Note |
---|---|---|---|
[[Media:admin_media_search_v14.0.0.15e.zip|14.0.0.15e.zip] | 14.* | 21 Mar 2024 | Accommodated a change in TNGv14.0.4. The change is backward compatible for TNGv14.* |
14.0.0.14d | 14.* | 17 Nov 2023 | Adds new search features, Adds columns , Adds hyperlinks to media linked Places,Allows the medialink hyperlinks to go to object viewers, And more! |
13.0.0.14d | 13 | 30 Nov 2020 | Very minor update - Added whitespace to the search form |
13.0.0.14c | 13.0.0.14c | 20 Nov 2020 |
|
13.0.0.14b | 13 | 3 Oct 2020 |
[Show details]
[Hide details]
v13.0.0.14a 1 Oct 2020
v13.0.0.14 20 Sep 2020
[Hide details]
|
Mod Version | TNG Version | Date | Note |
---|---|---|---|
14.0.0.15d | 14 | 17 Nov 2023 | Adds new search features, Adds columns , Adds hyperlinks to media linked Places,Allows the medialink hyperlinks to go to object viewers, And more! |
12.2.0.13a | 12.2 - 12.3 | 25 Jul 2020 |
|
12.2.0.13 | 12.2 - 12.3 | 17 Jul 2020 | No functional changes in the behavior of the search page, except that some features can now be disabled. This update is essentially all about the mod options. It simplifies (I hope) the editing of options by allowing groups of options to be set at once. |
12.2.0.12c1 | 12.2 - 12.3 | 25Feb2020 | No Functional Changes.
|
12.0.0.12c | 12.0 - 12.2 | 15Dec2019 | No Functional Changes. Just upgraded to version 3 of the shared mod libraries and fixed a bug that was using the media item tree instead of a medialink tree. (They are rarely different, but they can be.) |
12.0.0.12b | 12.0 - 12.2 | 30Oct2019 |
(See also the revision notes for v12.0.0.12 and v12.0.0.11, which were pretty short-lived.) |
12.0.0.12 | 12.0 - 12.2 | 24Oct2019 | This version needed immediate repair by version 12a, so it cannot be downloaded.
[Minor changes]
Small presentation enhancements:
[Hide details]
|
12.0.0.11 | 12.0 - 12.1 | 30Sep2019 | (This version was pretty short-lived. Several of its new features are handled much better in version 12.0.0.12a, which is also more fault-tolerant.)
[Less significant changes]
[Hide details]
|
12.0.0.10 | 12.0+ | 4May2018 | No functional changes; made compatible with TNGv12. |
10.1.0.10 | 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 |
10.1.0.9b | 10.1 - 11.1+ | 10May2017 |
|
10.1.0.8 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.0.7c | 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.0.7b | 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.0.7 | 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.0.5 | 10.1 | 30Dec2014 | No functional changes, just changed database references for TNG v10.1 compatibility. |
9.0.0.4 download | 9.0.0 - 10.0.0.3 | 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.3 | 9.0.0 - 10.0.0.3 | 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.1 | 9.0.0 - 10.0.0.3 | 08 May 2014 | Initial release. |
Sites using this mod
If you download and install this mod, please add your TNG site to the table below:
URL | User | Note | Mod-Version | TNG-Version | User-language |
---|---|---|---|---|---|
Robin Richmond's Genealogy Database | Robin Richmond | Mod developer | 14.0.0.15e | 14.0.3 | English |
Total Family History | Scott Bennett | Private Site (For right now) | V9.0.0.1 | TNG 10.0.1 - 11.1.2 | EN |
Roots & Relatives Remembered | Ron Krzmarzick | Public & Private, modified | See here | See here | EN,DE,CS |
Wortelboer Genealogy | Bernard Wortelboer | Public site | 10.1.0.8 | 11.0.0 | NL/EN |
De Zoethouten van Woudsend | John Zoethout | Public site | 10.1.0.5 | 10.1.0 | Dutch/English |
Hooley Family Links | Rick Hooley | Public/Private | See Here | See Here | EN |
DJCM.DK | Claus Martinussen | Private Site (For right now) | 13.0.0.14d | 13.0.4 | DA/EN |
Bisbee Family Connection | Rick Bisbee | Public site | 10.1.0.7(c) | 10.1.2 | English |
Adler-Wien | Herbert Fischer | Public site | 14.0.0.15a | 14.0 | DE |
Stamboom Jongman | Roel Jongman | Public/Private site | 10.1.0.9(b) | 10.1.3 | NL, DE, EN |
Our Family History | Paul Barrett | Public/Private site | 10.1.0.9b | 11.1.2 | EN |
The Cole / Tanner Family Tree | David Cole | Public/Private | see here | see here | EN, DE, FR, ES, NL |
Joseph Oran Holtz Genealogy Pages | Jim Holt | Private | See Here | See Here | EN |