Regroup Person-Child2Parent

From TNG_Wiki
Jump to navigation Jump to search
Regroup Person-Child2Parent
Summary On the Person Profile page (getperson.php), suppresses relationships between child and parent that you specify; generally, "Birth" and/or "Biological".
Validation
Mod Updated 23 Sep 2023
Download link v14.0.0.20b
TNG 14.0
Download stats
Author(s) Robin Richmond
Homepage this page
Mod Support [http://www.robinrichmond.com/family/mod_support.php My Mod Support form
Contact Developer My Mod Support form
Latest Mod 14.0.0.20b
Min TNG V 10.1
Max TNG V 14
Files modified
getperson.php, admin_genconfig.php, admin_updateconfig.php;
Related Mods
Notes
This mod can be used independently of the other mods in the Regroup Person family.

Purpose of the Mod

Make the Person Profile a little more succinct by suppressing the display of the parent/child relations such as 'birth' or 'biological' that can ordinarily be assumed. The modified Person Profile is also more explicit in the way it displays child-to-parent relationships that are the same for both parents, or than involve an undefined relationship. (See the visualizations for details.)

Mod Options

A mod option lets TNG admins define a set of relation values such as "birth" & "biological", and/or those values in other languagues. (See sections below for information about "Languages other than English" and "Natural" relationships

Mod Conflicts

Any number of other mods could conflict with this mod, but there are just too many Person Profile mods to check them all. If you encounter a conflict and want this functionality, please use My Mod Support Form to let me know.

  • Version 19f of this mod is compatible with Collapse Family Children but only if Collapse Family Children is installed first. With both mods installed, the way that the Person Profile displays child-to-parent relationships less explicitly, and more like the native TNG code. Specifically
    • When the relationship to one parent needs to be displayed, and the other relationship is not defined at all,
      • Without Collapse Family Children, the modified Person Profile will display a comma before or after the known relationship so that the user can tell whether the relationship applies to the father or mother (where the father always comes first), e.g. [Adopted,] or [,Adopted].
      • With Collapse Family Children, the relationship to be displayed is shown by itself, e.g. [Adopted].
    • When both relationships are the same (and should be displayed),

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.


regroup


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.


[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

BEFORE: Parent-to-child Regroup person-parent rel-before.png
AFTER: Parent-to-child

Note that the "Relationship" events are omitted.

Regroup person-parent rel-after.png
BEFORE: Child-to-parent
When the relationship is the same to both parents, the relationship is displayed once.
Child2parent-before-c2p.jpg
AFTER: Child-to-parent

As with the native code, when two relationship are displayed, the relationship with the father is displayed first.

  • If both relationships are suppressed, then no relationships are displayed, as in child #1.
  • If one of the two relationships is supposed to be suppressed, they are both displayed, as in child #2.
  • If both relationships are the same and should be displayed, they are both displayed, unlike the native code, which just displays the relationship once.
  • If one relationship is supposed to be shown, and the other is undefined, then the undefined relationship is inferred by a comma, as in [,Adopted] or [Adopted,].

(These last two rules are different if Collapse Family Children is installed; see the Conflicts section above.)
Child2parent-after-c2p.jpg

The Inner Mod Menu

This illustrates the Inner Mod Menu in the Person Profile, on a site where several mods that define Inner Mod Menus have been installed. (Depending on which mods you have installed, you may have to click on a "More mods" link where you see "Fewer mods" here.)

The Regroup Person-Child2Parent links in the menu contains

  1. A link to the TNG Wiki article (through the Wiki logo)
  2. A link to the "Mod Options" section of the Wiki article
  3. A link to the Mod Settings Block where the mod's option is edited.
  4. A link that pops up a brief description of what the mod did to the page. That popup is shown in the screenshot

Child2parent-innermodmenu.jpg

The Mod Settings Block

msbviz1


Child2parent-modsettingsblock.jpg

Languages other than English

The child/parent relationship field is one of the few instances where the TNG data entry pages use a drop-down selection list to specify data values. A notable effect of the drop-down selection list is that the stored relationship value is in English, not in the current language. In English, if you select "Birth", TNG will store the value "birth". In French, if you select "géniteur", TNG will also store "birth"..

Since we cannot reverse-translate "géniteur" to "Birth", admins of a French TNG database who want to suppress "géniteur" must specify "birth" (or "Birth"; it is not case-sensitive) in the mod options. A very advantageous side effect of this scheme is that, on multi-language sites, you do not have to specify the relationship in multiple languages - if you rely on TNG data entry pages.

But if you import your data from Gedcom files, well, the relationship values in the database will be exactly as they are in the Gedcom file, and that may mean that the data will likely contain "géniteur" rather than "birth". In this case, if you want to suppress "géniteur", you must specify "géniteur" in the mod options. And you may want to specify "birth" as well, just in case you slip up and edit a person record with the TNG data entry page.

Natural Relationships

In Heraldic genealogy, the relationship "natural" signifies an out-of-wedlock birth. Unfortunately, not all genealogy applications recognize that term or that meaning.

For example, in TNG, "Natural" is not a choice in the "relationship to parent' field. In fact, TNG provides no way to represent an out-of-wedlock birth other than in a comment, or by implication when an unmarried relationship is marked in some explicit way.

Family Tree Maker (FTM) really turns "Natural" on its head. FTM provides "Biological" as a choice for the parent/child relationship, omits "Natural", and does does not provide a way to specify "Out of wedlock". But, in its Gedcom extracts, it specifies "Natural" as the data value for every parent/child relationship that is not explicitly defined. Consequently, TNG site administrators who import data from Family Tree Maker will almost certainly need to specify "Natural" as a mod option.

Revision History

Mod Version TNG Version Date Contents
v14.0.0.20b 14 23 Sep 2023
  1. Modified the parent/child relation types option.
  2. Updated the search string for mod options.
  3. Rectified the behavior of the mod option when it starts with the defined option but is empty.
  4. Conditionally implemented code changes for children-to-parent relationships, contingent on the presence of the "Collapse Family Children" mod.
  5. The "Collapse Family Children" mod must be installed after "Collapse Family Children."
  6. When the "Collapse Family Children" mod is installed: a. If one relationship needs to be displayed, the other relationship is always shown to help users identify which relationship corresponds to each parent. b. If one relationship needs to be displayed and the other is not defined at all, only the one relationship is shown, making it impossible for the user to determine which parent it belongs to.
14.0.0.20 14 28 Jan 2023 No functional changes. Upgraded to TNGv14
13.0.0.19g 13 03 Dec 2020
  1. Clarified the meaning of the mod option within the mod settings block by adding borders to the table that contains the list of relationships, and by changing the text of the "add" button.
  2. Fixed the behavior of the mod options block if it starts with the option defined but empty.
  3. Fixed the behavior of the mod options block when the user attempts to add an empty relationship value.
  4. This mod is now compatible with Collapse Family Children, which must be installed before Regroup Person-Child2Parent. (See caveats in the "Conflicts" section above)
  5. Changed the default mod option values from "Birth,Natural" to "Birth,Biological"
  6. Fixed bugs introduced by versions 19c and 19e.
13.0.0.19b 13 10 Oct 2020 Upgraded to TNGv13 and fixed the display of Child-to-Parent relationships. Parent-to-Child relations specified by the mod options were being properly suppressed, but Child-to-Parent relationships were never being displayed.
12.0.0.19 12.0-12.3 31 May 2020 No functional changes.
  1. Renamed the mod
  2. Moved moved the mod's options to a [[Mod Settings Blocks|Mod Settings Block]
  3. Jumped to version 19 to stay in sync with other Regroup Person* mods
  4. Added an Inner Mod Menu
12.0.0.16b 12.0+ 24 Jul 2018 No functional changes; made compatible with TNGv12.
11.0.1.16b 10.0.1-11.1.2+ 19 Dec 2017 Updated for new TNG version
10.0.1.16 & 11.0.0.16 10.0.1-11.0 28 Mar 2016 Implemented a mod parameter to provide flexibility in choosing which relationship values to suppress.

Also, for TNGv11, this mod handles the display of Parent/Child relationshps in the list of children.

10.0.1.15 10.0.1-10.1.3 20 Feb 2016 No new end-user functionality; just added Show Mod Names functionality and dependency, and updated the mod number to stay in sync with Regroup Person Profile.
10.0.1.12 10.0.1-10.1.3 26 Dec 2014 Initial release; separated this mod from the larger Regroup Person Profile mod to reduce the chances and consequences of that mod running into conflicts.

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
Richmond's Genealogy Database
(See a specific Person Profile)
Robin Richmond's Genealogy Database Mod developer 14.0.0.2b 14 English
Martius Family Hendrik Martius Half public 11.0.1.16b 12.0.1 DE, EN, FR, NL
Baza danych Rodziny Jarocińskich Michał Jarociński Non-public site v13.0.0.19g 14.0 PL, EN
Delvee Family Assocation Rob Roy Cannot Install; Cannot contact developer 13.0.0.19g
TNG 14.0.6
EN
Roy Family Genealogy Rob Roy Cannot Install; Cannot contact developer 13.0.0.19g
TNG 14.0.6
EN
Vitter-Weaver Genealogy Jeffrey Vitter Public site 13.0.0.19g 13.0.3 EN, FR, CH, DE, ES, IT, NO
Auf den Spuren meiner Ahnen Michael Klein not functional, Public/Private site 14​.0​.0​.20b
TNG 14.0.3
EN, DE
Bastiaanssen Genealogy Jan Bastiaanssen Public / Private 13.0.0.19g 13.1.2 EN, NL, ES
Huygens - Van de Moortel Tom Huygens Public/Private on WordPress 13.0.0.19g 13.1.2 NL
Your Roots are Showing Harold Craswell Public/Private See Here See Here EN
Os Belard Luís Belard da Fonseca Public 14.0.0.20 14.0.2 PT, EN
Mello Garrido Luís Belard da Fonseca Public 14.0.0.20 14.0.2 PT, EN