Regroup Person-Hide Branches
Hide Branch Names | ||
---|---|---|
Summary | On the Person Profile, hides the person's branch names unless the user is an administrator or, if the user is assigned to a branch, that branch name can optionally be shown when the user views the Person Profile of someone in that branch. | |
Validation | ||
Mod Updated | 23 Sep 2023 | |
Download link | v14.0.0.20a
(See the Revision History) | |
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.20a | |
Min TNG V | 10.1 | |
Max TNG V | 14 | |
Files modified | getperson.php | |
Related Mods | Mod Settings Blocks_v14.0.0.3a, Admin Branches Show Users, The Regroup Person family of mods | |
Notes | This mod can be installed independently of other mods in the Regroup Person family. |
Purpose of the Mod
In the Person Profile, this mod limits the visibility of the branches to which an Individual is assigned.
- Administrators see all branch names assigned to all Individuals.
- Non-logged-in users and users without a branch assignment never see branch names.
- Depending on a mod option, users who are assigned to a branch may see their branch name when viewing someone in their branch.
Mod Options
The idea behind this mod's single option is that, even if you don't want users to see branch members, it make sense for a logged in user who has a branch restriction to see who is in that branch.
Other Mods
Compatibility
There are no apparent conflicts, but there are so many mods that affect the Person Profile that I haven't tested them all against this mod. Please contact me if you encounter any conflicts.
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 popup in the Person Profile will (optionally) also show branch-assigned users.
This mod is compatible with, and part of, My "Regroup Person" family of mods. [Show the family members]
My "Regroup Person" family of mods all affect the Person Profile. All of them can be used independently of Regroup Person Profile, which was the the first and is the most complex member of the family.(I'll add that the reputation of the family has been stained by the fact that Regroup Person Profile is distinctly complex and is incompatible with an awkward number of other Person Profile mods. But, in truth, Regroup Person Profile and Regroup Person-Date Place is are the family members that are particularly complex or invasive.)
- Regroup Person Profile - Rearranges the data in and spacing and formatting of the Person Profile. Also (optionally) adds siblings.
- Regroup Person-Branch Members - Turns each of the profiled person's branch names into a hyperlink that pops up a list of branch members. Options control whether anonymous visitors and/or logged-in users are allowed to see branch details.
- Regroup Person-Child2Parent - Hides the display of selected relationships (typically "birth", which would be assumed if it were not displayed) between the profiled person and that person's parents and children.
- Regroup Person-Date Place - Adjusts the spacing used to display (1) Event dates, places, and values and/or (2) The name/birth/death/age data for the profiled person's relatives.
- Regroup Person-Family Indicators - Based on Jeff Robison's Family Indicators Mod, this mod adds flags (i.e. "indicators") next to the names of the profiled person's relatives. The flags provide information about and links to several aspects of those relatives' relatives, including popup profiles and ancestor or descendant charts.
- Regroup Person-Gender Before Birth - Simply moves the Gender "event" so that it appears above the Birth event. (As you would expect, this mod is incompatible with Regroup Person-Remove Gender)
- Regroup Person-Hide Branches - Hides branch names from anonymous visitors and/or logged-in users who are not assigned to the branch.
- Regroup Person-Move Media - Simply moves the media files above the event map.
- Regroup Person-No Living Data - Suppresses display of ANY data about a living or private person the user doesn't have rights to see. By default, TNG will show some data, plus spouses, parents, and children.
- Regroup Person-Remove Gender - Removes the Gender event (the sex) from the event tables, leaving the gender icon next to the name as the sole representation of the person's gender. (As you would expect, this mod is incompatible with Regroup Person-Gender Before Birth)
- Regroup Person-Sources - Allows some source and citation data to be hidden for brevity, and to be displayed as desired.
Installation
Files Installed
This mod includes a typical mod subfolder, with the same base name as the mod's .cfg file. The subfolder is atypical in that no files in it are installed to working TNG folders. However, it does contain critical files that contain the mod's language strings, which the mod does not add to standard cust_text.php files. Instead, the PHP code modified by this mod loads the language strings from files in the mod's languages/ subfolder. Read more about this technique.
[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
Before Installation:
Note the circled branch names, visible to anyone who can see the person's name. Even with the mod, they will continue to be visible to administrators. |
After Installation, with the mod's option set NOT to allow "branch-restricted" users to see their own branch(es)
The branch names are now invisible to all end users (i.e. all non-admins) |
After Installation, with the mod's option set TO ALLOW "branch-restricted" users to see their own branch(es)
(These conditions all assume that the user is not a site administrator.) |
Condition 1 - The user is not in any of the person's branches
As with the example above, the user cannot see any of the branches |
Condition 2 - The user is in the branch "Bacon"
|
Condition 3 - The user is in a "virtual branch" that includes two of the person's branches
The branches whose descriptions are "Kuykendall" and "Hutcheson" have the branch names "HK-Kuykendall" and "HK-Hutcheson", and the user is in the branch whose name is "HK". Thus, the user is effectively in both the "Kuykendall" and "Hutcheson" branches |
FYI - With Regroup Person Profile installed
Regroup Person Profile is not interdependent with Hide Branch Names, but it does change the display of branch names significantly. Regroup Person Profile moves the tree and branch names and the edit date out of the event block, and into the Person Profile heading |
FYI - Without FindAGrave Links
FindAGrave Links is also not interdependent with Hide Branch Names, but since I inadvertently took the screenshots above with FindAGrave Links installed, I though that it might be useful to describe the effect of that mod. FindAGrave Links converts the string GRid=nnn (as shown below) in comment and note fields to a hyperlinked reference to the appropriate FindAGrave memorial page (as shown in the screen clips above). That puts the FindAGrave page just one click away from the Person Profile, and reduces the need to copy the FindAGrave page's images and text to your TNG site. |
Revision History
Mod Version | TNG Version | Date | Note |
---|---|---|---|
v14.0.0.20a | 14 | 23Sep2023 | Fixed a typo in admin_genconfig.php, Removed showmodnames references, changed the admin_genconfig.php search string |
v14.0.0.20 | 14 | 28Jan2023 | No functional changes. Upgraded to TNGv14 |
v13.0.0.19a | 13 | 20 Sep 2020 |
|
v12.0.0.19.zip | 12.0-12.3 | 10 May 2020 | No functional changes. This version's primary purpose is to set the mod's version number to 19 to show that all Regroup Person mods are in sync with Regroup Person Profile. Technical changes include
|
v12.0.0.18.zip | 12.0+ | 15 May 2018 |
|
12.0.0.4a | 12.0+ | 15 May 2018 | No functional changes; made compatible with TNGv12.
This mod version and all versions below are named Hide Branch Names |
10.0.0.4 | 10.0.0-10.1.3 | 14 Feb 2016 | - Uses Show Mod Names v2 |
10.0.0.4 | 10.0.0-10.1.3 | 6 Dec 2015 | - Uses the mod name display functionality defined by Show Mod Names
- Reworked code to be compatible with Show Branch Members |
10.0.0.3 | 10.0.0-10.1.1 | 11 Jul 2015 | - Followed Ken Roy's suggestion to use the code ($allow_edit && $allow_add && $allow_delete && !$assignedtree) to determine whether the user is an administrator. - Added the option to display matching branches to users who have a branch restriction. - Put the word "Branches" in front of the branch names. - Includes conditional code to allow a SQL statement to be executed in TNG v10.0 or v10.1 |
10.0.0.2 | 10.0.0-10.1 | 26 Feb 2015 | v10.0.0.1 would hide branch names from non-administrators, but wouldn't display them for administrators. |
10.0.0.1 | 10.0.0-10.1 | 26 Dec 2014 | New mod; adapted from a incompletely documented, un-credited mod already in use. |
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 |
---|---|---|---|---|---|
Richmond's Genealogy Database (See a specific Person Profile) | Robin Richmond | Mod developer | 14.0.0.20a | 14 | English |
DJCM.DK | Claus Martinussen | Public Site | 12.0.0.4a | 12.0.3 | DA, EN |
Brady Family Tree in Western Australia | Darryl Brady | Public site | 10.0.0.4 | 10.1.1 | EN, DE |
Our Family Links | Chuck Filteau | Public site, modified Template 12 | v10.0.0.3 | v10.1.2 | EN |
Martius family | Hendrik Martius | Half public | 12.0.0.4a | 12.0.1 | DE, EN, FR, NL |
Your Roots are Showing | Harold Craswell | Public/Private | See Here | See Here | EN |