TreeID-One Column

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]


TreeID-One Column
Summary Adds the TreeID or Tree Name next to the existing TreeID or Tree Name other in various TNG pages where only one of those values is shown. Based on Ken Roy's TreeIDMod, which adds a separate TreeID column in results tables, whereas this mod puts the TreeID and Tree Name in one column.
Validation
Mod Updated 10 Jan 2018
Download link v10.1.0.2
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 10.1.0.2
Min TNG V 10.1.0
Max TNG V at least 11.1.2
Files modified
search.php, famsearch.php, browsetrees.php, browsebranches.php, showmap.php, showtree.php, admin_branches.php, admin_places.php, admin_newbranch.php, admin_editbranch.php, admin_edituser.php, browse_dna_tests.php, English cust_text.php
Related Mods
Notes


Purpose of the Mod

Add the TreeID or TreeName to various programs where the only one of those values is displayed. It updates 12 different programs, and, depending on the program, it may

  1. Add the TreeID in front of the Tree Name in each row of the Tree column of a results table,
  2. Add the TreeID in front of the Tree Name in some programs that display or edit just one record,
  3. Add a row for the Tree ID in other programs that display or edit just one record, or
  4. Add the Tree ID or TreeName in drop-down <select> lists.

This mod is based on Ken Roy's Tree ID Mod, which two differences:

  • In case 1 above, this mod puts both values in one column, whereas Tree ID Mod adds a new column. The reason this mod was written was to avoid some conflicts that resulted from the extra column.
  • Also in cases 1 and 2 above, this mod does not add the TreeID when the TreeID and the Tree Name are the same.

Mod Conflicts

This mod conflicts with Tree ID Mod, but is essentially a variant of Tree ID Mod, so there would be no reason to try to install both mods. TreeID-One Column is known to be compatible with numerous other mods that modify the 12 programs that it modifies. Please report any conflicts.

Related Mods

  1. This mod is almost identical to Tree ID Mod, with the differences described above.
  2. This mod saves information about the programs it modifies so that Show Mod Names can display the list of (my) mods that affect a program.
    • Unlike most of my mods, this mod does not insert any code to try to call the Show Mod Names display function at the end of each program. Programs such as admin_users.php that are modified my another of my mods will already have that code, but programs that I do not modify otherwise, such as browse_dna_tests.php, will not.
    • Like my other mods, this mod does not require that Show Mod Names be installed. If Show Mod Names is not installed, the Show Mod Names button at the bottom of modified programs will simply not appear.

Installation

[Show Installation Details]

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

BEFORE: Person Search Results - Representing several search result programs where each table row represents a database record.

Treeid one column-before-search.jpg

AFTER: Person Search Results

The Tree column now has both the TreeID and the Tree Name - except when they are the same.

Treeid one column-after-search.jpg

BEFORE: showtree.php - A tree selected from the search function at Person Profile >> Info menu >> Trees TreeID one column showtree-before.jpg
AFTER: showtree.php

A new row at the top shows the TreeID

TreeID one column showtree-after.jpg
AFTER: Admin>>Branches>>Add New

The TreeID has been added to a drop-down selection list. Note that, in drop-down lists, the TreeID and the Tree Name are both displayed when they are the same.

TreeID one column newbranch-after.jpg
AFTER: Admin>>Branches>>Edit TreeID one column edit branches after.jpg

Revision History

Mod Version TNG Versions Date Note
10.1.0.2 10.1.0 - 11.1.2+ 10 Jan 2018 Except when it is adding the TreeID or Tree Name to <select> box options, the mod no longer adds the Tree ID if the TreeID and Tree Name are the same.
10.1.0.1p 10.1.0 - 11.1.2+ 07 Nov 2017 Removed the second line of the target location search string for cust_text.php files.
10.1.0.1 10.1.0 and up 17 Jun 2017 First production release. Derived from Ken Roy's Tree ID Mod. Made the browse_dna_tests.php target optional for compatibility with TNGv10.1. Other version 11 dependencies are no longer in the code.

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 10.1.0.1 11.1.1 English