TNG Integration

If you are not comfortable with html and php editing, this page may not be for you

GenWiki Overview

The TNG Wiki modification is intended to provide a wiki environment for genealogy related stories, histories, and facts that is directly accessible from the individual person pages within the TNG software. In particular, it will help create automated link between people and places from within your person pages. An example of the results have been categorized into two primary sections: People, and Places.

The Genealogical information is managed through the Genealogy software package called The Next Generation of Genealogy Sitebuilding © 2001-2006, created by Darrin Lythgoe, Sandy, Utah. (TNG) For more information on this package, follow the link in the previous line of text.

Although the TNG software does not come preconfigured to work specifically with MediaWiki, only a few modifications to the base TNG software are required to achieve a moderate wiki integration. This page includes the information necessary to make those changes.

TNG Version 7.1.0 support - Apr 26, 2009

Revision 4.7b Jul 3, 2008 - added an alternate file for no comma after the Surname. (alt genlib.php)

Revision 4.7a Jul 2, 2008 - missed a file for V7.0.0, package updated. (genlib.php)

Revision 4.7 Jul 2, 2008 - updated for TNG V7.0.0 files.

Revision 4.6a Feb 18, 2008 - bug fixes for the strategy 2 link_wiki.php file.

Revision 4.6 Feb 9, 2008 - updated for TNG V6.2.0 files.

Revision 4.5 Jul 16, 2007 - updated for TNG V6.1.1 files.

Revision 4.4 May 15, 2007 - updated for TNG V6.1.0 files.

Revision 4.3 Jan 15, 2007 - updated for TNG V6.0.4 files.

Revision 4.2 Nov 19, 2006 - updated for TNG V6.0.3 files.

Revision 4.1 Oct 22, 2006 - updated for TNG V6.0.2 files.

Markup Rev 1.0 Sep 30, 2006 - updated the Wiki Markup extension to include a key for the Family ID (update)

Revision 4.0 Sep 24, 2006 - updated for TNG V6 files.

Revision 3.1 Aug 3, 2006 - updated strategy 1 file. The Media:link_wiki_strategy_1.zip file. Correction to the url type subsitution.

Revision 3.0 July 24, 2006 - New version where GenWiki tables are installed into the same TNG database. Also includes 2 alternate TNG-GenWiki place link strategies.

Resulting GenWiki - TNG features

1. Within the person pages, an icon ( ) to the right of people's names will be displayed each time a wiki page is found to match the individual's name
2. If the TNG user is logged in as "admin" then a grayed icon ( ) to the right of all possible wiki link points will be displayed
3. Within the person pages, all "places" are examined for string matches to the wiki database. Two different customizable strategies have been included
   • Examples of this may be found on the page: Example Page. Check the place "Tiverton" next to "Died" and the wiki link icon next to a couple of the names.
   • The appearance of the icon or place link is automatic if there is a corresponding wiki page.
4. It is also possible to include links in the notes for pictures and histories, however this is a strictly manual entry (using standard html href=.... language) as in this example - check the History line at the bottom, there is an embedded link.

MediaWiki extensions

Although links to the TNG generated pages can be created using standard wiki html links, a small extension to the MediaWiki language makes this a little easier.

A "tng" tag was created with the following syntax:

• <tng i=XXX>Description</tng> for links to people using the person ID
• <tng f=XXX>Description</tng> for links to families using the family ID

The previous <person> tags will continue to work the same as the new shorter <tng> tags.

The TNG person/family IDs may be determined by examination of the TNG person/family pages, or hovering your mouse over any TNG person/family link and monitoring the browser status line.

Requirements

1. A working TNG installation - see The Next Generation of Genealogy Sitebuilding
   • For improved GenWiki People Name indexing, it is recommended that the TNG option to list Surnames first be used
     • found under Admin - General Settings - Name Order
2. A working MediaWiki installation - see MediaWiki Download
   • Version 3 and greater requires that MediaWiki is installed into the same TNG database and supports table name prefixes
   • If you prefer to maintain separate GenWiki and TNG databases, you may use version 2, click here
3. A backup of your TNG files
4. A backup of your MediaWiki files

Installation for TNG V5 / V6 / V7

!CAUTION! This zip contains a modified TNG personlib.php and getperson.php file.
If you have made any custom modifications to either of these files, do NOT copy these to your TNG directory, you will lose any customizations you have made.

• The zip file contains:
  • new_doc.gif - the grayed down icon for administrators
  • link_wiki_strategy_1.php - the wiki link function, see TNG Wiki Strategy 1 for more info
  • link_wiki_strategy_2.php - the wiki link function, see TNG Wiki Strategy 2 for more info
  • version 7.0.0/personlib.php - (this is a modified TNG file)
    • a version of personlib.php including the googlemap mod, the secret notes mod, is also included
  • version 7.0.0/getperson.php - (this is a modified TNG file)
  • version 7.0.0/genlib.php - (this is a modified TNG file)
  • version 6.2.0/personlib.php - (this is a modified TNG file)
    • a version of personlib.php including the googlemap mod is also included
  • version 6.2.0/getperson.php - (this is a modified TNG file)
  • version 6.1.1/personlib.php - (this is a modified TNG file)
    • a version of personlib.php including the googlemap mod is also included
  • version 6.1.1/getperson.php - (this is a modified TNG file)
  • version 6.1.0/personlib.php - (this is a modified TNG file)
    • a version of personlib.php including the googlemap mod is also included
  • version 6.1.0/getperson.php - (this is a modified TNG file)
  • version 6.0.x/personlib.php - (this is a modified TNG file)
    • a version of personlib.php including the googlemap mod is also included
  • version 6.0.x/getperson.php - (this is a modified TNG file)
  • version 5.1.4/personlib.php - (this is a modified TNG file)
  • version 5.1.4getperson.php - (this is a modified TNG file)

• IF you are running v7.0.0, v6.0.x, v6.1.0/1, V6.2.0 or v5.1.4 and you have NOT made any changes to personlib.php then

1. backup your existing TNG genlib.php, personlib.php and getperson.php files
2. download this zip (TNG Wiki Package (Rev 4.7b))
3. unzip it, examine the contents
4. decide which place search strategy you wish to implement see Strategy 1 or Strategy 2
5. rename your link_wiki_strategy_N.php file to link_wiki.php
6. modify the variables at the top of the link_wiki.php file to match your wiki setup, the database and table prefixes must match your wiki installation and the database name must be the same as your TNG database.
7. comment/uncomment the wiki article path style so that it matches your wiki article page paths
   • the article path is the URL style that is used by your wiki. Two possibilities exist. Some installation MUST use the "?title=" style URL, others MAY use the path style "/". Examine one of your wiki page urls to determine the style you are required to use.
8. copy your link_wiki.php, new_doc.gif and applicable getperson.php files to your base TNG directory
9. choose the desired personlib.php file version and rename it to "personlib.php" and copy it to your base TNG directory
10. for TNG V7, you will also need to copy the new genlib.php file to the base TNG directory
    • personlib_-_wiki -> only the code to create links to your wiki site
    • Select one of the following if you have already installed my simple GoogleMapLink mod
      • personlib_-_google_wiki -> the wiki link code and the simple google map link for places
      • personlib_-_google_wiki_secret -> the wiki link code, the simple google map links, and the display of private notes to admins
11. if you are logged in as admin, you should now see grayed icons next to the names
    • follow one of these links and you should end up at your wiki, create page option

In the event of a problem with your TNG site

1. copy your backup genlib.php, personlib.php and getperson.php files to your base TNG directory
   • all should be well now
2. you may also delete the link_wiki.php and new_doc.gif files

Wiki Language extension

1. download this zip file with the tag extension code ( Media:Wiki_Markup_Extension_Rev_1 )
2. examine the contents
   • there is only one file, persons.php
   • modify the contents;
     • feel free to change the author's name
     • and change to your favourite url
     • and you MUST change the url in the tag where it has "genealogy.mcfadyen.ca" to your url
3. copy the persons.php file to your wiki site in the directory extensions
   • ensure the file is executable
4. add the following line at the end of your "LocalSettings.php" file, just before the ?> line
   • include("extensions/persons.php");

• That's it, the wiki should now understand <tng> (or <person>) tags

Suggested Wiki Customizations

1. use Categories:
   • at the bottom of each Person Page, add a [[Category:People]] tag
   • at the bottom of each Places Page, add a [[Category:Places]] tag
2. modify your sidebar to include shortcuts to these areas
   • go to page: Mediawiki:sidebar (just enter this in the search box) see this site example
   • edit this page, if you added
     • Category:Places|List of Places
     • Category:People|List of People
   • as entries on this page, all sidebars will change
     • you may have to delete your page cache before you will see it

Support

1. You're sort of on your own... If you have a specific question, or feel some additional info in the above would help others, feel free to contact me directly. [genealogy at mcfadyen dot ca]
2. There are lots of changes that could be made, alternate ways to strip the place strings, etc, etc...
   • Please post suggestions, or your own flavour of this mod to the forum or list

Acknowledgments

Sincere thanks to all the TNG users in the TNG list and forums for their continued and dedicated support of Darrin's TNG platform.
A special thanks is extended to

• Roger Navarre and Gary Wood

for their perseverance and successful installation of the first GenWiki modifications. Check out their GenWiki extensions to TNG. Roger Navarre also authored the Strategy 2 for the place name parsing.