Sort User List

Sort Registered User List
Summary	Sorts the User List displayed in Admin by tree, then branch, then user name
Validation	{{{mod_validation}}}
Mod Updated	{{{mod_last_update}}}
Download link	sort_user_list.v8.1.1.zip for Tree/Role/Branch sort sort_user_list.v8.1.0.zip for Tree/Branch sort
Download stats	{{{download_stats}}}
Author(s)	Alan D Craxford
Homepage	Sort Registered User List (This page)
Mod Support	TNG Forums
Contact Developer
Latest Mod	8.1.1 for sort by Tree/Role/Branch 8.1.0 for sort by Tree/Branch
Min TNG V	8.0.2
Max TNG V	8.1.0
Files modified	admin_users.php
Related Mods	None
Notes	None

Purpose of the mod

The list of users displayed on the Registered Users admin page is sorted by default by the user's description field. If your site has more than one tree, each of which has its own user population, or some of your users are restricted to just one branch, then this small mod may present a clearer user directory.

The list is now sorted by tree (alphabetically by tree name), then the user's function or role (Guest, Submitter etc), then branch and then username. Administrators, and others not assigned to any tree, are listed first. Then users are grouped alphabetical by tree name and their assigned function or role (if one has been given, "Guest" if not). Users assigned to a specific branch appear at the end of the tree list.

Developer

The Sort Registered User List Mod was developed by Alan D Craxford

Requirements

• A working TNG 8.1 installation

Precautions

Backup admin_users.php prior to installation

Automated Installation

1. Download the appropriate file for your TNG version from the download links in the mod summary area in the upper right.
2. Extract the downloaded zip file to your 'mods folder.
3. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install the appropriate sort_user_list.cfg file.

Side effects

1. As with most source code modifications, these changes will likely be overwritten during your next TNG revision upgrade and will need to be re-implemented.

Visualization of Mod

V8.1.0

The first version of the mod did not include the Role as part of the sort.

V8.1.0 Sort by Tree/Branch Example
The image on the right shows the sort for V8.1.0 of the mod where Role was not sorted after the Tree.

V8.1.1

The current version of the mod includes the Role as part of the sort.

V8.1.1 Sort by Tree/Role/Branch Example

A specimen site contains two trees (Smithtree and Jonestree), each with its own population of users. Members of one tree do not get access rights to the other - unless they have been added to the second tree. In this example, site administrators have not been assigned to either tree and appear at the top of the list. Smithtree has five members. The Guests are sorted alphabetically by username first, the Submitters appear next, sorted alphabetivally. Jonestree has four members. One of the Guests has been assigned to a distinct branch and is sorted behind the remaining Guest. The Submitter appears last. (A future mod might look to sort the user function by significance - Submitter before Guest - rather than alphabetically by role name.)

Username Tree Branch Role James Administrator John Administrator Barbara Smithtree Guest Sally Smithtree Guest Sidney Smithtree Guest Jean Smithtree Submitter Thomas Smithtree Submitter Bernard Jonestree Guest Vincent Jonestree Guest Alan Jonestree Mumside Guest Sean Jonestree Submitter

TNG user sites using this mod

• Please add TNG sites that you have found that utilize this modification

URL	User	Note	Mod-Version/TNG-Version	User-language
The Extended Craxford Family Geneaolgy Magazine	Alan D Craxford	Mod Developer	V8.1.1/8.1.0	D,FR,GB,PR/BR
Our Roy and Boucher Family	Ken Roy	...	V8.1.0/8.0.2	EN, FR
Kielakowie.pl	Janusz Kielak	...	V8.1.1/8.1.2.1	PL,D,GB
...	...	...	...	...