Sosa

From TNG_Wiki
Jump to: navigation, search
Caution The latest version of this mod conflicts with the Census Plus International mod such that the Census Plus International mod now gets several PHP errors if you install the latest version of the Sosa mod. This was not the case on earlier versions of the Sosa mod which had been tested with the Census Plus International mod. KenRoy (talk) 17:10, 17 July 2019 (CDT)--

An updated version of the Census Plus International mod that fixes the issues caused by the latest Sosa mod is currently in beta test KenRoy (talk) 09:12, 19 July 2019 (CDT)--

Caution


Sosa
Summary Marks graphically the ancestors of the root of a tree.
Validation
Mod Updated 30 Jun 2019
Download link for
TNG 12.0

Sosa v12.0.2.2 Rev 3
Download stats
Author(s) Michel Kirsch
Homepage Luxemburg & Hainaut Roots
Mod Support TNG Community Forums
Contact Developer MyMail
Latest Mod 12.0.2.2 Rev 3 - ATTENTION! Delete sosa table at uninstall of earlier version for TNG v12
Min TNG V n.c
Max TNG V 12+
Files modified

admin​_backup​.php
admin​_families​.php
admin​_optimize​.php
admin​_people​.php
admin​_restore​.php
admin​_utilities​.php
customconfig​.php
descend​.php
descendtext​.php
desctracker​.php
familychart​.php
familygroup​.php
genlib​.php
getperson​.php
register​.php
search​.php
Related Mods
Notes



Purpose of the Mod

This Mod allows the administrator to designate the root of his tree (SOSA No. 1).
Then the users can trace the lineage of your SOSA 1 through all forms of TNG.
The ancestors of the SOSA 1 are then identified by a green ball and by their SOSA number.
The Mod also gives you a list of all SOSA over 31/63 generations. The next generations are also treated but receive no sosa (sosa > 2.10**9/2.10**18 !)
It is provided with a mini mod which modifiy the "Add Person Siblings Row" mod if you have installed it.

It is based on Sosa-Stradonitz's numbering, also called Eizinger's method or Ahnentafel numbering

Many thanks to

Ron, Ken, Scott for the testing, the ideas and the comments about this first version !
Bart for the code to delete the table before uninstall !
Google for some translations...

Development

Written by : MichelKirsch from Charleroi - Hainaut - Belgium

Requirements

A TNG 12.0.2 installation in working order.
This Mod works perfectly with Mods Open Street Map, Add Person Siblings Row, Show Siblings, Living Color, Research Tools and many others as I seen by Ron (80+ mods installed !)
It is possible that it works with earlier versions of TNG,
but the tests haven't been done. If someone tries, let me know the result.
Thank you.

IMPORTANT : Before installing

Before installing, it is important to make a backup copy of the following files (they will be modified by this mod):
By alphabetical order :

admin_backup.php
admin_families.php
admin_optimize.php
admin_people.php
admin_restore.php
admin_utilities.php
ahnentafel.php
customconfig.php
descend.php
descendtext.php
desctracker.php
extrastree.php
familychart.php
familygroup.php
genlib.php
getperson.php
languages/Dutch/cust_text.php
languages/Dutch-UTF8/cust_text.php
languages/English/cust_text.php
languages/English-UTF8/cust_text.php
languages/French/cust_text.php
languages/French-UTF8/cust_text.php
languages/German/cust_text.php
languages/German-UTF8/cust_text.php
languages/Spanish/cust_text.php
languages/Spanish-UTF8/cust_text.php
pedigreetext.php
register.php
search.php
verticalchart.php

INSTALLATION

Unzip the received file into a "sosa" directory directly in the "mods" sub directory of your TNG installation.
You do not have to create the table manually. It is created automatically at the first execution.
On the other hand for the uninstall, it is necessary to follow the instructions in order to erase
the table sosa (tng_sosa) become useless.

drop table button


Upgrade

When upgrading to a higher version.

  • Uninstall and "delete" the current Mod. It is not necessary to delete your table sosa_tng, EXCEPT if it is expressly explained in the release notes!
  • Proceed as for an installation with the new Mod

Mod Compatibility

There is currently a known Sosa v12.0.2.2 rev3 compatibility issue with the Census Plus International mod version v12.0.0.10. Census Plus International v12.0.0.10a that fixes the issues caused by the Sosa v12.0.2.2 rev3 mod is now in beta test.

In the event of a problem

  • Try using the Mod Manager Remove capability
  • Open an issue in the TNG Community Forums
  • Copy the backup of the affected files back to your TNG directory

Revision History

Version Release Date Contents
V12.0.2.2-3 29 june 2019 Optimize for 64 bits systems - The old table sosa must be deleted at uninstall of earlier version - Variables to change colours of sosa list - Marks parents in getperson.php - Marks child having a sosa in the siblings of current person (Show Siblings installed)- Choice between fake sosa(= -1) or negative sosa when trespassing PHP_INT_MAX limit
V12.0.2.2-2 20 june 2019 Upgrade for 64 bits systems - The old table sosa must be deleted at uninstall of earlier version - New algorithm to compute sosa - Sosa Icon
V12.0.2.2-1 16 june 2019 Sosa list before the TNG Menu. Big sosa list (must be open in a new tab)
V12.0.2.2 14 june 2019 Some changes of behaviour / layout. Version number visible on sosa menu
V12.0.2.1 23 may 2019 Original version.

Sites using this mod

If you download and install this mod, please add your TNG site to the table below: If you have a problem to do it, sebd me a mail...

URL User Note Mod-Version TNG-Version User-language
Racines luxo-hennuyeres Michel Kirsch Developper of the Mod 12.0.2.2 Rev 2 12.0.2 FR / EN / NL / (D)
Roots & Relatives Remembered Ron Krzmarzick Public & Private (modified) 12.0.2.2 R4 See Here EN,DE,CS,ES
Racine d'Alsace J-Louis Valory Public- private - T17 customized 12.0.2.2 12.1 FR

Snapshots

Here are some snapshots of the modified screens (there are 16 screens modified by Sosa) :

EN - Explanations Image
Main page (getperson.php)

A green ball indicates that this person is in the lineage. His sosa number is revealed by passing the mouse over the green ball.
The spouse and descendant in the lineage are marked with a green ball as well.
A new menu appears in the menu bar. It offers the following options:
For all: Go directly to sosa N° 1 [Goto Sosa 1] and list of sosas [List Sosa]
For the administrator of the site: possibility of designating the current person as sosa N ° 1 [Make him (her) sosa 1]
If you have several trees, you can designate several sosas N¨1 (one per tree).

Sosa Menu
Sample list of sosa:

The list starts at sosa 1 (generation 0) until the 31st generation.(Next generations are not numbered)
The list includes: the generation, sosa number, full name, ID of the person with him (her) possible multiple sosas
The common person is highlighted in clear in the list.
People with multiple sosas are highlighted in blue.

Sosa List
The same list with some multiple sosas.
Sosa List with Implex
All the reports of descent are provided with their sosa marker (the green bullet)next to people of the lineage, possibly with their multiple sosa

Here's an example with implex (multiple sosas) to A-A-grandparents.

Descend Compact
Here's the descend tree in text mode (descend.php)
Descend Text
The sosa marker is also present in the search results...
Search Result
... and in every others graphical representations of your tree (here in desctracker.php)
arbre sosa