Difference between revisions of "Place Map"

From TNG_Wiki
Jump to: navigation, search
(Updated for 10.0.0.5)
(place_map_v10.0.0.11)
 
(19 intermediate revisions by 4 users not shown)
Line 2: Line 2:
  
 
| mod_name = Place_Map
 
| mod_name = Place_Map
 
 
| mod_summary = This mod displays a map with all of the geocoded places in the TNG database.  Options include showing pins, clusters, or heatmaps of places.
 
| mod_summary = This mod displays a map with all of the geocoded places in the TNG database.  Options include showing pins, clusters, or heatmaps of places.
 
Places can be shown by Place Type or by Event Type.  In addition, places can be displayed over set time intervals.
 
Places can be shown by Place Type or by Event Type.  In addition, places can be displayed over set time intervals.
  
| mod_validation = Tested on TNG v10.1.3 and v11.0.1
+
| mod_validation = Tested on TNG v10.1.3, v11.0.2, v12.2
 
+
| download_link = for {{Tv120}}{{Tv110}}{{Tv100}} [http://voigtworld.com/ccount2/click.php?id=30 Place_map_v10.0.0.11.zip]
| download_link = for {{Tv110}}{{Tv100}} [http://voigtworld.com/ccount2/click.php?id=19 Place_map_v10.0.0.5.zip]
 
 
 
 
| download_stats = [http://voigtworld.com/ccount2/index.php?action=stats&groupid=4 Download Stats]
 
| download_stats = [http://voigtworld.com/ccount2/index.php?action=stats&groupid=4 Download Stats]
 
 
| mod_author = [[User:wvoigt|Wendel Voigt]]
 
| mod_author = [[User:wvoigt|Wendel Voigt]]
 
+
| mod_last_update = 07 Mar 2020
 
| mod_url = [[Place_Map]]
 
| mod_url = [[Place_Map]]
 
 
| mod_support = [http://www.voigtworld.com/genealogy?show=mod_support&modname=Place_Map Contact Wendel]
 
| mod_support = [http://www.voigtworld.com/genealogy?show=mod_support&modname=Place_Map Contact Wendel]
 
 
| mod_contact = [http://www.voigtworld.com/genealogy?show=mod_support&modname=Place_Map Contact Wendel]
 
| mod_contact = [http://www.voigtworld.com/genealogy?show=mod_support&modname=Place_Map Contact Wendel]
 
+
| mod_version = 10.0.0.10 for TNG V10 and up
| mod_version = 10.0.0.4 for TNG V10 and up
 
 
 
 
| min_TNG_ver = 10.0.0
 
| min_TNG_ver = 10.0.0
 
 
| max_TNG_ver = 10.0.0+
 
| max_TNG_ver = 10.0.0+
 
 
| TNG_file_list = See [[Place_Map#TNG_Modules_Involved | TNG Modules Involved]]
 
| TNG_file_list = See [[Place_Map#TNG_Modules_Involved | TNG Modules Involved]]
 
 
| related_mods = [[World_map_mod]]
 
| related_mods = [[World_map_mod]]
 
 
| notes          = May run slow on sites with very large number of places and events.
 
| notes          = May run slow on sites with very large number of places and events.
  
Line 45: Line 33:
  
 
Some of the features include:
 
Some of the features include:
 +
* Map provider can be '''Google Maps''' or '''Open Street Maps''' in setting.  However, it will default to Open Street Maps if a Google Map key is not provided.
 +
* The initial map display type can be set to 'ROADMAP', 'SATELLITE', 'HYBRID', or 'TERRAIN'.
 
* Custom sub-title
 
* Custom sub-title
 
* Custom map height (it uses the full width of the screen)
 
* Custom map height (it uses the full width of the screen)
Line 106: Line 96:
 
! Contents
 
! Contents
  
 +
|-
 +
 +
| V10.0.0.11
 +
 +
| width="20%" | 07 Mar 2020
 +
 +
|
 +
* Added setting and support for Open Street Maps as an alternative to Google Maps.  Will automatically switch to Open Street Maps if no Google map key is set.
 +
* Added setting for initial map display type.  Can be 'ROADMAP', 'SATELLITE', 'HYBRID', 'TERRAIN'.
 +
* Added check for place levels that have no entry.  Now provides a default.
 +
* Fixed issue where $subroot was not being used when loading mapconfig.php.
 +
 +
[http://voigtworld.com/ccount2/click.php?id=30 Place_map_v10.0.0.11.zip]
 +
 +
|-
 +
 +
| V10.0.0.10
 +
 +
| width="20%" | 17 Feb 2020
 +
 +
|
 +
* Can now configure what, if any, totals are displayed on the Places and Events legends.
 +
* Places and Events totals are now for the selected Tree, not all the Trees (unless All Trees is selected.)
 +
* Event legend can now be turned off.
 +
* Several new features on the date display.  Individual date ranges are clickable.  Can set starting date interval (by number or year).
 +
* Added an option to skip year intervals with no events.
 +
* Set the lat/lng accuracy to 5 decimal places (1.1 meters).
 +
* Can now select which TNG tree displays upon page load.  If the tree is not found, places for all trees are displayed.
 +
* Add option to change settings via URL parameters.  If enabled, URL parameters can be used to change the map.  See config for the URL parameters for each option.
 +
* Now hide the sidebar controls if the sidebar is turned off in configuration (NOTE: visitors will not be able to turn on the sidebar).
 +
* Some css updates.  Mostly adding items, but a few small tweaks.
 +
* This was first labeled v10.0.1.0  These two versions are identical except for the version number.
 +
 +
[http://voigtworld.com/ccount2/click.php?id=29 Place_map_v10.0.0.10.zip]
 +
 +
|-
 +
 +
| V10.0.0.9
 +
 +
| width="20%" | Never Published
 +
 +
|
 +
 +
* A special debug build given out to a few experiencing issues.
 +
 +
|-
 +
 +
| V10.0.0.8
 +
 +
| width="20%" | 08 Jan 2017
 +
 +
|
 +
 +
* update place_map.js to be more robust in ignoring invalid event types
 +
 +
[http://voigtworld.com/ccount2/click.php?id=22 Place_map_v10.0.0.8.zip]
 +
|-
 +
 +
| V10.0.0.7
 +
 +
| width="20%" | 01 Jan 2017
 +
 +
|
 +
 +
* Fixed problem with map keys not being loaded for google maps
 +
* Removed &sensor=false in calling google maps since it is no longer needed and was giving a warning.
 +
 +
[http://voigtworld.com/ccount2/click.php?id=21 Place_map_v10.0.0.7.zip]
 +
|-
 +
 +
| V10.0.0.6
 +
 +
| width="20%" | 28 Aug 2016
 +
 +
|
 +
 +
* Eliminated mod warnings.
 +
* Added robustness during initial load where unused place and event types are hidden.
 +
* Added support for TNG v11 Google map keys
 +
 +
[http://voigtworld.com/ccount2/click.php?id=20 Place_map_v10.0.0.6.zip]
 
|-
 
|-
  
Line 178: Line 249:
 
| [[User:wvoigt|Wendel Voigt]]
 
| [[User:wvoigt|Wendel Voigt]]
 
| Wendel is the developer of the Place_Map Mod
 
| Wendel is the developer of the Place_Map Mod
| 10.0.0.4
+
| 10.0.0.11
| 10.0.3
+
| 12.2
 
| English
 
| English
 
|-
 
|-
Line 189: Line 260:
 
| EN, DE, RU
 
| EN, DE, RU
 
|-
 
|-
| [http://www.bradyfamilytree.org/ Brady Family Tree in Western Australia]
+
| [https://www.bradyfamilytree.org/ Brady Family Tree in Western Australia]
 
| [[User:bradyfamilytree|Darryl Brady]]
 
| [[User:bradyfamilytree|Darryl Brady]]
 
| Public site  
 
| Public site  
Line 195: Line 266:
 
| 10.1.1
 
| 10.1.1
 
| EN, DE
 
| EN, DE
 +
|-
 +
| [http://racine-ad.fr/TNG/index.php Racine d'Alsace]
 +
| J-Louis Valory
 +
| Public/Private - T17 customized
 +
| 10.0.1.0
 +
| 12.0.2
 +
| French
 +
|-
 +
| [https://ourfamilyhistory.club Our Family History]
 +
| Paul Barrett
 +
| Public site
 +
|10.0.0.9
 +
| 11.1.2 with WordPress
 +
| EN
 
|-
 
|-
 
|}
 
|}
Line 209: Line 294:
 
* genlib.php
 
* genlib.php
  
 +
[[Category:Mods for TNG v12]]
 
[[Category:Mods for TNG v11]]
 
[[Category:Mods for TNG v11]]
 
[[Category:Mods for TNG v10]]
 
[[Category:Mods for TNG v10]]

Latest revision as of 21:01, 7 March 2020

Place_Map
Summary This mod displays a map with all of the geocoded places in the TNG database. Options include showing pins, clusters, or heatmaps of places. Places can be shown by Place Type or by Event Type. In addition, places can be displayed over set time intervals.
Validation Tested on TNG v10.1.3, v11.0.2, v12.2
Mod Updated 07 Mar 2020
Download link for
TNG 12.0
TNG 11.0
TNG 10.0
Place_map_v10.0.0.11.zip
Download stats Download Stats
Author(s) Wendel Voigt
Homepage Place_Map
Mod Support Contact Wendel
Contact Developer Contact Wendel
Latest Mod 10.0.0.10 for TNG V10 and up
Min TNG V 10.0.0
Max TNG V 10.0.0+
Files modified
Related Mods
Notes
May run slow on sites with very large number of places and events.


Introduction

Inspired by TNG Community Forum Topic:Map showing all locations of events, this is updated code in a mod format. While similar to World_map_mod, this mod provides additional flexibility in the way data can be displayed.

Some of the features include:

  • Map provider can be Google Maps or Open Street Maps in setting. However, it will default to Open Street Maps if a Google Map key is not provided.
  • The initial map display type can be set to 'ROADMAP', 'SATELLITE', 'HYBRID', or 'TERRAIN'.
  • Custom sub-title
  • Custom map height (it uses the full width of the screen)
  • Custom initial Latitude, Longitude, Zoom of Map. Chose to display these values or not on the map.
  • Custom pin display. Pins or clusters. A heatmap can be added (based on number of events at locations).
  • Can overlay the map options on the map, or have them separate below the map.
  • Custom year interval for display. You can select all, or year intervals such as 20, 25, 40, 50, etc.
  • Can have a sidebar with the names of the currently selected places. The place names can also be clicked to show the location information. Name information can be either shown Small to Big (e.g., city, county, state, country) or Big to small (e.g., Country, state, county, city).
  • Sidebar display, size, and location (on the map or below the map) are customizable.
  • Design is intended to scale with size of screen. So still useable on phones.
  • To make customization easier, all styling is done in css.

Custom Year Display

When enabled, this feature allows the exploration of event places over time in the database. The administrator can decide what year intervals are reasonable for displaying the data and which of those will be used as a default range. These intervals are then provided to the user of the page. When the intervals are turned on in the Map Options area, only those places with events during that year interval range will be displayed. The timeline below the map will show which interval is being displayed. Controls are then provided to step forward or backward one interval. Controls are also provided to skip to the beginning or end of all the intervals. The total interval range is based upon the dates in the data and will extend from the first dated event at a geocoded location to the latest dated event at a geocoded location.

Examples

Full Page

This example shows the full page, with a 20 year interval starting in 1880 and ending in 1899. The forward arrows will advance the time to 1900 to 1919 and the map will adjust accordingly. Also note the Map options in the upper right hand corner of the map and the side bar of displayed places in the lower right part of the screen. The sidebar of place names is scrollable and searchable. It will only display names of places currently displayed on the map. Places are only displayed if they are in the correct date range, have the place type selected, and have a selected event type. Using these controls, you can see just births, or just deaths or any combination you choose. Place_Map

Window from Sidebar selection

This example shows the place "New Braunfels, Comal Co., Texas" selected in the sidebar. The number of places in the sidebar was narrowed by the search field. In the map area, after the link was selected, a window was opened to show information about the place. The top title field, when clicked, will open the TNG page for that place. Icons at the bottom of the window let you zoom in, zoom out, or zoom to the place on the map. Place_Map

Mod Options Page

This is an example of the mod parameters that can be edited. Place_Map

Automated Installation

For TNG V10 and above

TNG version: 10.0
  1. Download the appropriate zip file from the Mod Summary in the upper right hand corner
  2. After downloading the zip file, unzip it into your mods folder
  3. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install the living_flag_backup.cfg.

Upgrade to new version

  1. In the Mod Manager, uninstall the Mod
  2. Install the new version of the mod using the above procedure.

Changes to genlib.php

For older versions of the mod manager, a valid mod must change at least one file. To accomodate, this mod changes genlib.php to include a menu item "Places" that points to the place_map.php. This is the only change to TNG. All other files are provided by the mod.

Caution

While care has been taken to be as efficient as possible in dealing with the data, it is possible that this mod may work very slowly with large collections of data. The author's site has almost 1600 geocoded places used in over 8500 events in the TNG database and performance is still reasonable. But your results may differ.

Revision History

Version Date Contents
V10.0.0.11 07 Mar 2020
  • Added setting and support for Open Street Maps as an alternative to Google Maps. Will automatically switch to Open Street Maps if no Google map key is set.
  • Added setting for initial map display type. Can be 'ROADMAP', 'SATELLITE', 'HYBRID', 'TERRAIN'.
  • Added check for place levels that have no entry. Now provides a default.
  • Fixed issue where $subroot was not being used when loading mapconfig.php.

Place_map_v10.0.0.11.zip

V10.0.0.10 17 Feb 2020
  • Can now configure what, if any, totals are displayed on the Places and Events legends.
  • Places and Events totals are now for the selected Tree, not all the Trees (unless All Trees is selected.)
  • Event legend can now be turned off.
  • Several new features on the date display. Individual date ranges are clickable. Can set starting date interval (by number or year).
  • Added an option to skip year intervals with no events.
  • Set the lat/lng accuracy to 5 decimal places (1.1 meters).
  • Can now select which TNG tree displays upon page load. If the tree is not found, places for all trees are displayed.
  • Add option to change settings via URL parameters. If enabled, URL parameters can be used to change the map. See config for the URL parameters for each option.
  • Now hide the sidebar controls if the sidebar is turned off in configuration (NOTE: visitors will not be able to turn on the sidebar).
  • Some css updates. Mostly adding items, but a few small tweaks.
  • This was first labeled v10.0.1.0 These two versions are identical except for the version number.

Place_map_v10.0.0.10.zip

V10.0.0.9 Never Published
  • A special debug build given out to a few experiencing issues.
V10.0.0.8 08 Jan 2017
  • update place_map.js to be more robust in ignoring invalid event types

Place_map_v10.0.0.8.zip

V10.0.0.7 01 Jan 2017
  • Fixed problem with map keys not being loaded for google maps
  • Removed &sensor=false in calling google maps since it is no longer needed and was giving a warning.

Place_map_v10.0.0.7.zip

V10.0.0.6 28 Aug 2016
  • Eliminated mod warnings.
  • Added robustness during initial load where unused place and event types are hidden.
  • Added support for TNG v11 Google map keys

Place_map_v10.0.0.6.zip

V10.0.0.5 18 June 2016
  • Abbreviated event names in placemap.Marker(). On my 1600 places with 8600 events I saw about 12% smaller HTML file.
  • Forced Google controls to the left side, making more room for Place Map overlays.
  • Made cluster images local after default images were no longer being served in original location.

Place_map_v10.0.0.5.zip

V10.0.0.4 28 June 2015
  • Added the ability to disable the Place location level pins.
  • Added a single pin name field to use if the Place location levels are disabled
  • Added mm_20_red.png file as a pin alternative when used above

Place_map_v10.0.0.4.zip

V10.0.0.3 06 April 2015
  • Added css to hide the year controls until needed. They no longer flash on, then off during page load.
  • Corrected problem when a date range had no events.

Place_map_v10.0.0.3.zip

V10.0.0.2 05 April 2015
  • Original release

Place_map_v10.0.0.2.zip

Developer

This mod was developed by Wendel Voigt

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
Voigtworld.com Wendel Voigt Wendel is the developer of the Place_Map Mod 10.0.0.11 12.2 English
MOTYER Family Genealogy John Mark Motyer Public site see here see here EN, DE, RU
Brady Family Tree in Western Australia Darryl Brady Public site 10.0.0.3 10.1.1 EN, DE
Racine d'Alsace J-Louis Valory Public/Private - T17 customized 10.0.1.0 12.0.2 French
Our Family History Paul Barrett Public site 10.0.0.9 11.1.2 with WordPress EN

Related Links

TNG Modules Involved

In TNG V10 and above, this mod modifies the following files:

  • genlib.php