MediaWiki Integration

Media Wiki Integration
Summary	Integrates MediaWiki with TNG for Individuals, Places, Repositories, and Sources
Validation	V9 mod was XHTML compliant.
Mod Updated	5 April 2020
Download link	for TNG 13.0 TNG 12.3.0 mediawiki_v12.3.0.9.zip for TNG 11.0 TNG 10.1.0 mediawiki_v10.1.0.7.zip for TNG 10.0 TNG 9.0 mediawiki_v9.2.0.3.zip mediawiki_v9.0.0.1.zip for TNG 9.0 mediawiki_v8.1.6.zip for TNG 8.1.2 mediawiki_v8.1.4.zip for TNG 8.0 mediawiki_v1.2.zip for TNG 7.0
Download stats	View download statistics
Author(s)	Brian McFadyen maintained by Ken Roy
Homepage	Wiki Integration (this page) Brian McFadyen's TNG Integration for history
Mod Support	TNG Commmunity Forums
Contact Developer
Latest Mod	12.3.0.9 for TNG 12.3+<br /10.1.0.7 for TNG 10.1+ 9.2.0.3 for TNG V9.2 and up 9.0.0.1 for TNG V9 8.1.6 for TNG V8.1.2 8.1.4 for TNG V8 1.2 for TNG V7
Min TNG V	7.1.0
Max TNG V	12+
Files modified	genlib.php getperson.php personlib.php link_wiki.php substitution_list.php
Related Mods	Surname First Mod is recommended for wiki person page indexing in TNG V7 Use Name Order of Surname first (with commas) in TNG V8
Notes	For TNG V7 you must edit the config file before installing it to reflect the URL for your own MediaWiki installation For TNG V9, if you also install the Geocode Assist Mod, it should be installed after the Wiki Integration mod.

Introduction

    See also: Single sign-on integration with SimpleSAMLphp

The Wiki Integration mod allows an integration of MediaWiki with TNG for Places and Individuals. 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 individual person pages.

An example of the results have been categorized into two primary sections:

• Article Index:People
• Article Index:Places

on Brian McFadyen's Wiki

V8.1.5 of the mod extends the capability to also allow creating links for sources and repositories and resolves the incompatibility with the Relationship Display Mod in TNG 8.1.2

Restrictions

Note the TNG Wiki Integration mod has the following restrictions:

• you must have MediaWiki installed

If you have not installed MediaWiki do NOT install this mod.

• it must be using the same database as TNG.

If your MediaWiki does not use the SAME database as TNG, do NOT install this mod.

See the TNG Community Forum entry MediaWiki Integration for additional details and history of the mod.

See also the MediaWiki - Installing for a visual supplement to the MediaWiki Installation Guide documentation.

Resulting MediaWiki - TNG features

• Within the person pages, an icon ( ) to the right of people's names will be displayed each time a wiki page is found that matchs the individual's name
• If the TNG user is logged in with admin privileges then a grayed icon ( ) to the right of all possible wiki link points will be displayed
• Within the person pages, all places are examined for string matches to the wiki database.

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

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

Strategies for integration

Two different customizable strategies are available for the Wiki Integration:

• Strategy 1 This approach is targeted at Location Strings that have been entered in a somewhat unrestricted manner. This strategy starts from the left, and checks for a GenWiki page that matches just the first segment, then the first two segments, then the first three segments, then four, five, etc. The largest continuous set of segments that match is turned into a GenWiki link. Then, the search starts again at the first non-matched segment and repeats the search. Segments that do not match a page are simply printed as text. This strategy is the default implemented by the mediawiki_v1.2.cfg file.

• Strategy 2 This approach was developed by Roger Navarre and works very well for well structured location strings. This approach is targeted at location strings with the following format:

town, county, state/province, country

See Brian McFadyen's site on recommendation on how to replace the link_wiki.php with the files used by the second strategy.

MediaWiki extensions

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

Note for V8.1.5 and above of this mod, you should copy the wiki language extension - persons.php from the TNG extensions folder to your wiki/extensions directory and follow the recommendations in the Post Installation.

For previous versions of the mod, this MediaWiki extension can be downloaded and installed from the MediaWiki Extensions on Brian McFadyen's web site.

The MediaWiki extension provides

A <tng> tag that uses the following syntax:

• <tng i=XXX>Description</tng> for links to a person page using the person ID
• <tng f=XXX>Description</tng> for links to a family page 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.

With the V8.1.5 version of the mod, the following tags were also added to persons.php:

• <tng s=XXX>Source Title</tng> for links to return to a Source page
• <tng r=XXX>Repository Name</tng> for links to return to a Repository page

The Source ID number should be the number displayed on the page created when clicking on document icon from the TNG source page. Note this should be the number only that follows the S id.

The Repository ID number should be the number displayed on the page created when clicking on document icon from the TNG repository page. Note this should be the number only that follows the REPO id.

See the Creating Wiki Links to TNG pages for illustrations on how to use the Wiki Language extension and on resulting links if the Wiki Language extension is not installed correctly.

See the Customizing the person.php file for illustrations on how to update the person.php in your wiki/extensions directory after installing the Wiki Language extension.

Developer

Mod developer is Brian McFadyen.

Modified by Ken Roy to support MediaWiki links for Repositories and Sources.

Modified by Jeff Robison to resolve conflict with the Relationship Display Mod in TNG 8.1.2

Modified by Rick Busbee to resolve conflict with the Living Color Mod in TNG 8.1.2

Modified by Linc Haymaker and Ken Roy for TNG V9

Revision History

Version	Date	Contents
V12.3.0.9	5 April 2020	Updated for TNG 12.3 Note: Post Installation Required Action to Edit the options and copy files to your wiki extenstions folder. Requires Collapse Family Children v12.3.0.4 if you use both mods to resolve the conflict
V10.1.0.7	25 Jan 2015	Updated for TNG 10.1 to resolve the sequence order of the icons displayed by Family Edit Links Mod, Family Indicators Mod, and Family Preview Mod
V10.1.0.6	20 Jan 2015	Updated for TNG 10.1 to resolve the conflict with Family Indicators Mod
V10.1.0.5	10 Jan 2015	Updated for TNG 10.1 to support MySQLi changes add Edit parameters for the persons.php that must then be copied to your wiki/extensions folder remove the install sequence dependency with the Geocode Assistant
V9.2.0.4	13 Nov 2013	Updated to add a new Edit parameter that controls whether existing MediaWiki page links open in a new window. Defaults to Yes.
V9.2.0.3	23 Feb 2013	Updated for TNG 9.2
V9.0.0.1	7 June 2012	Updated to not create the wiki link icons for the Person Preview on search results.
V9.0.0.0	2 February 2012	Updated for TNG V9
V8.1.6	25 Aug 2011	Updated to resolve conflict with the Living Color Mod in TNG 8.1.2
V8.1.5	27 Aug 2011	Updated zipfile to v8.1.5a to include the missing mediawiki/new_doc.gif file from V8.1.5
V8.1.5	6 Jun 2011	Updated to resolve conflict with the Relationship Display Mod in TNG 8.1.2 and to add new capability to link to Sources and Repositories, so that you can provide extended descriptions on your wiki for your TNG sources and repositories.
V8.1.4	16 Jul 2010	Bug Fix. Correction to yesterday's correction attempt.
V8.1.2/3	15 Jul 2010	Bug Fix. Failed attempts to correct the mistaken deletion of "Group Sheet" links on individual page.
V8.1.1	29 May 2010	Corrections to work with TNG V8.
V8.1.0	27 May 2010	Updated config file for TNG V8. The wiki URL, Wiki URL style, and Wiki table prefix are now editable parameters. See Mod Manager Syntax
V1.2	Dec 6, 2009	Updated config file documentation to point to TNG Wiki. This file is identical as that of V1.1 included in the Mod Manager zip file, but which will soon be eliminated from the bundle.
V1.1	12 May 2009	original Mod Manager config file

Requirements

For TNG:

• A working TNG installation.
• 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 See also the Surname First Mod if running TNG V7

• A backup of your TNG files
  • genlib.php (V7)
  • globallib.php (v8)
  • personlib.php
  • getperson.php
• An installed current version of the Mod Manager.

For MediaWiki:

• A working MediaWiki installation

If you have not installed MediaWiki do NOT install this mod

• The MediaWiki must be installed into the same TNG database and support table name prefixes

If your MediaWiki does not use the SAME database as TNG, do NOT install this mod.

• A backup of your MediaWiki files
• Installation of the Wiki Language Integration
• An edited version of the person.php file in your wiki/extensions directory that reflects your wiki URL and treeID
• Suggested Wiki Customizations to add the People and Place categories to your wiki sidebar

See also the MediaWiki - Installing for a visual supplement to the MediaWiki Installation Guide documentation.

Automated Install

1. Download the appropriate mediawiki installation package from the status box above.
2. Extract the zip file into your TNG admin/mod_folder for V7 or your /mods folder for V8
3. If using TNG V7, edit the mediawiki_v1.2.cfg file as shown below
4. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files

Note that the Wiki Integration Mod requires that your wiki database tables be installed in the same database as TNG. If your current MediaWiki installation is not using the same database as TNG, DO NOT install this mod.

Post Installation

TNG 10.1 and up

TNG version:

≥ 10.1.0

If using TNG V10.1 and above, you must

1. use the mod EDIT button on the Mod Manager page to enter additional details on your wiki
   • Wiki URL address
   • Wiki URL style
   • Wiki Database table prefix
   • Open wiki page in another window or tabe
   • the URL for your TNG site
   • your treeID
2. Copy (do NOT move) the extensions/persons.php file to your wiki/extensions folder

TNG 8.0 through TNG 10.0.3

TNG version:

≥ 8.0

If using TNG V8 and above, you must

1. use the mod EDIT button on the Mod Manager page to enter additional details on your wiki
   • Wiki URL address
   • Wiki URL style
   • Wiki Database table prefix
2. copy the persons.php file from the TNG extensions folder to your wiki/extensions folder, and
3. edit the new persons.php file to provide

1. • the URL for your TNG site
   • your treeID

V8.1.5 of the Wiki Integration mod resolves the compatibility issue with the Relationship Display Mod in TNG 8.1.2 and adds new capability to create Source and Repository pages on your wiki.
V8.1.6 of the Wiki Integration mod resolves the compatibility issue with the Living Color Mod which must be installed after the Wiki Integration mod.
V9.0.0.0 includes the expanded Source and Repository page links and does not contain any known conflict with other mods.
If you also install the Geocode Assist Mod it should be install ed after this mod, so the geocode globe displays after the location name. This restriction does no longer applies to v10.1.0.5 of the mod.

Edit Config File (V7 Only)

TNG version:

7.0

Note that you must edit the config file to replace lines 127-128 which are

        $wiki_url = "http://yourownsite.ext/wiki/";
        $wiki_prefix = "wiki_";

with the URL for your own web site and the wiki table prefix that you used.

Failure to edit the wiki URL, will result in a link to an invalid web site instead of your own MediaWIki installation.

Note that the trailing slash should probably not be included in the URL above, since it resulted in a double slash which also generates an invalid URL for the wiki page.

Manual Install

No longer recommended and may not be current.

Manual Install instruction for previous versions are available on Brian's site.

The MediaWiki Integration on the TNG Community Forum also provide some instructions.

Note this TNG mod requires that you have MediaWiki installed using the same database as TNG. See the TNG Community Forum entry MediaWiki Integration for additional details.

The following links provide information on integrating MediaWiki with TNG:

• MediaWiki Integration

• TNG Integration on Brian McFadyen's site

Sites using this mod

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

URL	User	Note	Mod-Version	TNG-Version	User-language
McFadyen Parker Genealogy	Brian McFadyen	Mod Developer. Best site to see this mod in action	8.1.4	8.0.1	EN
Oet Dorp en Marke Losser	Peter Heerink	Website that supports the genealogy website of a regional historical group.	v12.3.0.9	v12.3.0.6a	NL (site), DE, EN
Genealogieën van de Veenkoloniën	Henny Savenije	I was wondering if the redirection could be to name instead of name_._ID	v9.2.0.4.cfg	v.10.0.3	AF, DE, EN, ES, FR, IT, NL, NO, PT, SU, SV
Our Acadian, French-Canadian, and Maine Ancestors	Ken Roy	Installed on a test site only	9.2.0.3/10.1.0.7	10.0.3/10.1.0	EN, FR
Gentry-Rigsby-Kramitz Family Genealogy	Thom Rigsby	Just installed, only a few pages created	9.0.0.0	9.0	EN-US
Van den Heuvel	Marco van den Heuvel	Just installed, not much info yet.	9.0.0.0	9.0.3	NL, EN
Kleinmann Genealogy	John Kleinmann	Building it out now. Click "Wiki" under the "More" dropdown menu	10.1.0.7	10.1.1	EN
MFO Sample Wiki Page	Roger Mitchell	On-going project of expansion	9.2.0.3	9.2.1	EN
Leverette Family History	Jeff Leverette		10.1.0.7	10.1.3	EN
OurLife Family History - McMullen Clan	Sean Thompson	Not a public site	10.1.0.7	11.1.0	English
British 1820 Settlers of South Africa	Paul Tanner-Tremaine		10.1.0.7	11.1.1	English
Stamboom Jongman	Roel Jongman	Public/Private site	10.1.0.7	10.1.3	NL, DE, EN
The Williams Family Tree	Phil Williams	Public site. Added link to Wiki from menu bar.	10.1.0.7	11.1.2	English

TNG Sites using MediaWiki

Examples of sites using MediaWiki... but not the TNG Wiki Integration mod

• Zalewski family wiki
• Helderberg Hilltowns

Misc MediaWiki Genealogy sites

• GRAMPS
• Familypedia
• http://genealogy.smcox.com/wiki/Main_Page/
• http://microformats.org/wiki/genealogy
• http://www.grpl.org/wiki/index.php/Genealogy
• http://www.wikihow.com/Category:Genealogy
• http://en.wikibooks.org/wiki/Genealogy/Hardcopy

Related Links

• MediaWiki - Installing

• Wiki Language Extension

• http://www.mediawiki.org/wiki/MediaWiki

• Wikis for Genealogy http://www.cyndislist.com/wikis.htm