Browsemedia Search Form

Browsemedia Search Form
Summary	Adds elements to the search form, and moves elements of the search form and page navigation widgets so that they are positioned as they are in most other search forms. Also adds "Tree" and "Collection" columns when they are called for.
Validation
Mod Updated	13 Mar 2023
Download link	v14.0.0.4b TNG 14.0 v13.0.0.4a TNG 13.0 See the Revision History for older versions
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	14.0.0.4b
Min TNG V	12.0
Max TNG V	rrgip
Files modified	browsemedia.php, English cust_text.php
Related Mods
Notes

Purpose of the Mod

To makes browsemedia.php more like other TNG search pages, and to improve its usability. The mod

1. Moves the tree selection box into the search form so that it doesn't refresh the page and delete the search string when it is changed.
2. Separates the result page navigation widget from the search form.
3. Adds a "Tree" column if there is more than one tree and the user has not selected a tree.
4. Adds a "Collection" if the user is on the All Media version of the program or has selected all media collections.
5. Reduces the width of the "Linked To" column, with a style rule that uses "max-width" rather than "width".
6. Reduces the width of the Headstones "Status" column in the same way.

Mod Options

In TNGv12, these options are traditional Mod Manager parameters.
In TNGv13, these options are defined in a "Mod Settings Block" at Admin>>Setup>>General Settings, in the new subform "Mod Settings Blocks". Links directly to the mod settings can be found in the Mod Manager Description and the Mod Manager Edit Options page.

1. Whether to display a help icon for the search string. The help text talks about search fields and "Collections"
2. Whether to display a help icon for the "Galleries" button. The help text talks about the Galleries thumbnails.

The help icons and their default help text are shown in visualizations.

Other Mods

• This mod saves data that can be used by the Show Mod Names utility mod, but is not dependent on that mod. I know of no dependencies on other mods.
• This mod is related to Browsemedia Medialinks, which makes some of the same changes as this mod to results table columns. As a result of these duplicated changes, if you install both mods, the second mod causes "Not Installed" messages in the first mod. But uninstalling the second mod cleans up the discrepancies.those errors.

Conflicts

I have checked the TNG Wiki mods that say that they change browsemedia.php. I could not download three of them. Of the others, only one presented a conflict:

• Media display columns mod, which changes results table column sizes in six end-user programs. I don't understand why it does what it does to browsemedia, and I don't see a way to resolve the incompatibility.

If you find any other incompatibilities, please let me know.

Installation

This mod includes a typical mod subfolder, with the same base name as the mod's .cfg file. The subfolder is atypical in that no files in it are installed to working TNG folders. However, it does contain critical files that contain the mod's language strings, which the mod does not add to standard cust_text.php files. Instead, the PHP code modified by this mod loads the language strings from files in the mod's languages/ subfolder. Read more about this technique.

[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

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.

Problems?

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

[Hide Details]

Visualizations

Search Form BEFORE:	The tree selection field is not present if there is only one tree. When it is present, a change to the selected tree refreshes the screen and clears the search string.
Search Form AFTER:	Again, the Tree selection field is not displayed if there is only one tree. The Tree selection field does not refresh the page; it is just part of the form. The visibility of the search field help icon is controlled by a mod parameter. The visibility of the Gallery button help icon is controlled by a separate mod parameter. The search form is now separate from the Gallery/Descriptive view/Slide Show widget, and from the page navigation widget.
Results Columns AFTER:	There is now a Tree column if there is more than one tree and the user has not selected a tree. There is now a Collection column if the user is on the All Media version of the program or has selected all media collections. The width of the "Linked To" column has been reduced, with a style rule that uses "max-width" rather than "width". The same is true of the "Status" column (not shown) for Headstones.
Help Text Popup AFTER:	The information icon next to the search field pops up a TNG LITBox that explains Media Collections. It can be suppressed by a mod option. The pop-up text is defined as a language string.
Help Text Popup AFTER:	The information icon next to the Gallery button pops up a TNG LITBox that explains Media Collections. It can be suppressed by a mod option. The pop-up text is defined as a language string.
The Mod Settings Block AFTER:	A Mod Settings Block is an outlined subform within an Admin>>Setup program that contains the options for a single mod. What is most notable about a Mod Settings Block is that a hyperlink directly to a Mod Settings Block displays only that block (i.e. only one mod's options), not all of the other options in the form or subform. Here, you see the this mod's Mod Settings Block, in admin_genconfig.php, at Admin>>Setup>>General Settings. The triangular arrow next to the subfolder heading Mod Settings Blocks is pointing to the right, meaning that the subform is not open, and that your site's other mod settings blocks are not visible. If you were to open the subform by clicking on the heading, you would see the mod settings blocks for other mods that you have installed.

Revision History

Mod Version	TNG Version	Date	Note
14.0.0.4b	rrgip	13Mar2023	Upgrade to TNGv14
v13.0.0.4a	13	12Oct2020	Upgraded to TNGv13 and added coordination with Browsemedia Medialinks
v12.0.0.4	12.0-12.3	15Mar2020	Inserted a Mod Manager tag that had been optional but is required by TNGv12.3 Added optional help text for the Gallery button and search string. Modified the width of the Linked To field and the Headstones Status field. Added a "Collection" column when all Collections (mediatypes) are being shown.
v12.0.0.2	12.0 - 12.0.2+	25 Jan 2019	- Added a Mediatype field, - Changed tree dropdown so that it Does not autoselect, Defaults to the user's branch if there is a branch restriction
v12.0.0.1a	12.0+	15 May 2018	No functional changes; made compatible with TNGv12.
10.1.0.1a	10.1-11.1.1+	8 May 2017	New mod with typo corrected

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	14.0.0.4b	rrgip	English
The Cole / Tanner Family Tree	David Cole	Public/Private	see here	see here	EN, DE, FR, ES, NL