Regroup Person-Date Place

From TNG_Wiki
Jump to navigation Jump to search
Regroup Person-Date Place
Summary This mod changes the layout of the Person Profile to affect its white space and readability.
Validation
Mod Updated 11 Nov 2023
Download link 14.0.4.20c
TNG 14.0.4
See the Revision History for older versions
Download stats
Author(s) Robin Richmond
Homepage this page
Mod Support My Mod Support form
Contact Developer My Mod Support form
Latest Mod 14.0.4.20c
Min TNG V 12.0
Max TNG V 14.0.4
Files modified
getperson.php, personlib.php, globallib.php, genstyle.css, admin_genconfig.php, admin_updateconfig.php
Related Mods
Mod Settings Blocks, Regroup Person Profile, The Regroup Person* - family of related mods that affect the Person Profile.
Notes
This mod can work independently of the other mods in the Regroup Person family.


Purpose of the Mod

This mod formats Event dates, places, and values more compactly than the native Person Profile. I'm not about to say that I've improved it, but I do generally prefer the more compact format, and some other TNG administrators have said that they like it, too.

The mod two ways that the Person Profile can be made more or less compact.

  1. For each event, the date, place, and value can be made more compact by displaying in one HTML table cell.
  2. The birth/death/age data for relatives (parents, spouses, children) can be expanded to occupy three lines.

Different users are expected to prefer different formats at different times (perhaps depending on the overall density of a particular Person Profile.) Thus, the format of each of these aspects of the page can be controlled both by mod options and by a Spacing button on the page - and the spacing button can be suppressed through a mod option.

Mod Options

  1. Four options can be specified for Anonymous Visitors, Logged-in Users, and Administrators (i.e. there are 12 checkboxes)
    1. Start with less Event Date/Place/Value spacing
    2. Start with less spacing in relatives' birth/death/age data.
    3. Show a spacing control in the "Inner Menu" - the horizontal light-on-dark menu that is immediately below the tab menu.
    4. Show a second spacing control further down in the profile.
  2. Age format:
    • (75 years) – the native format
    • (age 75) and (Living, age 75)

These options are defined and edited at Admin>>Setup>>General Settings, in the new subform Mod Settings Blocks, where the options for various mods are organized into Mod Settings Blocks. The options can also be reached in the traditional way - through the mod's Edit Options button in the Mod Manager.

Related Mods

The Mod Settings Blocks mod packages this mod's options into what I call a "Mod Settings Block", which is a set of form fields that formatted and labeled so that it stands out among other options in an Admin>>Setting form. Mod Settings Blocks is a prerequisite for this mod; it must be installed before this mod can be installed.


regroup


Compatibility

Given the number of mods that affect the Person Profile, and the complexity of some of those mods, I would expect there to be some mod conflicts, but I haven't encountered them yet.

Installation

This mod does not install any files, but it does still have a mod subfolder, which contains the mod's language strings. That is, this mod's language strings are not defined in its .cfg file nor copied to cust_text.php files. As a result

  • This mod's language strings are loaded only into the TNG programs that need them, not into all TNG programs, and
  • It is easier to create, edit, test, and save translation for this mod than for mods that use standard cust_text.php strings.

This non-standard technique should be invisible to you unless you want to define a translation or override any of this mod's string values.
Read more about this technique, the simplified translation process, and the procedure for defining site-specific overrides to its language strings.


[Show Standard Installation Process]

Requirements

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

Procedure

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

Problems?

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


Visualizations

These visualizations are from version 18 of the mod, not version 19.

BEFORE:
Regroup person-date place-before18.png
AFTER:
Note the spacing control and the Inner Mod Menu label ("Mod Information") at the right end of the Inner Menu.
Regroup person-date place-after18.png
AFTER:, with the "more spacing" setting, hence the spacing control label is "-spacing"
Regroup person-date place-after218.png
AFTER:, showing the Inner Mod Menu

This screen clip shows how the Inner Mod Menu looks after at least four mods that affect the Person Profile have been installed.

Regroup person-date place-after-imm.png
AFTER:, showing this mod's Mod Settings Block

When invoked from the Regroup Person-Date Place "Change Mod Options" link in the Inner Mod Menu (the previous screen clip), only the options for the selected mod are shown. You can still click the triangular arrow or the subform name ("Robin's Mods") to see all of the Mod Settings Blocks in this subform.

Regroup person-date place-after-msb.png

Spacing Styling

The two spacing schemes implemented by this mod have identical HTML; they are just styled differently.   [See Details]

[Hide details]
Events:
  • The native code uses one row of the layout table for the event date and place, and a second row, when needed, for a value. It also places the date and place in two table cells, with a fixed width for the date cell.
  • The modded code uses one row of the layout table for each event, whether there is an event value or, and combines the data, place, and value cells into one table cell. The date and place are in divs that are expected to float next to each other, and the value is in a third div that may float next to the date and place, or may wind up on a separate line within the same table cell. Styling controls whether the date and place abut each other, or have padding and a border between them, and where the value is positioned. In the more compact spacing, the value is allowed to be on the same line as the date/place, but it will float to a new line when it cannot fit. In the wider spacing, the styling is changed so that
    1. The date div has a minimum width,
    2. The date and place are separated by a side border,
    3. The value is forced to a new line, and
    4. A horizontal border is placed between the date/place and the value.
[Hide details]

Revision History

Mod Version TNG Version Date Note
14.0.4.20c 14.0.4 21Mar2024 Accommodated underlying changes in TNGv14.0.4
14.0.3.20b 14.0.3 11Nov2023 Accommodated underlying changes in TNGv14.0.3
14.0.0.20 14.0-14.0.2 28Jan2023 No functional changes. Upgraded to TNGv14
13.0.4.19a 13.0.4 09Jun2021 TNGv13.0.4 added code that could display relatives genders along with their ages wherever relatives' birth/death/age are displayed in the Person Profile. However, I do not believe that the language strings for that are needed for the gender exist, thus I do not believe that this change in the PHP code will result in any changes to the Person Profile.
13.0.0.19a 13.0-13.0.3 09Jun2021
  1. Remove some redundant spacing that is generated when Add Person Siblings Row is also installed.
  2. Hides the suggestion icons and the place details spyglass icons when in Format for Printing mode
13.0.0.19 13.0-13.0.3 17Sep2020
  1. Coordinates differently with Regroup Person Profile so that both aspects of spacing are controlled by this mod. In TNGv12 (and version 18* of these two mods), each mod controlled one aspect of spacing.
  2. Added an Inner Mod Menu, which is visible only if the optional Inner Mod Menu mod is installed.
12.0.0.18a 12.0 - 12.2+ 16Dec2019
  1. Provided an alternate display format that looks much like the native Person Profile, and an optional spacing control to switch between the new formats.
  2. Added an Inner Mod Menu, and placed the mod options in a Mod Settings Block
12.0.0.15 12.0+ 24Jul2018 No functional changes; made compatible with TNGv12.
10.0.1.15 10.0.1-10.1.3 20 Feb 2016 No new end-user functionality; just added Show Mod Names functionality and dependency, and updated the mod number to stay in sync with Regroup Person Profile.
10.0.1.14 10.0.1-10.1.3 17Jul2015 Fixed two old bugs that date back to Regroup Person Profile v1:
  1. Some event notes were displaying in the wrong HTML table cells.
  2. Some source citation references next to event data were not wrapped in brackets.
10.0.1.13 10.0.1-10.1 03Jan2015 Minor cleanup of end-of-line spacing
10.0.1.12 10.0.1-10.1.0 26Dec2014 Initial release; separated this mod from the larger Regroup Person Profile mod to reduce the chances and consequences of that mod running into conflicts.

Sites using this mod

If you download and install this mod, please add your TNG site to the table below:

URL User Note Mod-Version TNG-Version User-language
Robin Richmond's Genealogy Database Robin Richmond Mod developer 14.0.0.20b

rrppdp


English
Wortelboer Genealogy Bernard Wortelboer 10.0.1.13 10.1.0 NL, EN
Stamboom Jongman Roel Jongman Public/Private site 10.1.0.15 10.1.3 NL, DE, EN
Mueller-Diefenbach Genealogy Bob Mueller 12.0.0.15 12.0.3 EN
Baza danych Rodziny Jarocińskich Michał Jarociński non-public site 13.0.0.19a 13.1.2 PL, EN
Huygens - Van de Moortel Tom Huygens Public/Private on WordPress 13.0.4.19a 13.1.2 NL