Sosa

From TNG_Wiki
Jump to navigation Jump to search


Ambox notice.png The latest version of this mod uses the guidelines for TNG v12+ cust_text.php files. If you are using TNGv12+, and any cust_text.php file in this mod is marked with a Bad Target error, you need to update your cust_text.php files before you can install this mod. [Show instructions]

If you upgraded to TNGv12+, and did not update your cust_text.php files as instructed in the upgrade readme script, then you must use the TNG Mod Manager to update them. To do so:

  1. Go to Mod Manager, and select its "Recommended Updates" tab.
    (If the "Recommended Updates" tab is not visible, then go to the Mod Manager Options tab, select "Display Settings", and turn on the "Recommended Updates" tab.)
  2. Click the "Update" button in the "Recommended Updates" tab.
    Installed mods do not interfere with the update, and if you already have (or think you may have) run this update, it will not hurt for you to run it again.

[See details in the TNGv12 Change Impacts Article][Hide the instructions]

TNG 14.0
TNG 13.0
TNG 12.0


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

Sosa v12.0.2.6
Download stats Show statistics
Author(s) Michel Kirsch
Homepage Racines luxo-hennuyeres
Mod Support TNG Community Forums
Contact Developer MyMail
Latest Mod 12.0.2.6 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
ahnentafel.php
customconfig.php
descend.php
descendtext.php
desctracker.php
extrastree.php
familychart.php
familygroup.php
genlib.php
getperson.php
pedigree.php

pedigreetext.php
register.php
search.php
templates/template10/index.php
verticalchart.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. When hover the mouse on it, show the generartion and sosa numbers.
The Mod also gives you a list of all SOSA

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

Many thanks to

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

Development

Written by : MichelKirsch from Charleroi - Hainaut - Belgium

Requirements

To avoid conflicts :
Installing this mod require the updating of the Balanced Media mod to the [Balanced Media]] version 12.0.0.2]


TNG version: 12.0.2

A TNG 12.0.2+ installation in working order.
This Mod works perfectly with Mods

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

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 fixes the PHP 7.1 issues caused by the Sosa v12.0.2.2 rev3 mod
  • If you are using the Balanced Media mod, you will need to upgrade to V12.0.0.2 in order to install Sosa v12.0.3.3

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 sosa table and the sosa_vars file 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

When upgrading to v12.0.2.5

  • WARNING!! before installing this version, you must delete or rename the file sosa_vars.php in the extensions folder of your TNG installation, in order to benefit from the new features.

Known problems

Large databases with many multiple sosa (many marriages between cousins) can result in a MySQL timeout when designating sosa 1. increase the limits on the server. Contact me.

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.6 10 oct 2019 Many minor code changes.

Visual:

  • Add a special sosa marker for implexes (multiple sosas). This marker is present even if you choose not to mark ALL ancestors.
  • Added sosa marker in descend.php, ahnentafel.php, extrastree.php and register.php. The sosa info is available in fan.php (ascending wheel).
  • Adding the sosa marker to the search result.
  • You can choose another menu form than the TNG button. Set the "Display full sosa menu" parameter on "No".

Comfort :

  • Easier parameter editing thanks to a dedicated page. In the Mod Manager, use the "Easy edit - Edition facile" button instead of the "Edit" button of the Mod Manager. This function is also accessible from the "Configurations" menu in the Administration section. A complete help file is available from the parameter editing page.
  • Automatic update of the preserved variables file

IMPORTANT

  • If you have many multiple sosa, the display of the sosa list is truncated after 256 characters. YOU MUST delete or rename your sosa table (tng_sosa). To rename it, you can use the parameters editor after installation. After deletion or renaming, you must redefine your sosa 1!
  • If you are using a 32-bit system, go to the settings page and change "Number of bits..." from 64 to 32.
V12.0.2.5 10 sept 2019 TNG compliance of the sosa list (display of names, colors, fixed titles, stripes every x lines).
Ability to choose the display of Degree of relationship or Generation (or both, or none) in the sosa list and in the sosa marker.

WARNING!! if you make an upgrade of a version below v12.0.2.4d, before installing this version, you must delete or rename the file sosa_vars.php in the extensions folder of your TNG installation, in order to benefit from the new features.

V12.0.2.4a 23 aug 2019 Introducing of a parallel between generation and degree of relationship.
V12.0.2.4 20 aug 2019 Code and philosophy of the program are changed to permits a better integration into TNG and another existing. Details of new functionnality are to be found into the sosa vxxx.cfg file.
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.5 12.0.2 FR/EN/NL/D/SP
Roots & Relatives Remembered Ron Krzmarzick Public & Private 12.0.2.4a See Here EN,DE,CS,ES
Racine d'Alsace J-Louis Valory Public- private - T17 customized 12.0.2.5 12.1 FR
Our Roy and Boucher Family Ken Roy Beta tested v12.0.2.4 and some earlier versions. Site Link goes to Family Chart of Sosa No 1 12.0.2.6 12.2 EN, FR
Surfing the Genetic Pool Andrew DuPree Using parts of the mod 12.0.2.4a 12.x EN
The St John genealogy Suzanne St. John 12.0.2.4 12.x EN
Genealogie der Familie Treichel aus Berlin Andreas Treichel 12.0.2.4 12.1 DE/EN/FR/SP
Ahnenforschung und Familienchronik LANDROCK-Family Thomas Landrock 12.0.2.5 12.0.2 D
genealogy pages of Anne Hegland and Kåre Kjøllesdal Kåre Kjøllesdal 12.0.2.5 12.2 EN/NOR
Histoires de famille - Ma tribu Catherine Cadel 12.0.2.5h 12.2 FR/EN/SP/IT/P

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. If you use already a custom menu, sosa menu is placed beyond.
The menu can be dispalyed in 3 different ways, depending of your working environment. It offers the following options:
For all: Go directly to sosa N° 1 [Go to Sosa 1], list of sosas [Sosas List], the same to be open in a new tab, and access to a web site about sosa numbering
For the administrator of the site: possibility of designating the current person as sosa N ° 1 [Designate as sosa 1]
If you have several trees, you can designate one sosas N¨1 per tree.

Sosa Menu
Sample list of sosa:

The list starts at sosa 1 (generation 0) until the end of your lineage
The list includes: the generation, sosa number, full name, ID of the person with him (her) possible multiple sosas
The current person and people with multiple sosa numbers are highlighted (colour choice in parameters).

Sosa List
The same list with some multiple sosas. All colours can be modified in mod's parameters.
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