Cookies help us deliver our services. By using our services, you agree to our use of cookies.


Jump to: navigation, search

Place Map

4,684 bytes added, 18:25, 10 October 2018
Sites using this mod
Places can be shown by Place Type or by Event Type. In addition, places can be displayed over set time intervals.
| mod_validation = Admin application not validatedTested on TNG v10.1.3 and v11.0.2
| download_link = for {{Tv110}}{{Tv100}}[ 22]
| download_stats = [ Download Stats]
| mod_author = [[User:wvoigt|Wendel Voigt]]
| mod_url = [[Place_Map]]
| mod_support = [http://www.tngforumvoigtworld.uscom/index.phpgenealogy?showtopicshow=mod_support&modname=3460 TNG ForumsPlace_Map Contact Wendel]
| mod_contact = [ My Mod Support&modname=Place_Map Contact Wendel]
| mod_version = 4 for TNG V10 and up
| min_TNG_ver = 10.0.0
| related_mods = [[World_map_mod]]
| notes = May run slow on sites with very large number of places and events.
== Introduction ==
Inspired by [http://wwwtng.tngforum.uscommunity/index.php?showtopic=3460 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 more additional flexibility in the way data can be displayed.
Some of the features include:
* 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, heatmaps . 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 ===
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.[[image:Place Map Example1.jpg|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.[[image:Place Map Example2.jpg|Place_Map]] === Mod Options Page ===This is an example of the mod parameters that can be edited.[[image:Place Map Example3.jpg|Place_Map]] ==[[Mod Manager - Installing Config Files | Automated Installation]] == === For TNG V10 and above ==={{TNG 10.0|and after}}# Download the appropriate zip file from the Mod Summary in the upper right hand corner # After downloading the zip file, unzip it into your '''mods''' folder# 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 == # In the Mod Manager, uninstall the Mod# 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==
{| border="1" cellspacing="5" cellpadding="2" class="wikitable" width="7590%"
! Contents
| V10.0.0.8
| width="20%" | 08 Jan 2017
* update place_map.js to be more robust in ignoring invalid event types
| 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.
| 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
| V10.0.0.5
| width="20%" | 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.
| V10.0.0.4
| width="20%" | 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
| V10.0.0.3
| width="20%" | 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.
== Sites using this mod ==
If you download and install this mod, please add your TNG site to the table below
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
! User
! Note
! Mod-Version
! TNG-Version
! User-language
| []
 | [[User:wvoigt| Wendel Voigt]]
| Wendel is the developer of the Place_Map Mod
 || 10.01.3,11.0.1 under test
| English
| [ MOTYER Family Genealogy]| [[User:JMM|John Mark Motyer]]| Public site| [[User:JMM|see here]]| [[User:JMM|see here]]| EN, DE, RU|-| [ Brady Family Tree in Western Australia]| [[User:bradyfamilytree|Darryl Brady]]| Public site || 10.1.1| EN, DE|-| [ Racine d'Alsace]| J-Louis Valory| Public/Private - T17 customized|| 12.0.2| French |-| [ Our Family History]| Paul Barrett| Public site|| 11.1.2 with WordPress| EN|-
== Related Links ==
* [http://wwwtng.tngforum.uscommunity/index.php?showtopic=3460 TNG Community Forum Topic:Map showing all locations of events]
* See also [[World_map_mod]]
* genlib.php
[[Category:Mods for TNG v11]]
[[Category:Mods for TNG v10]]
[[Category:admin_main.php mods]]

Navigation menu