Regroup Person-Branch Members
Regroup Person-Branch Members | ||
---|---|---|
Summary | Turns branch names in the Person Profile into hyperlinks to a popup list of Branch members, as in the Branch editor. Users assigned to the branch may also be displayed. | |
Validation | ||
Mod Updated | 23 Sep 2023 | |
Download link | v14.0.0.20b
(See the Revision History) | |
Download stats | ||
Author(s) | Robin Richmond | |
Homepage | Robin Richmond's Genealogy Database | |
Mod Support | My Mod Support form or TNG Community Forums | |
Contact Developer | this page | |
Latest Mod | 14.0.0.20b | |
Min TNG V | 10.1 | |
Max TNG V | 14.0.3 | |
Files modified | getperson.php, personlib.php | |
Related Mods | ||
Notes |
Purpose of the Mod
To allow selected website visitors to the Person Profile to see the members of branches to which the profiled person belongs.
- "To see the members of branches" means that the branch names are hyperlinked, and clicking on the hyperlinks pops up the same information box that is shown with the "Show Branch Members" function in the branch editor.
- By "selected users", I mean that a mod options controls whether unauthenticated visitors and logged-in users can see the branch
In TNGv12 only, this mod contains an option that enhances the Branch Members popup to show branch-assigned users and to add links and settings. These enhancements appear (optionally) in all Branch Members popups; that is, both in the Person Profile and in the Branch Editor. In TNGv13, these enhancements are implemented by the new Admin Branches Show Users mod.
The new features of the popup include:
- Since it now can be called from an end-user program (the Person Profile), the lists of people and families must make sure that the current user is allowed to see these people and families. If some records are restricted from being seen by the user, the restricted records are completely omitted from the lists.
- To accommodate inaccessible records, it modifies the wording in the subheading and adds the count of inaccessible records
- If any records are omitted from the lists because they are inaccessible by the user, a new message says how many were ommited.
- It ignores $tree as an input querystring parameter, since $branch is sufficient to identify the tree and branch uniquely.
- In the heading, it displays the tree to which the branch belongs, next to the branch name (unless the database has only one tree.)
- The heading now has id='top', to be used as a hyperlink destination.
- The word "Families" in the heading line with people and family counts is a hyperlink to the list of families.
- Person names and family names are now in ordered lists.
- Person names are now hyperlinked to the Person Profile rather than to the Person editor.
- There is now a heading above the list of families, with a hyperlink to the top of the litbox.
- Families are now hyperlinked to the Family Profile rather than tp the family editor.
- There is a list to the top of the litbox from the bottom.
- A new querystring parameter $showusers controls whether the branch's users are listed.
- In the new list of users
- The "realname" field from the users is the value that identifies each user
- If the user has an email address, the realname is displayed as a mailto: hyperlink.
- If the user has an associated person, that person's ID and name are displayed as a hyperlink to the person profile.
Mod Options
These options and are defined in a Mod Settings Block at Admin>>Setup>>General Settings in a new subform with the name "Mod Settings Blocks"
- The options control which class of users (visitors, logged-in users, admins) can see people in the branch and/or users who are assigned to the branch.
- If Admin Branches Show Users is not installed, then the options do not consider whether users who are assigned to the branch are displayed, since they can be displayed only if Admin Branches Show Users is installed.
Other Mods
Compatibility
No known mod conflicts or strict dependencies, but do please let me know if you find any.
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.
- Admin Branches Show Users was spun off from this mod for TNGv13. When it has been installed, the branch members that 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
- 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
Person Profile BEFORE: Note two branch names |
---|
Person Profile AFTER: |
The branch names are now hyperlinks, and clicking on one pops up the list of members. |
In the popup list created by ajx_showbranch.php: (These features are implemented by this mod in TNGv12, but by Admin Branches Show Users in TNGv13)
|
Admin Branch Edit BEFORE: |
When you click on the button shown, the members of the branch are listed in the pop-up box. Note that the button and the pop-up box heading are identical, and that they refer to "people" rather than "members" (which include families). |
Admin Branch Edit AFTER: |
In the popup litbox:
|
AFTER: The Person Profile "Inner Mod Menu" This menu drops down from the label "Mod Information" at the right end of the standard TNG "Inner Menu", just below the tab bar. It is visible only to site administrators. Several mods add Inner Mod Menu entries to the Person Profile. This screenshot shows the menu with four mods, plus a link to "more mods". Regroup Person-Branch members will always be shown above the "more mods" link. The button that is cut off to the right of "Mod Information" is added by Regroup Person-Date Place |
7. AFTER: The Regroup Person-Branch Members Profile "Mod Settings Block" msbviz1
msbgenconfig
|
Revision History
Mod Version | TNG Versions | Date | Note |
---|---|---|---|
v14.0.0.20b | 14 | 23 Sep 2023 | Changed the admin_genconfig.php search string, Cleaned up and corrected code reading the language strings, and Corrected a subscript reference |
v13.0.0.19c | 13-13.1 | 8 Nov 2021 |
|
v13.0.0.19b | 13 | 12 Sep 2020 |
|
v12.0.0.19 | 12.0-12.3 | 10May2020 | Renamed the mod to Regroup Person-Branch Members and jumped to v19 to be consistent with other mods in the Regroup Person family. No other meaningful functional changes
|
10.1.0.3 | 10.1-11.1.2+ | 14 Jan 2018 | This and earlier versions of the mod are named Show Branch Members
In the Branch Members litbox popup used by the Branch editor, and now by the Person Profile,
|
10.1.0.2 | 10.1-11.1.2+ | 4 May 2017 | Now makes sure that a branch-restricted user has an associated user before trying to display the associated user, and makes sure that the associated user exists. |
v10.1.0.1.zip | 10.1-10.1.3 | 30 Nov 2015 | New mod. |
Language Strings
language1
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's Roots"Robin Richmond's Genealogy Database] (See a specific Person Profile) |
Robin Richmond | Mod developer | 14.0.0.20b |
rrrpbm
|
English |
Your Roots are Showing | Harold Craswell | Public/Private | See Here | See Here | EN |
Martius family | Hendrik Martius | Use to inform living branch members on assigned users, e.g. corr. GDPR | 10.1.0.3 | 12.0.1 | DE, EN, FR, NL |
Daniel Bender - Generations | Allison Sibert | Public/ Living Private researchmod_v12.0.0.1 did not allow branches to show in header | 13.0.0.19c | 13.1.2 | EN |