Regroup Person-Sources

From TNG_Wiki
Jump to navigation Jump to search
Regroup Person-Sources
Summary Controls the amount of Source and Citation Details displayed in the Person Profile
Validation
Mod Updated 28 Jan 2022
Download link v14.0.0.20
TNG 14.0
v13.0.0.19
TNG 13.0
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.0.20
Min TNG V 12.0
Max TNG V 14
Files modified
getperson.php, personlib.php
Related Mods
Regroup Person Profile and other mods in the Regroup Person* family.
Notes

Purpose of the mod

Controls the amount of Source Citation Details displayed in the Sources (really "Source Citations') section of the Person Profile. It starts with just a list of source names. Buttons let you show all of the citation details, source details, and/or citation images. One-letter hyperlinks let you see or hide details for source citation.

Mod Options

None

Other Mods

Conflicts

  • This mod is not compatible with Citation Master. Please let me know of any other incompatibilities (or add them to this list).

Related Mods

  1. 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.
  2. Admin Branches Show Users was spun off from this mod for TNGv13. When it has been installed, the branch members popup in the Person Profile will (optionally) also show branch-assigned users.

regroup


Installation

Files Installed

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

BEFORE:
Regroup person-source-before.png
After Installation, as the page loads
  1. All of the Source Citations have been compressed to show only the Source ID, Title, and Author.
  2. There are now three buttons above the Source Citations block. They control three elements of a Source Citation - the Source details, the Citation details, and a possible Citation image.
  3. Not the three one-letter buttons next to the minimized Source Citation. "S", "C", and "I" toggle the display of that Source Citation's Source details, Citation details, and Image. If any of those components are missing (and all of them could be), the appropriate letter will be omitted. See item 2 and 10 in this screen clip.
Regroup person-source-after.png
After Clicking the "Show Source Details" button
  1. Note that the "Show Source Details" button has been changed to say "Hide", but the three one-letter links have not changes. At this point, the "S" link would hide the corresponding Source Details, and the other two letters would open their data.
Regroup person-source-after-sources.png
After Clicking the "Show Citation Details" button
  1. Now, the Citations button said "Hide Citation Details", and the one-letter links have not changed.
  2. Elements of the Citation details are labeled for clarity. "Citation" is a label for the whole citations section, and "Page" and "Text" are labels for those fields.
Regroup person-source-after-citations.png
With Regroup Person Profile Installed
  1. Regroup person Profile changes the Person Profile layout so that the mostly-wasted dark band on the left is replaced by a "Source Citations" heading.
  2. It moves the buttons to the right, and adds a very significant button labeled "Expand". The "Expand" button eliminates the limit on the Source Citation box, so that you can see more of the data than you can without the "Expand" button.

Yes, of course, it would be nice if Regroup Person-Sources offered the "Expand" button two, and I can coordiated the two mods so that they both generate a button and only one of the buttons is visible. But, well, maybe later. (Feedback on my mods almost always persuades me to prioritize the issue I'm getting feedback about.)

Regroup person-source-after-rpp.png

Revision History

Mod Version TNG Version Date Note
v14.0.0.20 13 20Sep2019 No functional changes. Upgraded to TNGv14
v13.0.0.19 13 20Sep2019 No functional changes. Upgraded to TNGv13
v12.0.0.19 12.0+ 19Dec2019 No functional changes. This version's primary purpose is to bring the version numbers of all Regroup Person mods in sync with Regroup Person Profile.
Technical changes include
  • Added an Inner Mod Menu, whose visibility is tied to installation of the Inner Mod Menus mod.
  • Moved the language strings to a mod subfolder.
v12.0.0.18c 12.0+ 19Dec2019
  • Fixed a conflict with v18b Regroup Person Profile. The two v18c's work together.
  • Uses styling to replace the two
    tags that separate source citations
  • Changed the "Show/Hide Images" functionality so that images can be viewed independently of citations
  • Added a single-letter link for Images.
  • The single-letter links within source citations are defined as language strings, instead of being derived from the initial letters of Source, Citation, and Image
v12.0.0.18 12.0+ 5May2019
  • This mod is no longer dependent on Regroup Person Profile.
  • Fixed a bug that was not displaying the source author in most cases.
  • Improved some of the formatting details of citation details and defined language strings for some field labels.
v12.0.0.16p 12.0+ 24Jul2018 No functional changes; made compatible with TNGv12
10.0.1.16p 10.1.0-11.1.2+ 07Nov2017 Removed the second line from the cust_text.php target location search string
10.0.1.15 10.0.1-10.1.3 20Feb2016 Initial release; separated this mod from the larger Regroup Person Profile mod to eliminate a conflict with that mod. Started with version 15 to be inline with Regroup Person Profile version numbers.

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.20 14 English
Baza danych Rodziny Jarocińskich Michał Jarociński non-public site 13.0.0.19 13.0.1, T7 PL, EN
Huygens - Van de Moortel Tom Huygens Public/Private on WordPress 13.0.0.19 13.1.2 NL
Your Roots are Showing Harold Craswell Public/Private See Here See Here EN