Difference between revisions of "Regroup Person-Date Place"
Robinrichm (talk | contribs) (new mod version 17) |
Robinrichm (talk | contribs) |
||
(22 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
− | {{TNGmod | + | {{construction |
+ | | notes=This article, and the mod, are in transition from mod version 17 to version 18. The text of this article describes mod version 18, but the visualizations are from mod version 17.<br>Robin Richmond12 Oct 2019}}{{TNGmod | ||
| mod_name = Regroup Person-Date Place | | mod_name = Regroup Person-Date Place | ||
− | | mod_summary = Establishes a more | + | | mod_summary = Establishes a more compact presentation of Event dates, places, and values in the Person Profile. |
| mod_validation = | | mod_validation = | ||
− | | mod_last_update = 2 | + | | mod_last_update = 2 Oct 2019 |
− | | download_link = [[Media:regroup_person-date_place_v12.0.0. | + | | download_link = [[Media:regroup_person-date_place_v12.0.0.18.zip|v12.0.0.18.zip]] {{Tv120}} |
| download_stats = | | download_stats = | ||
| mod_author = [[User:Robinrichm|Robin Richmond]] | | mod_author = [[User:Robinrichm|Robin Richmond]] | ||
Line 10: | Line 11: | ||
| mod_contact = [http://robinrichmond.com/family/mod_support.php My Mod Support form] | | mod_contact = [http://robinrichmond.com/family/mod_support.php My Mod Support form] | ||
| mod_support = [http://robinrichmond.com/family/mod_support.php My Mod Support form] or [http://tng.community/ TNG Community Forums] | | mod_support = [http://robinrichmond.com/family/mod_support.php My Mod Support form] or [http://tng.community/ TNG Community Forums] | ||
− | | mod_version = v12.0.0. | + | | mod_version = v12.0.0.18 |
| min_TNG_ver = 12.0 | | min_TNG_ver = 12.0 | ||
− | | max_TNG_ver = at least 12. | + | | max_TNG_ver = at least 12.2 |
− | | TNG_file_list = getperson.php, personlib.php, English cust_text.php | + | | TNG_file_list = getperson.php, personlib.php, admin_genconfig.php, admin_updateconfig.php, English cust_text.php |
− | | related_mods = Regroup Person* - family of related mods that affect the Person Profile (See [[#Related_Mods|Related Mods]]) | + | <br>Installs shared files: rrshared_modsettingsblocks. rrshared_innermodmenu2.php, img/rrshared_wikilogo.gif |
+ | | related_mods = The Regroup Person* - family of related mods that affect the Person Profile (See [[#Related_Mods|Related Mods]]) | ||
| notes = This mod can work independently of the other mods in the Regroup Person family. | | 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. | ||
{| style="margin-right:0.5 em;" align="right" | {| style="margin-right:0.5 em;" align="right" | ||
| __TOC__ | | __TOC__ | ||
|} | |} | ||
− | == | + | The new format is best described by the [[#Visualizations|Visualizations]] below, but I'll add two quick notes here: |
− | + | # Even I prefer the native format from time to time, so this mod now has an optional spacing control that can switch between the more and less compact presentations. | |
+ | # This mod adds what I call an '''[[Inner Mod Menus|Inner Mod Menu]]''' to the Inner Menu of the Person Profile. Inner Mod Menus provide quick links to information about a mod and to the options editor. I primarily use them Admin mods. The Inner Mod Menu in the Person Profile is visible only to site admins. | ||
+ | |||
+ | == Mod Options == | ||
+ | # The initial spacing level. | ||
+ | #* '''Less''' - My format...Event dates and places (and sometimes values) are strung together in one table cell. The padding within table cells is also reduced, resulting in less whitespace, but more data on the screen. | ||
+ | #* '''More''' - Event dates, places, and values are displayed in almost exactly the way they appear in the native Person Profile. Event dates and places are in separate table cells, and event values follow on another line. | ||
+ | # Show a spacing control in the Inner Menu. | ||
+ | #* The spacing control is a button at the right end of the Inner Menu. Since there are only two spacing settings, the button label is either '''<span class='white-space:nowrap'>+Spacing</span>''' or '''<span class='white-space:nowrap'>-Spacing</span>'''. | ||
+ | #* If the control is not visible, then the spacing level cannot be changed. | ||
− | + | Note that [[Regroup Person Profile]] also implements two spacing levels and an identical spacing control. When both mods are installed, they essentially merge the two sets of controls into one. That is, | |
− | The spacing | + | # The two spacing settings are always the same, that is, both are '''More'', or both are '''Less''' in both mods. |
− | + | # The two flags that determine whether the spacing control is visible also are always the same. | |
− | + | # When both mods say "Display the spacing control", only one control is displayed. | |
− | |||
− | # | ||
− | |||
− | # | ||
− | |||
− | |||
− | = | + | In addition, the mod options are custom TNG settings that are defined at Admin>>Setup>>General Settings, in a new '''[https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Mod Settings Block]''' in a new subform called '''Robin's Mods'''. |
− | |||
− | |||
== Related Mods == | == Related Mods == | ||
These related mods also affect the Person Profile. (Note that some of these mods have side effects in other TNG programs.) | These related mods also affect the Person Profile. (Note that some of these mods have side effects in other TNG programs.) | ||
# [[Regroup Person Profile]] - Regroups and re-positions data in the Person Profile the data in the Person Profile, and adds headings above each block of data. | # [[Regroup Person Profile]] - Regroups and re-positions data in the Person Profile the data in the Person Profile, and adds headings above each block of data. | ||
− | # [[Regroup Person-Date Place]] (this mod) - Affects the | + | # [[Regroup Person-Date Place]] (this mod) - Affects the formatting of and white space around Event dates and places. |
# [[Regroup Person-Move Media]] - Moves the media files above the map | # [[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-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. | ||
Line 51: | Line 56: | ||
== Compatibility == | == Compatibility == | ||
I've not found any conflicts yet, but I haven't tested all of the numerous mods that affect the Person Profile. | I've not found any conflicts yet, but I haven't tested all of the numerous mods that affect the Person Profile. | ||
− | |||
− | |||
==Installation== | ==Installation== | ||
− | This mod uses the standard installation procedure. {{RobinInstallationBoilerplate}} | + | This mod uses the standard installation procedure, though it should be noted that this mod contains a mod subfolder that is shared with other mods that implement '''[https://tng.lythgoes.net/wiki/index.php?title=Inner_Mod_Menus Inner Mod Menus]''' and '''[https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Mod Settings Blocks]'''. Because of the shared subfolder, as you unzip or copy the mod, you might get a warning noting that a file or folder already exists. You can just ignore that warning.<br>{{RobinInstallationBoilerplate}} |
== Visualizations == | == Visualizations == | ||
− | + | These visualizations are from version 17 of the mod, not version 18. | |
− | |||
{| border="1" cellspacing="1" cellpadding="2" class="wikitable" | {| border="1" cellspacing="1" cellpadding="2" class="wikitable" | ||
|- | |- | ||
|<span style="color: red">''' BEFORE:'''</span> | |<span style="color: red">''' BEFORE:'''</span> | ||
− | | [[Image:regroup_person-date_place- | + | |- |
+ | | [[Image:regroup_person-date_place-before18.png]] | ||
|- | |- | ||
| <span style="color: red">'''AFTER:'''</span> | | <span style="color: red">'''AFTER:'''</span> | ||
− | | [[Image:regroup_person-date_place-after.png]] | + | <div>Note the spacing control and the Inner Mod Menu label ("Mod Information") at the right end of the Inner Menu.</div> |
+ | |- | ||
+ | | [[Image:regroup_person-date_place-after18.png]] | ||
+ | |- | ||
+ | | '''<span style="color: red">AFTER:'''</span>, with the "more spacing" setting''', hence the spacing control label is "-spacing" | ||
+ | |- | ||
+ | | [[Image:regroup_person-date_place-after218.png]] | ||
+ | |- | ||
+ | | '''<span style="color: red">AFTER:'''</span>, 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. | ||
+ | |- | ||
+ | | [[Image:regroup_person-date_place-after-imm.png]] | ||
+ | |- | ||
+ | | '''<span style="color: red">AFTER:'''</span>, 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. | ||
+ | |- | ||
+ | | [[Image:regroup_person-date_place-after-msb.png]] | ||
|} | |} | ||
== Spacing Styling == | == Spacing Styling == | ||
− | The two spacing schemes have identical HTML; they are just styled differently. | + | The two spacing schemes implemented by this mod have identical HTML; they are just styled differently. |
<!---------------------- Details Double Toggle ---------------------> | <!---------------------- Details Double Toggle ---------------------> | ||
<div class='mw-collapsible mw-collapsible-content mw-customtoggle-details1 mw-customtoggle-details2' id='mw-customcollapsible-details1' style='text-decoration:underline;color:#0645ad;'>[See Details]</div> | <div class='mw-collapsible mw-collapsible-content mw-customtoggle-details1 mw-customtoggle-details2' id='mw-customcollapsible-details1' style='text-decoration:underline;color:#0645ad;'>[See Details]</div> | ||
<div class='mw-collapsible mw-collapsible-content mw-collapsed' id='mw-customcollapsible-details2' style='border:thin solid grey'> | <div class='mw-collapsible mw-collapsible-content mw-collapsed' id='mw-customcollapsible-details2' style='border:thin solid grey'> | ||
− | <div class='mw-customtoggle-details1 mw-customtoggle-details2' style='text-decoration | + | <div class='mw-customtoggle-details1 mw-customtoggle-details2' style='text-decoration* Events: |
− | * 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 | |
− | + | *# The date div has a minimum width, | |
− | * | + | *# The date and place are separated by a side border, |
− | + | *# The value is forced to a new line, and | |
− | * | + | *# A horizontal border is placed between the date/place and the value. |
− | |||
− | |||
<div style='text-align:right;>[<span class="mw-customtoggle-detail1 mw-customtoggle-detail2" style='text-decoration:underline;color:#0645ad;'>Hide details</span>]</div> | <div style='text-align:right;>[<span class="mw-customtoggle-detail1 mw-customtoggle-detail2" style='text-decoration:underline;color:#0645ad;'>Hide details</span>]</div> | ||
</div> | </div> | ||
Line 91: | Line 108: | ||
|- | |- | ||
! Mod Version !! TNG Version !! Date !! Note | ! Mod Version !! TNG Version !! Date !! Note | ||
− | |- | + | |- style="vertical-align:top;" <!-- ############################################################## --> |
− | | [[Media:regroup_person-date_place_v12.0.0. | + | | [[Media:regroup_person-date_place_v12.0.0.18.zip|12.0.0.18]] |
− | | 12.0+ | + | | 12.0 - 12.2+ |
− | | 2 | + | | 2 Oct 2019 |
− | | Provided an alternate display format that looks much like the native Person Profile. | + | | |
− | |- | + | # Provided an alternate display format that looks much like the native Person Profile, and an optional spacing control to switch between the new formats. |
+ | # Added an Inner Mod Menu, and placed the mod options in a Mod Settings Block | ||
+ | |- style="vertical-align:top;" <!-- ############################################################## --> | ||
| [[Media:regroup_person-date_place_v12.0.0.15.zip|12.0.0.15]] | | [[Media:regroup_person-date_place_v12.0.0.15.zip|12.0.0.15]] | ||
| 12.0+ | | 12.0+ | ||
| 24 Jul 2018 | | 24 Jul 2018 | ||
| No functional changes; made compatible with TNGv12. | | No functional changes; made compatible with TNGv12. | ||
− | |- | + | |- style="vertical-align:top;" <!-- ############################################################## --> |
| 10.0.1.15 | | 10.0.1.15 | ||
| 10.0.1-10.1.3 | | 10.0.1-10.1.3 | ||
| 20 Feb 2016 | | 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]]. | | 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]]. | ||
− | |- | + | |- style="vertical-align:top;" <!-- ############################################################## --> |
| 10.0.1.14 | | 10.0.1.14 | ||
| 10.0.1-10.1.3 | | 10.0.1-10.1.3 | ||
Line 113: | Line 132: | ||
# Some event notes were displaying in the wrong HTML table cells. | # Some event notes were displaying in the wrong HTML table cells. | ||
# Some source citation references next to event data were not wrapped in brackets. | # Some source citation references next to event data were not wrapped in brackets. | ||
− | |- | + | |- style="vertical-align:top;" <!-- ############################################################## --> |
| 10.0.1.13 | | 10.0.1.13 | ||
| 10.0.1-10.1 | | 10.0.1-10.1 | ||
| 03 Jan 2015 | | 03 Jan 2015 | ||
| Minor cleanup of end-of-line spacing | | Minor cleanup of end-of-line spacing | ||
− | |- | + | |- style="vertical-align:top;" <!-- ############################################################## --> |
| 10.0.1.12 | | 10.0.1.12 | ||
| 10.0.1-10.1.0 | | 10.0.1-10.1.0 | ||
Line 157: | Line 176: | ||
| 10.1.3 | | 10.1.3 | ||
| NL, DE, EN | | NL, DE, EN | ||
+ | |- | ||
+ | | [http://genealogy.ravensbeak.com Mueller-Diefenbach Genealogy] | ||
+ | | [[User:Cmhbob|Bob Mueller]] | ||
+ | | | ||
+ | | 12.0.0.15 | ||
+ | | 12.0.3 | ||
+ | | EN | ||
|} | |} | ||
[[Category:Mods for TNG v10]] [[Category:Mods for TNG v11]][[Category:Mods for TNG v12]] | [[Category:Mods for TNG v10]] [[Category:Mods for TNG v11]][[Category:Mods for TNG v12]] | ||
[[Category:personlib.php mods]] [[Category:getperson.php mods]] | [[Category:personlib.php mods]] [[Category:getperson.php mods]] | ||
+ | [[Category:admin_genconfig.php mods]] | ||
+ | [[Category:admin_updateconfig.php mods]] |
Revision as of 21:08, 14 October 2019
Regroup Person-Date Place | ||
---|---|---|
Summary | Establishes a more compact presentation of Event dates, places, and values in the Person Profile. | |
Validation | ||
Mod Updated | 2 Oct 2019 | |
Download link | v12.0.0.18.zip
| |
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 | v12.0.0.18 | |
Min TNG V | 12.0 | |
Max TNG V | at least 12.2 | |
Files modified | getperson.php, personlib.php, admin_genconfig.php, admin_updateconfig.php, English cust_text.php
Installs shared files: rrshared_modsettingsblocks. rrshared_innermodmenu2.php, img/rrshared_wikilogo.gif | |
Related Mods | The Regroup Person* - family of related mods that affect the Person Profile (See Related Mods) | |
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 new format is best described by the Visualizations below, but I'll add two quick notes here:
- Even I prefer the native format from time to time, so this mod now has an optional spacing control that can switch between the more and less compact presentations.
- This mod adds what I call an Inner Mod Menu to the Inner Menu of the Person Profile. Inner Mod Menus provide quick links to information about a mod and to the options editor. I primarily use them Admin mods. The Inner Mod Menu in the Person Profile is visible only to site admins.
Mod Options
- The initial spacing level.
- Less - My format...Event dates and places (and sometimes values) are strung together in one table cell. The padding within table cells is also reduced, resulting in less whitespace, but more data on the screen.
- More - Event dates, places, and values are displayed in almost exactly the way they appear in the native Person Profile. Event dates and places are in separate table cells, and event values follow on another line.
- Show a spacing control in the Inner Menu.
- The spacing control is a button at the right end of the Inner Menu. Since there are only two spacing settings, the button label is either +Spacing or -Spacing.
- If the control is not visible, then the spacing level cannot be changed.
Note that Regroup Person Profile also implements two spacing levels and an identical spacing control. When both mods are installed, they essentially merge the two sets of controls into one. That is,
- The two spacing settings are always the same, that is, both are More, or both are Less' in both mods.
- The two flags that determine whether the spacing control is visible also are always the same.
- When both mods say "Display the spacing control", only one control is displayed.
In addition, the mod options are custom TNG settings that are defined at Admin>>Setup>>General Settings, in a new Mod Settings Block in a new subform called Robin's Mods.
Related Mods
These related mods also affect the Person Profile. (Note that some of these mods have side effects in other TNG programs.)
- Regroup Person Profile - Regroups and re-positions data in the Person Profile the data in the Person Profile, and adds headings above each block of data.
- Regroup Person-Date Place (this mod) - Affects the formatting of and white space around Event dates and places.
- 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.
This mod also generates information that can be used by Show Mod Names, but it does not depend on Show Mod Names.
Compatibility
I've not found any conflicts yet, but I haven't tested all of the numerous mods that affect the Person Profile.
Installation
This mod uses the standard installation procedure, though it should be noted that this mod contains a mod subfolder that is shared with other mods that implement Inner Mod Menus and Mod Settings Blocks. Because of the shared subfolder, as you unzip or copy the mod, you might get a warning noting that a file or folder already exists. You can just ignore that warning.
[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
These visualizations are from version 17 of the mod, not version 18.
Spacing Styling
The two spacing schemes implemented by this mod have identical HTML; they are just styled differently.
<div class='mw-customtoggle-details1 mw-customtoggle-details2' style='text-decoration* 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
- The date div has a minimum width,
- The date and place are separated by a side border,
- The value is forced to a new line, and
- A horizontal border is placed between the date/place and the value.
Revision History
Mod Version | TNG Version | Date | Note |
---|---|---|---|
12.0.0.18 | 12.0 - 12.2+ | 2 Oct 2019 |
|
12.0.0.15 | 12.0+ | 24 Jul 2018 | 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 | 17 Jul 2015 | Fixed two old bugs that date back to Regroup Person Profile v1:
|
10.0.1.13 | 10.0.1-10.1 | 03 Jan 2015 | Minor cleanup of end-of-line spacing |
10.0.1.12 | 10.0.1-10.1.0 | 26 Dec 2014 | 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 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.17 | 12.0.3 | 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 |