Difference between revisions of "Person Map"
Line 598: | Line 598: | ||
| [[User:cfj| C. Jegersberg]] | | [[User:cfj| C. Jegersberg]] | ||
| Custom public | | Custom public | ||
+ | | 11.0.0.1 | ||
| 11.1.2.1 | | 11.1.2.1 | ||
− | |||
− | |||
| NO, SE, EN | | NO, SE, EN | ||
|} | |} |
Revision as of 02:17, 9 August 2018
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 | ||
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
|
The Person Map or Mobile Individual Page Map - Person Map mod conflict with the OpenStreetMap BETA mod. You need to uninstall the version of this mod that you are using before the OpenStreetMap mod will install. |
|
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. | |||||||
Mod Updated | 1 May 2018 | |||||||
Download link |
person_map_v12.0.0.7.zip
Dutch language file French language file German language file Spanish language file | |||||||
Download stats | See v9106 and mobile download stats other download statistics | |||||||
Author(s) | Bart 'Roebie' Degryse | |||||||
Homepage | Person Map | |||||||
Mod Support | TNG Community Forums | |||||||
Contact Developer | ||||||||
Latest Mod | 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 | 12+ | |||||||
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.
Mobile enhanced version provided by Ken Roy for TNG V10.1 and V11
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
- 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.
- Extract all the files from the downloaded zip file (1 cfg file and 2 images) into the mods folder.
- Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install the mod.
- Go to Admin >> Setup >> Configuration >> Map Settings.
- Make sure Enable Maps is set to Yes
- Also make sure to set Hide Public Maps to Start to No
- 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.
- Don't forget to press the Save button.
- If the mod doesn't behave as expected, please clear your browser's cache as a first measure:
- Log out of your TNG website
- Clear your browser's cache
- Close and reopen your browser
- 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 |
| |
Yes | No | No | Yes | 210,017 |
| |
Yes | No | Yes | No | 1,004,408 |
| |
Yes | No | Yes | Yes | 1,059,504 |
| |
Yes | Yes | No | No | 7,421 |
| |
Yes | Yes | No | Yes | 96,969 |
| |
Yes | Yes | Yes | No | 91,840 |
| |
Yes | Yes | Yes | Yes | 98,089 |
| |
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.
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).
In the event of a problem
- Try using the Mod Manager Remove capability
- Open an issue in the TNG Community Forums* Copy the backup of the affected files back to your TNG directory
Revision History
Version | Release Date | Contents |
---|---|---|
v12.0.0.7 | 15 May 2018 | Updated to fix issue with TNG v12 version when saving Map Settings |
v12.0.0.6 | 1 May 2018 | Updated for TNG v12 |
v11.0.0.1 | 23 March 2016 | Fixed the issue where the Mobile Individual Person Map - Person Map v11.0.0.0 had the wrong version number on a rewrite when changing the mapconfig.php file |
v11.0.0.0 | 15 March 2016 | Updated the Mobile Individual Page Map - Person Map for TNG V11 |
v10.1.0.2a | 25 April 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 |
v10.1.0.2 | 23 April 2015 | Mobile enhanced version of the Person Map that matches the Mobile Individual Page Map mod |
v9.1.0.6a | 25 February 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. |
v9.1.0.6 | 13 February 2015 | Added Wiki icon and URL for TNG 10.1 using the %wikipage:Person_Map% Mod Manager directive |
v9.0.0.5 v9.1.0.5 |
17 March 2013 | Minor change to ensure compatibility with the Mouse Wheel Zoom mod. |
v9.0.0.4 v9.1.0.4 |
15 March 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. |
v9.0.0.3 v9.1.0.3 |
12 March 2013 |
|
v9.0.0.2 v9.1.0.2 |
21 February 2013 | Added an image in front of the Click to display/hide link |
v9.1.0.1 | 19 February 2013 | First version of the mod for TNG v9.1+ (jQuery)
Has of course the same features as v9.0.0.1 |
v9.0.0.1 | 19 February 2013 | Added two more options to the mod's feature set |
v9.0.0.0 | 2 August 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 |
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 | |
Our Roy and Boucher Family | Ken Roy | Use the mobile version of the Person Map mod | 12.0.0.6 | 12.0.0 | EN, FR |
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 User:Kempons | see User:Kempons | 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 Site | 9.1.0.6a | 10.1.1 | 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 | SE, 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 | 12.0.0.2 | 12.0.1 beta 2 | EN, DE, NL |
Roots & Relatives Remembered | Ron Krzmarzick | Public & Private (Mobile Ind Page Version) | 12.0.0.2 | 12.0.1 | EN,DE,CS,ES |
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 |
Your Roots are Showing | Harold Craswell | Using Mobile Individual Person Map v11.0.0.1 | 11.0.0.1 | 11.1.0 | 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 | English |
Anderson, Kitchen, Ramirez, and Reynoso Families | Denton B. Anderson | Using Mobile Individual Person Map version | 11.0.0.1 | 11.1.0 | EN |
Juergen P. Bourdeaux | Public site | 11.0.0.1 | 11.1.0 | 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 | English, Polish |
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 | English |
Treichel-Familie.de | A. Treichel | Public & Private | 12.0.0.7 | 12.0.1 | DE, UK, FR, ES, PL |
Cole / Tanner Family Tree | David Cole | Public/Private | see here | see here | English |
Jegersberg.com | C. Jegersberg | Custom public | 11.0.0.1 | 11.1.2.1 | NO, SE, EN |