Regroup Person-Hide Branches

(Formerly Hide Branch Names)

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	10 May 2020
Download link	v12.0.0.19.zip TNG 12.0 See the Revision History for older versions
Download stats
Author(s)	Robin Richmond
Homepage	this page
Mod Support	My Mod Support form or TNG Community Forums
Contact Developer	My Mod Support form
Latest Mod	v12.0.0.19
Min TNG V	10.1
Max TNG V	at least 12.2
Files modified	getperson.php May Install rrshared_innermodmenu3.php, rrshared_modsettingsblocks3.php, rrshared_wikilogo.gif
Related Mods	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.

1. Administrators see all branch names assigned to all Individuals.
2. Non-logged-in users and users without a branch assignment never see branch names.
3. 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.

Compatibility With Other Mods

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

• This mod defines an "Inner Mod Menu" in the TNG "inner menu" (just below the tab menu). The Inner Mod Menu is visible only if Inner Mod Menus is installed.
• Like most of my mods, this mod saves information that can be used by Show Mod Names], but Show Mod Names is not required.
• This mod is in the "Regroup Person" family of mods that were written by Robin Richmond and that affect the Person Profile. All of these mods can be installed independently of the other mods in the family.

[Show the family members]

The "Regroup Person" family of mods:

1. Regroup Person Profile - The daddy in the family (and my first mod). It rearranges the data in the Person Profile, and adds features (some optional) such as siblings. more easy-to-read recordIDs relative's data, and the ability to control the formatting of dates and places.
2. Regroup Person-Branch Members - Makes each of the profiled person's branch names a hyperlink to a list of branch members, and, in some cases, to a list of branch members.
3. Regroup Person-Date Place - Combines event date, place, and description into one table cell, and coordinates with Regroup Person Profile to share an Inner Menu button that affects white space in the Person Profile.
4. Regroup Person-Family Indicators - Based on Jeff Robison's Family Indicators mod, this mod adds flags to parents & spouses that (1) pop-up a preview of both parents and that link to an ancestor chart, and adds flags to children and spouses that list the number of marriages that person had, and that link to a descendant chart.
5. Regroup Person-Hide Branches - Hides branch names from end-users.
6. Regroup Person-Move Media - Moves the media files above the map
7. 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.
8. Regroup Person-Parent Rel - Hides "natural" or "birth" relationships between the person and the parents.
9. Regroup Person-Sources - Allows source and citation data to be hidden for brevity, but displayed as desired.

[Hide the list of mods]

Installation

This mod is packaged with two mod subfolders.

1. The typical mod subfolder that has the same name as the mod's base filename. It contains the mod's language strings, in files under the subfolder languages/. That is, this mod does not copy its language strings into cust_text.php files. Instead, the Person Profile reads the language strings directly from the file in the mod subfolder. See notes about this technique
2. A mod subfolder that is shared with several other mods. The shared folder RR-shared_mod_includes_v12.0.0.4 contains files that help to manage mod options in many of my mods. It contains two files:
   1. rrshared_modsettingsblocks4.php - Supports the Mod Settings Block that lays out the mod's options in a distinct block that wraps a border around those options and that provide a way to link directly to the mod option rather than just to and Admin>>Setup program.
   2. img/rrshared_wikilogo.gif - An icon that links to a mod's TNG Wiki page from a Mod Settings Block.

Each mod that contains the shared folder may install its shared files, depending on whether those files already exist. Once the files from the shared folder have been installed (by any mod), those files will not be overwritten or removed by the subsequent installation or un-installation of any mod (including this one), nor will their presence or absence generate Mod Manager errors in uninstalled mods.

If you unzip mod distribution files directly into your mods folder, then the presence of the shared subfolder and the installation of its files should be invisible to you. But if you generally copy mod subfolders to your mods folder after you have unzipped the distribution file, then you need to make sure to copy the folder RR-shared_mod_includes_v12.0.0.4 (well, unless you are confident that it is already in your mods folder because it was part of another mod).
[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

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 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" This user can see "Bacon", but not the other branch names

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
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 Uses the new stand-alone mod Inner Mod Menus to display the mod's Inner Mod Menu. As a result, the visibility of the Inner Mod Menu is tied to the installation of the Inner Mod Menus mod. Moved the language strings to a mod subfolder. Added a link to the mod's options from a dummy mod parameter Upgraded to version 4 of the shared Mod Settings Blockis libraries Added "What has changed" text to the Inner Mod Menu (made possible by v5 of the Inner Mod Menu library)
v12.0.0.18.zip	12.0+	15 May 2018	Renamed the mod to Regroup Person-Hide Branches and jumped to v18 for consistency with other Regroup Person mods. Moved the mod option to a mod settings block Added an inner mod menu, like the other Regroup Person mod Fixed a problem with a dangling comma in the limited list of branches presented to users who are in one of the person's branches.
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 - Avoids database calls, thus removing any need to deal with TNGv10.0 vs 10.1.
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	12.0.0.19	12.3	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
Our Roy and Boucher Family	Ken Roy	Public site, modified Template 4 Installed without Show Mod Names	10.0.0.4a	11.1.0	EN
Martius family	Hendrik Martius	Half public	12.0.0.4a	12.0.1	DE, EN, FR, NL