Associate names

From TNG_Wiki
Revision as of 14:19, 7 September 2020 by MichelKirsch (talk | contribs) (Created page with "{{restricted}} {{V12_cust_text}} {{Languages|Associate_Names}} {{TNGmod | mod_name = Associate Names | mod_summary = Associating surnames with each other to facil...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Restricted Downloads of Associate names are restricted to logged in users. If you do not have a user account on the TNG Wiki use the Request Account link to request a user account Restricted
Caution If you have trouble downloading with Google Chrome, Vivaldi, Brave or other Chromium based browser, try using a right-click and select Open in new Window, then F5, or use another browser such as Firefox


Caution



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



Associate Names
Summary Associating surnames with each other to facilitate searches
Validation
Mod Updated 12 Aug 2020
Download link Associate Names v12.3.0.1b
Download stats Show Michel's statistics
Author(s) Michel Kirsch
Homepage Racines luxo-hennuyeres
Mod Support TNG Community Forums
Contact Developer MyMail
Latest Mod v12.3.0.1b for TNG v12
Min TNG V n.c
Max TNG V v12+
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
Notes



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.
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 TNG v12.3.0 installation in working order.


IMPORTANT : Before installing

Before installing, it is judicious to make a backup copy of the files that will be modified by this mod.

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

  • Unzip the received file directly in the "mods" sub directory of your TNG installation.
  • Via Mod Manager, install the Mod.


UNINSTALLATION

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.

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.

Known Problems

None at this day...

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
  • Retry. If the problem persists, open an issue in the TNG Community Forums or on the page of Michel Kirsch. At worst, send a mail to MyMail

Historic of modifications

Version Release Date Contents
v12.3.0.1b 12 Aug 2020 The lists are now multi select. You can add/remove more than one name at a time.
v12.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.
v12.3.0.1 07 Aug 2020 First online version.

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 v12.3.0.1 v12.3.0 FR/EN/NL/D/SP
Lignées revestoises Katryne v12.3.0.1a v12.3.0 FR/EN/D/IT
Genealogy of a Dutch East-Indies Family Rob Severijns Private V12.0.2.3a V12.3 NL/EN

Visualization and functionning


Access the Name Association menu.
The name association interface is accessed through Admin >> Setup >> Associate Names
access


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.

access


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.
access


A new option "Associated Names" is present in the search options.
Choose this option to search on all surnames associated with the one you are searching for.

access


A new option "Associated Names" is present in the search options.
Choose this option to search on all surnames associated with the one you are searching for.

access