Difference between revisions of "Regroup Person Profile"

From TNG_Wiki
Jump to navigation Jump to search
(→‎Mod Parameters: for version 18)
 
(115 intermediate revisions by 14 users not shown)
Line 1: Line 1:
{{V12_cust_text}}{{TNGmod
+
{{TNGmod
 
| mod_name        = Regroup Person Profile
 
| mod_name        = Regroup Person Profile
| mod_summary    = Moves things around on the Person Profile page (getperson.php), and compresses whitespace a bit.
+
| mod_summary    = This mod makese numerous changes to the layout of getperson.php to reorganize the display of a Person's Profile in a way that I find more readable.
 
| mod_validation  =
 
| mod_validation  =
| mod_last_update = 20 Jan 2019
+
| mod_last_update = 20 Mar 2024
| download_link  =  [[Media:regroup_person_profile_v12.0.0.17.zip|v12.0.0.17]]{{Tv120}}
+
| download_link  =  [[Media:regroup_person_profile_v14.0.4.20c.zip|v14.0.4.20c]]{{Tv1404}}<div style='font-size:90%;clear:both;'>(See the [[#Revision_History|Revision History for older version]])</div>
 
| download_stats  =
 
| download_stats  =
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
| mod_url        = [http://robinrichmond.org/family/ Robin Richmond's Genealogy Database]
+
| mod_url        = [[Regroup Person Profile]] (this page)
| mod_contact    = [http://robinrichmond.org/family/mod_support.php My Mod Support form]
+
| mod_contact    = [https://www.robinrichmond.com/family/mod_support.php My Mod Support form]
| mod_support    = [http://robinrichmond.org/family/mod_support.php My Mod Support form] or [http://tng.community/ TNG Community Forums]
+
| mod_support    = [https://www.robinrichmond.com/family/mod_support.php My Mod Support form]
| mod_version    = 12.0.0.17
+
| mod_version    = v14.0.4.20c
| min_TNG_ver    = 12.0
+
| min_TNG_ver    = 10.0.1
| max_TNG_ver    = at least 12.0.3
+
| max_TNG_ver    = 14.0.4
|   TNG_file_list  = getperson.php, personlib.php, genlib.php, globallib.php, css/genstyle.css, English cust_text.php, Norwegian cust_text.php
+
| TNG_file_list  = getperson.php, personlib.php, dna_test_results_lib.php, genlib.php, admin_genconfig.php, and admin_updateconfig.php
| related_mods  = The Regroup Person Profile family of mods
+
| related_mods  = [[Mod Settings Blocks]], [[#Related_Mods|The "Regroup Person" family of mods]]
 
| notes    =  
 
| notes    =  
}}
+
}}{| style="margin-right:0.5 em;" align="right"
 +
| __TOC__
 +
|}
 
== Purpose of the Mod ==
 
== Purpose of the Mod ==
To rearrange the data in the person profile in a way that I find more readable, with less scrolling. Here's a partial list:
+
To rearrange the data in the person profile in a way that I find more readable, with less scrolling. There are numerous changes, the most notable of which may be
# Just the most basic Person information is listed first, then parents, marriages, and "Other Personal Data".
+
* Each event's date and place or combined into one table cell primarily to prevent relative dates (e.g. Bef 5 Jul 1897) from wrapping to a second line within the date cell
# Subheadings are added above parents, marriages, other personal data, the event map, and source citations.
+
* Metadata such as the primary person's personID, date of last update, tree, branches, familyID and hyperlinks to family group sheets and family charts are moved to headings above the data tables for person, parents, and families.
# I've moved the person's ID number to the heading, right below the person's name, next to the thumbnail photo, and defined a new style class that distinguishes the letter I from a lower-case l or a 1.  
+
* A button that hides or shows the Event Map is placed in a heading above the map.
# The Event Map is enlarged a bit, as I've eliminated the mostly-blank left-hand column. It can also be hidden and re-displayed.
+
* Events not related to the profiled person's name, birth, christening, death and burial have been moved to a second HTML table labeled "Other Personal Person Events" that is placed below the Parents and Family tables.
# The Source box is also enlarged with the elimination of the mostly-blank left-hand column. New bolding of the Source titles improve readability a bit. Functionality that initially abbreviates the source citations and allows the user to expand them has been moved to [[Regroup Person-Sources]] with mod version 15.
+
Note that the other mods in the "Regroup Person" family make other changes to the Person Profile, as summarized in the [[#Related_Mods|Related Mods]] section of this page. In particular, [[Regroup Person-Date Place]] can restore the two-cell presentation of event dates and places.
# In the print-friendly page format, I ignore the cell height for the Sources, figuring that, when you print the page, you want to see all of the sources.
+
 
# The Cause of Death (_DCAUSE), Alias (ALIA) and Race events, plus secondary birth, death, burial, name, and name component events (and facts) are displayed in the main person information block instead of under "Other Personal Events".
+
See [[#Visualizations|Visualizations]]
See also the subheading [[#Related Mods|Related Mods]], some notes under [[#Incompatible Mods|Incompatible Mods]], the [[#Visualizations|Visualizations]], and additional comments in the .cfg file itself.
+
<!-- BEGIN Mod Details toggle --><span class="mw-collapsible mw-customtoggle-features1 mw-customtoggle-features2" id='mw-customcollapsible-features1'> or <span style="text-decoration:underline;color:#0645ad;white-space:nowrap">a detailed description here</span></span>
}}
+
<div class='mw-collapsible mw-collapsible-content mw-collapsed toccolours' id='mw-customcollapsible-features2' style="border:thick solid brown;">
 +
<div class="mw-customtoggle-features1 mw-customtoggle-features2" style="text-decoration:underline;color:#0645ad;text-align:right;">&#91;Hide details&#93;</div>
 +
<!-- BEGIN TOGGLED CONTENT -->
 +
# The most basic Person information is listed first, then parents, marriages, and only then, "Other Personal Data".
 +
#* Basic information includes (among other facts and events) Name, Sex, Birth, Death, Burial, Cause of Death, Alias, and Race.
 +
# Subheadings have been added above what I call "event blocks" - the blocks of data for personal data, parents, marriages, the event map, source citations, etc.  
 +
# Metadata elements (primary personID, familyIDs, treename, branches, edit date, links to edit pages) are no longer presented as if they were events. Some metadata elements have been moved to the person's heading, and others are placed immediately above the relevant event blocks.
 +
#* The tree name is not displayed if there is only one tree.
 +
# Under the control of a mod option, the personID for relatives (parents, spouses, children, siblings) can be displayed
 +
# The letter I in personIDs is displayed in a serif font to distinguish it from the digit 1 and the lower-case letter l.
 +
# The Event Map is enlarged a bit, as I've eliminated the mostly-blank shaded left-hand column, and tweaked the event list adjacent to the map. The entire map can also be hidden and re-displayed.
 +
# The Source Citations box is also enlarged with the elimination of the mostly-blank left-hand column. New bolding of the Source titles improve readability a bit. (See also [[Regroup Person-Sources]])
 +
# In the Format for Printing page, the cell height for the Source Citations is ignored, under the assumption that, when you print the page, you want to see all of the sources.
 +
# Under the control of a mod setting, the person's siblings can be displayed, and can be presented either with the Parent data or with the Person data.
 +
# When siblings are displayed, half-siblings can be included, and are flagged with the &#189; symbol.
 +
# A mod option allows the Person Notes to be displayed in places not covered by the related TNG system option, for example, up near the top of the page in the "Personal Information" data block.
 +
 
 +
See also [[#Visualizations|Visualizations]], [[#Related Mods|Related Mods]], [[#Incompatible Mods|Incompatible Mods]], and additional comments in the .cfg file itself.
 +
<!-- BUTTON AT THE BOTTOM OF TOGGLED CONTENT --><div class="mw-customtoggle-features1 mw-customtoggle-features2" style="text-decoration:underline;color:#0645ad;text-align:right;">&#91;Hide the options for mod v19&#93;</div></div><!-- END TOGGLED CONTENT and END DOUBLE TOGGLE -->
 
{| style="margin-right:0.5 em;" align="right"  
 
{| style="margin-right:0.5 em;" align="right"  
 
| __TOC__
 
| __TOC__
 
|}
 
|}
== Mod options ==
+
== Mod Options ==
Before mod version 18, this mod had two Mod Parameters:
+
This mod has numerous options in a mod settings block. [[#modsettingsblock|See a Visualization]]
# A value that controls whitespace within the HTML data tables by adjusting HTML cellpadding attribute. The TNG default is cellpadding=4. This mod's default is cellpadding=2, but the padding of 4px can be restored (or increased) with this parameter.  
+
<span class="mw-collapsible mw-customtoggle-19op1 mw-customtoggle-19op2" id='mw-customcollapsible-19op1'>or <span style="text-decoration:underline;color:#0645ad;">&#91;Show details here&#93;</span></span>
# A flag that determines whether to display person ID's for each parent, spouse, and child.
+
<div class='mw-collapsible mw-collapsible-content mw-collapsed toccolours' id='mw-customcollapsible-19op2' style="border:thick solid brown;">
 +
<div class="mw-customtoggle-19op1 mw-customtoggle-19op2" style="text-decoration:underline;color:#0645ad;text-align:right;">&#91;Hide the options&#93;</div>
 +
<!-- BEGIN TOGGLED CONTENT -->
 +
# '''Show dates of last edit" - There's not much point in showing change dates if the data was loaded by a Gedcom Import, since they are all the same.
 +
# '''For Relatives,''' (that is, for parents, spouses, children, and siblings) display the Gender Icon and/or personID.
 +
# Options about displaying siblings:
 +
#* '''Where to Display Siblings''' - "Don't display them", "With personal data", or "With parent's data".
 +
#* '''Show half-siblings''', which works only when they are displayed with personal data.
 +
#* '''Number of siblings to show when the Person Profile loads''': "none", "all", or some specific number.
 +
#**  Since users aren't always interested in siblings and a list of eight or ten or fifteen siblings can take up a lot of space, you can set this option to display only a few siblings to start. A hyperlink that says "{n} more" will expose the remaining siblings.
 +
#* These siblings options are similar to those provided by the [[Add Parents Children Row]] and [[Add Person Siblings Row]]. Those mods used to be compatible with Regroup Person Profile so that you select which way to handle siblings. But they are no long compatible, and there is a very good chance that I will remove this feature in favor those two mods.
 +
# ''Where to put notes''' - Allows several possibilities, including (but not limited to) displaying personal notes very close to the the top of the Person Profile.
 +
#* This option overrides the TNG configuration variable that provides more limited control of the placement of notes, and replaces that option in the configuration page with a note.
 +
# '''Adjust the styling of templates that use .art‐content‐layout:'''
 +
#* This option is driven by a styling conflict between Regroup Person Profile and certain TNG Templates. The styling problem manifests itself by using only half of the screen width to display the Person Profile. I may have fixed this conflict, but I can't be sure that it works in ''all'' templates. if you encounter the half-screen display, just try this option.  If it still doesn't work, [https://www.robinrichmond.com/family/mod_support.php please let me know].
  
In version 18, this mod has six custom TNG settings, defined and edited in the form at Admin>>Setup>>General&nbsp;Settings, in the new subform '''[https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Robin's Mods]'''
+
Also note that several options from earlier versions of Regroup Person Profile are not listed here. In most cases, the relevant features and their options have been spun off from Regroup Person Profile into new "Regroup Person*" mods. See some details in [#Related_Mods|Related Mods]] below.
# '''Spacing''' - Controls whether the Name/Birth/Death/Age data for relatives (parents, spouses, children, siblings) has "more" or "less" spacing.  "More" means the data occupies 3 lines.
+
<!-- BUTTON AT THE BOTTOM OF TOGGLED CONTENT --><div class="mw-customtoggle-19op1 mw-customtoggle-19op2" style="text-decoration:underline;color:#0645ad;text-align:right;">&#91;Hide the options for mod v19&#93;</div></div><!-- END TOGGLED CONTENT and END DOUBLE TOGGLE -->
# '''SpacingControl''' - Whether there will be a spacing control at the right end of the Inner Menu that can change the spacing above.
 
# '''AgeFormat''' - 'Original': (75 years), or 'New': (Age 75) or (Living, Age 75)
 
# '''ShowRelativesIDs''' - Whether to show the PersonID of relatives.
 
# '''SiblingsBlock''' - Whether and where to display the person's siblings. (no / in the parents data block / in the person's primary data block). Note that, in the person's primary data block, "siblings" means "siblings ''of'' the person", and in the parents block, "siblings" means "all of the siblings (including the primary person)".
 
# '''SiblingsAtStart''' - The number of siblings to show before the rest are hidden behind a "show more" link. "0" means "always show them all"
 
 
 
Note that the "Spacing" and "SpacingControl" options coordinate with identically named options in '''[[Regroup Person-Date Place]]''' so that both values are the same, and only one spacing control is created on the Inner Menu.  Javascript code in admin_genconfig.php keeps the options in sync.
 
  
 +
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 Regroup Person Profile row of the Mod Manager List
 +
* From the Inner Mod Menu that this mod installs on the Person Profile page (see a visualization below), and
 +
* From the "Mod Settings Block" subform at Admin>>Setup>>General Settings
 
== Other Mods ==
 
== Other Mods ==
These mods also affect the Person Profile. (Note that Regroup Person Profile and some of these mods do have side effects in some other TNG programs.)
+
Many, many mods affect the Person Profile. These notes cannot cover them all (and are not really up to date).
# [[Regroup Person-Date Place]] - Combines event date, place, and description into one table cell
 
# [[Regroup Person-Move Media]] - Moves the media files above the map
 
# [[Regroup Person-No Living Data]] - Suppresses display of ANY data about a living or private person the user doesn't have rights to.  By default, TNG will show some data, plus spouses, parents, and children.
 
# [[Regroup Person-Parent Rel]] - Hides "natural" or "birth" relationships between the person and the parents.
 
# [[Regroup Person-Sources]] - Starts the display of source citations with just the Source ID, Title, and Author, and provides buttons so the user can display Source details and/or Citation details, for individual source citations and for all source citations..
 
 
 
=== Dependencies ===
 
* [[Regroup Person-Sources]] depends on this mod.
 
* This mod generates information that ''can be'' used by [[Show Mod Names]], but it does not depend on [[Show Mod Names]].
 
  
 +
=== Related Mods ===
 +
{{RobinBoilerplate | text=msb}}
 +
{{RobinBoilerplate | text=regroup}}
 
=== Compatible Mods ===
 
=== Compatible Mods ===
 
This is not a complete list of compatible mods that affect the Person Profile.   
 
This is not a complete list of compatible mods that affect the Person Profile.   
* This mod is compatible with [[Census Plus International]], [[Citation Master]], [[Compact Person Media]], [[Default Photo Preview]], [[Event Map add children mod]], [[Family Indicators Mod]], [[Family Preview Mod]], [[Geocode Assist Mod]], [[Google Maps - More Place Levels Mod]], [[Living Color Mod]], [[Public Access Control]], [[Relationship Display Mod]], [[Relocate Person Photos]], [[Same Person Link]], [[Simple Titles Mod]], [[Submit Photo/Document Form Mod]], [[Submit Photo Tab Mod]], [[Wiki Integration]].  (Note: I have tested the ''installation'' of [[Census Plus International]] and [[Wiki Integration]], but not their ''functionality''.)
+
* This mod is compatible with [[Census Plus International]], [[Citation Master]], [[Compact Person Media]], [[Default Photo Preview]], [[Event Map add children mod]], [[Family Indicators Mod]], [[Family Preview Mod]], [[Geocode Assist Mod]], [[Google Maps - More Place Levels Mod]], [[Living Color Mod]], [[OpenStreetMap]], [[Public Access Control]], [[Relationship Display Mod]], [[Relocate Person Photos]], [[Same Person Link]], [[Simple Titles Mod]], [[Submit Photo/Document Form Mod]], [[Submit Photo Tab Mod]], [[Wiki Integration]].  (Note: I have tested the ''installation'' of [[Census Plus International]] and [[Wiki Integration]], but not their ''functionality''.)
 +
* With version 19e of Regroup Person Profile, it is compatible with version 13.0.0.2b of [[Fixed Family Tab]] and 13.0.0.4 of [[Public Access Control]].
  
=== Incompatible Mods ===
+
=== Mod Conflicts ===
This may not be a complete list of incompatible mods.  Please contact me if you run into any other conflicts.
+
This is not a complete list of incompatible mods.  Please contact me if you run into any other conflicts.
* This mod (Regroup Person Profile) is not compatible with [[Add Person Age Row]], [[Compact Person Media]], [[Divorce Indicator]], [[Family Chart Mod]], [[Family Edit Links Mod]], [[Mobile Site Enhancements]], [[No Notesring]], [[Optional Person Rows]], and [[Person Map]].
+
* Regroup Person Profile is not compatible with [[Add Person Age Row]], [[Burial Website Media Import]], [[Divorce Indicator]], [[Family Edit Links Mod]], [[Mobile Site Enhancements]], [[No Notesring]], and [[Optional Person Rows]].
* This mod is not compatible with [[ID Prefix Format]], butit incorporates the functionality of [[ID Prefix Format]] by using an alternate font to make the "I" in person ID's distinct from "l" and "1".
+
* Regroup Person Profile and Collapse Family Children can be installed together, but they do not work together. When they are both installed, the display of the profile person's children is broken.
* This mod is also not compatible with [[Person Map]], but incorporates some of the functionality of [[Person Map]] in that it can hide and re-display the Event Map.
 
* This mod conflicts with [[Adjust Date Column Width]], but when the companion mod [[Regroup Person-Date Place]] is installed, [[Adjust Date Column Width]] becomes pointless, since [[Regroup Person-Date Place]] combines the date and location columns.
 
* This mod conflicts with [[Add Person Cremated Row]], but like [[Add Person Cremated Row]], it creates a Cremation pseudo-event.  
 
  
=== Conflict Mods ===
+
=== Overlap ===
* [[Submit Headstone Photo Mod]] can be installed ''after'' this modIn some versions, installing [[Submit Headstones Photo Mod]] creates a Bad Target error in Regroup Person Profile in Mod Manager, but the Person Profile still works.  The Bad Target error can be removed by uninstalling [[Submit Headstone Photo Mod]].
+
These mod implement features that are also implemented by Regroup Person Profile or a companion mod from the Regroup Person* family. In some cases, the two mods have installation or functional conflicts, and you must pick one or the other. In cases where the mods do work together, some Regroup Person* features can be disabled in favor of the other mod, but, in others the "compatible" features are redundant and you'll probably want to install just one of the two mods.
* [[Count_Ancestors_n_Descendants]] can be installed ''after'' this mod. You need to uninstall [[Count_Ancestors_n_Descendants]] before this mod.
+
* [[Add Person Siblings Row]] adds the profiled person's siblings to the personal data block. Regroup Person Profile also ''optionally'' displays siblings, though in a different specific location and in a different format. Since Regroup Person Profile and [[Add Person Siblings Row]] ''are'' compatible, you can choose the format you prefer. Of course, if you do install [[Add Person Siblings Row]], then you'll probably want to use the options for Regroup Person Profile to disable its display of siblings.
* [[Signature Display]] can be installed ''before'' this mod. You need to uninstall [[Signature Display]] after this mod.
+
* [[Add Parents Children Row]], like [[Add Person Siblings Row]], adds the profiled person siblings to the Person Profile, but does no in the parents' data block. Again, Regroup Person Profile also ''optionally'' displays siblings in the parents' data block, but does so in a different formatRegroup Person Profile and [[Add Parents Children Row]] ''are'' compatible, but if you install [[Add Parents Children Row]], then you'll probably want to disable Regroup Person Profile's display of siblings.
 +
* [[ID Prefix Format]]: Regroup Person Profile also uses an alternate font to make the "I" in person ID's distinct from the lower-case letter "l" and the number "1".
 +
* [[Person Map]]: Like [[Person Map]], Regroup Person Profile allow users to hide and re-display the Event Map.
 +
* [[Life Dates Mod]], which uses a three-line format for relative's name/birth/death/age data that is similar to the one that Regroup Person Profile implements.  The [[Life Dates Mod]] uses different style, but the changes serve the same purpose.
 +
* [[Adjust Date Column Width]]: [[Regroup Person-Date Place]] (a companion to Regroup Person-Profile) effective ''eliminates'' the Event date column by combing the date and place into one continuous string.
 +
* [[Add Person Cremated Row]]: Like [[Add Person Cremated Row]], Regroup Person Profile displays TNG's non-standard "Cremated" flag as though it were a separate event.
 +
* [[Family Indicators Mod]] ''is'' compatible with Regroup Person Profile, but not with [[Regroup Person-Family Indicators]], which was derived from [[Family Indicators Mod]]. [[Regroup Person-Family Indicators]] implements indicators that are almost identical to those implemented by [[Family Indicators Mod]] and generates popup ancestor previews that are very similar to those displayed by [[Family Indicators Mod]]. The most significant distinction between the two family indicators mods is that [[Regroup Person-Family Indicators]] also affects the siblings that can be displayed by Regroup Person Profile.
 +
* [[Remove Gender Row]]: Regroup Person Profile's companion Mod [[Regroup Person-Remove Gender]] also removes the Gender row from the Person Profile.
  
==Installation==
+
=== Interdependencies ===
This mod uses the standard installation procedure. {{RobinInstallationBoilerplate}}
+
* [[Submit Headstone Photo Mod]] can be installed ''after'' Regroup Person Profile.  In some versions of one mod or the other, installing [[Submit Headstone Photo Mod]] creates a Bad Target error in Regroup Person Profile in Mod Manager, but the Person Profile still works.  If the Bad Target error does occur, [[Submit Headstone Photo Mod]] must be uninstalled before Person Profile can be uninstalled..
 +
* [[Count_Ancestors_n_Descendants]] can be installed ''after'' this mod, and must be uninstalled before Regroup Person Profile can be uninstalled.
 +
* [[Signature Display]] must be installed ''after'' this mod.
  
 +
== Installation ==
 +
This mod does not install any files. It modifies getperson.php, personlib.php, dna_test_results_lib.php, genlib.php, admin_genconfig.php, and admin_updateconfig.php. Instead of cluttering genstyle.css and cust_text.php (for several languages) with styles and strings that are used only by the Person Profile,
 +
<ul><li>This mod defines an inline style sheet in getperson.php. You can override these styles by specifying new style rules in genstyle.css</li>
 +
<li>{{RobinBoilerplate | text=languageandfiles}}</li>
 +
</ul>
 +
{{RobinBoilerplate | text=install}}
 
== Visualizations ==
 
== Visualizations ==
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
+
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
 
|-
 
|-
|<span style="color: red">'''1. BEFORE AND AFTER OVERVIEW'''</span><br>
+
|<span style="color:brown;">'''1. BEFORE AND AFTER OVERVIEW'''</span><br>
 
Click on the image below to see larger side-by-side non-annotated before and after images.  Note that the media files have been clipped out because they haven't changed.  But the personal and family data is now laid out differently, the Event Map is now slightly wider, and the Sources, by default, show only the titles, not the full citation information. <span style="color: red">(Note that Some of the changes shown in the visualizations are now implemented by other mods that were extracted from earlier versions of [[Regroup Person Profile]]). In particular, [[Regroup Person-Date Place]] now combines the date, place, and description for an event into one cell in the display table.)</span>
 
Click on the image below to see larger side-by-side non-annotated before and after images.  Note that the media files have been clipped out because they haven't changed.  But the personal and family data is now laid out differently, the Event Map is now slightly wider, and the Sources, by default, show only the titles, not the full citation information. <span style="color: red">(Note that Some of the changes shown in the visualizations are now implemented by other mods that were extracted from earlier versions of [[Regroup Person Profile]]). In particular, [[Regroup Person-Date Place]] now combines the date, place, and description for an event into one cell in the display table.)</span>
 
|-
 
|-
 
| [[File:regroup_person_profile-both.png|637x670px]]
 
| [[File:regroup_person_profile-both.png|637x670px]]
|-
+
|}
| <span style="color: red">'''2. BEFORE:'''</span> '''The personal data section of the original version of the Personal Profile.'''<br>
+
 
 +
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
 +
| <span style="color:brown;">'''2. BEFORE:'''</span> '''The personal data section of the original version of the Personal Profile.'''<br>
 
The red comments describe some of the changes that the mod will make.  
 
The red comments describe some of the changes that the mod will make.  
 
|-
 
|-
 
| [[Image:regroup_person_profile-before1.png]]
 
| [[Image:regroup_person_profile-before1.png]]
|-
+
|}
| <span style="color: red">'''3. AFTER:'''</span> '''The personal AND family data in the new format'''
+
<span id='visualization3'></span>
 +
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
 +
| <span style="color:brown;">'''3. AFTER:'''</span> '''The personal AND family data in the new format'''
 
# Personal meta-data has been moved to the heading.
 
# Personal meta-data has been moved to the heading.
 +
# The "Mod Information" menu, ''which is visible only to admins'', provides links to this Wiki article, and provides a link ''directly to'' the mod options.
 +
#* By "directly to", I mean that the link opens this mod's "Mod Settings Block", without the need to select a subform at "Admin>>Setup>>General&nbsp;Settings", nor to scroll down to this mod's options. (See [[#modsettingsblock|The Mod Settings Block Screenshot]].
 +
# Events that describe the profiled person are divided into two data blocks. Basic name, birth, death, and burial information are in the first data block (like the native Person Profile), but all other personal events are displayed in a second block, labeled "Other Personal Events" ''below'' the person's parents and families.
 
# The white space between blocks of data is now occupied by headings and metadata.
 
# The white space between blocks of data is now occupied by headings and metadata.
# The words "wife" and "husband" are substituted for "spouse" in the Family block
+
# A mod option determnines whether the personID of each relative(spouses, parents, children, siblings) is shown.
# The indentation of data about children has been improved.  
+
# The words "Wife" and "Husband" replace "Family" in the table row for the spouse/partner name.
# This visualization does not show the Person ID's that are (optionally) placed after the names of parents, spouses, and children.)
+
#* I now realize that labels other than "Wife" and "Husband" should be used if the parents are not married. In a future version, I hope to implement labels that reflect the nature of the relationship, though '''''I need suggestions about what terms to use.'''''
 +
# The indentation of the children's name/birth/death/age data has been improved. The data now wraps like HTML list items; that is, it does not wrap below the number at the beginning of the line.
 
|-
 
|-
| [[Image:regroup_person_profile-after1.png]]
+
| [[Image:regroup_person_profile-after19.jpg]]
|-
+
|}
| <span style="color: red">'''4. AFTER:'''</span> '''The new Event Map'''<br>
+
 
 +
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
 +
| <span style="brown;">'''4. AFTER:'''</span> '''The Event Map'''<br>
 
The map is wider than before because the mod has eliminated the colored left-hand column, and put the Event Map label in the whitespace above the map.  It has also modified the layout of the first pin legend so it wastes less space, and so that it wraps more cleanly when the page is narrow enough to require wrapping.  Also note the button outlined in red at the top right, which changes to "Show Event Map" when the Event Map is hidden.
 
The map is wider than before because the mod has eliminated the colored left-hand column, and put the Event Map label in the whitespace above the map.  It has also modified the layout of the first pin legend so it wastes less space, and so that it wraps more cleanly when the page is narrow enough to require wrapping.  Also note the button outlined in red at the top right, which changes to "Show Event Map" when the Event Map is hidden.
 
|-
 
|-
 
| [[Image:regroup_person_profile-after-map.png]]
 
| [[Image:regroup_person_profile-after-map.png]]
 +
|}
 +
 +
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
 +
| <span style="brown;">'''5. AFTER:'''</span> '''The Source Citations block'''<br>
 +
Like the Event Map, the Sources block no longer uses the colored left-hand column, and its label (now "Source Citations") is in the whitespace above the sources. The [[Regroup Person-Sources]] mod adds substantial functionality to the Source Citations block. It loads the page with just the Source name, and provides links and buttons that add and remove Source and Citation details.
 +
|-
 +
| [[Image:regroup_person-after-sources.png]]
 +
|}
 +
 +
<span id='visualization6'></span>
 +
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
 +
| <span style="brown;">'''6. AFTER:'''</span> '''Siblings '''<br>
 +
# A mod option controls whether siblings are displayed in the Parents' data block,  in the basic personal data block (as shown here), or not displayed at all.
 +
# Another mod option controls how many siblings are shown as the page is loaded  If not all siblings are initially displayed, the program displays a "more" link that expands the list to include all siblings.
 +
# The the name of the person being profiled is not a hyperlink, since we are already on that person's profile.
 +
|-
 +
| [[Image:regroup_person_profile-siblings.png]]
 +
|}
 +
 +
<span id='modsettingsblock'></span>
 +
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
 +
| <span style="brown;">'''7. AFTER:'''</span> '''The Regroup Person Profile mod configuration settings in their "Mod Settings Block"'''<br>
 +
{{RobinBoilerplate | text=msbviz1}}
 +
{{RobinBoilerplate | text=msbgenconfig}}
 
|-
 
|-
| <span style="color: red">'''5. AFTER:'''</span> '''The new Sources block'''<br>
+
| [[Image:Rpp-after-msb20b.png]]
Like the Event Map, the Sources block no longer uses the colored left-hand column, and its label (now "Source Citations") is in the whitespace above the sources. The [[Regroup Person-Sources]] mod adds substantial functionality to the Source Citations block. It can remove details from each Source Citation, and provides button and links that display Source and/or Citation details.  
+
|}
 +
 
 +
<span id='innermodmenu'></span>
 +
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
 +
| colspan='2' | <span style="brown;">'''8. AFTER:'''</span> '''The Person Profile "Inner Mod Menu" after several Regroup Person* mods have been installed.'''
 
|-
 
|-
| [[Image:regroup_person-after-sources.png]]
+
{{RobinBoilerplate | text=msbviz1}}
 +
{{RobinBoilerplate | text=msbgenconfig}}
 +
| [[Image:Rpp-after-imm20b.PNG]]
 
|}
 
|}
  
== Controlling White Space with Classes ==
+
== Language Strings==
<span style='font-size:90%;'>'''Aside:''' Vertical whitespace can produce a feeling of "openness" in web pages and other media.  But sometimes it unnecessarily reduces the amount of data that can be seen at once, and increases the need for users to do vertical scrolling.  So I've been known to push back a bit - especially when whitespace is provided by &lt;br> tags rather than style rules. To that end:</span>
+
{{RobinBoilerplate | text=language1}}
 +
 
 +
== White Space ==
 +
<span style='font-size:90%;'>'''Aside:''' Vertical whitespace can produce a feeling of "openness" in web pages and other media.  But sometimes it unnecessarily reduces the amount of data that can be seen at once, and increases the need for users to do vertical scrolling.  So I've been known to push back on whitespace a bit - especially when whitespace is generated by &lt;br> tags rather than style rules. To that end:</span>
 
# This mod uses styles to decrease the whitespace between the HTML tables that define various sections of the Person Profile (basic personal data, parents, families, the event map, media items, etc.). This mod provides 1ex of whitespace in the bottom margin of each table. You can increase that whitespace with a style rule such as <code><span style="white-space:nowrap;">.datatable {margin-bottom:1em;}</span></code> at the bottom of your genstyle.css or in your template's mytngstyle.css.
 
# This mod uses styles to decrease the whitespace between the HTML tables that define various sections of the Person Profile (basic personal data, parents, families, the event map, media items, etc.). This mod provides 1ex of whitespace in the bottom margin of each table. You can increase that whitespace with a style rule such as <code><span style="white-space:nowrap;">.datatable {margin-bottom:1em;}</span></code> at the bottom of your genstyle.css or in your template's mytngstyle.css.
 
# This mod removes a hard break from the end of the TNG "innermenu". Whitespace below the innermenu can be restored by a style rule such as <code><span style="white-space:nowrap;">.pub-innermenu {margin-bottom:1em;}</span></code> at the bottom of your genstyle.css or your template's mytngstyle.css.
 
# This mod removes a hard break from the end of the TNG "innermenu". Whitespace below the innermenu can be restored by a style rule such as <code><span style="white-space:nowrap;">.pub-innermenu {margin-bottom:1em;}</span></code> at the bottom of your genstyle.css or your template's mytngstyle.css.
Line 118: Line 199:
 
#*:<span style='padding:2px 10px; color:white; background-color:steelblue;'>Personal Information &nbsp;|&nbsp; Media &nbsp;|&nbsp; Notes &nbsp;|&nbsp; Source Citations &nbsp;|&nbsp; Event Map &nbsp;|&nbsp; All &nbsp;|&nbsp; PDF&nbsp;&nbsp;</span>
 
#*:<span style='padding:2px 10px; color:white; background-color:steelblue;'>Personal Information &nbsp;|&nbsp; Media &nbsp;|&nbsp; Notes &nbsp;|&nbsp; Source Citations &nbsp;|&nbsp; Event Map &nbsp;|&nbsp; All &nbsp;|&nbsp; PDF&nbsp;&nbsp;</span>
 
#* This change affects not just the Person Profile, but most TNG page headings. However, the .pub-innermenu style rule shown above will restore whitespace to all affected pages.
 
#* This change affects not just the Person Profile, but most TNG page headings. However, the .pub-innermenu style rule shown above will restore whitespace to all affected pages.
 
===Modifying Style Rules===
 
When you want to modify the effect of a style rule defined in the master TNG stylesheet, css/genstyle.css, you '''should not''' edit the existing rule. This is especially true for style rules added by a mod, but is also true of "native" styles. If you edit a mod-defined rule, you will break the mod's installed status, and, in either case, your change will likely be lost with any TNG upgrades.  Instead, as indicated by the instructions above, you should define a ''new'' style rule for the same style class, focus on the style attribute you want to change, and place your new rule
 
* At the very bottom of genstyle.css, or
 
* In the stylesheet file mytngstyle.css in your template's css folder (which is empty in fresh TNG installations).
 
Note that your template's mytngstyle.css folder may be the safer of these two options, since it is easier to backup the entire mytngstyle.css file than to backup a set of rules inside genstyle.css. But, of course, if you use more than one template, the style rules that you put in a template's mytngstyle.css will need to be duplicated in the all of the other templates you use.
 
  
 
== Formatting Person and Family IDs ==
 
== Formatting Person and Family IDs ==
 
In order to distinguish the leading "I" of a person ID from a "1" or a lower-case "l", this mod displays PersonIDs and FamilyIDs with style classes that change the font of the ID's.
 
In order to distinguish the leading "I" of a person ID from a "1" or a lower-case "l", this mod displays PersonIDs and FamilyIDs with style classes that change the font of the ID's.
 +
 +
== "Source Citations" ==
 +
This mod relabels the "Sources" section of the Person Profile as "Source Citations". The distinction is not important, especially to end users, but it does have meaning, and I think that translators - and maybe some others -  might benefit from an explanation..
 +
 +
At least in English, the terms "Sources", "Citations", or "Source Citations" are completely ambiguous, and could each reasonably serve as a heading.  But the items listed in this section of the report do not accurately represent what TNG calls "Sources" ''or'' "Citations"
 +
 +
* They are not TNG "Sources" '''in that they contain''' citation details. They also are not unique. Two entries in the list can have different citation details from the same source.
 +
* So really, they are more like citations, and "Citations" would be a perfectly reasonable heading.
 +
* But they are not really TNG "Citations" in that TNG citation records can point to only one event.  They can be thought of as (for lack of a better term) "generic citations" or "unique citations". After all, in many genealogy applications, citations can link to many events (even to events in multiple person and family records).  In those applications, the heading "Citations" would be completely consistent with the way that the items in the list are stored in the database.
 +
 +
In any case, it turned out to be so trivial to change the heading that I just did it.
 +
 +
== Event Labels  as Nouns or Verbs ==
 +
In "most?" genealogy applications, most event labels are nouns, e.g. BIRT->Birth, CHR=Christening, DEAT->Death, BURI->Burial, MARR=>Marriage, DIV=>Divorce, OCCU->Occupation, RESI->Residence, IMMI->Immigration, GRAD->Graduation, EDUC->Education,RELI->Religion.
 +
 +
In TNG Person Profile, however,
 +
 +
* The labels for "custom" events (those stored in the Events table) are all defined in the Eventtypes tables, which is edited at Admin>>Eventtypes. When you add a new Eventtype, you can specify an arbitrary tag and label (a "description"), or select from about 45 hard-coded tags, which are each paired with a label. Most of those labels, like the ones listed above, are in noun form. Once entered into the Eventtypes table, an Eventtype's label can be changed.
 +
* The labels for "Built-in" events (those stored in the People, Families, and Children tables rather than in the Events table) have hard-coded labels, which are
 +
** Displayed in the People and Families edit page as nouns, e.g.  BIRT->Birth, CHR=Christening, DEAT->Death, BURI->Burial, MARR=>Marriage, DIV=>Divorce, and
 +
** Displayed in the Person Profile, the Places detail page, and the Register report  in verb forms, e.g. BIRT->Born, CHR=Christened, DEAT->Died, BURI->Buried, MARR=>Married, DIV=>Divorced.
 +
** The verb forms are handy for generating sentences in the Register Report (e.g. "Moses Wheeler was born on 5 Jan 1598 in Bow, Middlesex, England; died on 15 Jan 1698 in Stratford, Fairfield County, Connecticut, USA; was buried in Old Congregational Burying Ground, Stratford, Fairfield County, Connecticut, USA.") but are distinctly inconsistent with the other events and with the typical noun forms.
  
 
== Revision History ==
 
== Revision History ==
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
! Mod Version !! TNG Version !! Date !! Note
 
! Mod Version !! TNG Version !! Date !! Note
|-  
+
|- style="vertical-align:top;"<!-- ############################################################## -->
| [[Media:regroup_person_profile_v12.0.0.17.zip|12.0.0.17]]
+
|[[Media:regroup_person_profile_v14.0.4.20c.zip|v14.0.4.20c]]
| 12.0+
+
|14.0.4
| 24 Jul 2018
+
|20Mar2024
 +
|Changed one location to handle a code change in TNG14.0.4.
 +
 
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
|[[Media:Regroup_person_profile_v14.0.1.20b1.zip|v14.0.1.20b1]]
 +
|14.0.1-14.0.3
 +
|5Nov2023
 +
|Upgraded to TNGv14.0.1, Fixed bug that caused some mods to display children in the wrong font, Tweaked two insertion strings to avoid conflicts with Show All Family
 +
 
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
| [[Media:Regroup person profile v13.0.4.19g1.zip|13.0.4.19g1]]
 +
| 13.0.4+
 +
| 28Apr2022
 +
| Changes comments that begin with "#[", since that syntax is not valid in PHP8. Please note the .cfg file for older versions of this mod may still contain that string, which you should change to something such as "##[" if you are using PHP8.
 +
 
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
| [[Media:Regroup person profile v13.0.4.19g.zip|13.0.4.19g]]
 +
| 13.0.4
 +
| 14Jun2021
 +
|
 +
* Accommodates a change made in TNGv13.0.4 to the way TNG handles source titles.
 +
* Fixed a problem in which private notes could be exposed, depending on the placement of the notes according a mod option.
 +
 
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
| [[Media:Regroup person profile v13.0.3.19f.zip|13.0.3.19f]] [[Media:Regroup person profile v13.0.0.19f.zip|13.0.0.19f]]
 +
| 13.0.3
 +
| 21Feb2020
 +
|
 +
# Cleaned up the Group Sheet, Family Chart, and Edit links above the parents marriage block
 +
# Changed the way that this mod interacts with [[Regroup Person-Gender Before Birth]] and [[Regroup Person-Remove Gender]]
 +
# Added the ability to place general notes near the top of the page; just after the name and gender.
 +
# Created a separate version for TNGv13.0.3 because of underlying code changes.
 +
 
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
| [[Media:Regroup person profile v13.0.0.19e.zip|13.0.0.19e]]
 +
| 13-13.0.2
 +
| 28Nov2020
 +
| Established compatibility with the [[Public Access Control]] mod.
 +
 
 +
|}
 +
 
 +
<div class="mw-collapsible mw-customtoggle-older1 mw-customtoggle-older2" id='mw-customcollapsible-older1'><span style="text-decoration:underline;color:#0645ad;">See changes preceding TNGv13 and Sep 2020</span> - back to Apr 2014, for TNGv10.1</div>
 +
<div class='mw-collapsible mw-collapsible-content mw-collapsed toccolours' id='mw-customcollapsible-older2' style="border:thin solid grey;">
 +
<!-- BEGIN TOGGLED CONTENT -->
 +
'''Changes Preceding TNGv13 and Sep 2020'''<div class="mw-customtoggle-older1 mw-customtoggle-older2" style="text-decoration:underline;color:#0645ad;text-align:right;">&#91;Hide details&#93;</div>
 +
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 +
! Mod Version !! TNG Version !! Date !! Note
 +
 
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
| [[Media:Regroup person profile v13.0.0.19d.zip|13.0.0.19d]]
 +
| 13-13.0.2
 +
| 10Nov2020
 +
|
 +
# Bug fix: when a parent of the profiled person is undefined ALL children of an undefined parents were being shown as half siblings.
 +
# Norwegian translation by Svein Krakeli
 +
# Moved RACE and CREM to the main data block.
 +
# Suppresses empty notes
 +
 
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
|[[Media:Regroup person profile v13.0.0.19c.zip|13.0.0.19c]]
 +
| 13.0
 +
| 7Oct2020
 +
|
 +
v19c 7 Oct 2020
 +
# Bug fix: the 'Hide Map'/'Show Map' button was not changing to 'Show Map' when the map is hidden.
 +
# Bug fix: Events and notes used different-sized fonts because of a TNGv13 upgrade mistake
 +
# No longer shows the tree name if there is only one tree in the database
 +
v19b 3 Oct 2020
 +
# Fixed a typo that broke the the mod parameter edit page.
 +
v19a 29 Sep 2020
 +
# Implemented an ad-hoc heading that goes above all of the media items. The heading value comes from a custom string that must be defined in each language's cust_text.php file.
 +
# Modifications to the French translation.
 +
v13.0.0.19 17 Sep 2020
 +
# Changed 6 target location search strings that now specify the "normal" class for data block table tags.
 +
# Added a target location to handle TNGv13's new placement of LDS events vis-a-vis custom events.
 +
# Now uses the Mod Settings Blocks mod rather than shared files.
 +
# Added French translations by Katryne Chauvigné-Bourlaud
 +
|-
 +
|14.0.1.20b1
 +
|14
 +
|11 Nov 2023
 +
|
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
| [[Media:Regroup person profile v12.0.0.19.zip|12.0.0.19]]
 +
| 12.0 - 12.3
 +
| 15Aug2020
 +
| Most of the changes involve coordination with other Regroup Person* mods &emsp; <span class="mw-collapsible mw-customtoggle-v191 mw-customtoggle-v192" style="text-decoration:underline;color:#0645ad;">&#91;Show details&#93;</span>
 +
<div class="mw-collapsible mw-collapsible-content mw-collapsed toccolours" style="border:thin solid grey;">
 +
<!-- BEGIN TOGGLED CONTENT -->
 +
<div class="mw-customtoggle-v191 mw-customtoggle-v192" style="text-decoration:underline;color:#0645ad;text-align:right;">&#91;Hide details&#93;</div>
 +
# Fixed a typo that was preventing sibling's popup profiles from popping up.
 +
# Moved changes to the format of relatives' name/birth/death/age info to Regroup Person-Date Place, which was already handling event date/place spacing. This also removed the spacing button from this mod and the relatively complex coordination between the two mods over the spacing button.
 +
# Moved changes to the Age format to Regroup Person-Date Place since the age format is part of relatives' name/birth/death/age info.
 +
# This mod still has to coordinate with Regroup Person-Date Place in that the formatting of siblings' name/birth/death/age strings is different if Regroup Person-Date Place is installed.
 +
# Both this mod and Regroup Person-Date Place have been identified as v19, since the changes in the functionality of and coordination between the two mods means that if both are installed,  they both must use v19 or above.
 +
# Under control of a new option, the mod now can move person notes up into the main personal data block.
 +
# Another new mod option determines whether record change dates are displayed. (There isn't much point in displaying change dates if a Gedcom Import has specified the same change date for every record, whether it was changed or not.)
 +
# Coordinates with Regroup Person-Family Indicators to make sure that the Regroup Person-Family Indicators icon is used for siblings.
 +
# See the .cfg file Revision History for other details.
 +
<!-- BUTTON AT THE BOTTOM OF TOGGLED CONTENT --><div class="mw-customtoggle-v191 mw-customtoggle-v192" style="text-decoration:underline;color:#0645ad;text-align:right;">&#91;Hide details&#93;</div>
 +
</div><!-- END TOGGLED CONTENT and END DOUBLE TOGGLE -->
 +
 
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
| [[Media:Regroup person profile v12.0.0.18d.zip|12.0.0.18d]]
 +
| 12.0 - 12.3
 +
| 24Feb2020
 +
|
 +
* The siblings list is now labeled "Siblings" whether it is in the personal data block, or in the parents' data block.
 +
* Added a missing %end:% tag, as required in TNGv12.3.
 +
* Upgraded to version 4 of the shared mod libraries.
 +
 
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
| [[Media:Regroup person profile v12.0.0.18b.zip|12.0.0.18b]]
 +
| 12.0 - 12.2
 +
| 19Dec2019
 +
| Upgraded to version 3 of the shared mod includes libraries, installed a temporary CSS patch to allow this mod to work in certain templates, fixed a bug that was preventing relatives' data from being reformatted into three lines, and eliminated a conflict with Regroup Person-Source v18b.
 +
 
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
| [[Media:Regroup person profile v12.0.0.18.zip|12.0.0.18]]
 +
| 12.0-12.2
 +
| 28Sep2019
 +
|
 +
* Moved the mod options to admin_genconfig.php, which requires shared include files for '''[https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Mod Settings Blocks]'''.
 +
* Can now display siblings, either in the main person data block, or in the parents' block.
 +
* Can display relatives name/birth/death data on one line or on three lines.
 +
* Can display a spacing control to dynamically affect the relatives name/birth/death format.
 +
* Has new options to control the display of siblings, the relatives' data, and the spacing control.
 +
* The presence of the spacing control is coordinated with Regroup Person-Date Place, which has its own spacing options.
 +
 
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
| [[Media:Regroup person profile v12.0.0.17.zip|12.0.0.17]]
 +
| 12.0-12.2
 +
| 24Jul2018
 
| Fixed a typo that was preventing the marriage block displaying the words "Wife" or "Husband".
 
| Fixed a typo that was preventing the marriage block displaying the words "Wife" or "Husband".
|-  
+
|- style="vertical-align:top;"<!-- ############################################################## -->
| [[Media:regroup_person_profile_v12.0.0.16p.zip|12.0.0.16p]]
+
|[[Media:Regroup person profile v12.0.0.16p.zip|12.0.0.16p]]
 
| 12.0+
 
| 12.0+
| 24 Jul 2018
+
| 24Jul2018
 
| No functional changes; made compatible with TNGv12.
 
| No functional changes; made compatible with TNGv12.
|-  
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 11.0.0.16p
 
| 11.0.0.16p
 
| 11.0-11.1.2+
 
| 11.0-11.1.2+
 
| 28 Mar 2016
 
| 28 Mar 2016
 
| No functional changes. Removed the second line of the cust_text.php target location search strings.
 
| No functional changes. Removed the second line of the cust_text.php target location search strings.
|-  
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 11.0.0.16a
 
| 11.0.0.16a
 
| 11.0-11.1
 
| 11.0-11.1
| 28 Mar 2016
+
| 28Mar2016
 
| Updated for TNGv11.  Added Race to the set of events that I have moved from the Other Personal Events table to the main personal events table.
 
| Updated for TNGv11.  Added Race to the set of events that I have moved from the Other Personal Events table to the main personal events table.
|-  
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 10.0.1.15a
 
| 10.0.1.15a
 
| 10.0.1-10.1.3
 
| 10.0.1-10.1.3
| 10 Mar 2016
+
| 10Mar2016
 
| Fixed an old bug in location 33 that erased the event map if any notes were attached to the person rather than to an event.
 
| Fixed an old bug in location 33 that erased the event map if any notes were attached to the person rather than to an event.
|-  
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 10.0.1.15
 
| 10.0.1.15
 
| 10.0.1-10.1.3
 
| 10.0.1-10.1.3
 
| 20 Feb 2016
 
| 20 Feb 2016
 
| - Moves some Source Citations functionality to [[Regroup Person-Sources] to establish compatibility with [[Citation Master]]. <br/> - Implemented [[Show Mod Names]] functionality.<br/> - Fixed a bug that disabled the scrolling of citations.<br/> - Eliminated a TNGv10.1 database function call in one target location.
 
| - Moves some Source Citations functionality to [[Regroup Person-Sources] to establish compatibility with [[Citation Master]]. <br/> - Implemented [[Show Mod Names]] functionality.<br/> - Fixed a bug that disabled the scrolling of citations.<br/> - Eliminated a TNGv10.1 database function call in one target location.
|-  
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 10.0.1.14f
 
| 10.0.1.14f
 
| 10.0.1-10.1.2
 
| 10.0.1-10.1.2
| 19 Jul 2015
+
| 19Jul2015
 
| - Followed more of Jeannette Wickham's suggestion and added name facts and events to the primary personal data block, instead of "Other Personal Data".<br/> - Fixed two old bugs in my code that put some notes in narrow columns.<br/> - Fixed another old bug that caused some event source citation links not to be enclosed in brackets.<br/> - Added Norwegian translation of cust_text strings, courtesy of Ørjan K. Albriktsen.<br/> - Moved code to accommodate  the [[Public Access Control]] mod.
 
| - Followed more of Jeannette Wickham's suggestion and added name facts and events to the primary personal data block, instead of "Other Personal Data".<br/> - Fixed two old bugs in my code that put some notes in narrow columns.<br/> - Fixed another old bug that caused some event source citation links not to be enclosed in brackets.<br/> - Added Norwegian translation of cust_text strings, courtesy of Ørjan K. Albriktsen.<br/> - Moved code to accommodate  the [[Public Access Control]] mod.
|-  
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 10.0.1.14
 
| 10.0.1.14
 
| 10.0.1-10.1.1
 
| 10.0.1-10.1.1
| 08 Jul 2015
+
| 08Jul2015
 
| Folded [[Regroup Person-Other IDs]] back into this mod.  Followed Jeanette Wickham's suggestion to put cause of death plus secondary birth, death, and burial events in the data block at the top of the page instead of in the "Other Personal Data" block.  Now works with [[Default Photo Preview]]. Improved code comments.  Reintroduced some of the whitespace that I had eliminated by removing &lt;br/&gt; tags.
 
| Folded [[Regroup Person-Other IDs]] back into this mod.  Followed Jeanette Wickham's suggestion to put cause of death plus secondary birth, death, and burial events in the data block at the top of the page instead of in the "Other Personal Data" block.  Now works with [[Default Photo Preview]]. Improved code comments.  Reintroduced some of the whitespace that I had eliminated by removing &lt;br/&gt; tags.
|-  
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 10.0.1.13
 
| 10.0.1.13
 
| 10.0.1-10.1
 
| 10.0.1-10.1
| 03 Jan 2015
+
| 03Jan2015
 
| Had to restore some trailing spaces to some lines of code, because I had mistakenly tested the mod with a beta version of Mod Manager that was deleting trailing spaces.   
 
| Had to restore some trailing spaces to some lines of code, because I had mistakenly tested the mod with a beta version of Mod Manager that was deleting trailing spaces.   
|-  
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 10.0.1.12
 
| 10.0.1.12
 
| 10.0.1-10.0.3
 
| 10.0.1-10.0.3
| 27 Dec 2014
+
| 27Dec2014
 
| Moved some functionality from this mod to five new mods whose names also begin with "Regroup Person".  
 
| Moved some functionality from this mod to five new mods whose names also begin with "Regroup Person".  
|-  
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 10.0.1.11
 
| 10.0.1.11
 
| 10.0.1-10.0.3
 
| 10.0.1-10.0.3
 
| 10Aug2014
 
| 10Aug2014
 
| Modified the way Person and Family ID's are displayed, and added the capability of displaying Person ID's for parents and children.
 
| Modified the way Person and Family ID's are displayed, and added the capability of displaying Person ID's for parents and children.
|-  
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 10.0.1.10
 
| 10.0.1.10
 
| 10.0.1-10.0.2
 
| 10.0.1-10.0.2
 
| 23 Jun 2014
 
| 23 Jun 2014
 
| Fixed a bug that broke hyperlinks to husband or wife if the string "Family" is in the tree ID.
 
| Fixed a bug that broke hyperlinks to husband or wife if the string "Family" is in the tree ID.
|-  
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 10.0.1.9
 
| 10.0.1.9
 
| 10.0.1-10.0.2
 
| 10.0.1-10.0.2
| 1 3May 2014
+
| 13May2014
 
| Now handles sub-event data entered in TNG, like Agency, Cause, Address, etc.
 
| Now handles sub-event data entered in TNG, like Agency, Cause, Address, etc.
|-  
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 10.0.1.8
 
| 10.0.1.8
 
| 10.0.1-10.0.2
 
| 10.0.1-10.0.2
 
| 12May2014
 
| 12May2014
 
| Changed a hard break to a div to work better with [[Relationship Display Mod]], and moved the changes in cust_text from the top of the file (where, I've learned, some people don't have the distribution comments) to the bottom of the file.  
 
| Changed a hard break to a div to work better with [[Relationship Display Mod]], and moved the changes in cust_text from the top of the file (where, I've learned, some people don't have the distribution comments) to the bottom of the file.  
|-  
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 10.0.1.7
 
| 10.0.1.7
 
| 10.0.1-10.0.2
 
| 10.0.1-10.0.2
 
| 30Apr2014
 
| 30Apr2014
 
| Fixed to work with TNG v10.0.2 as well as v10.0.1
 
| Fixed to work with TNG v10.0.2 as well as v10.0.1
|-  
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 10.0.1.6
 
| 10.0.1.6
 
| 10.0.1
 
| 10.0.1
 
| 26Apr2014
 
| 26Apr2014
 
| Used classes more effectively and eliminated some side effects that could show up in other TNG modules.
 
| Used classes more effectively and eliminated some side effects that could show up in other TNG modules.
|-
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 10.0.1.4
 
| 10.0.1.4
 
| 10.0.1
 
| 10.0.1
| 21 Apr 2014
+
| 21Apr2014
 
| Accommodated the installation of [[Geocode Assist Mod]] and [[Wiki Integration]]. Displays the "I" in the Person ID in a font that distinguishes it from "l" and "1".
 
| Accommodated the installation of [[Geocode Assist Mod]] and [[Wiki Integration]]. Displays the "I" in the Person ID in a font that distinguishes it from "l" and "1".
|-  
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 10.0.1.3
 
| 10.0.1.3
 
| 10.0.1
 
| 10.0.1
| 17 Apr 2014
+
| 17Apr2014
 
| Removed a couple of changes and changed a couple of others to improve compatibility with other mods - specifically [[Family Preview Mod]] and mods that tweak the Event Map Pins legend.
 
| Removed a couple of changes and changed a couple of others to improve compatibility with other mods - specifically [[Family Preview Mod]] and mods that tweak the Event Map Pins legend.
|-  
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 10.0.1.2
 
| 10.0.1.2
 
| 10.0.1
 
| 10.0.1
| 16 Apr 2014
+
| 16Apr2014
 
| Fixed bugs that (1)repeated marriage information for people with multiple marriages &amp; (2) didn't always display the person id number and edit date. Also accommodated another mod.
 
| Fixed bugs that (1)repeated marriage information for people with multiple marriages &amp; (2) didn't always display the person id number and edit date. Also accommodated another mod.
|-  
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 10.0.1.0
 
| 10.0.1.0
 
| 10.0.1
 
| 10.0.1
| 15 Apr 2014
+
| 15Apr2014
 
| Initial release.
 
| Initial release.
 
|}
 
|}
 +
<!-- BUTTON AT THE BOTTOM OF TOGGLED CONTENT --><div class="mw-customtoggle-older1 mw-customtoggle-older2" style="text-decoration:underline;color:#0645ad;text-align:right;">&#91;Hide old changes&#93;</div>
 +
</div><!-- END TOGGLED CONTENT and END DOUBLE TOGGLE -->
  
 
== Sites using this mod ==
 
== Sites using this mod ==
Line 237: Line 468:
  
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
|-
+
! URL !! User !! Note !! Mod-Version !! TNG-Version !! User-language
! URL
 
! User
 
! Note
 
! Mod-Version
 
! TNG-Version
 
! User-language
 
 
|-
 
|-
 
| [https://www.robinrichmond.com/family10/getperson.php?mylastname=Richmond&myfirstname=Clarence&mybirthyear=1895 Robin Richmond's Genealogy Database]
 
| [https://www.robinrichmond.com/family10/getperson.php?mylastname=Richmond&myfirstname=Clarence&mybirthyear=1895 Robin Richmond's Genealogy Database]
 
| [[User:Robinrichm|Robin Richmond]]
 
| [[User:Robinrichm|Robin Richmond]]
 
| Mod developer
 
| Mod developer
| 12.0.0.17
+
| 14.0.0.20b
| 12.0.3
+
| 14
| English
+
| EN
 
|-  
 
|-  
 
| [http://turnermob.com/ Turner mob family Genealogy]
 
| [http://turnermob.com/ Turner mob family Genealogy]
Line 264: Line 489:
 
| 10.1.0.15a
 
| 10.1.0.15a
 
| 10.1.3
 
| 10.1.3
| NL, DE, EN
+
| NL,DE, EN
 
|-
 
|-
 
| [https://theroadtoethel.com The Road to Ethel]
 
| [https://theroadtoethel.com The Road to Ethel]
Line 271: Line 496:
 
| 12.0.0.17
 
| 12.0.0.17
 
| 12.0.3
 
| 12.0.3
| English
+
| EN
 +
|-
 +
| [https://ahnenklein.com Auf den Spuren meiner Ahnen]
 +
| Michael Klein
 +
| Public/Private site
 +
| 12.0.0.18d
 +
| 12.0.3
 +
| DE,EN
 +
|-
 +
| [http://jarocinscy.pl/drzewo/index.php Baza danych Rodziny Jarocińskich]
 +
| [[User:Mjaro|Michał Jarociński]]
 +
| non-public site -- great mod!
 +
| 14.0.0.20
 +
| 14.0
 +
| PL,EN
 +
|-
 +
| [https://svkrfam.no Sidsel & Svein Krakeli Familiesider]
 +
| Svein Krakeli
 +
| Public/Private site
 +
| 13.0.0.19c
 +
| 13.0.0
 +
| NO,EN
 +
|-
 +
| [https://vitter.org/familytree Vitter-Weaver Genealogy]
 +
| [[User:Jeffrey Vitter|Jeffrey Vitter]]
 +
| Public site
 +
| 13.0.3.19f
 +
| 13.0.3
 +
| EN,FR,CH,DE,ES,IT,NO
 +
|-
 +
| [https://scealta.nl/ Scealta]
 +
| Ton van Lil
 +
| Public/Private site
 +
| 13.0.0.19f
 +
| 14.0
 +
| NL,EN
 +
|-
 +
|[https://huygens-vandemoortel-ancestry.be/ Huygens - Van de Moortel]
 +
|[[User:Fluffy82|Tom Huygens]]
 +
|Public/Private on WordPress
 +
|13.0.4.19g1
 +
|13.1.2
 +
|NL
 +
|-
 +
| [https://www.genealogywings.com/ MOTYER Family Genealogy]
 +
| [[User:JMM|John Mark Motyer]]
 +
| Public site
 +
| [https://www.genealogywings.com/jmm_pages/My-TNG-mods.php See here]
 +
| [https://www.genealogywings.com/jmm_pages/My-TNG-mods.php See here]
 +
| EN
 +
|-
 +
| [https://www.craswell.ca/ Your Roots are Showing]
 +
| [[User:crashar|Harold Craswell]]
 +
| Public/Private
 +
| [https://www.craswell.ca/rrmodcompare_report.php?power=basic&cachemethod=3&sb=filename&aformat=full&statushilite=1&b1=0 See Here]
 +
| [https://www.craswell.ca/rrmodcompare_report.php?power=basic&cachemethod=3&sb=filename&aformat=full&statushilite=1&b1=0 See Here]
 +
| EN
 +
|-
 +
|[http://www.genealogyhome.com/ Daniel Bender - Generations]
 +
|[https://tng.lythgoes.net/wiki/index.php/User:Amsibert Allison Sibert]
 +
|Public/ Living Private, researchmod_v12.0.0.1 did not allow branches to show in header
 +
|13.0.4.19g1
 +
|13.1.2
 +
|EN
 +
|-
 
|}
 
|}
  
[[Category:Mods for TNG v10]] [[Category:Mods for TNG v11]][[Category:Mods for TNG v12]]
+
[[Category:Mods for TNG v10]] [[Category:Mods for TNG v11]][[Category:Mods for TNG v12]][[Category:Mods for TNG v13]][[Category:Mods for TNG v14]]
 
[[Category:getperson.php mods]]
 
[[Category:getperson.php mods]]
 
[[Category:personlib.php mods]]
 
[[Category:personlib.php mods]]
 
[[Category:genlib.php mods]]
 
[[Category:genlib.php mods]]
[[Category:globallib.php mods]]
+
[[Category:admin_genconfig.php mods]]
[[Category:cust_text.php English mods]]
+
[[Category:admin_updateconfig.php mods]]
[[Category:genstyle.css mods]]
+
[[Category:dna_test_results_lib.php mods]]

Latest revision as of 09:31, 21 March 2024

Regroup Person Profile
Summary This mod makese numerous changes to the layout of getperson.php to reorganize the display of a Person's Profile in a way that I find more readable.
Validation
Mod Updated 20 Mar 2024
Download link v14.0.4.20c
TNG 14.0.4
Download stats
Author(s) Robin Richmond
Homepage Regroup Person Profile (this page)
Mod Support My Mod Support form
Contact Developer My Mod Support form
Latest Mod v14.0.4.20c
Min TNG V 10.0.1
Max TNG V 14.0.4
Files modified
getperson.php, personlib.php, dna_test_results_lib.php, genlib.php, admin_genconfig.php, and admin_updateconfig.php
Related Mods
Notes

Purpose of the Mod

To rearrange the data in the person profile in a way that I find more readable, with less scrolling. There are numerous changes, the most notable of which may be

  • Each event's date and place or combined into one table cell primarily to prevent relative dates (e.g. Bef 5 Jul 1897) from wrapping to a second line within the date cell
  • Metadata such as the primary person's personID, date of last update, tree, branches, familyID and hyperlinks to family group sheets and family charts are moved to headings above the data tables for person, parents, and families.
  • A button that hides or shows the Event Map is placed in a heading above the map.
  • Events not related to the profiled person's name, birth, christening, death and burial have been moved to a second HTML table labeled "Other Personal Person Events" that is placed below the Parents and Family tables.

Note that the other mods in the "Regroup Person" family make other changes to the Person Profile, as summarized in the Related Mods section of this page. In particular, Regroup Person-Date Place can restore the two-cell presentation of event dates and places.

See Visualizations or a detailed description here

[Hide details]
  1. The most basic Person information is listed first, then parents, marriages, and only then, "Other Personal Data".
    • Basic information includes (among other facts and events) Name, Sex, Birth, Death, Burial, Cause of Death, Alias, and Race.
  2. Subheadings have been added above what I call "event blocks" - the blocks of data for personal data, parents, marriages, the event map, source citations, etc.
  3. Metadata elements (primary personID, familyIDs, treename, branches, edit date, links to edit pages) are no longer presented as if they were events. Some metadata elements have been moved to the person's heading, and others are placed immediately above the relevant event blocks.
    • The tree name is not displayed if there is only one tree.
  4. Under the control of a mod option, the personID for relatives (parents, spouses, children, siblings) can be displayed
  5. The letter I in personIDs is displayed in a serif font to distinguish it from the digit 1 and the lower-case letter l.
  6. The Event Map is enlarged a bit, as I've eliminated the mostly-blank shaded left-hand column, and tweaked the event list adjacent to the map. The entire map can also be hidden and re-displayed.
  7. The Source Citations box is also enlarged with the elimination of the mostly-blank left-hand column. New bolding of the Source titles improve readability a bit. (See also Regroup Person-Sources)
  8. In the Format for Printing page, the cell height for the Source Citations is ignored, under the assumption that, when you print the page, you want to see all of the sources.
  9. Under the control of a mod setting, the person's siblings can be displayed, and can be presented either with the Parent data or with the Person data.
  10. When siblings are displayed, half-siblings can be included, and are flagged with the ½ symbol.
  11. A mod option allows the Person Notes to be displayed in places not covered by the related TNG system option, for example, up near the top of the page in the "Personal Information" data block.

See also Visualizations, Related Mods, Incompatible Mods, and additional comments in the .cfg file itself.

[Hide the options for mod v19]

Mod Options

This mod has numerous options in a mod settings block. See a Visualization or [Show details here]

[Hide the options]
  1. Show dates of last edit" - There's not much point in showing change dates if the data was loaded by a Gedcom Import, since they are all the same.
  2. For Relatives, (that is, for parents, spouses, children, and siblings) display the Gender Icon and/or personID.
  3. Options about displaying siblings:
    • Where to Display Siblings - "Don't display them", "With personal data", or "With parent's data".
    • Show half-siblings, which works only when they are displayed with personal data.
    • Number of siblings to show when the Person Profile loads: "none", "all", or some specific number.
      • Since users aren't always interested in siblings and a list of eight or ten or fifteen siblings can take up a lot of space, you can set this option to display only a few siblings to start. A hyperlink that says "{n} more" will expose the remaining siblings.
    • These siblings options are similar to those provided by the Add Parents Children Row and Add Person Siblings Row. Those mods used to be compatible with Regroup Person Profile so that you select which way to handle siblings. But they are no long compatible, and there is a very good chance that I will remove this feature in favor those two mods.
  4. Where to put notes' - Allows several possibilities, including (but not limited to) displaying personal notes very close to the the top of the Person Profile.
    • This option overrides the TNG configuration variable that provides more limited control of the placement of notes, and replaces that option in the configuration page with a note.
  5. Adjust the styling of templates that use .art‐content‐layout:
    • This option is driven by a styling conflict between Regroup Person Profile and certain TNG Templates. The styling problem manifests itself by using only half of the screen width to display the Person Profile. I may have fixed this conflict, but I can't be sure that it works in all templates. if you encounter the half-screen display, just try this option. If it still doesn't work, please let me know.

Also note that several options from earlier versions of Regroup Person Profile are not listed here. In most cases, the relevant features and their options have been spun off from Regroup Person Profile into new "Regroup Person*" mods. See some details in [#Related_Mods|Related Mods]] below.

[Hide the options for mod v19]

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 Regroup Person Profile row of the Mod Manager List
  • From the Inner Mod Menu that this mod installs on the Person Profile page (see a visualization below), and
  • From the "Mod Settings Block" subform at Admin>>Setup>>General Settings

Other Mods

Many, many mods affect the Person Profile. These notes cannot cover them all (and are not really up to date).

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.

This mod is compatible with, and part of, My "Regroup Person" family of mods.    [Show the family members]

[Hide details]

My "Regroup Person" family of mods all affect the Person Profile. All of them can be used independently of Regroup Person Profile, which was the the first and is the most complex member of the family.(I'll add that the reputation of the family has been stained by the fact that Regroup Person Profile is distinctly complex and is incompatible with an awkward number of other Person Profile mods. But, in truth, Regroup Person-Date Place is the only other member of the family that is similarly complex and invasive.)

  1. Regroup Person Profile - Rearranges the data in and spacing and formatting of the Person Profile. Also (optionally) adds siblings.
  2. Regroup Person-Branch Members - Turns each of the profiled person's branch names into a hyperlink that pops up a list of branch members. Options control whether anonymous visitors and/or logged-in users are allowed to see branch details.
  3. Regroup Person-Child2Parent - Hides the display of selected relationships (typically "birth", which would be assumed if it were not displayed) between the profiled person and that person's parents and children.
  4. Regroup Person-Date Place - Adjusts the spacing used to display (1) Event dates, places, and values and/or (2) The name/birth/death/age data for the profiled person's relatives.
  5. Regroup Person-Family Indicators - Based on Jeff Robison's Family Indicators Mod, this mod adds flags (i.e. "indicators") next to the names of the profiled person's relatives. The flags provide information about and links to several aspects of those relatives' relatives, including popup profiles and ancestor or descendant charts.
  6. Regroup Person-Gender Before Birth - Simply moves the Gender "event" so that it appears above the Birth event. (As you would expect, this mod is incompatible with Regroup Person-Remove Gender)
  7. Regroup Person-Hide Branches - Hides branch names from anonymous visitors and/or logged-in users who are not assigned to the branch.
  8. Regroup Person-Move Media - Simply moves the media files above the event map.
  9. Regroup Person-No Living Data - Suppresses display of ANY data about a living or private person the user doesn't have rights to see. By default, TNG will show some data, plus spouses, parents, and children.
  10. Regroup Person-Remove Gender - Removes the Gender event (the sex) from the event tables, leaving the gender icon next to the name as the sole representation of the person's gender. (As you would expect, this mod is incompatible with Regroup Person-Gender Before Birth)
  11. Regroup Person-Sources - Allows some source and citation data to be hidden for brevity, and to be displayed as desired.
[Hide the list of Regroup Person mods]

Compatible Mods

This is not a complete list of compatible mods that affect the Person Profile.

Mod Conflicts

This is not a complete list of incompatible mods. Please contact me if you run into any other conflicts.

Overlap

These mod implement features that are also implemented by Regroup Person Profile or a companion mod from the Regroup Person* family. In some cases, the two mods have installation or functional conflicts, and you must pick one or the other. In cases where the mods do work together, some Regroup Person* features can be disabled in favor of the other mod, but, in others the "compatible" features are redundant and you'll probably want to install just one of the two mods.

Interdependencies

Installation

This mod does not install any files. It modifies getperson.php, personlib.php, dna_test_results_lib.php, genlib.php, admin_genconfig.php, and admin_updateconfig.php. Instead of cluttering genstyle.css and cust_text.php (for several languages) with styles and strings that are used only by the Person Profile,

[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

1. BEFORE AND AFTER OVERVIEW

Click on the image below to see larger side-by-side non-annotated before and after images. Note that the media files have been clipped out because they haven't changed. But the personal and family data is now laid out differently, the Event Map is now slightly wider, and the Sources, by default, show only the titles, not the full citation information. (Note that Some of the changes shown in the visualizations are now implemented by other mods that were extracted from earlier versions of Regroup Person Profile). In particular, Regroup Person-Date Place now combines the date, place, and description for an event into one cell in the display table.)

Regroup person profile-both.png
2. BEFORE: The personal data section of the original version of the Personal Profile.

The red comments describe some of the changes that the mod will make.

Regroup person profile-before1.png

3. AFTER: The personal AND family data in the new format
  1. Personal meta-data has been moved to the heading.
  2. The "Mod Information" menu, which is visible only to admins, provides links to this Wiki article, and provides a link directly to the mod options.
    • By "directly to", I mean that the link opens this mod's "Mod Settings Block", without the need to select a subform at "Admin>>Setup>>General Settings", nor to scroll down to this mod's options. (See The Mod Settings Block Screenshot.
  3. Events that describe the profiled person are divided into two data blocks. Basic name, birth, death, and burial information are in the first data block (like the native Person Profile), but all other personal events are displayed in a second block, labeled "Other Personal Events" below the person's parents and families.
  4. The white space between blocks of data is now occupied by headings and metadata.
  5. A mod option determnines whether the personID of each relative(spouses, parents, children, siblings) is shown.
  6. The words "Wife" and "Husband" replace "Family" in the table row for the spouse/partner name.
    • I now realize that labels other than "Wife" and "Husband" should be used if the parents are not married. In a future version, I hope to implement labels that reflect the nature of the relationship, though I need suggestions about what terms to use.
  7. The indentation of the children's name/birth/death/age data has been improved. The data now wraps like HTML list items; that is, it does not wrap below the number at the beginning of the line.
Regroup person profile-after19.jpg
4. AFTER: The Event Map

The map is wider than before because the mod has eliminated the colored left-hand column, and put the Event Map label in the whitespace above the map. It has also modified the layout of the first pin legend so it wastes less space, and so that it wraps more cleanly when the page is narrow enough to require wrapping. Also note the button outlined in red at the top right, which changes to "Show Event Map" when the Event Map is hidden.

Regroup person profile-after-map.png
5. AFTER: The Source Citations block

Like the Event Map, the Sources block no longer uses the colored left-hand column, and its label (now "Source Citations") is in the whitespace above the sources. The Regroup Person-Sources mod adds substantial functionality to the Source Citations block. It loads the page with just the Source name, and provides links and buttons that add and remove Source and Citation details.

Regroup person-after-sources.png

6. AFTER: Siblings
  1. A mod option controls whether siblings are displayed in the Parents' data block, in the basic personal data block (as shown here), or not displayed at all.
  2. Another mod option controls how many siblings are shown as the page is loaded If not all siblings are initially displayed, the program displays a "more" link that expands the list to include all siblings.
  3. The the name of the person being profiled is not a hyperlink, since we are already on that person's profile.
Regroup person profile-siblings.png

7. AFTER: The Regroup Person Profile mod configuration settings in their "Mod Settings Block"

A Mod Settings Block is an outlined subform within an Admin>>Setup program that contains the options for a single mod. What is most notable about a Mod Settings Block is that a hyperlink directly to a Mod Settings Block displays only that block (i.e. only one mod's options), not all of the other options in the form or subform.

Here, you see the this mod's Mod Settings Block, in admin_genconfig.php, at Admin>>Setup>>General Configuration. The triangular arrow next to the subfolder heading Mod Settings Blocks is pointing to the right, meaning that the subform is not open, and that your site's other mod settings blocks are not visible. If you were to open the subform by clicking on the heading, you would see the mod settings blocks for other mods that you have installed.

Rpp-after-msb20b.png

A Mod Settings Block is an outlined subform within an Admin>>Setup program that contains the options for a single mod. What is most notable about a Mod Settings Block is that a hyperlink directly to a Mod Settings Block displays only that block (i.e. only one mod's options), not all of the other options in the form or subform. Here, you see the this mod's Mod Settings Block, in admin_genconfig.php, at Admin>>Setup>>General Configuration. The triangular arrow next to the subfolder heading Mod Settings Blocks is pointing to the right, meaning that the subform is not open, and that your site's other mod settings blocks are not visible. If you were to open the subform by clicking on the heading, you would see the mod settings blocks for other mods that you have installed.
8. AFTER: The Person Profile "Inner Mod Menu" after several Regroup Person* mods have been installed.
Rpp-after-imm20b.PNG

Language Strings

This mod stores its language strings (for all languages) in the languages folder within the mods subfolder, in files named {language}_custtext.php (e.g English_custtest.php, French_UTF8-custtext.php). There is typically no need for separate file for English-UTF8.

This technique for storing custom text files has several advantages, including that translators can create, test, and edit language files without having to uninstall and reinstall the mod.

Specifying site-specific overrides to language strings is not as straightforward as it is with conventional cust_text.php files. Read about the problem and the solution.

White Space

Aside: Vertical whitespace can produce a feeling of "openness" in web pages and other media. But sometimes it unnecessarily reduces the amount of data that can be seen at once, and increases the need for users to do vertical scrolling. So I've been known to push back on whitespace a bit - especially when whitespace is generated by <br> tags rather than style rules. To that end:

  1. This mod uses styles to decrease the whitespace between the HTML tables that define various sections of the Person Profile (basic personal data, parents, families, the event map, media items, etc.). This mod provides 1ex of whitespace in the bottom margin of each table. You can increase that whitespace with a style rule such as .datatable {margin-bottom:1em;} at the bottom of your genstyle.css or in your template's mytngstyle.css.
  2. This mod removes a hard break from the end of the TNG "innermenu". Whitespace below the innermenu can be restored by a style rule such as .pub-innermenu {margin-bottom:1em;} at the bottom of your genstyle.css or your template's mytngstyle.css.
    • The "innermenu" is a horizontal menu on most TNG pages that appears immediately below the "Tab menu". It usually has white text on a dark background, and its links are almost always separated by vertical bars. In the Person Profile, the innermenu looks something like this:
      Personal Information  |  Media  |  Notes  |  Source Citations  |  Event Map  |  All  |  PDF  
    • This change affects not just the Person Profile, but most TNG page headings. However, the .pub-innermenu style rule shown above will restore whitespace to all affected pages.

Formatting Person and Family IDs

In order to distinguish the leading "I" of a person ID from a "1" or a lower-case "l", this mod displays PersonIDs and FamilyIDs with style classes that change the font of the ID's.

"Source Citations"

This mod relabels the "Sources" section of the Person Profile as "Source Citations". The distinction is not important, especially to end users, but it does have meaning, and I think that translators - and maybe some others - might benefit from an explanation..

At least in English, the terms "Sources", "Citations", or "Source Citations" are completely ambiguous, and could each reasonably serve as a heading. But the items listed in this section of the report do not accurately represent what TNG calls "Sources" or "Citations"

  • They are not TNG "Sources" in that they contain citation details. They also are not unique. Two entries in the list can have different citation details from the same source.
  • So really, they are more like citations, and "Citations" would be a perfectly reasonable heading.
  • But they are not really TNG "Citations" in that TNG citation records can point to only one event. They can be thought of as (for lack of a better term) "generic citations" or "unique citations". After all, in many genealogy applications, citations can link to many events (even to events in multiple person and family records). In those applications, the heading "Citations" would be completely consistent with the way that the items in the list are stored in the database.

In any case, it turned out to be so trivial to change the heading that I just did it.

Event Labels as Nouns or Verbs

In "most?" genealogy applications, most event labels are nouns, e.g. BIRT->Birth, CHR=Christening, DEAT->Death, BURI->Burial, MARR=>Marriage, DIV=>Divorce, OCCU->Occupation, RESI->Residence, IMMI->Immigration, GRAD->Graduation, EDUC->Education,RELI->Religion.

In TNG Person Profile, however,

  • The labels for "custom" events (those stored in the Events table) are all defined in the Eventtypes tables, which is edited at Admin>>Eventtypes. When you add a new Eventtype, you can specify an arbitrary tag and label (a "description"), or select from about 45 hard-coded tags, which are each paired with a label. Most of those labels, like the ones listed above, are in noun form. Once entered into the Eventtypes table, an Eventtype's label can be changed.
  • The labels for "Built-in" events (those stored in the People, Families, and Children tables rather than in the Events table) have hard-coded labels, which are
    • Displayed in the People and Families edit page as nouns, e.g. BIRT->Birth, CHR=Christening, DEAT->Death, BURI->Burial, MARR=>Marriage, DIV=>Divorce, and
    • Displayed in the Person Profile, the Places detail page, and the Register report in verb forms, e.g. BIRT->Born, CHR=Christened, DEAT->Died, BURI->Buried, MARR=>Married, DIV=>Divorced.
    • The verb forms are handy for generating sentences in the Register Report (e.g. "Moses Wheeler was born on 5 Jan 1598 in Bow, Middlesex, England; died on 15 Jan 1698 in Stratford, Fairfield County, Connecticut, USA; was buried in Old Congregational Burying Ground, Stratford, Fairfield County, Connecticut, USA.") but are distinctly inconsistent with the other events and with the typical noun forms.

Revision History

Mod Version TNG Version Date Note
v14.0.4.20c 14.0.4 20Mar2024 Changed one location to handle a code change in TNG14.0.4.
v14.0.1.20b1 14.0.1-14.0.3 5Nov2023 Upgraded to TNGv14.0.1, Fixed bug that caused some mods to display children in the wrong font, Tweaked two insertion strings to avoid conflicts with Show All Family
13.0.4.19g1 13.0.4+ 28Apr2022 Changes comments that begin with "#[", since that syntax is not valid in PHP8. Please note the .cfg file for older versions of this mod may still contain that string, which you should change to something such as "##[" if you are using PHP8.
13.0.4.19g 13.0.4 14Jun2021
  • Accommodates a change made in TNGv13.0.4 to the way TNG handles source titles.
  • Fixed a problem in which private notes could be exposed, depending on the placement of the notes according a mod option.
13.0.3.19f 13.0.0.19f 13.0.3 21Feb2020
  1. Cleaned up the Group Sheet, Family Chart, and Edit links above the parents marriage block
  2. Changed the way that this mod interacts with Regroup Person-Gender Before Birth and Regroup Person-Remove Gender
  3. Added the ability to place general notes near the top of the page; just after the name and gender.
  4. Created a separate version for TNGv13.0.3 because of underlying code changes.
13.0.0.19e 13-13.0.2 28Nov2020 Established compatibility with the Public Access Control mod.
See changes preceding TNGv13 and Sep 2020 - back to Apr 2014, for TNGv10.1
Changes Preceding TNGv13 and Sep 2020
[Hide details]
Mod Version TNG Version Date Note
13.0.0.19d 13-13.0.2 10Nov2020
  1. Bug fix: when a parent of the profiled person is undefined ALL children of an undefined parents were being shown as half siblings.
  2. Norwegian translation by Svein Krakeli
  3. Moved RACE and CREM to the main data block.
  4. Suppresses empty notes
13.0.0.19c 13.0 7Oct2020

v19c 7 Oct 2020

  1. Bug fix: the 'Hide Map'/'Show Map' button was not changing to 'Show Map' when the map is hidden.
  2. Bug fix: Events and notes used different-sized fonts because of a TNGv13 upgrade mistake
  3. No longer shows the tree name if there is only one tree in the database

v19b 3 Oct 2020

  1. Fixed a typo that broke the the mod parameter edit page.

v19a 29 Sep 2020

  1. Implemented an ad-hoc heading that goes above all of the media items. The heading value comes from a custom string that must be defined in each language's cust_text.php file.
  2. Modifications to the French translation.

v13.0.0.19 17 Sep 2020

  1. Changed 6 target location search strings that now specify the "normal" class for data block table tags.
  2. Added a target location to handle TNGv13's new placement of LDS events vis-a-vis custom events.
  3. Now uses the Mod Settings Blocks mod rather than shared files.
  4. Added French translations by Katryne Chauvigné-Bourlaud
14.0.1.20b1 14 11 Nov 2023
12.0.0.19 12.0 - 12.3 15Aug2020 Most of the changes involve coordination with other Regroup Person* mods   [Show details]
[Hide details]
  1. Fixed a typo that was preventing sibling's popup profiles from popping up.
  2. Moved changes to the format of relatives' name/birth/death/age info to Regroup Person-Date Place, which was already handling event date/place spacing. This also removed the spacing button from this mod and the relatively complex coordination between the two mods over the spacing button.
  3. Moved changes to the Age format to Regroup Person-Date Place since the age format is part of relatives' name/birth/death/age info.
  4. This mod still has to coordinate with Regroup Person-Date Place in that the formatting of siblings' name/birth/death/age strings is different if Regroup Person-Date Place is installed.
  5. Both this mod and Regroup Person-Date Place have been identified as v19, since the changes in the functionality of and coordination between the two mods means that if both are installed, they both must use v19 or above.
  6. Under control of a new option, the mod now can move person notes up into the main personal data block.
  7. Another new mod option determines whether record change dates are displayed. (There isn't much point in displaying change dates if a Gedcom Import has specified the same change date for every record, whether it was changed or not.)
  8. Coordinates with Regroup Person-Family Indicators to make sure that the Regroup Person-Family Indicators icon is used for siblings.
  9. See the .cfg file Revision History for other details.
[Hide details]
12.0.0.18d 12.0 - 12.3 24Feb2020
  • The siblings list is now labeled "Siblings" whether it is in the personal data block, or in the parents' data block.
  • Added a missing %end:% tag, as required in TNGv12.3.
  • Upgraded to version 4 of the shared mod libraries.
12.0.0.18b 12.0 - 12.2 19Dec2019 Upgraded to version 3 of the shared mod includes libraries, installed a temporary CSS patch to allow this mod to work in certain templates, fixed a bug that was preventing relatives' data from being reformatted into three lines, and eliminated a conflict with Regroup Person-Source v18b.
12.0.0.18 12.0-12.2 28Sep2019
  • Moved the mod options to admin_genconfig.php, which requires shared include files for Mod Settings Blocks.
  • Can now display siblings, either in the main person data block, or in the parents' block.
  • Can display relatives name/birth/death data on one line or on three lines.
  • Can display a spacing control to dynamically affect the relatives name/birth/death format.
  • Has new options to control the display of siblings, the relatives' data, and the spacing control.
  • The presence of the spacing control is coordinated with Regroup Person-Date Place, which has its own spacing options.
12.0.0.17 12.0-12.2 24Jul2018 Fixed a typo that was preventing the marriage block displaying the words "Wife" or "Husband".
12.0.0.16p 12.0+ 24Jul2018 No functional changes; made compatible with TNGv12.
11.0.0.16p 11.0-11.1.2+ 28 Mar 2016 No functional changes. Removed the second line of the cust_text.php target location search strings.
11.0.0.16a 11.0-11.1 28Mar2016 Updated for TNGv11. Added Race to the set of events that I have moved from the Other Personal Events table to the main personal events table.
10.0.1.15a 10.0.1-10.1.3 10Mar2016 Fixed an old bug in location 33 that erased the event map if any notes were attached to the person rather than to an event.
10.0.1.15 10.0.1-10.1.3 20 Feb 2016 - Moves some Source Citations functionality to [[Regroup Person-Sources] to establish compatibility with Citation Master.
- Implemented Show Mod Names functionality.
- Fixed a bug that disabled the scrolling of citations.
- Eliminated a TNGv10.1 database function call in one target location.
10.0.1.14f 10.0.1-10.1.2 19Jul2015 - Followed more of Jeannette Wickham's suggestion and added name facts and events to the primary personal data block, instead of "Other Personal Data".
- Fixed two old bugs in my code that put some notes in narrow columns.
- Fixed another old bug that caused some event source citation links not to be enclosed in brackets.
- Added Norwegian translation of cust_text strings, courtesy of Ørjan K. Albriktsen.
- Moved code to accommodate the Public Access Control mod.
10.0.1.14 10.0.1-10.1.1 08Jul2015 Folded Regroup Person-Other IDs back into this mod. Followed Jeanette Wickham's suggestion to put cause of death plus secondary birth, death, and burial events in the data block at the top of the page instead of in the "Other Personal Data" block. Now works with Default Photo Preview. Improved code comments. Reintroduced some of the whitespace that I had eliminated by removing <br/> tags.
10.0.1.13 10.0.1-10.1 03Jan2015 Had to restore some trailing spaces to some lines of code, because I had mistakenly tested the mod with a beta version of Mod Manager that was deleting trailing spaces.
10.0.1.12 10.0.1-10.0.3 27Dec2014 Moved some functionality from this mod to five new mods whose names also begin with "Regroup Person".
10.0.1.11 10.0.1-10.0.3 10Aug2014 Modified the way Person and Family ID's are displayed, and added the capability of displaying Person ID's for parents and children.
10.0.1.10 10.0.1-10.0.2 23 Jun 2014 Fixed a bug that broke hyperlinks to husband or wife if the string "Family" is in the tree ID.
10.0.1.9 10.0.1-10.0.2 13May2014 Now handles sub-event data entered in TNG, like Agency, Cause, Address, etc.
10.0.1.8 10.0.1-10.0.2 12May2014 Changed a hard break to a div to work better with Relationship Display Mod, and moved the changes in cust_text from the top of the file (where, I've learned, some people don't have the distribution comments) to the bottom of the file.
10.0.1.7 10.0.1-10.0.2 30Apr2014 Fixed to work with TNG v10.0.2 as well as v10.0.1
10.0.1.6 10.0.1 26Apr2014 Used classes more effectively and eliminated some side effects that could show up in other TNG modules.
10.0.1.4 10.0.1 21Apr2014 Accommodated the installation of Geocode Assist Mod and Wiki Integration. Displays the "I" in the Person ID in a font that distinguishes it from "l" and "1".
10.0.1.3 10.0.1 17Apr2014 Removed a couple of changes and changed a couple of others to improve compatibility with other mods - specifically Family Preview Mod and mods that tweak the Event Map Pins legend.
10.0.1.2 10.0.1 16Apr2014 Fixed bugs that (1)repeated marriage information for people with multiple marriages & (2) didn't always display the person id number and edit date. Also accommodated another mod.
10.0.1.0 10.0.1 15Apr2014 Initial release.
[Hide old changes]

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.20b 14 EN
Turner mob family Genealogy Margaret Turner Public site 10.0.1.14d 10.1.1 EN
Stamboom Jongman Roel Jongman Public/Private site 10.1.0.15a 10.1.3 NL,DE, EN
The Road to Ethel Alicia Clemmons Public site 12.0.0.17 12.0.3 EN
Auf den Spuren meiner Ahnen Michael Klein Public/Private site 12.0.0.18d 12.0.3 DE,EN
Baza danych Rodziny Jarocińskich Michał Jarociński non-public site -- great mod! 14.0.0.20 14.0 PL,EN
Sidsel & Svein Krakeli Familiesider Svein Krakeli Public/Private site 13.0.0.19c 13.0.0 NO,EN
Vitter-Weaver Genealogy Jeffrey Vitter Public site 13.0.3.19f 13.0.3 EN,FR,CH,DE,ES,IT,NO
Scealta Ton van Lil Public/Private site 13.0.0.19f 14.0 NL,EN
Huygens - Van de Moortel Tom Huygens Public/Private on WordPress 13.0.4.19g1 13.1.2 NL
MOTYER Family Genealogy John Mark Motyer Public site See here See here EN
Your Roots are Showing Harold Craswell Public/Private See Here See Here EN
Daniel Bender - Generations Allison Sibert Public/ Living Private, researchmod_v12.0.0.1 did not allow branches to show in header 13.0.4.19g1 13.1.2 EN