Person Map

From TNG_Wiki
Jump to navigation Jump to search
Restricted Downloads of Person Map 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 Restricted
Caution 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 Caution


Ambox notice.png The latest version of this mod uses the guidelines for TNG v12+ cust_text.php files. If you are using TNGv12+, and any cust_text.php file in this mod is marked with a Bad Target error, you need to update your cust_text.php files before you can install this mod. [Show instructions]

If you upgraded to TNGv12+, and did not update your cust_text.php files as instructed in the upgrade readme script, then you must use the TNG Mod Manager to update them. To do so:

  1. Go to Mod Manager, and select its "Recommended Updates" tab.
    (If the "Recommended Updates" tab is not visible, then go to the Mod Manager Options tab, select "Display Settings", and turn on the "Recommended Updates" tab.)
  2. Click the "Update" button in the "Recommended Updates" tab.
    Installed mods do not interfere with the update, and if you already have (or think you may have) run this update, it will not hurt for you to run it again.

[See details in the TNGv12 Change Impacts Article][Hide the instructions]

TNG 14.0
TNG 13.0
TNG 12.0


Person Map
Summary Adds options to the Map Settings dialog to fine tune the showing of the map on the person pages.
Validation The mod is XHTML compliant.Valid-xhtml10.png
Mod Updated 28 Feb 2021
Download link for
TNG 14.0
TNG 13.0.1

Merged mobile-standard version
person_map_v13.0.1.10.zip
For
TNG 13.0
person_map_v13.0.0.8.zip
Note mobile versions not available at this time
TNG 12.0
for the Mobile enhanced version mobile_ind_page_person_map_v12.0.0.2.zip

person_map_v12.0.0.7.zip
TNG 11.0
for the Mobile enhanced version mobile_ind_page_person_map_v11.0.0.1.zip
TNG 10.1.0
Mobile enhanced version mobile_ind_page_person_map_v10.1.0.2a.zip
TNG 11.0
TNG 10.0
TNG 9.1
person_map_v9.1.0.6a.zip
Download stats See v9106 and mobile download stats
Author(s) Bart 'Roebie' Degryse
Homepage Person Map
Mod Support TNG Community Forums
Contact Developer TNG Community Forums
Latest Mod 13.0.1.10 for TNG v13.0.1+
13.0.0.8 for TNG v13
mobile enhanced v12.0.0.2
12.0.0.7 for TNG v12
and up mobile enhanced v10.1.0.2a
9.1.0.6a for TNG v9.1 and up
9.0.0.5 for TNG v9.0
Min TNG V 9.0.0
Max TNG V 13.0.1+
Files modified
admin_mapconfig.php
admin_updatemapconfig.php
cust_text.php
genlib.php
genstyle.css
getperson.php
mapconfig.php
Related Mods
Notes

Purpose of the mod

This mod will add options to the Map Settings dialog to fine tune the showing of the map on the person pages.

Developer

This mod was developed by Bart 'Roebie' Degryse
Idea by Cyndi Wiseman in response to a question by Mitch Gariador.
Version 9.x.0.1 features in response to a question by Roger Mitchell.
Version 9.x.0.3 features in response to a question by Sam Clark. Thanks to Sam and to Jerry Liebowitz for extensive testing and to Ken Roy and Martin Pannier for translations.


TNG version: 12.3.0
TNG version: 10.1.0

Mobile enhanced version provided by Ken Roy for TNG V10.1, V11, and v12 only


TNG version: 13.0.1

Person Map mod includes the previous Mobile version of the mod, since both mods were merged together.

Requirements

  • A working TNG installation.
  • A backup of all affected files (see the list in the summary in the upper right corner of the page)
  • An installed current version of the Mod Manager (is already included in TNG v9)

Installation

  1. Download the appropriate zip file as shown in the summary in the upper right corner of the page. NOTE that I host these zip files on my own server. That way I can count the number of downloads for each mod I made and estimate the relevance of such mod.
  2. Extract all the files from the downloaded zip file (1 cfg file and 2 images) into the mods folder.
  3. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install the mod.
  4. Go to Admin >> Setup >> Configuration >> Map Settings.
  5. Make sure Enable Maps is set to Yes
  6. Also make sure to set Hide Public Maps to Start to No
  7. Next set the three new options Show the map on the person page, Allow to toggle the visibility, Reset location markers on unhide and Scroll event map section to to your liking. More on these options in the next two paragraphs.
  8. Don't forget to press the Save button.
  9. If the mod doesn't behave as expected, please clear your browser's cache as a first measure:
    1. Log out of your TNG website
    2. Clear your browser's cache
    3. Close and reopen your browser
    4. Log in into your TNG website

Features

The latest version of this mod adds tree options to the Map Settings dialog.

  • Start with expanded event map section
  • Allow to toggle the visibility

The next paragraph will give a detailed description of the effect of these parameters especially in conjunction with other TNG settings.

  • Reset location markers on unhide

When you open the page the map will show a given region. Now suppose you scroll the map to show another region. Now hide the map, next unhide the map. The map will still show the latest region. Setting this option to Yes, forces the map to reload when you unhide it, making it show the former region again.

  • Scroll event map section to

If the getperson page is higher than the browser viewport this option will define the page's behavior: scroll to the top of the event map section, or the bottom or center it in the viewport.

  • There is also an image just before the Click to display/hide link to draw a bit of attention

Detailed Behavior Description

This paragraph will describe the effect of several of the Map Settings options on the behavior of the getperson page, not only the ones added by the mod itself but also the TNG options. It has become quite extensive as there are many possible combinations. To limit the width of the table I've given each option a number (see below).

Another aspect that has been overly discussed on and off the mailing list is the impact on bandwidth. To tackle this I have done some tests. Using the Firefox addin HttpFox I have recorded the list of files and the amount of data fetched from the web server each time I refresh a certain page on my TNG website. The details on the recorded information are in this excel file (zipped). The numbers marked in red are the ones that are related to the Event Map section. I have summed them in the excel file and you can also find them in the table below. Remember that these are not absolute figures, they will vary for each website and each getperson page, even for each browser brand. It's the relationship between them that matters most. Or like it was mostly formulated on the mailing list: is the map loaded or not?

Note 1: I have only recorded this information for the getperson page. That explains why there's not always a number mentioned.
Note 2: Depending on the settings a different part of genstyle.css is fetched. That's why I have decided to add this file to the list of Event Map section related files.
Note 3: This tests where done without caching. With caching on the amounts of data fetched should be (far) lower as many of the files can be perfectly cached.

Option Number Added by
Enable Maps 1 TNG
Hide Admin Maps to Start 2 TNG
Hide Public Maps to Start 3 TNG
Start with expanded section 4 MOD
Allow to toggle the visibility 5 MOD

An empty cell means that the setting doesn't matter for the described effect.

1 2 3 4 5 Bytes fetched Description
Site wide behaviour
No         27,697 Maps are disabled
Behavior of admin site
Yes No         Maps will show
Yes Yes         A grey button labeled Show/hide clickable map shows, but no map. When you click it the map will show.
Behavior of getperson page
Yes   No No No 32,077
  • The Event Map section is completely invisible and there is no way to make it visible.
  • The map itself won't load at all.
Yes   No No Yes 210,017
  • The Event Map section is collapsed.
  • There is a Click to Display link. When you click it the Event Map section is expanded and the map will show.
  • Initially only some parts of the Event Map section are loaded even though they are not visible yet. The map itself is not loaded yet.
Yes   No Yes No 1,004,408
  • The Event Map section is completely visible and there is no way to hide it.
  • Obviously the map is fully loaded.
  • This is the default behavior when this mod is not installed.
Yes   No Yes Yes 1,059,504
  • The Event Map section is completely visible.
  • There is also a Click to Hide link.
  • Here too the map is fully loaded.
Yes   Yes No No 7,421
  • The Event Map section is completely invisible and there is no way to make it visible.
  • The map itself won't load at all.
Yes   Yes No Yes 96,969
  • The Event Map section is collapsed.
  • There is a Click to Display link. When you click it the Event Map section is expanded. The map is not yet visible: you only get a Load the map link (with the famous grey arrow). When you click this link the map finally loads and shows.
  • Initially only some parts of the Event Map section are loaded even though they are not visible yet. The map itself is not loaded yet.
Yes   Yes Yes No 91,840
  • The Event Map section is completely visible and there is no way to hide it.
  • The map is not yet visible: you only get a Load the map link (with the famous grey arrow). When you click this link the map finally loads and shows.
Yes   Yes Yes Yes 98,089
  • The Event Map section is completely visible.
  • There is also a Click to Hide link.
  • The map is not yet visible: you only get a Load the map link (with the famous grey arrow). When you click this link the map finally loads and shows.
Behavior of other public pages (cemeteries, ...)
Yes           Since the Hide Public Maps to Start option only affects the getperson page and this mod doesn't affect other pages than the getperson page, the map on these pages shows, just as it does without the mod.

Other Languages

Those who use other languages in addition to English can find appropriate mods to add Dutch, French or Spanish custom text additions in the summary in the upper right corner of this page. Follow the same procedure as explained above to install them.

Note that these language mods are only for the 9.0.0.0 version of the mod. New ones will come soon!

Visualization of this mod

The following images show the visual effects of installing the mod.

Without the mod installed

This is how the Admin >> Setup >> Configuration >> Map Settings page looks in the default TNG 9 template 3 layout.

Without the mod installed
With the mod installed

Once you have this mod installed this is how that same page will look like. As you can see several new options have been added.

With the mod installed
The Event Map section collapsed

This is how the Event Map section of the getperson page might look like (depending on your settings of course). As you can see there is an image in front of the Click to display link to draw a little more attention.

The display image
The Event Map section expanded

Here the Event Map section is already expanded. You can see that the Click to hide link has its own image.

The hide image

The following images show the effect of the Scroll event map section to option. To make this screenshots I resized my browser so that the viewport is smaller than the page, but larger than the Event Map section. Then I've scrolled to the bottom of the page. This I consider the starting point which you can see in the first image (the Collapsed column). Then I've set the mods settings to:

  • Hide Public Maps to Start: No
  • Start with expanded section: No
  • Allow to toggle the visibility: Yes

Each image shows the effect after clicking the Click to display link (see also image The Event Map section collapsed above).

Collapsed Top Middle Bottom Browser default
Event Map section collapsed, page scrolled down to the bottom Event Map section expanded, page scrolled to section top Event Map section expanded, section vertically centered in viewport Event Map section expanded, page scrolled to section bottom Event Map section expanded, no scrolling
This is my starting point: the Event Map section is collapsed   Note that if the viewport is not high enough to accomodate for the Event Map section + a 10 pixel wide border around it, the section will not be centered (it just didn't look good) but scrolled to the top of the section.   This is the behavior when the mod doesn't do any scrolling. This behavior is browser dependent, although most browsers behave the same.

In the event of a problem

Revision History

Mod Version Date Contents
13.0.1.10 28 Feb 2021 Merged the previous Mobile Individual Page Map - Person Map mod into the Person Map mod rather than create a Mobile Person Map for TNG v13
13.0.1.9b 6 Oct 2020 Updated to fix the issue where the mod was showing as Partially Installed if the user update the Map Settings
13.0.1.9a 25 Oct 2020 Updated for TNG 13.0.1 to add German and Spanish translations and fix French toggle header text
13.0.1.9 25 Oct 2020 Updated for TNG 13.0.1 and includes Danish, Dutch, and French translations
13.0.0.8 14 Sep 2020 Updated for TNG 13
12.0.0.7 15 May 2018 Updated to fix issue with TNG v12 version when saving Map Settings
12.0.0.6 1 May 2018 Updated for TNG v12
11.0.0.1 23 Mar 2016 Fixed the issue where the Mobile Individual Page Map v11.0.0.0 had the wrong version number on a rewrite when changing the mapconfig.php file
11.0.0.0 15 Mar 2016 Updated the Mobile Individual Page Map - Person Map for TNG V11
10.1.0.2a 25 Apr 2015 Updated the Mobile Individual Page Map - Person Map to fix a problem caused when editing Admin > Map Settings and to add the 2 needed gif files
10.1.0.2 23 Apr 2015 Mobile enhanced version of the Person Map that matches the Mobile Individual Page Map mod
9.1.0.6a 25 Feb 2015 Fixed problem introduced by v9.1.0.6 changes to display the Wiki icon in TNG v10.1 where the version number was not changed in the admin_updatemapconfig.php which caused a problem when updating Map Settings.
9.1.0.6 13 Feb 2015 Added Wiki icon and URL for TNG 10.1 using the %wikipage:Person_Map% Mod Manager directive
9.0.0.5
9.1.0.5
17 Mar 2013 Minor change to ensure compatibility with the Mouse Wheel Zoom mod.
9.0.0.4
9.1.0.4
15 Mar 2013 Bugfix: the Dutch translation of the Click to hide and Click to display labels was not suited for being used by this mod. This version enables to have a custom text. This custom text is set by the language mod.
You only need this update if you want to get the Dutch text right. If you do update however you will have to update all the Person Map mods you're using.
Example: You cannot update the main mod and the Dutch language mod but keep using the 9.0.0.1 version of the French language mod.
9.0.0.3
9.1.0.3
12 Mar 2013
  • Changed layout and labels of the options added to the Map Settings page
  • Added new option Scroll Event Map section to
  • Bug fix to avoid hiding of the map on other pages than getperson.php
9.0.0.2
9.1.0.2
21 Feb 2013 Added an image in front of the Click to display/hide link
9.1.0.1 19 Feb 2013 First version of the mod for TNG v9.1+ (jQuery)

Has of course the same features as v9.0.0.1

9.0.0.1 19 Feb 2013 Added two more options to the mod's feature set
9.0.0.0 2 Aug 2012 Initial config file release for TNG v9.0.0 upto v9.0.3

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
no public site Bart 'Roebie' Degryse Mod developer 9.1.0.5 9.2.0 NL/EN/ES/FR
Our Roy and Boucher Family Ken Roy Currently support Bart's mod.
  • Merged Mobile Individual Page - Person Map in v13.0.1.10
13.0.1.10
TNG 14.0.4
EN, FR
Treichel-Familie.de Andreas Treichel Public & Private 13​.0​.1​.10
TNG 14.0.6
DE,EN,FR,ES,PL
Genealogie Dorp en Marke Losser Peter Heerink Public Site 12.0.0.7 12.3 NL
Families all over the World Hans Weebers Public/Private 11.0.0.1 11.0.0.0 NL/DE/ENG/(FR)
Mitchell Families Online Roger Mitchell A great mod made even better! 9.1.0.5 9.2.0 EN
no public site Joyaa Antares 9.1.0.5 9.2.0 EN
The Tathams of County Durham Robert Collingwood 9.1.0.3 10.0.2 EN
Palmer Family and Friends Gerry Hubacka Not a public site. 9.0.0.2 9.0.3 EN
Nordic Ancestry Mogens C Fenger Not a public site 9.1.0.3 9.1.2 DA,EN
Chamberlain and Eidenbenz Genealogy Graham Chamberlain 12.0.0.2 12.0.1 EN,DE,FR,ES,NL
Osborne Morris Families Steve Osborne 9.1.0.2 9.1.1 EN
Roy~Royes Family Links Bruce Roy 9.1.0.2 9.1.1 EN
DiFava/Brandt Family Tree Larry & Linda DiFava 9.1.0.2 9.1.2 EN
Gilbert family history Warren Gilbert 9.1.0.2 9.1.2 EN
Kemp(e) Family History Andrew Kemp See here See here EN
Whittlesey-Whittelsey Family History Willis S Whittlesey III Public site 9.1.0.2 9.2.0 EN
Ancestral Stewart Family Tree Michael Stewart 9.1.0.3 9.2.0 EN
Legacy Gazette: My Roots - My Legacy Melissa Watson Padilla Public Site 9.1.0.5 TNG 9.2.1 EN
Robison & Blythe Genealogy Jeff Robison Sweet mod 9.1.0.3 11.1.0 EN
Grogan mob Margaret Turner Public site 9.1.0.6a 10.1.1 EN
Turner mob Margaret Turner Public site 9.1.0.6a 10.1.1 EN
Hooley Family Links Rick Hooley Public/Private See Here See Here EN
Gittens One-name Study Cliff Gittens Nice mod, cleans up initial page view. 9.1.0.5 10.0.2 EN
Wortelboer Genealogy Bernard Wortelboer 10.1.0.2a 10.1.3 NL, EN
Andersson-Hoppe-Sahlin-Thorell Erik Hoppe Public / Private 11.0.0.1 11.1.2 SV,EN, DE
Brady Family Tree in Western Australia Darryl Brady Public site 10.1.0.2a 10.1.1 EN, DE
Familie van Seeventer Sandor van Seeventer Public site 13.0.1.10
TNG 14.0.5
EN, DE, NL
Roots & Relatives Remembered Ron Krzmarzick Public & Private, Person Map See here See here EN,DE,CS
Roebuck and Families Ancestry Website Donald Roebuck Public site except for Living 11.0.0.1 11.0.2 EN
Our Family Links Chuck Filteau Public site, modified Template 12 9.1.0.6a v10.1.2 EN
MyMispoche Carlton Brooks Using Mobile Individual Person Map v11.0.0.1 11.0.0.1 11.1.0 EN
OurLife Family History - McMullen Clan Sean Thompson Not a public site. Using Mobile Individual Person Map version 11.0.0.1 11.1.0 EN
Anderson, Kitchen, Ramirez, and Reynoso Families Denton B. Anderson Using Mobile Individual Person Map version 11.0.0.1 11.1.0 EN
Genealogische Datenbank JPB Public site See here See here DE, EN, FR
Rintoul/Bowman Family Andrew Rintoul Public/Private 12.0.0.2 12.0 EN, DE, ES, FR
Drzewo Genealogiczne Rodziny Pepel Klemens Pepel Not a Public site 11.0.0.1 11.1.1 EN, PO
Genealogy of the Weir and Drain Families Beverley Stimpson Public Site 11.0.0.1 11.1.2 EN
Bumbery-Wangler Bob Bumbery Public Site 11.0.0.1 11.1.2 EN
Our Acadian Family Randal Suire Public & Media/Private 12.0.0.7 12.0.1 DE, FR
The Cole / Tanner Family Tree David Cole Public/Private See here See here EN,DE,FR,ES,NL
Jegersberg.com C. Jegersberg Custom public 11.0.0.1 11.1.2.1 NO, SE, EN
Racine d'Alsace J-Louis Valory Public/Private - T17 customized 12.0.0.7 12.0.2 FR
Cordes-Thomas Genealogy John Cordes Public site 12.0.0.7 12.0.2 EN
Journeys in Genealogy Patrick Thrush Public WordPress/TNG bundle 12.0.0.7 12.1 EN
Brabantse Genealogie Rob van Rij Public Site 12.0.0.1 12.2 EN,NL
Stamboom familie Boersma Jan Boersma public site 12.0.0.7 12.0.3 NL, EN
Botebygden - Local Community Research Erik Hoppe public site 12.0.0.2 12.3 SE
The Severijns / Timmer Familytree Rob Severijns Public / Private See here See here NL, EN
Bastiaanssen Genealogy Jan Bastiaanssen Public / Private 13.0.1.10
TNG 14.0.5
EN, NL, ES
Hangaard Genealogy David Hangard Public / Private 13.0.1.10 13.0.4 EN, NO
Skeel, Schaffalitzky og Ahlefeldt Finn Holbek Public / Private 13.0.1.10 13.1.0 DA, Multi
Lathrope Family Genealogy S Sharpe Public 13.0.0.2a 13.0.4 EN
Helwegs Ahnen Andreas Helweg Public site
  • small changes in 'Click to display' text in Config file, due to European data protection regulations
13.0.1.10 13.1 DE, EN, DA, NL
Joseph Oran Holtz Genealogy Pages Jim Holt Private See Here See Here EN
R G Strong Family Genealogy Russell Strong Public V13.0.1.10 14.0.4 EN, DE, FR, NL
Kielakowie.com Janusz Kielak Public site 13.0.1.10 14.0.1 PL, EN, DE
Familjen Johnson Leif Johnson Public site See here See here SE, EN