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 | |
Download link | v14.0.0.20b
(See the Revision History) | |
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].
- When the relationship to one parent needs to be displayed, and the other relationship is not defined at all,
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.
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.
(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
|
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 |
|
14.0.0.20 | 14 | 28 Jan 2023 | No functional changes. Upgraded to TNGv14 |
13.0.0.19g | 13 | 03 Dec 2020 |
|
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.
|
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 |
|
EN | |
Roy Family Genealogy | Rob Roy | Cannot Install; Cannot contact developer | 13.0.0.19g |
|
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 |
|
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 |