Same Person Link
|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.|
Media:same_person_link_v188.8.131.52_french.zip French Language file
|Download stats||View download counts|
View Multi-Tree mods statistics
with help from Mike Bluett, Bart Degryse, and Roger Moffat
|Homepage||Same Person Link (this page)|
|Mod Support||TNG Forums|
|Latest Mod||184.108.40.206 for TNG V9.1|
|Min TNG V||9.1.0|
|Max TNG V||9.1.1|
Requires creation of the Cross Tree table
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.
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.
Mod developer is Ken Roy with extensive help from
- Mike Bluett to debug the AJAX dialogs,
- Bart Degryse to get the Cross Tree 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
|V220.127.116.11||22 January 2013||
|V18.104.22.168||15 January 2013||
|V22.214.171.124||14 January 2013||Initial beta test release of the mod for TNG 9.1|
|V126.96.36.199||15 December 2012||Initial test version of the mod for TNG 9.1 was never released|
|V188.8.131.52||5 October 2012||Initial test version of the mod was never released|
|V184.108.40.206||6 June 2012||Initial version of the mod was never released since you had to manually create the table entries|
- Download the appropriate mod version from the status box above.
- Extract the zip file into your /mods folder (unzip the .zip file and upload the cross_tree_link_v9.x.x.x.cfg file and the cross_tree_links folder to your site's /mods folder.)
- Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files
Upgrade to new version
- Remove the existing cross_tree_link.cfg
- Install the new version of the mod using the Automated Install procedure
| 1. Using Admin >> Setup >> General Settings >> Table Names,
| 2. If you want the Same Person Links on your own site to open in a new window
There are some actions required for updating from the previous Cross Tree Link mod, either v220.127.116.11 or v18.104.22.168, 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 /> ID'; $admtext['samepersonhdrtreeid'] = 'Tree<br /> ID'; $admtext['samepersonextnote'] = 'External Link Note'; $text['sameperson'] = 'Same Person 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:v22.214.171.124% %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 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 to'; $text['samepersonis'] = ''; $text['samepersonat'] = ' on the following web site '; %end:%
The resulting display after installing the override mod would then be
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.
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.
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
| If you click the box to Create as an external link to another site you must enter the
Same Person Link List
When you click Save, the Same Person Links list will be displayed.
Edit Same Person Link
You can Edit the Same Person Link
Delete Same Person Link
or delete an existing link.
You can use the People Search to find candidates that can be cross linked across trees.
Shown with the Tree ID Mod installed
A people search will also reveal merge candidates
TNG User sites using this mod
If you download and install this mod, please add TNG site to the table below
|Our Acadian, French-Canadian, and Maine Ancestors||Ken Roy||Installed on a test site only||V126.96.36.199||TNG 9.1.0||EN, FR|
|Clan Moffat Genealogy Online||Roger Moffat||Sample Page http://genealogy.clanmoffat.org/getperson.php?personID=I77080&tree=ClanMoffat||V188.8.131.52||TNG 9.1.0||EN|
|Mitchell Families Online||Roger Mitchell||Sample page not available (Living Persons)||V184.108.40.206||TNG 9.1.0||EN|
Same Person Link Examples
- Marie Boucquenier in my primary tree - Antoine Roy
- Marie Boucquenier in Monsieur Pierre Le Clercq's tree Roys_in_France
TNG Modules Impacted
The following TNG Modules are modified, and should be backed up prior to installing this mod:
- your languages cust_text.php file(s)
The following modules are added by this mod: