Regroup Person-Hide Branches

From TNG_Wiki
Jump to navigation Jump to search
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
TNG 14.0
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.

  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.

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

  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 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.

Hide branch names-before.png
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)

Hide branch names-after-none.png
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

Hide branch names-after-none.png
Condition 2 - The user is in the branch "Bacon"


This user can see "Bacon", but not the other branch names

Hide branch names-after-bacon.png
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

Hide branch names-after-hk.png
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

Hide branch names-regroup person profile.png
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.

Hide branch names-fag.png

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
  • No TNGv13 syntax or functional changes
  • Uses the Mod Settings Blocks mod rather than shared files.
  • Added French translations by Katryne Chauvigné-Bourlaud
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 - see Regroup Person-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 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