MediaWiki Integration
Downloads of MediaWiki Integration are restricted to logged in users. If you do not have a user account on the TNG Wiki use the Request Account link to request a user account | ||
If you have trouble downloading with Google Chrome, Vivaldi, Brave or other Chromium based browser, try using a right-click and select Open in new Window, then F5, or use another browser such as Firefox |
V10.1.0.5 and later of the MediaWiki Integration mod now allows you to Edit the parameters for both the TNG/extensions/link_wiki1.php and the persons.php file that must then be copied to your wiki/extensions folder.
If you also use Collapse Family Children you need v12.3.0.4 to resolve the conflict. If you also install the Family Indicators Mod and Family Preview Mod (LB version), you may want to install them first. Installation order influences the order of the icons. |
|
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
for
mediawiki_v10.1.0.7.zip for
mediawiki_v9.2.0.3.zip mediawiki_v9.0.0.1.zip for
mediawiki_v8.1.6.zip for
mediawiki_v8.1.4.zip for
mediawiki_v1.2.zip for
| ||||||||||
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:
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
|
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
- Download the appropriate mediawiki installation package from the status box above.
- Extract the zip file into your TNG admin/mod_folder for V7 or your /mods folder for V8
- If using TNG V7, edit the mediawiki_v1.2.cfg file as shown below
- 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
- 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
- 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
- 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
- copy the persons.php file from the TNG extensions folder to your wiki/extensions folder, and
- edit the new persons.php file to provide
- 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:
- 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
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
- Wikis for Genealogy http://www.cyndislist.com/wikis.htm