Associate names

Associate Names
Summary	Associating surnames with each other to facilitate searches
Validation
Mod Updated	30 Jul 2023
Download link	for TNG 12.0 TNG 13.0 TNG 14.0 v12.3.0.4a
Download stats	Show Michel's statistics
Author(s)	Michel Kirsch
Homepage	Racines luxo-hennuyeres
Mod Support	TNG Community Forums
Contact Developer
Latest Mod	v12.3.0.4a for TNG v12 & 13 & 14
Min TNG V	v12+
Max TNG V	14+
Files modified	admin_setup.php famsearchform.php genlib.php languages/English-UTF8/cust_text.php languages/English/cust_text.php languages/French-UTF8/cust_text.php languages/French/cust_text.php search.php searchform.php searchlib.php
Related Mods	mk parameters links
Notes

Note

From version 3, this Mod is compatible with TNG v14.0
New in version 4 :
- Adding a new person to your genealogy will automatically update the field 'assocname' for this person.
- Now your associations are saved in a text file, so your they can be restored after a new gedcom import.
It is of the highest importance that you go at least once to the admin_assocnames.php page (via the ad-hock button in the mod manager)
to allow the automatic creation of the text file for the first time. There is no need to save something. Opening the page creates automatically the text file.
The text file is stored in your extensions folder : associated_names.txt. It will be copied (associated_names.bak.txt) then updated each time you save your associations.
DO NOT rename or move this file, or you won't be able to restore your associations!
Restoring the associations can be done by clicking on the dedicated button on the same page or via the post_importation tools (Admin >> Import/Export)

Purpose of the Mod

This mod allows family names to be associated with a reference family name, so that a search on the reference name or on one of the associated names will give a result for all the associated family names.
For example, if you associate the names 'le Roy', Roy and King with the reference name "DuRoy", a search on the surname Roy will return all the 'le Roy', Roy, King and DuRoy from your database.
When viewing a person who belongs to a list of associated names, the associated names can be displayed (parameter). Each associated name is clickable separately and gives you the list concerning this name.
Support EN/FR/NL languages.

Development

Author : Michel Kirsch from Charleroi-Hainaut-Belgium

With thanks

to Katryne and Jean-Louis for their testing and patience.
to [DeepL] and Rob for some translations.

Requirements

• A working TNG installation.
• A backup of all affected files (see the list in the summary in the upper right corner of the page)
• An installed current version of the Mod Manager.

TNG Modules Impacted

You can click on the [Expand] link on the right to display the list of TNG Modules change and the [Collapse] link to hide this section again.

The following TNG Modules are modified, and should be backed up prior to installing this mod:

admin_setup.php
famsearchform.php
genlib.php
languages/English-UTF8/cust_text.php
languages/English/cust_text.php
languages/French-UTF8/cust_text.php
languages/French/cust_text.php
search.php
searchform.php
searchlib.php

Files created/copied by this Mod

Source	Destination
associate_names/admin_assocnames.php	TNG root/admin_assocnames.php
associate_names/assoc_names.gif	TNG root/img/assoc_names.gif

Installation

1. Download the appropriate zip file as shown in the mod summary in the upper right corner of the page.
2. Extract the file from the downloaded zip file into the mods folder or FTP the extracted 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 mod.

In the event of a problem

• Try using the Mod Manager Remove capability
• Copy the backup of the affected files back to your TNG directory
• Contact us through the TNG Community Forums or on the page of Michel Kirsch. At worst, send a mail to

Upgrade

• Uninstall and eventually Delete the current Mod.
• Proceed as for an installation with the new Mod.
• Your existing names associations will not be affected.

Uninstalling the mod

If you want to completely Remove (uninstall) this mod and all its tables, you should

1. The COMPLETE uninstallation requires the destruction of the 'assocname' field of the tng_people table.
   A button is provided in the Mod Manager. It must be used BEFORE uninstalling the Mod.
2. click the Uninstall button to uninstall the mod
3. click the Delete button to delete the config file from the mods folder.

Revision History

Mod Version	Date	Contents
12.3.0.4a	30 Jul 2023	Compatible with the Create Site Map Mod.
12.3.0.4	05 Jun 2023	Add admin_login condition - When a new person is added, hes assocname is automatically filled in - Each time you save your associations, a text file is updated (READ the note in front of this page !!),so your associations can be restored after a new gedcom import.
12.3.0.3	02 Oct 2022	Ready TNG 14. the double-click on an item in the lists was no longer supported by TNG 14.
12.3.0.2k	06 Apr 2022	Update the assocname field for a new person if needed Danish translations by Hanne.
12.3.0.2j	08 Jan 2022	Fix 2 PHP8 Warnings Ready to work with a future version of the Optional Person Rows Mod
12.3.0.2h	08 Aug 2021	The link in Admin >> Setup is no more activated by this Mod. Use the new mk parameters links Mod
12.3.0.2g	24 May 2021	Improve menu in admin_menu if Sosa and/or Menu_manager Mods are installed.
12.3.0.2f	04 Apr 2021	Modify code to avoid conflict with Simple SEO Mod.
12.3.0.2e	03 Apr 2021	The list at the beginning of the getperson.php page showed an "\" before the name. (D'\ETAIN in place of D'ETAIN).
12.3.0.2d	09 Mar 2021	With German translations (Jürgen).
12.3.0.2c	13 Feb 2021	The second name of the associated names list has a bad link (Jürgen).
12.3.0.2b	03 Feb 2021	Fixed another problem with apostrophe - The name of the current person is now in front of the associated names list - Modification at the option's text.
12.3.0.2	08 Dec 2020	The names associated with the current name can be displayed on getperson.php, in or above the form.
12.3.0.1b	12 Aug 2020	The lists are now multi select. You can add/remove more than one name at a time.
12.3.0.1a	10 Aug 2020	Fix problem with mysqli_fetch_all command (ISP have not installed mysqlnd module) Fix problems with names containing apostrophes.
12.3.0.1	07 Aug 2020	First online version.

Visualization and functioning

Access the Name Association menu. The name association interface is accessed through Admin >> Mod Manager >> Associate Names button

The name association screen.
To associate names with each other, first choose a 'Reference Name' from the list of your names.
Then, associate to this 'Reference Name' the names you choose from the list on the left.
Double-click on the chosen name or select it and move it to the list on the right using the 'right' arrow. To remove a name from the list on the right, double-click on it or select it
and move it back to the list on the left using the 'left' arrow.

A checkbox (checked by default) is added.
You can leave the box checked, even for a search on surnames that are not associated.
The only search for which you have to uncheck the box will be a search on a surname associated with others and
for which you want results ONLY on this surname, and not on the surnames associated with it.

A new option "Associated Names" is present in the dropdown menu search options for Last Names (Advanced Search for People).
Choose this option to search on all surnames associated with the one you are searching for.

A new option "Associated Names" is present in the dropdown menu search option for Last Names (Search Families).
Choose this option to search on all surnames associated with the one you are searching for.

by parameter, you can choose to display the names associated with the current name. Above the form...

... or in the form, as field. Each associated name is clickable and lead to the result of a search on this name alone.

Sites using this mod

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

URL	User	Note	Mod-Version	TNG-Version	User-language
Racines luxo-hennuyeres	Michel Kirsch	Mod's Developper	12.3.0.2k	13.1.2	FR/EN/NL/D/SP
Racine d'Alsace	J-Louis Valory	Private - T17 customized	12.3.0.1b	12.3	FR
The Severijns / Timmer Familytree	Rob Severijns	Public / Private	12.3.0.4a	14.0.3	NL, EN
GénéaKat	Katryne	Public & Private	12.3.0.4a	14.0.3	FR/EN
Baza danych Rodziny Jarocińskich	Michał Jarociński	Non-public site	12.3.0.2a	13.0.1	PL, EN
Genealogische Datenbank	JPB	Public site	see here	see here	DE, EN, FR
Stegemüller Family History	Hanne B. Stegemüller	Public site	12.3.0.3	14.0	EN, DE, DA
Racine d'Alsace	J-Louis Valory	Public (registration)	12.3.0.2g	13.0.3	FR
Les Lapierre d'Amérique	Normand Lapierre	Public/Private	12.3.0.2h	3.0.4	FR/EN
MOTYER Family Genealogy	John Mark Motyer	Public site	See here	See here	EN
Kielakowie.com	Janusz Kielak	Public site	12.3.0.3	14.0.1	PL, EN, DE
Drzewo.online	Marcin Senderski	Private	12.3.0.3	14.0.1	PL, EN, FR, DK
Harnett Sheehan Families	Kathy Harnett Sheehan	Private/Very helpful mod!	14.0.1.11a	14.0.2	EN
Halleux Family Test Site	Jean-Luc Halleux	test site	12.3.0.4	14.0.2	FR,NL,PT,EN,ES
Auf den Spuren meiner Ahnen	Michael Klein	Public/Private site	12​.3​.0​.4a	TNG 14.0.3	EN, DE