Same Person Link

From TNG_Wiki
Revision as of 07:14, 2 May 2014 by KenRoy (talk | contribs) (update to remove hard-code tree table name and for MySQL 5.5)
Jump to navigation Jump to search
Ambox notice.png The Same Person Link mod is only available to TNG 9.1 and above environments, due to the change in the javascript framework.
There are no intentions of ever attempting to link media between trees.
The mod requires that you create the TNG Same Person Link table (tng_sameperson) after installation before you can add same person links between two or more trees on your site, or an external link to the same person on a cousin's TNG site or an external link to another web site that contains information on the person.
TNG 10.0
TNG 9.1


Same Person Link
Summary Adds a Same Person Link row to the Personal Information section of the Individual page (getperson.php)
Validation Mod is XHTML compliant.Valid-xhtml10.png
Mod Updated {{{mod_last_update}}}
Download link for
TNG 10.0
same_person_link_v10.0.0.1.zip
Language files are same as V9
for
TNG 9.1
same_person_link_v9.1.0.6.zip
French Language file
Dutch Language file
German Language file
Portuguese Language file
Download stats View download counts
View Multi-Tree mods statistics
Author(s) Ken Roy
with help from Mike Bluett, Bart Degryse, and Roger Moffat
Homepage Same Person Link (this page)
Mod Support TNG Forums
Contact Developer Ken Roy
Latest Mod 10.0.0.1 for TNG V10
9.1.0.6 for TNG V9.1-v9.2.2
Min TNG V 9.1.0
Max TNG V 10.0.2
Files modified
Related Mods
Notes
Requires creation of the Same Person Link table


Introduction

Since TNG does not support merging individuals from on tree into another tree, the Same Person Link mod was developed to show the connections. A Same Person Link is a record that shows two people as the same person:

  • in a different tree on the same TNG site - in this case the reciprocal link will be automatically displayed when viewing the person in the other tree
  • on a different TNG web site
  • or on a different non-TNG web site.

External site links are not restricted to TNG sites only but can be created to any other web site that contains information on the person.

Same Person Links

You can create Same Person Links to

  • a personID in another tree on your own web site
  • a person on another web site

When linking to a personID in another tree on your own web site, the easiest way to find the needed personIDs is to use the Find Person dialog within the Same Person Link dialogs. You can also use the Search People dialog. To make it easier to find the needed information, you might want to install the Tree ID Mod which adds the treeID to the search results.

Restrictions

Note that when creating Same Person Links to another tree on your site, there is only one record created in the database table. You can only edit Same Person Links between two people from the Source person, but not from the Target person. If you are editing the person a Same Person Link points to you will not be able to edit that link from that Target person.

For example, Person 1, Tree 1 is linked to Person 2, Tree 2. The link was set up from person 1's page and the link details are obtainable by clicking on the "same person link" (which is highlighted by a green dot). Now, if we go to the corresponding Person 2 page, no link is indicated.

Therefore you should probably create your Same Person Links from the same tree so as to not get confused.

If you have the same person in multiple trees on your site, it will require that you create multiple Same Person Links as well as create them from tree 2 pointing to the same person in tree 3, 4, etc.


Developer

Mod developer is Ken Roy with extensive help from

Mike Bluett to debug the AJAX dialogs,
Bart Degryse to get the Same Person Link table changes borrowed his Persistent Bookmarks mod working correctly,
Several beta testers, especially Roger Moffat who updated the Help screen, tweaked the External Link display sentence, and helped convert the mod to Same Person Link to better describe its functionality
Danish translations provided by Mogens C. Fenger
German and Portuguese translations provided by Carlos A. Heuser

Revision History

Version Date Contents
V10.0.0.1 28 April 2014 Updated to remove the hard-code tng_trees table and to provide values for Not Null fields required by MySQL 5.5

Changes were provided by Ian Fettes

V10.0.0.0 6 February 2014 Updated for TNG V10 table layout change in Admin >> Setup >> General Settings
V9.1.0.6 26 January 2013 Fix problem where mysql_free_result was not within the if statement checking for Living or Private on Living and Private pages when not logged in
V9.1.0.5 25 January 2013
  • renamed the mod to Same Person Link
  • fixed the Edit dialog to update the Same Person Link Tree ID and Same Person Link Tree Name fields in the database and in the Same Person Link list dialog
  • added Help file to the zip file package, includes extensive re-write of the help file by Roger Moffat
  • increased the size of the Same Person Link Name field
  • added 2 new fields to support External site links to other than TNG sites - External Tree Name (optional) and External Site Name
  • changed the URL to be the complete URL. For an external TNG site this includes the getperson.php?personID= and tree= to position directly to the person
  • increased the size of the Same Person Link Note field
V9.1.0.4 15 January 2013
  • Added Edit parameter to control whether Same Person Links open in a separate window (defaults to No)
  • Fixed Add Same Person Links dialog so that the TreeID and Treename for the first tree in the pull down list is already primed
V9.1.0.3 14 January 2013 Initial beta test release of the mod for TNG 9.1
V9.1.0.2 15 December 2012 Initial test version of the mod for TNG 9.1 was never released
V9.0.0.1 5 October 2012 Initial test version of the mod was never released
V9.0.0.0 6 June 2012 Initial version of the mod was never released since you had to manually create the table entries

Automated Install

  1. Download the appropriate mod version from the status box above.
  2. Extract the zip file into your /mods folder (unzip the .zip file and upload the same_person_link_v9.x.x.x.cfg file and the same_person_link folder to your site's /mods folder.)
  3. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files

Upgrade to new version

  1. Remove the existing same_person_link.cfg
  2. Install the new version of the mod using the Automated Install procedure


Post Installation

1. Using Admin >> Setup >> General Settings >> Table Names,
  • create the tng_sameperson table by clicking the Create button
once the Same Person Link table (tng_sameperson) is created the button is changed to Rename
Same person link table create.png
If you forget to create the Same Person Link table, when you access an individual page, you will get an error from the new same person links query added to getperson.php
Same person link table not created.png
2. If you want the Same Person Links on your own site to open in a new window
  • go to the Mod Manager and using Edit change the option from N to Y
Same person link edit options.jpg
3. You must do a force page reload after installing the mod to get the updated selectutil.js file. See Bypassing Browser Cache

Beta Testers

There are some actions required for updating from the previous Same Person Link mod, either v9.1.0.3 or v9.1.0.4, please contact the Mod Developer

Custom Text Additions

Note that config file only includes the English language changes, so if you support multiple languages you will need to modify the config file to add the custom text for those other languages.

The following custom text will be added to your English/cust_text.php file by this mod. If you are using other languages, you must add these lines to each of your language cust_text.php files with appropriate translations of course.


// Same Person Link  default localization for table maintenance
$admtext['sameperson'] = 'Same Person Link';
// Same Person Link(s) default localization
$admtext['samepersonlinks'] = 'Same Person Link(s)';
$admtext['entersamepersonID'] = "Please enter the Person ID for the same person link.";
$admtext['entersamepersontreeID'] = "Please enter the Tree ID for the same person link.";
$admtext['entersamepersontreename'] = "Please enter the Tree Name for the same person link.";
$admtext['entersamepersonwebsite'] = "Please enter the web site URL for the same person link.";
$admtext['enterabssamepersonname'] = "Please enter the Person Name for the external link.";
$admtext['enterabssamepersontreename'] = "Please enter the Tree Name for the external link.";
$admtext['enterabssamepersonsitename'] = "Please enter the Site Name for the external link.";
$admtext['enterabssamepersonwebsite'] = "Please enter the web site URL for the external link.";
$admtext['confdeletesameperson'] = "Are you sure you want to delete this same person link?";
$admtext['linkfromtree'] = 'Links from this person';
$admtext['linktype'] = 'Type';
$admtext['linktotree'] = 'Links to same person';
$admtext['samepersontree'] = 'Same Person Link(s)';
$admtext['samepersonid'] = 'Same PersonID';
$admtext['samepersontreeid'] = 'Same Person Tree ID';
$admtext['samepersontreename'] = 'Same Person Tree Name';
$admtext['samepersonwebsite'] = 'External Site URL';
$admtext['modifysamepersontree'] = 'Modify Same Person Links:';
$admtext['addnewsamepersontree'] = 'Add Same Person Links:';
$admtext['changestosamepersons'] = 'Changes to Same Person Links';
$admtext['samepersonselecttreeid'] = ' or Select Tree from list';
$admtext['findsameperson'] = 'Find person in other Tree';
$admtext['revlink'] = 'Rev';
$admtext['reverselink'] = 'Reverse Link';
$admtext['linkexternal'] = 'Create as an external link to another site';
$admtext['extsameperson'] = 'External Link';
$admtext['extlink'] = 'Ext';
$admtext['samepersonnote'] = 'Same Person Note';
$admtext['samepersonname'] = "External Person Name";
$admtext['samepersonexttreename'] = 'External Tree Name';
$admtext['samepersonsitename'] = "External Site Name";
$admtext['samepersonhdrpersonid'] = 'Person<br />&nbsp;ID';
$admtext['samepersonhdrtreeid'] = 'Tree<br />&nbsp;ID';
$admtext['samepersonextnote'] = 'External Link Note';
$text['sameperson'] = 'Same&nbsp;Person&nbsp;Link';
$text['samepersonis'] = 'This person is also ';
$text['samepersonin'] = ' in the ';
$text['samepersonmysite'] = ' tree on this site';
$text['samepersoninext'] = ' in the tree ';
$text['samepersonat'] = ' at ';

You can download the French language file for an example of how to construct the language file config file for your other languages.

Overriding Custom Text

If you would prefer that the Individual (getperson.php) page displays a different row heading and a slightly different sentence, you could install a custom mod after installing the Same Person Link mod to override some of the custom text variables. This technique eliminates the Clean Up error you get on the Mod Manager screen caused by manually changing the $text variable values. For example, the following is a sample mod that would accomplish this without having to modify the Same Person Link mod source and show both mods as installed.


%name:Same Person Link - mine%
%version:v9.1.0.5%
%description:This  mod overrides some of the text variables for the Same Person Link row  to the Personal Information section on the Individual page  (getperson.php). <br /><br />
Mod developer is Ken  Roy.  For additional details see <a  href="http://tng91beta.royandboucher.com/wiki/index.php?title=Same_Person_Link"  target="_blank">Same Person Link</a><br /><br />%

%target:languages/English/cust_text.php%
%location:%
?>
%end:%
%insert:before%
// Same Person Link - my overrides
$text['sameperson'] = 'Links&nbsp;to';
$text['samepersonis'] = '';
$text['samepersonat'] = ' on the following web site ';
%end:%

%target:languages/English-UTF8/cust_text.php%
%location:%
?>
%end:%
%insert:before%
// Same Person Link - my overrides
$text['sameperson'] = 'Links&nbsp;to';
$text['samepersonis'] = '';
$text['samepersonat'] = ' on the following web site ';
%end:%

The resulting display after installing the override mod would then be

Same person link text override.png

Visualization

Visitor

The Same Person Link mod adds a new row on the person Individual page for each same person link that is created. You can create a link to another tree on your own site, or a link to a cousin's TNG site, or to any web site that contains information on the person.

Showing both type of links

Administrator

The TNG Administrator can use the Same Person Link dialog from the Edit Person page, to add a same person link to another tree on their own site, a link to a cousin's TNG site, or a link to any other web site that contains information on the person.

Same Person Link

Add Same Person Link

When you first access the Same Person Link dialog, TNG will put you in the Add Same Person Link dialog.

The default is to automatically create a record that provides the reciprocal link from the other tree on your site back to this person, unless you check the box to Create as an external link to another site

  • Select the Tree ID and Tree Name from the pull down selection list
Same person link select tree.png
  • click the Find icon to got to the Find Person ID and then
  • Enter the last name and first name for the person in the Find dialog boxes
  • click the link for the correct person to add the PersonID to the Same Person PersonID
Same person link select personID.png
If you click the box to Create as an external link to another site you must enter the
  • External Person Name
  • External Tree Name (optionally)
  • External Site Name
  • External Site URL, which for another TNG site needs to be the complete URL including the getperson.php?personID= and tree= parameters to position directly to the person
  • External Link Note (optionally)
Same person link external link.png

Same Person Link List

When you click Save, the Same Person Links list will be displayed.

Same Person Links list

Edit Same Person Link

You can Edit the Same Person Link

Edit an existing Same Person Link

Delete Same Person Link

or delete an existing link.

Delete an existing Same Person Link

Finding Candidates

You can use the People Search to find candidates that can be cross linked across trees.

Cross tree link candidates.png

Shown with the Tree ID Mod installed

Cross tree link search results multi-tree.png

A people search will also reveal merge candidates

Cross tree link merge candidates.png

Sites using this mod

If you download and install this mod, please add TNG site to the table below

URL User Note Mod-Version TNG-Version User-language
Our Acadian, French-Canadian, and Maine Ancestors Ken Roy Link to another tree and Link to another TNG site V10.0.0.0 TNG 10.0.0 EN, FR
Clan Moffat Genealogy Online Roger Moffat Robert Moffat links from Clan Moffat Genealogy to Clan Moffat UK V10.0.0.0 TNG 10.0.0 EN
Mitchell Families Online Roger Mitchell Sample page not available (Living Persons) V9.1.0.6 TNG 9.1.1 EN
Our Family Histories Bryan S. Larson William Draper, Jr. links from my site to GenMayle.com V10.0.0.0 TNG 10.0.0 EN
Nordic Ancestry Mogens C. Fenger Translated into Danish V10.0.0.0 TNG 10.0.0 EN, DA
Bush Family Genealogy Chuck Bush Linked my tree to my wife's tree, same webhost different domains V9.1.0.6 TNG 9.1.1 EN
Jessen Family Genealogy Chad Jessen Landmark, Gulbrand Tomasson links to a tree on Ancestry.com V9.1.0.6 TNG 9.1.1 EN
Steve's Family Tree Steve Overton Link individuals between trees as well as other TNG sites. V10.0.0.0 TNG 10.0.0 EN
Brazilian-German family trees Carlos A. Heuser Link individuals between trees as well as other TNG sites. V9.1.0.6 TNG 9.1.1 EN DE PT-BR
Kemp(e) Family History Andrew Kemp see User:Kempons see User:Kempons EN
Norwegians of Dodge & Olmsted Counties, Minnesota Sam Clark Link to another tree v9.1.0.6 TNG 9.2.2 EN, NO, DA, DE, NE
Hooley Family Links Rick Hooley login: guest pwd: guest 10.0.0.0 10.0.1 EN
... ... ... ... ... ...

Same Person Link Examples

The following are some Same Person Link examples

  • Nicolas Roy links from Antoine Roy tree to Nicolas Roy tree on same web site
  • Jacob Bourgeois links to Jacques (Jacob) Bourgeois) on another TNG User site
  • Robert Moffat links from Clan Moffat Genealogy to Clan Moffat UK tree

TNG Modules Impacted

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

  • customconfig.php
  • admin_backup.php
  • admin_optimize.php
  • admin_restore.php
  • admin_utilities.php
  • admin_genconfig.php
  • tabledefs.php
  • admin_modmanager.php
  • getperson.php
  • personlib.php
  • tngdblib.php
  • admin_editperson.php
  • ajx_editperson.php
  • eventlib_js.php
  • js/selectutils.js
  • css/genstyle.css
  • your languages cust_text.php file(s)

The following modules are added by this mod:

  • admin_addsameperson.php
  • admin_samepersonlinks.php
  • admin_deletesameperson.php
  • admin_editsameperson.php
  • admin_maketable_sameperson.php
  • admin_removetable_sameperson.php
  • admin_updatesameperson.php
  • upgrade_sameperson.php
  • languages/English/sameperson_help.php