Difference between revisions of "Regroup Person-Hide Branches"

From TNG_Wiki
Jump to navigation Jump to search
(updated for feedback on beta version)
Line 89: Line 89:
 
|}
 
|}
  
== Mod Change History ==
+
== Revision History ==
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
|-
 
|-

Revision as of 17:43, 2 January 2018

Construction The article below describes a complete, tested mod.

This mod also has a new "beta" version:10.0.0.4a that can be downloaded here: hide_branch_names_v10.0.0.4a.zip

Beta version appears to work fine on TNG 11.1 --KenRoy (talk) 16:10, 14 April 2017 (CDT)

Here's what the new version does:

  1. Uses Show Mod Names v2

I've been using the new version for a while, but

  • It needs to be tested on other TNG sites,
  • I haven't completed the description below, and
  • I haven't created the visualizations this article needs

In truth, I have over 40 new and updated mods in this state, and I'd appreciate whatever help that anyone can offer. So it would be great if you could download the mod, test it, and let me know how it works for you. And if you're up for it, screenshots from before the mod was installed and after (annotated or not) would be a great help. Just email any updates to me. My email username is 'mail, and my email domain is robinrichmond.com.

Thanks in advance. Robin Richmond 18:43, 13 April 2017 (CDT)

Construction


Hide Branch Names
Summary On the Person Profile, hides branch names unless the user is an administrator or has a branch restriction, in which case, only matching branches are shown.
Validation
Mod Updated {{{mod_last_update}}}
Download link For
TNG 10.0
(mod)_v10.0.0.4.zip
Download stats
Author(s) Robin Richmond
Homepage Robin Richmond's Genealogy Database
Mod Support My Mod Support form or TNG Community Forums
Contact Developer My Mod Support form
Latest Mod 10.0.0.4
Min TNG V 10.0
Max TNG V 10.1.3
Files modified
getperson.php
Related Mods
Notes


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 restriction never see any branch assignments.
  3. If the mod parameter is true, then logged-in users who have a branch restriction see branch assignments for their branch only. That is,
    • If an Individual has 3 branches, including the one assigned to the current user, only the user's branch would be shown.
    • If an Individual has one or more branches, bot not the one assigned to the current user, no branches branches would be shown.

Mod Parameters

The one parameter allows logged-in users with a branch assignment to see their branch name, for Indivduals in their branch. When the parameter is false, only administrators will see any branch names in the person profile.

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

  1. This mod uses the mod registration and display features as defined by Show Mod Names. If you have not installed Show Mod Names, you won't see any effect, but if you have installed Show Mod Names, the names of all mods that use this feature will be shown at the bottom of the Person Profile.
  2. Show Branch Members doesn't have a dependent relationship with this mod, but it also affects the display of branch names in the Person Profile. It turns whatever branch names are displayed into hyperlinks that show a list of the branch's members.

Installation

  1. Remove previous version of this mod.
  2. Backup the getperson.php, the only file affected by this mod.
  3. Download the .zip file, and extract its .cfg file to your mods folder.
  4. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files.

In the event of a problem

  1. Try using the Mod Manager Remove capability
  2. Contact me through My Mod Support form.

Visualization of this Mod

BEFORE:

Note the circled branch name, visible to anyone who can see the person's name.

Hide branch names-before.png
AFTER:

The branch name is now invisible to non-administrators and to users not restricted by a matching branch.

Hide branch names-after.png
AFTER: If you have installed Show Mod Names, this mod will join other compliant mods in a list at the bottom of the page.
Person profile modlist.png

Revision History

Mod Version TNG Versions Date Note
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
Robin Richmond's Genealogy Database (not installed) Robin Richmond Mod developer 10.0.0.4 10.1.3 English
DJCM.DK Claus Martinussen Public Site 10.0.0.4 11.1 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