Regroup Person Profile

From TNG_Wiki
Revision as of 16:41, 24 July 2018 by Rmcrae (talk | contribs) (New version 12.0.0.16p)
Jump to navigation Jump to search
Regroup Person Profile
Summary Moves things around on the Person Profile page (getperson.php), and compresses whitespace a bit.
Validation
Mod Updated 24 Aug 2018
Download link
v12.0.0.16p
TNG 12.0
11.0.0.16p
TNG 11.0
10.0.1.15a
TNG 10.0.1
Download stats
Author(s) Robin Richmond
Homepage Robin Richmond's Genealogy Database
Mod Support My Mod Support form or TNG Community Forums
Contact Developer My Mod Support form
Latest Mod v10.0.1.15a & v11.0.0.16p & v12.0.0.16p
Min TNG V 10.1
Max TNG V at least 12.0
Files modified
getperson.php, personlib.php, genlib.php, globallib.php, css/genstyle.css, English cust_text.php, Norwegian cust_text.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:

  1. Just the most basic Person information is listed first, then parents, marriages, and "Other Personal Data".
  2. Subheadings are added above parents, marriages, other personal data, the event map, and source citations.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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 also the subheading #Mods Derived From This One, some notes under #Incompatible Mods, the #Visualizations, and additional comments in the .cfg file itself. }}

Mod Parameters

This has two parameters that affect getperson.php:

  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.

Mods Derived From This One

Starting with mod version 12, I have created several other mods by pulling changes out of Regroup Person Profile. The new mods are:

  1. Regroup Person-Date Place - Combines event date, place, and description into one table cell
  2. Regroup Person-Move Media - Moves the media files above the map
  3. 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.
  4. Regroup Person-Parent Rel - Hides "natural" or "birth" relationships between the person and the parents.
  5. Regroup Person-Sources - Starts the display of source citations with just the Source ID, Title, and Author, and provides buttons so the user can add Source details and/or Citation details.

(Also, Regroup Person-Other IDs, which Added Person ID's (styled with serifs on the "I") to parents, spouses, and children was re-folded into Regroup Person ID with version 14.)

As a result, several mods that used to conflict with Regroup Person Profile now only conflict with one of these "child" mods. You can thus get most of the functionality of the "Regroup Person" family by installing only the "Regroup Person" mods that don't conflict with other mods you already have in use.

Compatibility With Other Mods

Dependencies

Compatible Mods

This is not a complete list of compatible mods that affect the person profile.

Incompatible Mods

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

Requirements

  • A working TNG installation.
  • An installed current version of the Mod Manager.
  • You should backup files listed in the panel on the right.
  • If you also want to use Sources and Citations Mod, it must be installed first.

Installation

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

In the event of a problem

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

Controlling White Space with Classes

I have removed many hard breaks from the PHP code, and made sure that there are CSS classes in css/genstyle.css that you can use to control the vertical whitespace between page elements. Specifically,

  1. All of the HTML tables that display person profile data (basic personal data, parents, families, the event map, media items, etc.) are now associated with the class "datatable", which has a new style rule that defines margin-bottom:1ex; to provide some whitespace between the tables. You can add more whitespace by adding a style rule such as .datatable {margin-bottom:1em;} at the bottom of your somewhere below the style I have added.
  2. A hard break has been removed from the bottom of the standard TNG page-specific "innermenu" - the horizontal menu bar just under the tab bars. On the personal profile, it has links labeled Personal Information, Media, Sources, etc. This change actually affects not just the Person Profile, but most TNG page headings. To restore that whitespace in all affected pages, you can apply a bottom margin to the TNG standard .pub-innermenu class, with a style rule such as .pub-innermenu { margin-bottom:1em; } at the bottom of your /css/genstyle.css file.
  3. (v14) A hard break has been removed from the heading, below the person's thumbnail photo and the tab menu. I've put 4px of whitespace back in, but you can add to that with a style rule such as .headingthumb {padding-right:5px; padding-bottom:4px;}

(Note: If you want to adjust whitespace by modifying a style rule defined by TNG or by a mod, it is probably best not to edit the existing rule, because modifying that rule will prohibit the mod from uninstalling cleanly. Instead, you should add a new style rule such as at the bottom of the css/genstyle.css mod.

Formatting Person and Family IDs

In order to distinguish the leading "I" of a person ID from a "1" or a lower-case "l", person and family ID's in the person profile now are displayed with style classes .rp-idvalue and rp-idletter, which are now defined in /css/genstyle.css, and can be re-defined by TNG site administrators. The class .rp-idvalue applies to the entire ID, and the style rp-idletter applies only to the first letter of the ID. As installed, both classes simply use the font "Verdana", which has serifs on the letter "I".

Visualizations

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
BEFORE: The personal data section of the original version of the Personal Profile. The red comments indicate how the layout has been changed by the mod. (Again, the changes indicated by the circles in this screenshot are now implemented by a separate mod, Regroup Person-Date Place.)
Regroup person profile-before1.png
AFTER: The personal AND family data in the new format. Note that the circled generic thumbnail is a bit smaller, and the overall effect of the changes is to take up less space. Some people would consider this presentation to be "crowded", whereas I consider the default TNG presentation to be "overly sparse". :-) Actually, since I made this screenshot, I have tweaked some style classes so that things are a little less crowded. (And, once more, this screenshot shows event data merged into a single cell, which is now done by a separate mod, Regroup Person-Date Place. It also does not show the Person ID's that are (optionally) placed after the names of parents, spouses, and children.)
Regroup person profile-after1.png
AFTER: The new Event Map, which is wider than before because I have eliminated the colored left-hand column, and put the Event Map label in the whitespace above the map. I have 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
AFTER: The new Sources block, which, like the Event Map, no longer uses the colored left-hand column, and has its label in the whitespace above the sources. To make this mod compatible with Citation Master, this mod no longer abbreviates the source citations and allows the user to click a button to add details. That functionality is now implemented through Regroup Person-Sources
Regroup person-source-before.png

Custom Text

The following strings are defined in the English and English-UTF8 versions of cust_test.php. Note that I had to create strings that display "Husband" and "Wife", since the existing definitions of $text['husband'] and $text['wife'] display "Father" and "Mother".

$text['otherevents'] = "Other Personal Events";
$text['hidemap'] = "Hide Event Map";
$text['showmap'] = "Show Event Map";
$text['hidecite'] = "Hide Citation Details";
$text['showcite'] = "Show Citation Details";
$text['spousehusband'] = "Husband";
$text['spousewife'] = "Wife";

Revision History

Mod Version TNG Version Date Note
12.0.0.16p 12.0+ 24 Aug 2018 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 28 Mar 2016 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 10 Mar 2016 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 19 Jul 2015 - 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 08 Jul 2015 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 03 Jan 2015 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 27 Dec 2014 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 1 3May 2014 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 21 Apr 2014 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 17 Apr 2014 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 16 Apr 2014 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 15 Apr 2014 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 11.0.0.16p 11.1.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