Browsemedia Search Form
Browsemedia Search Form | ||
---|---|---|
Summary | Adds elements to the search form, moves elements of the search form and page navigation widget so that they are more logically placed. If this mod is installed, you can edit its options. | |
Validation | ||
Mod Updated | 25 Mar 2024 | |
Download link | v14.0.4.4e
See the Revision History for older versions | |
Download stats | ||
Author(s) | Robin Richmond | |
Homepage | Robinnd's Roots | |
Mod Support | My Mod Support form | |
Contact Developer | My Mod Support form | |
Latest Mod | 14.0.4.4e | |
Min TNG V | 12.0 | |
Max TNG V | 14.0.4 | |
Files modified | browsemedia.php, admin_updateconfig.php, admin_genconfig.php | |
Related Mods | Mod Settings Blocks, Browse Media Medialinks | |
Notes |
Purpose of the Mod
- To make the layout of the browsemedia.php search form and results table more more like other TNG search pages, and to improve its appearance and usability in small ways:
- Moves the tree selection box into the search form.
- Moves the page navigation widget out of the search form and positions it above and below the results table.
- Moves the "See Gallery" (or ) and Slide Show buttons out of the search form, and positions them below the search form but above the navigation widget.
- Other presentation tweaks
- Adds a "Tree" column if there is more than one tree and the user has not selected a tree.
- Adds a "Collection" drop down box that is just a bit handier the "Media" drop-down menu
- Reduces the width of the "Linked To" column, with a style rule that uses "max-width" rather than "width".
- Reduces the width of the Headstones "Status" column in the same way.
- Adds help text to describe TNG Collections and the Gallery view.
Mod Options
The mod configuration variables for Browsemedia Search Form are
- Whether to display a help icon for the search string. The help text describes the searchable fields and TNG Collections.
- Whether to display a help icon for the "Galleries" button. The help text describes the differences between thumbnail gallery and the tabular descripive view of search results.
The help icons and help textare illustrated in visualizations below.
These options are defined and edited in a "Mod Settings Block". Each mod that puts it mod configuration variables at Admin>>Setup>>General Settings, in the new subform "Mod Settings Blocks". As with ordinary mod options, the mod settings block is accessible from the Mod Manager "Edit Options" button, but that button is not available if the mod is only Partially Installed. However, three other links to the mod settings block work even if the mod is in a Partially Installed state (which, as described under the Related Mods heading, is not necessarily an error condition).
- From the mod description in the status cell of the Browsemedia Search Form row of the Mod Manager List
- From the Inner Mod Menu that this mod installs on browsemedia.php (see a visualation below), and
- From the "Mod Settings Block" subform at Admin>>Setup>>General Settings
Related Mods
- {{RobinBoilerplate |text=msbmod}
- {{RobinBoilerplate |text=msb2}
- {{RobinBoilerplate |text=imm}
- Browsemedia Medialinks also changes browsemedia.php. Browsemedia Medialinks focuses on the Media Links column of the search form, whereas Browsemedia Search Form focuses on the search form and the positioning of the search results navigation menu above and below the search results.
- Acually, both mods make identical changes to the "Links" column in the results table. But they do so by adding stye classes rather than changing the HTML code, and the duplicated style does not cause any problems
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 does not install any files, but it does still have a mod subfolder, which contains the mod's language strings. That is, this mod's language strings are not defined in its .cfg file nor copied to cust_text.php files. As a result
- This mod's language strings are loaded only into the TNG programs that need them, not into all TNG programs, and
- It is easier to create, edit, test, and save translation for this mod than for mods that use standard cust_text.php strings.
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.
Files Modified
- browsemedia.php - The End-user program that displays media items (for all media collections)
- admin_genconfig.php - The form at Admin>>Setup>>General Settings, which contains all Mod Settings Blocks.
- admin_genconfig.php - The form at Admin>>Setup>>General Settings, which contains all Mod Settings Blocks.
- admin_updateconfig.php - The admin_genconfig.php action script that saves the Admin>>Setup>>General Settings form, including all Mod Settings Blocks
[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
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.
|
Results Columns AFTER: |
|
Help Text Popup AFTER: |
|
Help Text Popup AFTER: |
|
The Mod Settings Block AFTER: |
msbviz1
msbgenconfig
|
Revision History
Mod Version | TNG Version | Date | Note |
---|---|---|---|
v14.0.4.4e | 14.0.4 | 25Mar2024 | Updated the mod to TNGv14. Added an info icon next to the Media Collection selection box and updated all help text. Depends on MSB 14.0.4.4d |
v14.0.0.4c | 14.0-14.0.3 | 21Nov2023 | Updated the mod to TNGv14. Fixed undefined subscript errors. |
v13.0.0.4a | 13 | 12Oct2020 | Upgraded to TNGv13 and added coordination with Browsemedia Medialinks |
v12.0.0.4 | 12.0-12.3 | 15Mar2020 |
|
v12.0.0.2 | 12.0 - 12.0.2+ | 25 Jan 2019 | - Added a Mediatype field, - Changed tree dropdown so that it |
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.4c |
rrgip
|
English |
The Cole / Tanner Family Tree | David Cole | Public/Private | see here | see here | EN, DE, FR, ES, NL |