Regroup Person-No Living Data

From TNG_Wiki
Revision as of 20:49, 24 December 2014 by Robinrichm (talk | contribs) (new mod)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Regroup Person-No Living Data
Summary Moves things around on the Person Profile page (getperson.php), and compresses whitespace a bit.
Validation
Mod Updated {{{mod_last_update}}}
Download link For
TNG 10.0.3
TNG 10.0.1

regroup_person_profile_v10.0.1.11.zip
Download stats
Author(s) Robin Richmond
Homepage Robin Richmond's Genealogy Database
Mod Support My Mod Support form or TNG Forums
Contact Developer My Mod Support form
Latest Mod 10.0.1.11
Min TNG V 10.0.1
Max TNG V 10.0.3
Files modified
getperson.php,
genlib.php,
globallib.php,
personlib.php,
languages/English/cust_text.php,
languages/English-UTF8/cust_text.php,
css/genstyle.css
Related Mods
My Regroup Family Profile mod does some of the same things to (uh, rather, "for"!) the standard TNG Family Group sheet.
Notes
This is a very large mod, and was not written with the intent that it be shared as a public mod. It conflicts with many other TNG mods. See Compatibility with Other Mods to the left.


      • DRAFT ****

Purpose of the Mod

To rearrange the data in the person profile in a way that I find more readable, with less scrolling. In particular:

  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. The date, place, and possible descriptive text for an event are combined into a single cell of the HTML table. (Regular event notes are still displayed on a row below the date and place.)
  4. 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 distinguished the I from an l or 1.
  5. 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.
  6. Initially, I show only the source title for all sources. The details can be displayed and re-suppressed.
  7. 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. Again, initially, the sources show only the source title. AFTER you generate the printer-friendly page, you can click on a button to expand all of the sources.
  8. See also the mod parameters, the Mods whose functionality has been incorporated into this mod, and the visualizations.

Mod Parameters

  1. The HTML cellpadding parameter that controls whitespace within the HTML data tables.
  2. Whether to suppress ALL data for living or private people that the user is not allowed to see. TNG normally will display deceased parents and spouses of living people. By default, this mod suppresses that data. Changing this parameter value can restore TNG's default display of living people.
  3. Whether to display Person ID's for parents, spouses, and children. This is not a default functionality of TNG, and is turned off by default. See the visualization below.

Compatibility With Other Mods

This mod is a veritable foggy highway pileup of collisions with other mods. If a mod affects the Person Profile and isn't listed here, you should assume that there will be 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.

Automated Installation

  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.

In the event of a problem

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

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".

//rr - Strings used by the Regroup Person Profile Mod
$text['livingmessage'] = "When you are not logged in, you cannot see information about Living people.";
$text['privatemessage'] = "You do not have the rights to see this person's information";
$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";
//rr - End of Strings used by the Regroup Person Profile Mod

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 data tables (basic personal data, parents, families, other personal data, the event map, each media type, etc.) are now identified with the class "datatable", which has a new style rule that defines margin-bottom:1ex; to provide some whitespace between the tables. If you want to adjust that whitespace, it is probably best not to edit the rule I have defined, because modifying that rule will prohibit the mod from uninstalling cleanly. Instead, you should add a new style rule such as .datatable {margin-bottom:1em;} 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 which, on the personal profile, has what I'll call pseudo-buttons labeled Personal Information, Media, Sources, etc. 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; }

Displaying Person and Family IDs with Style Classes

All Person and Family ID's on this page (including the ones that are displayed only when the Display ID's mod parameter is True) are displayed by the new function displayID() in personlib.php. That function uses the style class .idvalue, which is now defined in /css/genstyle.css, and can be re-defined by TNG site administrators. Another style class, .idletter, is available in case a TNG site administrator wants to distinguish the first letter from the rest of the ID.

If you want to highlight person ID's by using an alternate color, you really should put a style rule defining .idvalue and/or .idletter in your template's mytngstyle.css file, since, if you change the template, colors defined in /css/genstyle.css might not be visible.

Mod Change History

Mod Version TNG Versions Date Note
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 23Jun2014 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.

Visualization of this Mod

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.
Regroup person profile-both.png
BEFORE: The personal data section of the original version of the Personal Profile. Note the red comments that indicate how the layout has been changed by the mod.
Regroup person profile-before1.png
AFTER: The personal AND family data in the new format. Note that the circled generic thumbnail is smaller, so that it takes up no more vertical space than the heading next to it.
Regroup person profile-after1.png
AFTER: The Parents and Family Blocks showing Person ID's. When the third Mod Parameter is turned on, the Person ID's for the parents, spouses, and children are displayed.
Regroup person profile-after-ids.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 circled 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. I have not changed the height of the Sources table, which, in TNGv10, has a fixed height and scrolls vertically when that height is exceeded. But I have reduced the amount of data that is displayed (initially), as I display only the Source titles, not source citation details. (It is just coincidence that the example profile I chose has 12 sources which fit into the defined space without any vertical scrolling.) Note the circled button at the upper right, which changes to "Hide Citation Details" when the details are displayed.
Regroup person profile-after-sources.png

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 10.0.1.11 10.0.3 English
MOTYER Family Genealogy John Mark Motyer Public site 10.0.1.7 10.0.2 EN, DE, RU
Turner mob family Genealogy Margaret Turner Public site 10.0.1.11 10.0.3 EN