Difference between revisions of "Relationship to Site Owner Mod"

From TNG_Wiki
Jump to navigation Jump to search
(73 intermediate revisions by 14 users not shown)
Line 3: Line 3:
 
| mod_summary    = Adds a line to the getperson.php page if the person displayed is related to a single, predefined person - typically this would be the Site Owner - in the database.
 
| mod_summary    = Adds a line to the getperson.php page if the person displayed is related to a single, predefined person - typically this would be the Site Owner - in the database.
 
| mod_validation = XHTML compliant.[[Image:Valid-xhtml10.png|44px]]
 
| mod_validation = XHTML compliant.[[Image:Valid-xhtml10.png|44px]]
| download_link  = [http://lisaandroger.com/downloads/?did=26 Relationship to Site Owner Mod - TNG 10.0.0] for {{tv100}}<hr  />[http://lisaandroger.com/downloads/?did=25 Relationship to Site Owner Mod - TNG 9.2.2] for {{Tv922}}<hr  />[http://lisaandroger.com/downloads/?did=24 Relationship to Site Owner Mod - TNG 9.1.x] for {{Tv91}}
+
| download_link  = [http://lisaandroger.com/downloads/download-info/tng-11-0-relationship-to-site-owner-mod/ TNG 11.0.0.2 Relationship to Site Owner Mod] for {{Tv110}}{{Tv120}}<br /><hr  />[http://lisaandroger.com/downloads/download-info/tng-10-1-relationship-to-site-owner-mod/ TNG 10.1.0 Relationship to Site Owner Mod] for {{tv1010}}<br /><hr  />[http://lisaandroger.com/downloads/download-info/tng-10-0-relationship-to-site-owner-mod/ TNG 10.0.0 Relationship to Site Owner Mod]<br /> for {{tv100}}<br /><hr  /> [http://lisaandroger.com/downloads/download-info/tng-9-2-2-relationship-to-site-owner-mod/ TNG 9.2.2 Relationship to Site Owner Mod] for {{Tv922}}<hr  />[http://lisaandroger.com/downloads/download-info/tng-9-1-relationship-to-site-owner-mod/ TNG 9.1.x Relationship to Site Owner Mod] for {{Tv91}}
 
<br />
 
<br />
 
| mod_author      = Roger Moffat - based on relationship.php by Darrin Lythgoe as part of TNG
 
| mod_author      = Roger Moffat - based on relationship.php by Darrin Lythgoe as part of TNG
 
| mod_url        = [[Relationship to Site Owner Mod]] (This page)
 
| mod_url        = [[Relationship to Site Owner Mod]] (This page)
| mod_support    = [http://www.tngforum.us/ TNG Forums]
+
| mod_support    = [http://tng.community/ TNG Community Forums]
| mod_version    = v10.0.0.0 for TNG V10<br />v9.2.2.0 for TNG V9.2.2<br />v9.1.0.1 for TNG V9.1
+
| mod_version    = v10.1.0.0 for TNG V10.1.x and TNG V11.x.x<br />v10.0.0.0 for TNG V10.0.x<br /> v9.2.2.0 for TNG V9.2.2<br />v9.1.0.1 for TNG V9.1
 
| use_mod_manager = Yes
 
| use_mod_manager = Yes
 
| min_TNG_ver    = 9.1.0
 
| min_TNG_ver    = 9.1.0
| max_TNG_ver    = 10.0.0
+
| max_TNG_ver    = 11.0.0
 
| TNG_file_list  = getperson.php<br/>genlib.php<br>languages/English/cust_text.php<br>languages/English-UTF8/cust_text.php
 
| TNG_file_list  = getperson.php<br/>genlib.php<br>languages/English/cust_text.php<br>languages/English-UTF8/cust_text.php
 
| related_mods    = [[Relationship Display Mod]] by Jeff Robison
 
| related_mods    = [[Relationship Display Mod]] by Jeff Robison
Line 42: Line 42:
 
For TNG 9 up to TNG 9.2.1
 
For TNG 9 up to TNG 9.2.1
 
Download the .cfg file from:
 
Download the .cfg file from:
* [http://lisaandroger.com/downloads/?did=24 Relationship to Site Owner Mod - TNG 9.1]
+
* [http://lisaandroger.com/downloads/download-info/tng-9-1-relationship-to-site-owner-mod/ TNG 9.1 Relationship to Site Owner Mod]
  
 
For TNG 9.2.2  
 
For TNG 9.2.2  
 
Download the .cfg file from:
 
Download the .cfg file from:
* [http://lisaandroger.com/downloads/?did=25 Relationship to Site Owner Mod - TNG 9.2.2]
+
* [http://lisaandroger.com/downloads/download-info/tng-9-2-2-relationship-to-site-owner-mod/ TNG 9.2.2 Relationship to Site Owner Mod]
  
For TNG 10.0.0 up to  
+
For TNG 10.0.0 up to TNG 10.0.3
 
Download the .cfg file from:
 
Download the .cfg file from:
* [http://lisaandroger.com/downloads/?did=26 Relationship to Site Owner Mod - TNG 10.0.0]
+
* [http://lisaandroger.com/downloads/download-info/tng-10-0-relationship-to-site-owner-mod/ TNG 10.0.0 Relationship to Site Owner Mod]
 +
 
 +
For TNG 10.1.0 up to
 +
Download the .cfg file from:
 +
* [http://lisaandroger.com/downloads/download-info/tng-10-1-relationship-to-site-owner-mod/ TNG 10.1.0 Relationship to Site Owner Mod]
 +
 
 +
For TNG 11.0.0 up to
 +
Download the .cfg file from:
 +
* [http://lisaandroger.com/downloads/download-info/tng-11-0-relationship-to-site-owner-mod/ TNG 11.0.0 Relationship to Site Owner Mod]
  
 
==Revision History==
 
==Revision History==
Line 59: Line 67:
 
! Date
 
! Date
 
! Description
 
! Description
 +
|-
 +
| V11.0.0.2
 +
| 15 October 2018
 +
|
 +
*Fix to show half cousins
 +
|-
 +
| V11.0.0.1
 +
| June 2016
 +
|
 +
*Minor changes for TNG 11
 +
|-
 +
| V10.1.0.1
 +
| 30 August 2015
 +
|
 +
*Minor tweak to encode the & symbol so the Mod passes validation.
 +
|-
 +
| V10.1.0.0
 +
| 13 February 2015
 +
|
 +
*Change required for TNG 10.1.0 changing from mysql_ queries to mysqli_ queries.
 
|-
 
|-
 
| V10.0.0.0
 
| V10.0.0.0
Line 85: Line 113:
 
== Automated Installation ==
 
== Automated Installation ==
 
# Download the mod from the link above. Extract the .cfg file and then upload it to the '''mods''' folder on your site.
 
# Download the mod from the link above. Extract the .cfg file and then upload it to the '''mods''' folder on your site.
# Follow the normal automated installation for Mod Manager, as shown in   the example [[Mod Manager - Installing Config Files]] to install.
+
# Follow the normal automated installation for Mod Manager, as shown in the example [[Mod Manager - Installing Config Files]] to install.
 
# Once installed, you need to click on the Edit button beside the Mod in Mod Manager to set the PersonID and Tree for the person relationships are calculated from. (See screen shot below). The Edit screen for the Mod allows you to set:
 
# Once installed, you need to click on the Edit button beside the Mod in Mod Manager to set the PersonID and Tree for the person relationships are calculated from. (See screen shot below). The Edit screen for the Mod allows you to set:
# * ID of the person to base calculations from. Defaults to (I1)
+
 
* Tree the base person to base is in. Defaults to (tree1)
+
:: ID of the person to base calculations from. Defaults to (I1)
* List of "bots" excluded. Defaults to (google, yahoo, baidu, msnbot)
+
:: Tree the base person to base is in. Defaults to (tree1)
* Maximum number of relationships to show. A similar but separate setting is found in TNG Admin -> Setup -> Chart Settings -> Relationship -> Initial Relationships. Defaults to (5)
+
:: List of "bots" excluded. Defaults to (google, yahoo, baidu, msnbot)
 +
:: Maximum number of relationships to show. A similar but separate setting is found in TNG Admin -> Setup -> Chart Settings -> Relationship -> Initial Relationships. Defaults to (5)
  
 
== In the event of a problem ==
 
== In the event of a problem ==
Line 97: Line 126:
 
== Custom Text Additions ==  
 
== Custom Text Additions ==  
  
'''Note:''' The config file only includes the English language changes, so if you support multiple languages you can modify the config file to add the custom text for those other languages, or manually add the following custom text to each of your other languages with appropriate translations.
+
'''Note:''' The config file only includes the English language changes, so if you support multiple languages you can either:
 +
# modify the config file to add the custom text for those other languages or
 +
# manually add the following custom text to each of your other languages with appropriate translations. e.g. if your site uses '''German UTF-8''' you'd add the translations to your languages/'''German-UTF8'''/cust_text.php file
  
English custom text is included in the mod. '''This Is For Reference Only!'''
 
  
 
<syntaxhighlight lang="php" enclose="div">
 
<syntaxhighlight lang="php" enclose="div">
Line 109: Line 139:
  
 
</syntaxhighlight>
 
</syntaxhighlight>
 
If you site supports other languages, copy these 3 lines and put them in the cust_text.php file for the languages that your site uses - e.g. languages/German-UTF8/cust_text.php
 
  
 
== Visualization of this mod ==
 
== Visualization of this mod ==
Line 129: Line 157:
  
 
====Admin Configuration Options====
 
====Admin Configuration Options====
The configuration options from within Mod Manager to change the person from whom relationships are calculated and the list of bots from which the line is hidden
+
===TNG 9 & 10.0.x===
 +
The configuration options from within Mod Manager to change the person from whom relationships are calculated, how many relationships to calculate if there's more than one between the 2 people, and the list of bots from which the line is hidden
 
{|
 
{|
 
|
 
|
 
|[[File:RelationshipToSiteOwnerConfiguration.png|right]]
 
|[[File:RelationshipToSiteOwnerConfiguration.png|right]]
 +
|}
 +
===TNG 10.1.x===
 +
The configuration options from within Mod Manager to change the person from whom relationships are calculated, how many relationships to calculate if there's more than one between the 2 people, and the list of bots from which the line is hidden
 +
{|
 +
|
 +
|[[File:RelationshipToSiteOwner_10.1.png|right]]
 
|}
 
|}
  
Line 146: Line 181:
 
|-
 
|-
 
| [http://lisaandroger.com/genealogy/getperson.php?personID=I16&tree=Roger Roger's Genealogy Online]
 
| [http://lisaandroger.com/genealogy/getperson.php?personID=I16&tree=Roger Roger's Genealogy Online]
| [[User:Thekiwi|Roger Moffat]]
+
| [[User:TheKiwi|Roger Moffat]]
 
| Mod developer (Public site)
 
| Mod developer (Public site)
|V9.1.0.1/TNG 9.2.1
+
|V10.0.0.0/TNG 10.0.0
 
|English
 
|English
|-
 
 
 
|-
 
|-
 
| [http://legacygazette.com Legacy Gazette: My Roots - My Legacy]
 
| [http://legacygazette.com Legacy Gazette: My Roots - My Legacy]
Line 158: Line 191:
 
| 9.1.0.0/TNG 9.2.1
 
| 9.1.0.0/TNG 9.2.1
 
| EN
 
| EN
|-
 
 
 
|-
 
|-
 
| [http://teresa-goatham.me.uk/genealogy/home.php Teresa's Tree]
 
| [http://teresa-goatham.me.uk/genealogy/home.php Teresa's Tree]
Line 167: Line 198:
 
| EN
 
| EN
 
|-
 
|-
 
+
| [http://www.maarelweb.nl/stamboom/surnames100.php/ Van der Maarel Genealogy]
[[Category:Mods for TNG v9]]
+
| [[User:Edward|Edward van der Maarel]]
 +
|
 +
| 10.0.0.0/TNG 10.0
 +
| EN, NL
 +
|-
 +
| [http://www.overtonmedia.com/tng Steve's Family Tree]
 +
| [[User:Steve Overton|Steve Overton]]
 +
| Private site
 +
| v10.0.0.0/TNG 10.0.0
 +
| EN
 +
|-
 +
| [http://williamsfamilytree.co.uk The Williams Family Tree]
 +
| [[User:RottenSod|Phil Williams]]
 +
| Public Site
 +
| v10.0.0.0/TNG 10.0.3
 +
| English
 +
|-
 +
| [https://genealogywings.com/ MOTYER Family Genealogy]
 +
| [[User:JMM|John Mark Motyer]]
 +
| Public site
 +
| [[User:JMM|see here]]
 +
| EN, DE, RU
 +
|-
 +
| [https://www.gambrillfamilytree.com/ Gambrill Family Tree]
 +
| [[User:bobbyfamilytree|Bobby Gambrill]]
 +
| Public site
 +
| v10.1.0 / TNG 12.0
 +
| EN
 +
|-
 +
| [http://justalittleleaf.co.uk Genealogy of the Weir and Drain Families]
 +
| [[User:BeverleyStimpson|Beverley Stimpson]]
 +
| Public Site
 +
| 11.0.0.1       
 +
| EN
 +
|-
 +
| [http://theroadtoethel.com/genealogy/index.php The Road to Ethel]
 +
| Alicia Clemmons
 +
| Public site
 +
| TNG v. 12.0.3
 +
| EN
 +
|-
 +
|}
 
[[Category:Mods for TNG v9]]
 
[[Category:Mods for TNG v9]]
 +
[[Category:Mods for TNG v10]]
 +
[[Category:Mods for TNG v11]]
 +
[[Category:Mods for TNG v12]]
 
[[Category:getperson.php mods]]
 
[[Category:getperson.php mods]]
 
[[Category:genlib.php mods]]
 
[[Category:genlib.php mods]]

Revision as of 13:57, 6 June 2019

Relationship to Site Owner
Summary Adds a line to the getperson.php page if the person displayed is related to a single, predefined person - typically this would be the Site Owner - in the database.
Validation XHTML compliant.Valid-xhtml10.png
Mod Updated {{{mod_last_update}}}
Download link TNG 11.0.0.2 Relationship to Site Owner Mod for
TNG 11.0
TNG 12.0


TNG 10.1.0 Relationship to Site Owner Mod for
TNG 10.1.0


TNG 10.0.0 Relationship to Site Owner Mod
for
TNG 10.0


TNG 9.2.2 Relationship to Site Owner Mod for
TNG 9.2.2

TNG 9.1.x Relationship to Site Owner Mod for
TNG 9.1

Download stats {{{download_stats}}}
Author(s) Roger Moffat - based on relationship.php by Darrin Lythgoe as part of TNG
Homepage Relationship to Site Owner Mod (This page)
Mod Support TNG Community Forums
Contact Developer {{{mod_contact}}}
Latest Mod v10.1.0.0 for TNG V10.1.x and TNG V11.x.x
v10.0.0.0 for TNG V10.0.x
v9.2.2.0 for TNG V9.2.2
v9.1.0.1 for TNG V9.1
Min TNG V 9.1.0
Max TNG V 11.0.0
Files modified
getperson.php
genlib.php
languages/English/cust_text.php
languages/English-UTF8/cust_text.php
Related Mods
Relationship Display Mod by Jeff Robison
Notes


Purpose of the Mod

This Mod adds a line near the top of getperson.php that indicates the relationship of the person on the page to a single, predefined individual - usually the TNG Site Owner - in the database. If there is no relationship that is also listed.

It uses JQuery to load the line after getperson.php has been loaded, so that the sometimes intensive calculations behind the relationship do not slow down the loading of getperson.php.

It does not load this line if the page is being viewed by a bot, so not letting the server get bogged down by a fast moving web bot.

It allows for configuration of:

  • the single individual in the TNG Database to calculate relationships from
  • a list of bots for which the line is not shown.
  • how many relationships to calculate if the person and the Site Owner are related in more than one way. This is a separate setting from what is in TNG Admin for Relationships.

Developer

This Mod was developed by Roger Moffat. The relationships are calculated using a stripped down version of relationship.php - part of TNG by Darrin Lythgoe.

Downloads

For TNG 9 up to TNG 9.2.1 Download the .cfg file from:

For TNG 9.2.2 Download the .cfg file from:

For TNG 10.0.0 up to TNG 10.0.3 Download the .cfg file from:

For TNG 10.1.0 up to Download the .cfg file from:

For TNG 11.0.0 up to Download the .cfg file from:

Revision History

Version Date Description
V11.0.0.2 15 October 2018
  • Fix to show half cousins
V11.0.0.1 June 2016
  • Minor changes for TNG 11
V10.1.0.1 30 August 2015
  • Minor tweak to encode the & symbol so the Mod passes validation.
V10.1.0.0 13 February 2015
  • Change required for TNG 10.1.0 changing from mysql_ queries to mysqli_ queries.
V10.0.0.0 6 February 2014
  • Change required for TNG 10.0.0. Also now includes a "not related to" statement if there is no relationship.
V9.2.2.0 8 Aug 2013
  • Change required for TNG 9.2.2.
V9.1.0.1 24 May 2013
  • Page load problem when switching language fixed - thanks Jeff Robison for the heads up.
V9.1.0.0 10 March 2013
  • Relationship calculated AFTER the page has loaded
  • Configurable list of bots so the relationship won't' calculate when a bot is accessing the page.
  • Parameters to set the Tree and PersonID to calculate the relationship from.

Automated Installation

  1. Download the mod from the link above. Extract the .cfg file and then upload it to the mods folder on your site.
  2. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install.
  3. Once installed, you need to click on the Edit button beside the Mod in Mod Manager to set the PersonID and Tree for the person relationships are calculated from. (See screen shot below). The Edit screen for the Mod allows you to set:
ID of the person to base calculations from. Defaults to (I1)
Tree the base person to base is in. Defaults to (tree1)
List of "bots" excluded. Defaults to (google, yahoo, baidu, msnbot)
Maximum number of relationships to show. A similar but separate setting is found in TNG Admin -> Setup -> Chart Settings -> Relationship -> Initial Relationships. Defaults to (5)

In the event of a problem

Custom Text Additions

Note: The config file only includes the English language changes, so if you support multiple languages you can either:

  1. modify the config file to add the custom text for those other languages or
  2. manually add the following custom text to each of your other languages with appropriate translations. e.g. if your site uses German UTF-8 you'd add the translations to your languages/German-UTF8/cust_text.php file


// For Relationship to SiteOwner line on getperson.php
$text['siteowner'] = $dbowner . " (the owner of this site)";
$text['clicktoviewrelationship'] = "Click to View Relationship";
$text['withingenerations'] = " is not related to " . $text['siteowner'] . " within xxx generations";

Visualization of this mod

On getperson.php page

If there is a relationship, it is described:

RelationshipToSiteOwner.png

If there is no relationship, that is stated:

NotRelatedWithinxxxGenerations.png

Admin Configuration Options

TNG 9 & 10.0.x

The configuration options from within Mod Manager to change the person from whom relationships are calculated, how many relationships to calculate if there's more than one between the 2 people, and the list of bots from which the line is hidden

RelationshipToSiteOwnerConfiguration.png

TNG 10.1.x

The configuration options from within Mod Manager to change the person from whom relationships are calculated, how many relationships to calculate if there's more than one between the 2 people, and the list of bots from which the line is hidden

RelationshipToSiteOwner 10.1.png

TNG User sites using this mod

Please add TNG sites that you have found that utilize this modification

URL User Note Mod-Version/TNG-Version User-language
Roger's Genealogy Online Roger Moffat Mod developer (Public site) V10.0.0.0/TNG 10.0.0 English
Legacy Gazette: My Roots - My Legacy Melissa Watson Padilla 9.1.0.0/TNG 9.2.1 EN
Teresa's Tree Teresa Goatham Public site 9.1.0.1/TNG 9.2.1 EN
Van der Maarel Genealogy Edward van der Maarel 10.0.0.0/TNG 10.0 EN, NL
Steve's Family Tree Steve Overton Private site v10.0.0.0/TNG 10.0.0 EN
The Williams Family Tree Phil Williams Public Site v10.0.0.0/TNG 10.0.3 English
MOTYER Family Genealogy John Mark Motyer Public site see here EN, DE, RU
Gambrill Family Tree Bobby Gambrill Public site v10.1.0 / TNG 12.0 EN
Genealogy of the Weir and Drain Families Beverley Stimpson Public Site 11.0.0.1 EN
The Road to Ethel Alicia Clemmons Public site TNG v. 12.0.3 EN