Sort User List

From TNG_Wiki
Jump to navigation Jump to search
Sort User List
Summary Sorts the User List displayed in Admin by tree, then branch, then user name
Validation Admin n/a
Mod Updated {{{mod_last_update}}}
Download link for
TNG 10.0
TNG 9.0
TNG 8.0
for Tree/Role/Branch sort
for Tree/Branch sort
Download stats View V10 Download Stats
Author(s) Alan D Craxford
Homepage Sort User List (This page)
Mod Support TNG Community 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 10.0.0
Files modified
Related Mods

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.


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

Renamed from Sort Registered User List by Ken Roy for TNG V10. Created V10.0.0.0 of the mod so the name matches the wiki article name. The code remains the same as v8.1.1


  • A working TNG 8.1 installation


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


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.
Sort User installed v8.1.0.jpg


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

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
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 ... 10.0.0 EN, FR
Total Family History Scott Bennett Private Site (For right now) V TNG 10.0.1 EN
Roots & Relatives Remembered Ron Krzmarzick Quasi-Public 11.0.1 (modified to fix 'last login' sort) EN