Difference between revisions of "Regroup Person Profile"

From TNG_Wiki
Jump to navigation Jump to search
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{construction
+
{{TNGmod
|notes=The visualizations (which are still generally accurate) are not from the latest version of the mod. The features that are introduced by this version are shown in the [[#Revision_History|Revision History]]. The mod now can display siblings, and can display relative's data in multiple lines.
 
These changes make the installation of some other mods unnecessary, but they ''may'' have introduced other conflicts. There are just so many Person Profile mods that I haven't checked them all.
 
Robin Richmond, 25 Feb 2020}}{{TNGmod
 
 
| mod_name        = Regroup Person Profile
 
| mod_name        = Regroup Person Profile
 
|  mod_summary    = Reorganizes the Person Profile page - for instance, moving 'less important' personal events below the Parent and Family data blocks, putting headings above the Person Profile's data blocks, moving metadata to headings, allow the Map to be hidden, and removing the mostly-empty label column from the Map and Sources blocks.
 
|  mod_summary    = Reorganizes the Person Profile page - for instance, moving 'less important' personal events below the Parent and Family data blocks, putting headings above the Person Profile's data blocks, moving metadata to headings, allow the Map to be hidden, and removing the mostly-empty label column from the Map and Sources blocks.
 
| mod_validation  =
 
| mod_validation  =
| mod_last_update = 25 Feb 2020
+
| mod_last_update = 15 Aug 2020
| download_link  =  [[Media:regroup_person_profile_v12.0.0.18d.zip|v12.0.0.18d]]{{Tv120}}
+
| download_link  =  [[Media:regroup_person_profile_v12.0.0.19.zip|v12.0.0.19]]{{Tv120}}
 
| download_stats  =
 
| download_stats  =
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
Line 13: Line 10:
 
| mod_contact    = [https://www.robinrichmond.com/family/mod_support.php My Mod Support form]
 
| mod_contact    = [https://www.robinrichmond.com/family/mod_support.php My Mod Support form]
 
| mod_support    = [https://www.robinrichmond.com/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] or [http://tng.community/ TNG Community Forums]
| mod_version    = 12.0.0.18d
+
| mod_version    = 12.0.0.19
 
| min_TNG_ver    = 10.0.1
 
| min_TNG_ver    = 10.0.1
| max_TNG_ver    = 12.2
+
| max_TNG_ver    = 12.3
 
|  TNG_file_list  = getperson.php, personlib.php, genlib.php, globallib.php, css/genstyle.css, English cust_text.php, Norwegian cust_text.php, admin_genconfig.php, admin_updateconfig.php
 
|  TNG_file_list  = getperson.php, personlib.php, genlib.php, globallib.php, css/genstyle.css, English cust_text.php, Norwegian cust_text.php, admin_genconfig.php, admin_updateconfig.php
 
| related_mods  = The Regroup Person Profile family of mods.
 
| related_mods  = The Regroup Person Profile family of mods.
Line 26: Line 23:
 
|}
 
|}
 
Here's a partial list of changes:
 
Here's a partial list of changes:
# Just the most basic Person information is listed first, then parents, marriages, and only then, "Other Personal Data".
+
# The most basic Person information is listed first, then parents, marriages, and only then, "Other Personal Data".
 
#* Basic information includes Name, Birth, Death, Burial, Cause of Death (_DCAUSE), Alias (ALIA) and Race, and (I think) LDS ordinances.
 
#* Basic information includes Name, Birth, Death, Burial, Cause of Death (_DCAUSE), Alias (ALIA) and Race, and (I think) LDS ordinances.
# Subheadings have been added above parents, marriages, other personal data, the event map, and source citations.  
+
# 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 (primary personID, familyIDs, tree, 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 other to spaces ''between'' the event blocks.
+
# Metadata elements (primary personID, familyIDs, tree, 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 other to spaces ''between'' the event blocks.
# All personIDs are displayed so that the "I" is displayed with an alternate font, distinguishing it from from a lower-case l or a 1.  
+
# Under the control of a mod option, the personID for relatives (parents, spouses, children, siblings) can be displayed
# The Event Map is enlarged a bit, as I've eliminated the mostly-blank shaded left-hand column. The entire map can also be hidden and re-displayed.
+
# All personIDs are styled "I" is displayed with an alternate font, distinguishing it from from a lower-case l or a 1.  
 +
# The Event Map is enlarged a bit, as I've eliminated the mostly-blank shaded left-hand column, and tweaked the even 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.
 
# 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.
# In the Format for Printing 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.
+
# 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, displays the person's ''full'' siblings, either with the Parent data, or with the Person data.
+
# Under the control of a mod setting, the person's siblings are displayed, and can be presented either with the Parent data or with the Person data.
# Under the control of a mod setting, can display the name/birth/death/age data for children, parents, and siblings in three lines to improve readability.  
+
# When siblings are displayed, half-siblings can be included, and are marked as half-siblings.
 +
# 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 the subheading [[#Related Mods|Related Mods]], some notes under [[#Incompatible Mods|Incompatible Mods]], the [[#Visualizations|Visualizations]], and additional comments in the .cfg file itself.
 
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.
}}
 
 
{| style="margin-right:0.5 em;" align="right"  
 
{| style="margin-right:0.5 em;" align="right"  
 
| __TOC__
 
| __TOC__
 
|}
 
|}
 
== Mod Options ==
 
== Mod Options ==
In mod versions before version 18, this mod has two Mod Parameters:
+
'''Mod version 19+''' &emsp;&emsp;&emsp;&emsp;[[#modsettingsblock|See a Visualization]] &emsp;&emsp;&emsp;&emsp; <span class="mw-collapsible mw-customtoggle-19op1 mw-customtoggle-19op2" id='mw-customcollapsible-19op1' style="text-decoration:underline;color:#0645ad;">&#91;Show details&#93;</span>
# 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.
+
<div class='mw-collapsible mw-collapsible-content mw-collapsed toccolours' id='mw-customcollapsible-19op2' style="border:thick solid red;">
# A flag that determines whether to display person ID's for each parent, spouse, and child.
+
<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 -->
 +
# '''Use smaller generic male and female thumbnails'''
 +
# '''Show dates of last edit" - There's not much point in showing change dates if the data was loaded by a Gedcom Import
 +
# '''Show PersonIDs for Relatives''' - Parents, spouses, children, and siblings.
 +
# Options about displaying siblings:
 +
#* '''Where to Display Siblings''' - "Don't display them", "With personal data", or "With parent's data". #**
 +
#* '''Number of siblings to show when the Person Profile loads''' - 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. The option value "0" means "always show them all". (There is not a way to say "don't show any when the page loads but click on a link to show them all").
 +
# '''<span style="background-color:yellow">New</span> Show extended list of siblings''' - Show half-siblings; that is, all children of all of the profiled person's parents.
 +
# '''<span style="background-color:yellow;">New</span> Where to put notes''' - Allows several possibilities, and overrides a TNG system system
 +
# '''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 still, if you encounter the half-screen display, just to select this option.  If it still doesn't work, [https://www.robinrichmond.com/family/mod_support.php please let me know].
 +
#* This adjustment is done by Javascript, and only done within the Person Profile. It does not affect any other pages in any template.
 +
 
 +
'''Some details about the display of siblings'''
 +
* When they are shown with the parents' data (as the parents' "''children''"),
 +
** The profiled person is listed but not hyperlinked, and
 +
** If the person has more than one set of parents, each couple's children are listed.
 +
* When shown with the person's personal data (as "siblings"),
 +
** The profiled person is not displayed at all, and
 +
** If the "Show extended list of siblings" is selected, that list includes half-siblings. That is, the list includes all children of all of the person's parents' marriages. The extended list of children is grouped by the parents of a set of children.
 +
 
 +
Also,
 +
* You may have noticed that some of these options enable features that are also implemented by other mods. Those features are included in Regroup Person Profile only when the other mods are incompatible with Regroup Person Profile. See [[#Overlap|Overlap]] and [[#Interdependencies|Interdependencies]] in the [[#Other_mods|Other mods]] section of this aticle]]
 +
* Several options from mod version 18 that affected the display of event dates and places, and the name/birth/death/age data for relatives have been moved to [[Regroup Person-Date Place|Regroup Person-Date Place v19]]. If you want to use both this mod and [[Regroup Person-Date Place]], you must use version 19* of both.
 +
<!-- 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 -->
 +
 
 +
'''Mod version 18*''' &emsp;&emsp;&emsp;&emsp; <span class="mw-collapsible mw-customtoggle-18op1 mw-customtoggle-18op2" id='mw-customcollapsible-18op1' style="text-decoration:underline;color:#0645ad;">&#91;Show details&#93;</span>
 +
<div class='mw-collapsible mw-collapsible-content mw-collapsed toccolours' id='mw-customcollapsible-18op2' style="border:thin solid grey;">
 +
<!-- BEGIN TOGGLED CONTENT -->
 +
(Note that some of these options have been moved to the [[Regroup Person-Date Place]] mod in version 19 of both mods.)
  
In version 18+, this mod has six custom TNG settings, which are defined and edited in the form at Admin>>Setup>>General&nbsp;Settings, in the new subform '''Robin's&nbsp;Mods''', where the options for various mods are organized into '''[https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Mod&nbsp;Settings&nbsp;Blocks]'''.  
+
This mod has seven custom TNG settings, which are defined and edited in the form at Admin>>Setup>>General&nbsp;Settings, in the new subform '''Robin's&nbsp;Mods''', where the options for various mods are organized into '''[https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Mod&nbsp;Settings&nbsp;Blocks]'''.  
# '''Spacing''' - Controls the Name/Birth/Death/Age data for relatives; that is parents, spouses, children, and siblings  
+
# '''Spacing''' - Controls whether the Name/Birth/Death/Age data for relatives (parents, spouses, children, and siblings) is on one (possibly wrapped) line, or separated onto three lines. See [[#visualization7|Visualization 7]]
#* '''Less''' - Just like the native Person Profile. The data for each relative is strung together in one line that can wrap to a new line. (However, the wrapping styling is different, and wrapped text stays to the right of the child numbers and/or ancestor/descendant indicators.)
+
#* '''Less''' - Just like the native Person Profile. The data for each relative is strung together in one line that can wrap to a new line.
 
#* '''More''' - Similar to some other mods, the Name/Birth/Death/Age data is separated into three lines, each of which ''could'' wrap, but probably won't.
 
#* '''More''' - Similar to some other mods, the Name/Birth/Death/Age data is separated into three lines, each of which ''could'' wrap, but probably won't.
# '''Spacing Control''' - Whether there will be a spacing control at the right end of the Inner Menu that can switch between the two spacing levels above.
+
# '''Spacing Control''' - Whether there will be a spacing control at the right end of the Inner Menu that can switch between the two spacing levels above. See [[#visualization3|Visualization 3]], item 4.
 
# '''Age Format''' - 'Original': (75 years), or 'New': (Age 75) or (Living, Age 75)
 
# '''Age Format''' - 'Original': (75 years), or 'New': (Age 75) or (Living, Age 75)
# ''' Relatives IDs''' - Whether to show the PersonID of relatives (e.g. parents, spouses, children, and siblings)
+
# ''' Relatives IDs''' - Whether to show the PersonID of relatives; e.g. parents, spouses, children, and siblings. See [[#visualization3|Visualization 3]], item 7.
# '''Siblings''' - Whether and where to display the person's siblings. (no / in the parents data block / in the person's primary data block).
+
# '''Siblings''' - Whether and where to display the person's siblings. There are three possible values, representing "Don't show siblings", "Put them in the parents' data block", and "Put them in the persons primary data block". See [[#visualization6|Visualization 6]].
# '''Siblings at Start''' - The number of siblings to show before the rest are hidden behind a "show more" link. "0" means "always show them all"
+
# '''Siblings at Start''' - Not all of the siblings are necessarily displayed as the page loads. This option controls the number of siblings to be initially displayed.  All other siblings are hidden behind a hyperlink. The option value "0" means "always show them all".
 +
# '''Adjust the styling of templates...''' - For the modified Person Profile to look right in certain TNG templates, this option must be selected. My recommendation is to check this option's checkbox if your modified Person Profile takes up only half of your screen width. If it still doesn't work, please let me know.
 +
#* This 'adjustment' is done by Javascript, and only done within the Person Profile. It does not affect any other pages in any template.
 +
Note that the "Spacing" and "Spacing Control" options coordinate with identically named options in '''[[Regroup Person-Date Place]]''' so that both options are the same in both mods, and only one spacing control is created on the Inner Menu. If you want to use version 18 of either this mod or [[Regroup Person-Date Place]], and you want to use both mods, you must install a v18 version of both mods.
 +
<!-- BUTTON AT THE BOTTOM OF TOGGLED CONTENT --><div class="mw-customtoggle-18op1 mw-customtoggle-18op2" style="text-decoration:underline;color:#0645ad;text-align:right;">&#91;Hide the options for mod version 18*&#93;</div>
 +
</div><!-- END TOGGLED CONTENT and END DOUBLE TOGGLE -->
  
Note that the "Spacing" and "SpacingControl" options coordinate with identically named options in '''[[Regroup Person-Date Place]]''' so that both options are the same in both mods, and only one spacing control is created on the Inner MenuJavascript code in admin_genconfig.php keeps the options in sync.
+
'''Before version 18''', this mod has two classic Mod Parameters &emsp;&emsp;&emsp;&emsp;<span class="mw-collapsible mw-customtoggle-17op1 mw-customtoggle-17op2" id='mw-customcollapsible-17op1' style="text-decoration:underline;color:#0645ad;">&#91;Show details&#93;</span>
 +
<div class='mw-collapsible mw-collapsible-content mw-collapsed toccolours' id='mw-customcollapsible-17op2' style="border:thin solid grey;">
 +
<!-- BEGIN TOGGLED CONTENT -->
 +
# A value that controls whitespace within the HTML data tables by adjusting HTML cellpadding attributeThe 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.  
 +
# A flag that determines whether to display person ID's for each parent, spouse, and child.
 +
<!-- BUTTON AT THE BOTTOM OF TOGGLED CONTENT --><div class="mw-customtoggle-17op1 mw-customtoggle-17op2" style="text-decoration:underline;color:#0645ad;text-align:right;">&#91;Hide details&#93;</div>
 +
</div><!-- END TOGGLED CONTENT and END DOUBLE TOGGLE -->
  
 
== Other Mods ==
 
== Other Mods ==
Line 62: Line 101:
  
 
=== Related Mods ===
 
=== Related Mods ===
This mod is in the "Regroup Person" family of mods that were written by Robin Richmond and that affect the Person Profile. All of these mods can be installed independently of the other in the family.
+
* [[Inner Mod Menus]], which displays an "[https://tng.lythgoes.net/wiki/index.php?title=Inner_Mod_Menus Inner Mod Menu]" in the TNG "inner menu" (just below the tab menu). The Inner Mod Menu is ''defined by'' this mod but is visible only if '''[[Inner Mod Menus]]''' is installed. It is also visible only to TNG administrators; never to end-users. I highly recommend that you install this mod because Inner Mod Menus provide links to handy information - particularly to this mod's mod options.
 +
* [[Show Mod Names]], which displays information saved by this mod.  But [[Show Mod Names]] ''is not required''.
 +
* The "Regroup Person" family of mods that were written by Robin Richmond and that affect the Person Profile. All of these mods can be installed independently of the other in the family.
 
<div class="mw-collapsible mw-customtoggle-rpfamily1 mw-customtoggle-rpfamily2" id='mw-customcollapsible-rpfamily1' style="text-decoration:underline;color:#0645ad;">&#91;Show the family members&#93;</div>
 
<div class="mw-collapsible mw-customtoggle-rpfamily1 mw-customtoggle-rpfamily2" id='mw-customcollapsible-rpfamily1' style="text-decoration:underline;color:#0645ad;">&#91;Show the family members&#93;</div>
 
<div class='mw-collapsible mw-collapsible-content mw-collapsed toccolours' id='mw-customcollapsible-rpfamily2' style="border:thin solid grey;">
 
<div class='mw-collapsible mw-collapsible-content mw-collapsed toccolours' id='mw-customcollapsible-rpfamily2' style="border:thin solid grey;">
Line 75: Line 116:
 
# [[Regroup Person-Parent Rel]] - Hides "natural" or "birth" relationships between the person and the parents.
 
# [[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.
 
# [[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.
<!-- BUTTON AT THE BOTTOM OF TOGGLED CONTENT --><div class="mw-customtoggle-rpfamily1 mw-customtoggle-rpfamily2" style="text-decoration:underline;color:#0645ad;text-align:right;">&#91;Hide the list of mods&#93;</div>
+
<!-- BUTTON AT THE BOTTOM OF TOGGLED CONTENT --><div class="mw-customtoggle-rpfamily1 mw-customtoggle-rpfamily2" style="text-decoration:underline;color:#0645ad;text-align:right;">&#91;Hide the list of Regroup Person mods&#93;</div>
 
</div><!-- END TOGGLED CONTENT and END DOUBLE TOGGLE -->
 
</div><!-- END TOGGLED CONTENT and END DOUBLE TOGGLE -->
  
Line 89: Line 130:
 
=== Overlap ===
 
=== Overlap ===
 
These mods conflict with Regroup Person Profile, but Regroup Person Profile, or a companion mod, implements at least a good part of the functionality of these mods:
 
These mods conflict with Regroup Person Profile, but Regroup Person Profile, or a companion mod, implements at least a good part of the functionality of these mods:
* [[ID Prefix Format]]: Regroup Person Profile uses an alternate font to make the "I" in person ID's distinct from the lower-case letter "l" and the number "1".  
+
* [[Burial Website Media Import]]: I have an unpublished version ''is'' compatible; until the [[Burial Website Media Import]] mod is updated to be compatible, [https://www.robinrichmond.com/family/mod_support.php Contact me] if you want the compatible version.
* [[Person Map]]: Regroup Person Profile can hide and re-display the Event Map.
+
* [[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".  
* [[Life Dates Mod]]: Under the a mod option, Regroup Person Profile can reformat the name/birth/death information for relatives into three lines. Another mod option allows users to switch between the 1-line and 3-line formats.
+
* [[Person Map]]: Like [[Person Map]], Regroup Person Profile allow users to hide and re-display the Event Map.
* [[Adjust Date Column Width]]: [[Regroup Person-Date Place]] (a companion to Regroup Person-Profile) combines the Event date and place into what is effectively one column.
+
* [[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.
* [[Add Person Cremated Row]]: Like [[Add Person Cremated Row]], Regroup Person Profile displays TNG's non-standard "Cremated" flag as though it is a separate event.
+
* [[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.
  
 
=== Interdependencies ===
 
=== Interdependencies ===
* [[Submit Headstone Photo Mod]] can be installed ''after'' this Regroup Person Profile.  In 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.  If the Bad Target error does occur, [[Submit Headstone Photo Mod]] must be uninstalled before Person Profile can be uninstalled..
+
* [[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 to 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]] can be installed ''''before'' this mod. Regroup Person Profile must be uninstalled to allow [[Signature Display]] to be uninstalled.
+
* [[Signature Display]] must be installed ''after'' this mod.
 +
* [[Fixed Family Tab]] must be installed ''before'' this mod.
  
 
== Installation ==
 
== Installation ==
 
=== Files Installed ===
 
=== Files Installed ===
This mod is packaged with a mod subfolder that is shared with several other mods. The shared folder '''RR-shared_mod_includes_v12.0.0.3''' contains files that help to manage mod options in many of my mods:
+
This mod is packaged with a mod subfolder that is shared with several other mods. The shared folder '''RR-shared_mod_includes_v12.0.0.4''' contains files that help to manage mod options in many of my mods. It contains
## '''rrshared_innermodmenu4.php''' - [https://tng.lythgoes.net/wiki/index.php?title=Inner_Mod_Menus Inner&nbsp;Mod&nbsp;Menus]
+
# '''rrshared_modsettingsblocks4.php''' - Supports the [https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Mod Settings Block] that lays out the mod's options in a distinct block that wraps a border around those options and that provide a way to link directly to the mod option rather than just to and Admin>>Setup program.
## '''rrshared_modsettingsblocks4.php''' - [https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Mod Settings Blocks]
+
# '''img/rrshared_wikilogo.gif''' - An icon that links to a mod's TNG Wiki page from a Mod Settings Block
## '''img/rrshared_wikilogo.gif''' - An icon that links to a mod's TNG Wiki page from an Inner Mod Menu or Mod Settings Block
 
  
Each mod that contains the shared folder may install some or all of its shared files, depending on whether those files already exist. Once a file from the shared folder has been installed (by any mod), that file will not be overwritten or removed by the subsequent installation or un-installation of any mod (including this one), nor will its presence or absence generate any Mod Manager errors.  
+
Each mod that contains the shared folder ''may'' install its shared files, depending on whether those files already exist. Once the files from the shared folder have been installed (by any mod), those files will not be overwritten or removed by the subsequent installation or un-installation of any mod (including this one), nor will their presence or absence generate Mod Manager errors in uninstalled mods.  
  
 
If you unzip mod distribution files directly into your mods folder, then the presence of the shared subfolder and the installation of its files should be invisible to you.  But if you generally ''copy'' mod subfolders to your mods folder after you have unzipped the distribution file, then you need to make sure to copy the folder '''RR-shared_mod_includes_v12.0.0.4''' (well, unless you are confident that it is already in your mods folder because it was part of another mod).<br>{{RobinInstallationBoilerplate}}
 
If you unzip mod distribution files directly into your mods folder, then the presence of the shared subfolder and the installation of its files should be invisible to you.  But if you generally ''copy'' mod subfolders to your mods folder after you have unzipped the distribution file, then you need to make sure to copy the folder '''RR-shared_mod_includes_v12.0.0.4''' (well, unless you are confident that it is already in your mods folder because it was part of another mod).<br>{{RobinInstallationBoilerplate}}
 +
 +
== Language Strings==
 +
This mod, like many of my newer mods, does not add strings to the standard TNG cust_text.php files. Instead, the language strings are stored in the mod's normal mod subfolder, <code>regroup_person_profile_v12.0.0.19</code> (where the subfolder's version number will change with the updates to the mod), in files named <code>{language}_custtext.php</code> (eg. <code>French-UTF8_custtext.php</code>. I'm using this nonstandard technique '''[https://tng.lythgoes.net/wiki/index.php?title=User:Robinrichm#Language_Strings_NOT_in_cust_text.php_Files for several reasons]''', but there is a rarely-relevant downside. That is, for $text strings in end-user programs, you cannot override the mod's language strings by simply putting you own strings at the bottom of the applicable cust_text.php file.  ('''[https://tng.lythgoes.net/wiki/index.php?title=User:Robinrichm#Overriding_Strings_in_.7Blanguage.7D_custtext.php_files See the solution]''')
  
 
== Visualizations ==
 
== Visualizations ==
See the [[#Revision_History|Revision History]] to learn what is different about version 18.
 
 
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
 
|-
 
|-
Line 127: Line 171:
 
| [[Image:regroup_person_profile-before1.png]]
 
| [[Image:regroup_person_profile-before1.png]]
 
|}
 
|}
 
+
<span id='visualization3'></span>
 
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
 
| <span style="color: red">'''3. AFTER:'''</span> '''The personal AND family data in the new format'''
 
| <span style="color: red">'''3. AFTER:'''</span> '''The personal AND family data in the new format'''
# The Age format can be different (under the control of a mod option)
 
 
# 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'', gives access to information about and options for several of the mods that affect the person profile.
+
# 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.
# The "Spacing" button affects the layout of two specific parts of the Person Profile (see the [[#Mod_Options|Mod Options]] above).
+
#* 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 ''below'' the person's parents and families.
+
# 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.
# A mod option, determnines whether the personID of each relative(spouses, parents, children, siblings) is shown.  
+
# A mod option determnines whether the personID of each relative(spouses, parents, children, siblings) is shown.  
 
# The words "Wife" and "Husband" replace "Family" in the table row for the spouse/partner name.  
 
# 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 how to do this.
+
#* 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 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.
#* Also, under the control of a mod option and the "Spacing" button, the name/birth/death/age data can be broken into three lines for readability.  That format is shown in a visualization below.
 
# (Not shown here) Under the control of a mod option, the person's siblings can be listed. See a visualization below.
 
 
|-
 
|-
| [[Image:regroup_person_profile-after1.png]]
+
| [[Image:regroup_person_profile-after19.jpg]]
 
|}
 
|}
  
 
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
| <span style="color: red">'''4. AFTER:'''</span> '''The new Event Map'''<br>
+
| <span style="color: red">'''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.
 
|-
 
|-
Line 154: Line 195:
  
 
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
| <span style="color: red">'''5. AFTER:'''</span> '''The new Sources block'''<br>
+
| <span style="color: red">'''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 can remove details from each Source Citation, and provides button and links that display Source and/or Citation details.  
+
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]]
 
| [[Image:regroup_person-after-sources.png]]
 
|}
 
|}
  
 +
<span id='visualization6'></span>
 
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
 
| <span style="color: red">'''6. AFTER:'''</span> '''Siblings '''<br>
 
| <span style="color: red">'''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.
 
# 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.
#* The popup previous that show details about parents and children are not available for siblings.
+
# 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.
# Another mod option controls how many siblings are intially displayed. If not all siblings are, 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.
Note that the name of the person being profiled is not a hyperlink, since we are already on that person's profile.
 
expanded format is used by default.
 
 
|-
 
|-
 
| [[Image:regroup_person_profile-siblings.png]]
 
| [[Image:regroup_person_profile-siblings.png]]
 
|}
 
|}
  
 +
<span id='modsettingsblock'></span>
 
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="2" cellspacing="1" cellpadding="2" class="wikitable"
| <span style="color: red">'''7. AFTER:'''</span> '''The optional 3-line name/birth/death/age format'''<br>
+
| <span style="color: red">'''8. AFTER:'''</span> '''The Mods "Mod Settings Block"'''<br>
A mod option controls
+
A Mod Settings Block outlined subform within an Admin>>Setup program that contains the options for a single mod.  What is most notable out a Mod Settings Block is that a hyperlink to a Mod Settings Block displays ''only'' that block, not all of the other options in the form or subform.  This presentation is directly comparable to the subforms at Admin>>Setup>>General&nbsp;Settings, that is, when you open one of the subforms, all of the other options are still there; they are just not visible until or unless you click on anpother subform heading to open ''that'' subform.
# Whether this expanded format is used by default, and
+
 
# Whether the "Spacing" button that switches between the one-line and three-line formats is visible.
+
Here, you see the Regroup Person Profile mod settings block, which is in the '''Robin's&nbsp;Mods''' subform of admin_genconfig.php. The triangular arrow next to the heading '''Robin's&nbsp;Mods''' is pointing to the right, meaning that the subform '''Robin's&nbsp;Mods''' is ''not'' open.  If you were to click on that heading, you would see the Mod Settings Blocks for other mods that you have installedo.  (They are shown in alphabetical order according to the mod name.)
 
|-
 
|-
| [[Image:regroup_person_profile-3lines.png]]
+
| [[Image:regroup_person_profile-after-modsettingsblock19.jpg]]
 
|}
 
|}
  
 
== White Space ==
 
== 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 a bit - especially when whitespace is provided by &lt;br> tags rather than style rules. To that end:</span>
+
<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 200: Line 241:
 
{| 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.19.zip|12.0.0.19]]
 +
| 12.0 - 12.3
 +
| 15Aug2020
 +
| Details to come...
 +
 
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| [[Media:regroup_person_profile_v12.0.0.18d.zip|12.0.0.18d]]
 
| [[Media:regroup_person_profile_v12.0.0.18d.zip|12.0.0.18d]]
Line 368: Line 415:
 
| 12.0.3
 
| 12.0.3
 
| English
 
| English
 +
|-
 +
| [https://ahnenklein.com Auf den Spuren meiner Ahnen]
 +
| Michael Klein
 +
| Public/Private site
 +
| 12.0.0.18d
 +
| 12.0.3
 +
| DE, ENG
 +
|-
 +
| [http://jarocinscy.pl/drzewo/index.php Baza danych Rodziny Jarocińskich]
 +
| [[User:Mjaro|Michał Jarociński]]
 +
| non-public site
 +
| v12.0.0.19
 +
| 12.3, T7
 +
| PL, EN
 
|}
 
|}
  

Revision as of 15:09, 10 September 2020

Regroup Person Profile
Summary Reorganizes the Person Profile page - for instance, moving 'less important' personal events below the Parent and Family data blocks, putting headings above the Person Profile's data blocks, moving metadata to headings, allow the Map to be hidden, and removing the mostly-empty label column from the Map and Sources blocks.
Validation
Mod Updated 15 Aug 2020
Download link v12.0.0.19
TNG 12.0
Download stats
Author(s) Robin Richmond
Homepage this page
Mod Support My Mod Support form or TNG Community Forums
Contact Developer My Mod Support form
Latest Mod 12.0.0.19
Min TNG V 10.0.1
Max TNG V 12.3
Files modified
getperson.php, personlib.php, genlib.php, globallib.php, css/genstyle.css, English cust_text.php, Norwegian cust_text.php, admin_genconfig.php, admin_updateconfig.php
Related Mods
The Regroup Person Profile family of 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.

Here's a partial list of changes:

  1. The most basic Person information is listed first, then parents, marriages, and only then, "Other Personal Data".
    • Basic information includes Name, Birth, Death, Burial, Cause of Death (_DCAUSE), Alias (ALIA) and Race, and (I think) LDS ordinances.
  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, tree, 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 other to spaces between the event blocks.
  4. Under the control of a mod option, the personID for relatives (parents, spouses, children, siblings) can be displayed
  5. All personIDs are styled "I" is displayed with an alternate font, distinguishing it from from a lower-case l or a 1.
  6. The Event Map is enlarged a bit, as I've eliminated the mostly-blank shaded left-hand column, and tweaked the even 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.
  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 are 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 marked as half-siblings.
  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 the subheading Related Mods, some notes under Incompatible Mods, the Visualizations, and additional comments in the .cfg file itself.

Mod Options

Mod version 19+     See a Visualization      [Show details]

[Hide the options]
  1. Use smaller generic male and female thumbnails
  2. Show dates of last edit" - There's not much point in showing change dates if the data was loaded by a Gedcom Import
  3. Show PersonIDs for Relatives - Parents, spouses, children, and siblings.
  4. Options about displaying siblings:
    • Where to Display Siblings - "Don't display them", "With personal data", or "With parent's data". #**
    • Number of siblings to show when the Person Profile loads - 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. The option value "0" means "always show them all". (There is not a way to say "don't show any when the page loads but click on a link to show them all").
  5. New Show extended list of siblings - Show half-siblings; that is, all children of all of the profiled person's parents.
  6. New Where to put notes - Allows several possibilities, and overrides a TNG system system
  7. 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 still, if you encounter the half-screen display, just to select this option. If it still doesn't work, please let me know.
    • This adjustment is done by Javascript, and only done within the Person Profile. It does not affect any other pages in any template.

Some details about the display of siblings

  • When they are shown with the parents' data (as the parents' "children"),
    • The profiled person is listed but not hyperlinked, and
    • If the person has more than one set of parents, each couple's children are listed.
  • When shown with the person's personal data (as "siblings"),
    • The profiled person is not displayed at all, and
    • If the "Show extended list of siblings" is selected, that list includes half-siblings. That is, the list includes all children of all of the person's parents' marriages. The extended list of children is grouped by the parents of a set of children.

Also,

  • You may have noticed that some of these options enable features that are also implemented by other mods. Those features are included in Regroup Person Profile only when the other mods are incompatible with Regroup Person Profile. See Overlap and Interdependencies in the Other mods section of this aticle]]
  • Several options from mod version 18 that affected the display of event dates and places, and the name/birth/death/age data for relatives have been moved to Regroup Person-Date Place v19. If you want to use both this mod and Regroup Person-Date Place, you must use version 19* of both.
[Hide the options for mod v19]

Mod version 18*      [Show details]

(Note that some of these options have been moved to the Regroup Person-Date Place mod in version 19 of both mods.)

This mod has seven custom TNG settings, which are defined and edited in the form at Admin>>Setup>>General Settings, in the new subform Robin's Mods, where the options for various mods are organized into Mod Settings Blocks.

  1. Spacing - Controls whether the Name/Birth/Death/Age data for relatives (parents, spouses, children, and siblings) is on one (possibly wrapped) line, or separated onto three lines. See Visualization 7
    • Less - Just like the native Person Profile. The data for each relative is strung together in one line that can wrap to a new line.
    • More - Similar to some other mods, the Name/Birth/Death/Age data is separated into three lines, each of which could wrap, but probably won't.
  2. Spacing Control - Whether there will be a spacing control at the right end of the Inner Menu that can switch between the two spacing levels above. See Visualization 3, item 4.
  3. Age Format - 'Original': (75 years), or 'New': (Age 75) or (Living, Age 75)
  4. Relatives IDs - Whether to show the PersonID of relatives; e.g. parents, spouses, children, and siblings. See Visualization 3, item 7.
  5. Siblings - Whether and where to display the person's siblings. There are three possible values, representing "Don't show siblings", "Put them in the parents' data block", and "Put them in the persons primary data block". See Visualization 6.
  6. Siblings at Start - Not all of the siblings are necessarily displayed as the page loads. This option controls the number of siblings to be initially displayed. All other siblings are hidden behind a hyperlink. The option value "0" means "always show them all".
  7. Adjust the styling of templates... - For the modified Person Profile to look right in certain TNG templates, this option must be selected. My recommendation is to check this option's checkbox if your modified Person Profile takes up only half of your screen width. If it still doesn't work, please let me know.
    • This 'adjustment' is done by Javascript, and only done within the Person Profile. It does not affect any other pages in any template.

Note that the "Spacing" and "Spacing Control" options coordinate with identically named options in Regroup Person-Date Place so that both options are the same in both mods, and only one spacing control is created on the Inner Menu. If you want to use version 18 of either this mod or Regroup Person-Date Place, and you want to use both mods, you must install a v18 version of both mods.

[Hide the options for mod version 18*]

Before version 18, this mod has two classic Mod Parameters     [Show details]

  1. 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.
  2. A flag that determines whether to display person ID's for each parent, spouse, and child.
[Hide details]

Other Mods

Many, many mods affect the Person Profile. These notes cannot cover them all.

Related Mods

  • Inner Mod Menus, which displays an "Inner Mod Menu" in the TNG "inner menu" (just below the tab menu). The Inner Mod Menu is defined by this mod but is visible only if Inner Mod Menus is installed. It is also visible only to TNG administrators; never to end-users. I highly recommend that you install this mod because Inner Mod Menus provide links to handy information - particularly to this mod's mod options.
  • Show Mod Names, which displays information saved by this mod. But Show Mod Names is not required.
  • The "Regroup Person" family of mods that were written by Robin Richmond and that affect the Person Profile. All of these mods can be installed independently of the other in the family.
[Show the family members]

The "Regroup Person" family of mods:

  1. Regroup Person Profile - (this mod) The daddy in the family (and my first mod)
  2. Regroup Person-Branch Members - Makes each of the person's branch names a hyperlink to a list of branch members.
  3. Regroup Person-Date Place - Combines event date, place, and description into one table cell, and coordinates with Regroup Person Profile to share an Inner Menu button that affects white space in the Person Profile.
  4. Regroup Person-Hide Branches - Hides branch names from end-users.
  5. Regroup Person-Move Media - Moves the media files above the map
  6. 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.
  7. Regroup Person-Parent Rel - Hides "natural" or "birth" relationships between the person and the parents.
  8. 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.
[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. This mod (Regroup Person Profile) is not compatible with Add Person Age Row, Divorce Indicator, Family Chart Mod, Family Edit Links Mod, Mobile Site Enhancements, No Notesring, Optional Person Rows, and Person Map.

Overlap

These mods conflict with Regroup Person Profile, but Regroup Person Profile, or a companion mod, implements at least a good part of the functionality of these mods:

Interdependencies

Installation

Files Installed

This mod is packaged with a mod subfolder that is shared with several other mods. The shared folder RR-shared_mod_includes_v12.0.0.4 contains files that help to manage mod options in many of my mods. It contains

  1. rrshared_modsettingsblocks4.php - Supports the Mod Settings Block that lays out the mod's options in a distinct block that wraps a border around those options and that provide a way to link directly to the mod option rather than just to and Admin>>Setup program.
  2. img/rrshared_wikilogo.gif - An icon that links to a mod's TNG Wiki page from a Mod Settings Block

Each mod that contains the shared folder may install its shared files, depending on whether those files already exist. Once the files from the shared folder have been installed (by any mod), those files will not be overwritten or removed by the subsequent installation or un-installation of any mod (including this one), nor will their presence or absence generate Mod Manager errors in uninstalled mods.

If you unzip mod distribution files directly into your mods folder, then the presence of the shared subfolder and the installation of its files should be invisible to you. But if you generally copy mod subfolders to your mods folder after you have unzipped the distribution file, then you need to make sure to copy the folder RR-shared_mod_includes_v12.0.0.4 (well, unless you are confident that it is already in your mods folder because it was part of another mod).
[Show Installation Details]

Requirements

  • A working TNG installation.
  • An installed current version of the Mod Manager.
  • You should backup files listed in the panel on the right.

Procedure

  1. Remove and delete previous version of this mod.
  2. Backup the files updated by this mod. They are listed in the panel at the upper right.
  3. Download the .zip file, Extract its .cfg file to the mods folder.
  4. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files.

Problems?

  1. Try using the Mod Manager Remove capability
  2. Contact me through My Mod Support form.
[Hide Details]

Language Strings

This mod, like many of my newer mods, does not add strings to the standard TNG cust_text.php files. Instead, the language strings are stored in the mod's normal mod subfolder, regroup_person_profile_v12.0.0.19 (where the subfolder's version number will change with the updates to the mod), in files named {language}_custtext.php (eg. French-UTF8_custtext.php. I'm using this nonstandard technique for several reasons, but there is a rarely-relevant downside. That is, for $text strings in end-user programs, you cannot override the mod's language strings by simply putting you own strings at the bottom of the applicable cust_text.php file. (See the solution)

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

8. AFTER: The Mods "Mod Settings Block"

A Mod Settings Block outlined subform within an Admin>>Setup program that contains the options for a single mod. What is most notable out a Mod Settings Block is that a hyperlink to a Mod Settings Block displays only that block, not all of the other options in the form or subform. This presentation is directly comparable to the subforms at Admin>>Setup>>General Settings, that is, when you open one of the subforms, all of the other options are still there; they are just not visible until or unless you click on anpother subform heading to open that subform.

Here, you see the Regroup Person Profile mod settings block, which is in the Robin's Mods subform of admin_genconfig.php. The triangular arrow next to the heading Robin's Mods is pointing to the right, meaning that the subform Robin's Mods is not open. If you were to click on that heading, you would see the Mod Settings Blocks for other mods that you have installedo. (They are shown in alphabetical order according to the mod name.)

File:Regroup person profile-after-modsettingsblock19.jpg

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.

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

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.

Revision History

Mod Version TNG Version Date Note
12.0.0.19 12.0 - 12.3 15Aug2020 Details to come...
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.

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 12.0.0.18a 12.2.2 English
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 English
Auf den Spuren meiner Ahnen Michael Klein Public/Private site 12.0.0.18d 12.0.3 DE, ENG
Baza danych Rodziny Jarocińskich Michał Jarociński non-public site v12.0.0.19 12.3, T7 PL, EN