Regroup Person-Child2Parent

Regroup Person-Child2Parent
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
	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	Mod Settings Blocks_v14.0.0.3a, Regroup Person*
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),
  - Without Collapse Family Children, the modified Person Profile will display both relationships, separated by a comma, e.g. [Adopted,Adopted].
  - With Collapse Family Children, the relationship is just shown once, e.g. [Adopted].

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

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.

[Hide Details]

Visualizations

BEFORE: Parent-to-child
AFTER: Parent-to-child Note that the "Relationship" events are omitted.
BEFORE: Child-to-parent When the relationship is the same to both parents, the relationship is displayed once.
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.)

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 A link to the TNG Wiki article (through the Wiki logo) A link to the "Mod Options" section of the Wiki article A link to the Mod Settings Block where the mod's option is edited. A link that pops up a brief description of what the mod did to the page. That popup is shown in the screenshot

The Mod Settings Block msbviz1

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	Modified the parent/child relation types option. Updated the search string for mod options. Rectified the behavior of the mod option when it starts with the defined option but is empty. Conditionally implemented code changes for children-to-parent relationships, contingent on the presence of the "Collapse Family Children" mod. The "Collapse Family Children" mod must be installed after "Collapse Family Children." 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	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. Fixed the behavior of the mod options block if it starts with the option defined but empty. Fixed the behavior of the mod options block when the user attempts to add an empty relationship value. This mod is now compatible with Collapse Family Children, which must be installed before Regroup Person-Child2Parent. (See caveats in the "Conflicts" section above) Changed the default mod option values from "Birth,Natural" to "Birth,Biological" 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. Renamed the mod Moved moved the mod's options to a [[Mod Settings Blocks\|Mod Settings Block] Jumped to version 19 to stay in sync with other Regroup Person* mods 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.