Difference between revisions of "Regroup Person Profile"
Robinrichm (talk | contribs) (mod v18d) |
Robinrichm (talk | contribs) |
||
Line 161: | Line 161: | ||
{| border="2" cellspacing="1" cellpadding="2" class="wikitable" | {| border="2" cellspacing="1" cellpadding="2" class="wikitable" | ||
− | | <span style="color: red">''' | + | | <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. | #* The popup previous that show details about parents and children are not available for siblings. | ||
Line 168: | Line 168: | ||
expanded format is used by default. | expanded format is used by default. | ||
|- | |- | ||
− | | [[Image: | + | | [[Image:regroup_person_profile-siblings.png]] |
|} | |} | ||
{| border="2" cellspacing="1" cellpadding="2" class="wikitable" | {| border="2" cellspacing="1" cellpadding="2" class="wikitable" | ||
− | | <span style="color: red">''' | + | | <span style="color: red">'''7. AFTER:'''</span> '''The optional 3-line name/birth/death/age format'''<br> |
A mod option controls | A mod option controls | ||
# Whether this expanded format is used by default, and | # 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. | # Whether the "Spacing" button that switches between the one-line and three-line formats is visible. | ||
|- | |- | ||
− | | [[Image: | + | | [[Image:regroup_person_profile-3lines.png]] |
|} | |} | ||
Line 205: | Line 205: | ||
| 24Feb2020 | | 24Feb2020 | ||
| | | | ||
− | + | * The siblings list is now labeled "Siblings" whether it is in the personal data block, or in the parents' data block. | |
− | + | * Added a missing %end:% tag, as required in TNGv12.3. | |
− | + | * Upgraded to version 4 of the shared mod libraries. | |
|- style="vertical-align:top;" <!-- ############################################################## --> | |- style="vertical-align:top;" <!-- ############################################################## --> |
Revision as of 09:43, 25 February 2020
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. 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 |
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 | 25 Feb 2020 | |
Download link | v12.0.0.18d
| |
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.18d | |
Min TNG V | 10.0.1 | |
Max TNG V | 12.2 | |
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:
- Just 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.
- Subheadings have been added above parents, marriages, other personal data, the event map, and source citations.
- 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.
- 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.
- 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.
- 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.
- 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, can display the name/birth/death/age data for children, parents, and siblings in three lines to improve readability.
See also the subheading Related Mods, some notes under Incompatible Mods, the Visualizations, and additional comments in the .cfg file itself. }}
Mod Options
In mod versions before version 18, this mod has two Mod Parameters:
- 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.
- A flag that determines whether to display person ID's for each parent, spouse, and child.
In version 18+, this mod has six 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.
- Spacing - Controls the Name/Birth/Death/Age data for relatives; that is parents, spouses, children, and siblings
- 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.)
- 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.
- 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)
- Siblings - Whether and where to display the person's siblings. (no / in the parents data block / in the person's primary data block).
- 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"
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 Menu. Javascript code in admin_genconfig.php keeps the options in sync.
Other Mods
Many, many mods affect the Person Profile. These notes cannot cover them all.
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.
The "Regroup Person" family of mods:
- Regroup Person Profile - (this mod) The daddy in the family (and my first mod)
- Regroup Person-Branch Members - Makes each of the person's branch names a hyperlink to a list of branch members.
- 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.
- Regroup Person-Hide Branches - Hides branch names from end-users.
- Regroup Person-Move Media - Moves the media files above the map
- Regroup Person-No Living Data - Suppresses display of ANY data about a living or private person the user doesn't have rights to. By default, TNG will show some data, plus spouses, parents, and children.
- Regroup Person-Parent Rel - Hides "natural" or "birth" relationships between the person and the parents.
- Regroup Person-Sources - Starts the display of source citations with just the Source ID, Title, and Author, and provides buttons so the user can display Source details and/or Citation details, for individual source citations and for all source citations.
Compatible Mods
This is not a complete list of compatible mods that affect the Person Profile.
- This mod is compatible with Census Plus International, Citation Master, Compact Person Media, Default Photo Preview, Event Map add children mod, Family Indicators Mod, Family Preview Mod, Geocode Assist Mod, Google Maps - More Place Levels Mod, Living Color Mod, Public Access Control, Relationship Display Mod, Relocate Person Photos, Same Person Link, Simple Titles Mod, Submit Photo/Document Form Mod, Submit Photo Tab Mod, Wiki Integration. (Note: I have tested the installation of Census Plus International and Wiki Integration, but not their functionality.)
- This mod is compatible with all of the other members of the Regroup Person* family listed above. (A temporary conflict with Regroup Person-Sources was resolved with v18c of both mods.
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:
- 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".
- Person Map: Regroup Person Profile can hide and re-display the Event Map.
- 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.
- 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.
- 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.
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..
- Count_Ancestors_n_Descendants can be installed after this mod, and must be uninstalled before Regroup Person Profile to be uninstalled.
- Signature Display can be installed ''before this mod. Regroup Person Profile must be uninstalled to allow Signature Display to be uninstalled.
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.3 contains files that help to manage mod options in many of my mods:
- rrshared_innermodmenu4.php - Inner Mod Menus
- rrshared_modsettingsblocks4.php - Mod Settings Blocks
- 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.
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
- Remove and delete previous version of this mod.
- Backup the files updated by this mod. They are listed in the panel at the upper right.
- Download the .zip file, Extract its .cfg file to the mods folder.
- Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files.
Problems?
- Try using the Mod Manager Remove capability
- Contact me through My Mod Support form.
Visualizations
See the Revision History to learn what is different about version 18.
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.) |
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. |
3. AFTER: The personal AND family data in the new format
|
5. AFTER: The new Sources 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 can remove details from each Source Citation, and provides button and links that display Source and/or Citation details. |
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 a bit - especially when whitespace is provided by <br> tags rather than style rules. To that end:
- 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. - 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.
- 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:
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.18d | 12.0 - 12.3 | 24Feb2020 |
|
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 |
|
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 |