Placesearch-More Info

Placesearch-More Info
Summary	Modifies placesearch.php to to incorporate places subordinate to the named place, and to do display data info other than the redundant place name in the even details.
Validation
Mod Updated	28 Jan 2023
Download link	v14.0.0.5j TNG 14.0 v13.1.0.5h TNG 13.1.0 See the Revision History for older versions
Download stats
Author(s)	Robin Richmond
Homepage	Robin Richmond's Genealogy Database
Mod Support	My Mod Support form
Contact Developer	My Mod Support form
Latest Mod	14.0.0.5j
Min TNG V	12.0
Max TNG V	14
Files modified	placesearch.php
Related Mods	Mod Settings Blocks, Inner Mod Menus, Notes-Expand WWW Refs, FindAGrave Links (see Related Mods)
Notes

Purpose of the Mod

To make placesearch.php (which I will refer to frequently as the TNG "Place Detail" report) more useful, by, among other things:

• Adding information to most event tables,
• Adding the ability to focus on a particular Event type, and
• Adding the ability to
  • Bubble-up to higher-level places, and
  • Include places that are subordinate to (or within) the selected place.
• Displaying the entire Place Note rather than a truncated version.
• Trying to link to Wiki articles for the selected Place, and its subordinate place components.

This rather complex mod makes numerous enhancements to placesearch.php. However, this mod does not substantially alter the basic functionality of placesearch.php. In most cases, when you first display the Place Detail report, you'll see essentially what TNG has always shown you, with new buttons that enable the various new features.

New Features

The features listed here, and more, are illustrated in the Visualizations below. (The order in which the features are listed is pretty arbitrary. The order of the Visualizations generally matches the order of these notes.

Wikipedia Link

[Show Details]

A Wikipedia icon next to the Placename in the page heading tries to link to Wikipedia articles for each component of the Placename. (Jump to the relevant visualization)

When you click on the Wikipedia icon, a second copy of the placename - which looks essentially like the placename immediately to its left - appears. Each linked component of this second copy of placename, however, goes to (what we hope is) the Wiki article for that component.

[Hide Details]

Abbreviated Placenames

[Show Details]

Subordinate placenames can be abbreviated, since they all contain the name of the selected place. (See these relevant visualizations: Subordinate Places & Event Tables)

When subordinate places are included in a report, their placenames always (by definition) share the name of the selected place as a suffix. For instance, the names of places within Bradley County, Tennessee end with "Bradley County, Tennessee, USA". As a result, there is a great deal of redundancy in a list of subordinate placenames, and in the event place column of the Place Detail report's event tables.

When mod parameters permit it, those redundant suffixes will be replaced by ellipses, and the selected placename will be replaced by the word "(here)" (in parentheses).

In addition,

1. The report will display a button that causes the full placenames to be displayed, and
2. All abbreviated placenames will be clickable. When you click on an abbreviated placename, its full name will replace the abbreviation (but only for that one instance of the placename).
   [Hide Details]

Event Tables

[Show Details]

The modified Place Details Report removes some redundant information from the event tables, and adds new information to most of them.

(Jump to the relevant visualization)

1. In native Place Details report, each event table has a column for the place at which the event occurred. But, because of the very nature of the Place Details report, the same placename appears in every row of the event table. This mod removes the placename column from every event table.
2. All event table for personal events have columns for the birth date/place and the death date/place (well, except for the Birth and Death columns, which omit a redundant Place column)
3. When a person has more than one event of a given type (as frequently happens with Residence and Census events) all information for all of a person's events (except for the event date) is the same. Thus, on all but the first row, the name, birth date/place, and death date/place are replaced by ditto marks.

Note that this is one of the few features implemented by this mod that is not hidden behind a button.

[Hide Details]

Event Focus

[Show Details]

The modified Place Details report lets you focus on any event listed for that place; that is, to display only that events Event Table, and, if there are enough events occurrences, to step through multiple pages of just that event. (Jump to the relevant visualization)

The native Place Details report always shows you events of all event types. Thus, if you are really interested in the list of, say Residence events, when you link to the second, third, or fourth (etc.) page of marriage events you necessarily must

• Wait for the report to run a query for every possible eventtype, and
• Scroll through the event tables that precede the event table you are looking for.

The Placesearch-More Info mod addresses that situation by adding a Focus button next to each event table. When you click on a Focus button, the Place Details report will then focus on one type of event, and will display a Show All Events next to its only event table.

If you are looking at, say page 5 of all event types, and then decide to focus on one event type, the program necessarily takes you back to page 1 of that event type. Similarly, if you are focused on one event type, and are looking at page 5, when you click "Show All Events", you'll be taken back to page 1.

[Hide Details]

Subordinate Places

[Show Details]

This may be the most significant new feature implemented by this mod. It lets you see map pins and events from all Places that are subordinate to (i.e. within) the selected place! (Jump to the relevant visualization)

If you are looking at a report for "Bradley County, Tennessee, USA", the native TNG code does not show you all events that occurred in Bradley County. Instead, it shows you all events that occurred at the exact placename "Bradley County, Tennessee, USA", excluding events that occur within Bradley County, at places like "Cleveland, Bradley County, Tennessee, USA", "Fort Hill Cemetery, Cleveland, Bradley County, Tennessee, USA", etc.

The modified report lets you see both. That is, when the selected place in a Place Details report has subordinate Places, you will see a button that shows the number of subordinate places and allows you to display them, e.g. Include Subordinate Places (35). When you click on that button, the page reloads and

1. Displays all of those subordinate places on the map, and
2. Includes all of those subordinate places in the event search results.

Below the map, you'll see another button that says Show Place Names. Clicking on that button will display a list of subordinate places. Once the list is displayed, it can be sorted by map pin number or by placename.

Importantly, but less-than-ideally, this feature shows all subordinate Places, not just the Places that are immediately subordinate to the selected Place.

Special cases

1. If the selected Place has only a few subordinate places, the modified code loads them automatically, with a button that says "Exclude Subordinate Places". The meaning of "a few subordinate places" is determined by a mod parameter.
2. When multiple Places have the same geographic coordinates, those places will be represented by one map pin. If you click on such a map pin, the map balloon will include the names of all of the Places that the pin represents.
3. The Place Details report is normally invoked for a specific tree in your database. But when it is invoked without a selected tree:
   • More than one instance of the selected Place may be shown on the map.
     • You should ordinarily expect to see just one pin on the map, as all of the instances of the selected Place in different trees should have the same geo-coordinates. But it is certainly possible for the same place to have different coordinates in different trees, so you could see multiple pins.
   • When you also display subordinate Places, Places that don't have matching geo-coordinates in all trees will also be listed more than once.
     [Hide Details]

Bubbling Up

[Show Details]

The Place Details report places the name of the selected place at the top of the report. The modified report turns each "superior" component of that into a hyperlink to its own Place Details report. (Jump to the relevant visualization)

For example
Cleveland, Bradley County, Tennessee, USA.

As a result, you can quickly generate a Place Details report for Bradley County, for Tennessee, or even for the USA.

The selected place does not have to be a Place in the database. That is, the existence of the place "Cleveland, Bradley County, Tennessee, USA" in a database does not require that "Bradley County, Tennessee, USA" be a place in the database. If the new placename (e.g. "Bradley County, Tennessee, USA") does not exist as a Place in the database, the report will note that fact, but will still offer you the opportunity to display all places that are subordinate to that placename.

[Hide Details]

Full Place Note

[Show Details]

The modified Place Details report displays the entire place note. After all, if there is any place in TNG where the full place note is displayed, it should be the Place Details report.

Before displaying the Place note, the native Place Details report, like several other TNG programs,

• Truncates the text fields to the length specified by a TNG system parameter, and
• Removes HTML tags in the field.

It does so by calling the aptly-named TNG system function truncateIt().

To display the entire Place note, the modified Place Detail report calls a different TNG system function, insertLinks(), which

• Does not truncate the Notes field or remove existing HTML code in the note, and
• Recognizes web addresses and converts them into hyperlinks.

The Place note is also affected by other TNG mods - see Related Mods below.)

[Hide Details]

Mod Options

These mod options are custom TNG settings, defined and edited in a Mod Settings Block in the form at Admin>>Setup>>General Settings, in a new subform named Mod Settings Blocks. (Robin's Mods in TNGv12). See the last visualization below..

1. Maximum number of subordinate places that will be loaded automatically (10) - As noted above, this mod allows users to see places that are subordinate to (i.e. within) the selected place. When there are few enough subordinate places, the subordinate places can be displayed automatically. This parameter determines what "few enough" is. When there are more than this number of subordinate places, all of the subordinate results will be hidden behind a button. A value of zero means, in effect "Don't ever load subordinate places automatically".
2. Abbreviate Placenames in the Places List below the map (yes) - By definition, the selected Placename is a suffix to every subordinate Placename. To save space in the list of subordinate Placenames, that redundant suffix can be hidden. The full Placename will be displayed when you mouse over an abbreviated Placename. The default is to hide those suffixes (at least initially).
3. Allow the format of Placenames under the map to be toggled (yes) - This option is particularly relevant if you start with full placenames and don't want users to see the abbreviated placenames. If you start with abbreviated placenames, you're probably going to want users to be able to see the full placenames.
4. Abbreviate Placenames in the Event tables (yes) - This option works exactly like Abbreviate Placenames in the Places List below the map.
5. Allow the format of Placenames in the Event tables to be toggled (yes) - This option works exactly like Allow the format of Placenames under the map to be toggled.

Paths to the Place Detail report

Several execution paths lead you to the Place Detail report. Among them are:

1. In many places where Place names are listed (for example, the Person Profile, Ancestor & Descendant reports, and the end-user Place List program (browseplaces.php), a small spyglass icon next to the Place name leads directly to the Place Detail report.
2. The View/Test button on each result line at Admin >> Places runs the Place Detail report.
3. In the list of places in the Place Detail report, each Placename is a hyperlink to the Place Detail report.
4. Portions of the selected Place name at the top of the Place Detail report are hyperlinks to the Place Detail report.

The first two of these paths always select a Place name in a particular tree, and the last two are new features implemented by this mod. (I believe that there is a also path that allows you to select a Place name without specifying a tree, but I can't think of it now.)

Compatibility

• In TNGv12, this mod incorporates the single change made by Placesearch Entire Note, and is thus not compatible with it. In TNGv13, the native code displays the entire Place note, so Placesearch Entire Note has been retired.
• This mod is not compatible with Wikipedia Link Mod' but it has its own implementation of Wikipedia links. Thus Wikipedia Link Mod isn't needed with this mod.
• In TNGv13, this mod IS compatible with OpenStreetMap.

Related Mods

1. The Mod Settings Blocks mod packages this mod's options into what I call a "Mod Settings Block", which is a set of form fields that formatted and labeled so that it stands out among other options in an Admin>>Setting form. Mod Settings Blocks is a prerequisite for this mod; it must be installed before this mod can be installed.
2. Notes-Expand WWW Refs affects the Place Notes field by recognizing web addresses that begin with "www." and converting them into hyperlinks.
3. FindAGrave Links affects the Place Notes field by recognizing abbreviated FindAGrave Grave and Cemetery references (CRid=nnnn or GRid=nnnn) and expanding them into hyperlinks.

Note that Notes-Expand WWW Refs and FindAGrave Links affect the TNG system function insertLinks(), and thus automatically affect several TNG programs. They affect the Place Detail only if this mod (Placesearch-More Info) is also installed.

Installation

This mod does not use standard cust_text.php files for language strings. Instead, it stores languages strings in the mod's subfolder, and pages modified by this mod load language strings directly from files in the mod's languages/ subfolder. Read more about this technique and its procedure for handling site-specific language string overrides.

[Show Standard Installation Process]

Requirements

• A working TNG installation.
• An installed current version of the Mod Manager.
• You should backup files listed in the panel on the right.

Procedure

1. Remove and delete previous version of this mod.
2. Backup the files updated by this mod. They are listed in the panel at the upper right.
3. Download the .zip file, Extract its .cfg file to the mods folder.
4. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files.

Problems?

1. Try using the Mod Manager Remove capability
2. Contact me through My Mod Support form.

[Hide Details]

Visualizations

These visualizations reflect the New Features listed above, and are in the same order as those features, though not all features have visualizations. Still, these visualizations and their notes are pretty extensive.

[Show the visualizations]

[Hide the Visualizations]

The Place Details report before installation of this mod The two Event tables shown here have 204 and 60 events, and thus require 7 and 2 pages to display. Other Event tables might have 2 events, or 5000.

After Installation: 1. The Wikipedia Link in the page heading The second instance of the placename, as shown here, appears only after a user clicks on the Wikipedia icon. Each of its hyperlinks try to link to a Wikipedia article. A city/town link uses the town name and the state name, e.g. Leon, Iowa A county link uses the county name and the state name, e.g. Decatur County, Iowa The state and country links use just that name, e.g. Iowa and USA If there is what TNG calls a "Location" component of the placename, the hyperlink to Wikipedia consists only of the Location name. (In my database, Locations are almost always cemeteries. Some cemeteries do have articles whose titles are merely the cemetery name. Other article titles include the city and/or state, but a link to the cemetery alone may display a disambiguity page, or be a starting point for a Wikipedia search. These links do not explicitly open a new browser window or tab, so it is likely that users will want to shift-click or control-click on them to open (respectively) a new window or tab.

After Installation: 2. Changes to Event Tables The Primary instances of TNG's built-in Eventtypes are explicitly labeled. The built-in Eventtypes (Birth, Death, Christening, Burial, Marriage, Divorce, and LDS events). Most, if not all, Person and Family records in a TNG database, are likely to have just one instance of these events. Secondary instances of the built-in Eventtypes are not explicitly labeled as such. The Placename is now displayed in the heading for each Eventtype. The redundant event place column has has been removed from each table. Every event table for personal events now has Birth and Death columns. The redundant placename suffix ", Bradley County, Tennessee, USA" has been removed from the Placename "Cleveland...". The abbreviation of placenames can be suppressed by a mod parameter. To flag cases where the selected Placename is used, it is abbreviated as "(here)". No spyglass is needed for (here). The mod parameter that suppresses the abbreviation of placenames (mentioned with feature #5) also suppresses this feature. When a person has events on consecutive lines, the duplicate Person names, Birth/Death dates, and Birth/Death places have been replaced with ditto marks.

After Installation: 3. Focusing on an Event In case you are interested in drilling down into only one type of event, a "Focus" button is now placed next to each Event table. When you click on a "Focus" button, the program displays only one event table. On pages where only one event table is displayed, the program will display a "Show All Events" button in place of the "Focus" button.

After Installation: 4. Bubble-up and Hiding the map These two features are manifested at the very top of the Place Details report; hence the very short screen clip just below. The hyperlinks within the place name at the top of the page let you "bubble-up" to higher-level place names. In this example, those higher-level placenames are Bradley County, Tennessee, USA Tennessee, USA, and even USA The place that you bubble-up to does not have to be represented by a Placename in your database! You will see a warning if you bubble-up to a place that isn't in your database, but when you encounter that situation, you can: View (and then select) subordinate places for the new place (as described with the next visualization), or Just bubble-up to another place component. New "Hide Map" and "Show Map" buttons let you hide (or show) the map - not just for the moment, but for subsequent invocations of the Place Details report. If the map is hidden, you may see an "Always Show Map" button in addition to the "Show Map" button. The "Include Subordinate Places" button will add all places that are subordinate to (or within) the selected place to be added to the map and to the Event tables. The way that subordinate events are defined and handled are described with the next visualization. The button is highlighted here because the next visualization assumes that the user has clicked on this button.

After Installation: 5. Subordinate Places: This screen clip represents the Place Details Report after the user has clicked on the "Show Subordinate Places" button, and the web page has been reloaded so that it shows the subordinate places. The "Show Subordinate Places" button has been replaced with two buttons, "Show full Placenames" and "Exclude Subordinate Places" button. There are now multiple pins on the map. The selected Place is represented by pin #1 Places with the same geolocation utilize one pin. All Placenames associated with that pin are displayed in the pin's popup balloon. Another new button, "Show place names", causes a list of all of the subordinate Placenames to be displayed. (See the next visualization.) The Place Detail Report displays a Cemetery table if any cemeteries exist in (or in this case within) the selected Place. The values in the "Location" column of the Cemeteries table are never abbreviated because, unlike placenames, Cemetery locations are composed of separate City, County, State, and Country fields. The In the Primary Birth events table, the Birth Place column is displayed because the report is no longer limited to one Placename. When subordinate places are being displayed, the Event Place column necessarily consists of the selected Placename itself (represented by "(here)") and subordinate Placenames. The abbreviation of Placenames can be suppressed by a mod parameter.

After Installation: 6. List of Subordinate Places When you click the "Show place names" button shown in the previous visualization, the page display a list of the subordinate Placenames. (This button does not cause the page to reload, as most of the other new buttons do. This button simply displays the names, which were already in the page, but hidden.) As in the native code, the geocoordinates associated with a pin are displayed when you mouse over the pin. The geocoordinates are no longer in the pop-up balloon. A pin's balloon pops up when you click on the pin. When a pin represents more than one Place, each Placename is shown in the balloon. The "Display place names" button has been replaced by three buttons: "Show full Placenames", "Sort by Placename", and "Hide place names" This "Show full Placenames" button applies only to the list of Placenames, not to the Event tables below. The selected Placename is shown above a horizontal line, and the subordinate Placenames are show below the line. Each subordinate Placename has an attached spyglass as a hyperlink to its own Place Detail Report. As a result, you can drill down from a County to a City, etc. When you hover overa placename, the full placename is displayed in a popup. (This is not shown) When you click on an abbreviated Placename, the full Placename is displayed, as illustrated by "Charleston, Bradley County, Tennessee, USA" The Placenames of Places without geocoordinates are shown at the end of the list.

After Installation: 7. The Placesearch-More Info options in a Mod Settings Block A Mod Settings Block is an outlined subform within an Admin>>Setup program that contains the options for a single mod. What is most notable about a Mod Settings Block is that a hyperlink directly to a Mod Settings Block displays only that block (i.e. only one mod's options), not all of the other options in the form or subform. Here, you see the this mod's Mod Settings Block, in admin_genconfig.php, at Admin>>Setup>>General Settings. The triangular arrow next to the subfolder heading Mod Settings Blocks is pointing to the right, meaning that the subform is not open, and that your site's other mod settings blocks are not visible. If you were to open the subform by clicking on the heading, you would see the all of the mod settings blocks on your site.

[Hide the Visualizations]

Styles

This mod does not add style rules to css/genstyle.css because there are already sooo many rules in genstyle.css, and it seems inappropriate to add several new styles that are used by only one program. Instead, the style rules created by this mod are in an embedded style sheet that is positioned in the DOM just ahead of the reference to genstyle.css. As a result, if TNG site administrators want to modify these rules, they can do so by adding rules at the bottom of genstyle.css or in their template's mytngstyle.css.     [Show this mod's styles]

/* Create just a little bit of room around <h4> headings */
h4.rrpmi-h4 {margin-top:2px; margin-bottom:2px}
/* Create a minimum width for data cells for dates and places */
table.rrpmi td.placecell {min-width:10em;}
table.rrpmi td.datecell {min-width:1em;}
/* Wrap the event heading and focus button */
.rreventhead {max-width:1000px;}
/* Border between the primary and subordinate place lists.*/
/* Note that the place lists are not HTML lists, but are a series of divs that wrap two
   divs that float next to each other.  That's the only way I could come up with to
   get a pin image next to some items, and a sequence number next to others.*/
#rrpmi-primary {border-bottom:thin solid grey;
}
/* Define a width for the subordinate place list so the right-floated "Focus" buttons don't
   drift too far to the right. And force the subordinate place list into two columns.*/
#rrpmi-subordinate {max-width:80em;
	column-count:2;
	column-gap:3.4em;
}
/* This is the wrapper for each item in a placelist. */
.rrpmi-item { break-inside:avoid;
	overflow:hidden;
}
/* This class is for the pin or number that is listed next to a placename. The width is
   designed to accommodate pins or list item numbers. The pin is actually a background image.*/
.rrpmi-num {float:left;
	width:2.2em;
	text-align:right;
	background-repeat:no-repeat;
	break-inside:avoid;
}
/* When a placename in a place list has a pin, a spacer gif image is placed in the floating div
   where the pin is a background image.  The spacer gif dimensions cut off part of the tip of
   the pin to avoid excessive whitespace between placename. */
.rrpmi-num img {width:20px; height:20px;}
}
/* The placenames are put in divs with the rrpmi-name class. */
.rrpmi-name {float:left;
	font-weight:bold;
	margin-left:2.2em;
	break-inside:avoid;
}
/* When a placename in a place list has a pin, this class makes sure that the placename div is
   tall enough to accommodate the truncated pin in the div with class=rrpmi-num. */
.rrpmi-pin { min-height:25px;
}

[[Hide the styles]

Revision History

Mod Version	TNG Version	Date	Note
v14.0.0.5j	14	28Jan2023	No functional changes. Upgraded to TNGv14
v13.1.0.5h	13.1	28Oct2021	Small changes to to accommodate small syntactic changes in TNGv13.1
v13.0.0.5g	13.0-13.0.1	04Dec2020	Handled a change in the TNG "Patch for v13.0.1". The mod covers TNGv13.0 and TNGv13.0.1 with and without the patch, and is projected to cover TNGv13.0.2.
v13.0.0.5f	13.0-13.0.1	28Nov2020	Established compatibility with Public Access Control Small tweaks - no longer displays an OpenStreetMaps link below the map and removes a pointless popup. Even smaller tweak - Pays attention to the "Show all pins" TNG system option (from Admin>>Setup>Map Settings)
v13.0.0.5e	13	10Nov2020	The "Show Map" button wasn't working The birth and death places were not being displayed in the event tables.
v13.0.0.5d	13	07Nov2020	Changed target location search strings affected by new isset() or empty() function calls. Changed a very large target location search string that had several v13 code changes that affect map details. The native code now shows the entire placenote, so that code didn't need to be changed.
v12.0.0.5	12.0-12.3	29Mar2020	Fixed a reference to the wrong variable name that sometimes generated an error Upgraded to version 5 of my shared mod includes Added the Wikipedia link next to the Placename in the page heading.
12.0.0.3	12.0-12.0.1+	15Nov2018	Simplified the map popup balloons. Geocodes and notes are no longer in the balloons. When a pin represents multiple Places, all of the Placenames are listed in the popup balloon. Added mod parameters that suppress the abbreviation of Placenames Added a button to "Show full Placenames" or "Show short Placenames" Placenames are no longer links to their own Place Details report. Instead, the standard spyglass serves as the hyperlink to a Place Details report. Individual abbreviated Placenames now Pop-up the full Placename when you mouse over them, and Are changed to the full Placename when you click on them. When Places have notes, a link that says "Notes" is displayed, and the note is displayed when you click on the link. One very large target location replacement has been broken into two locations to accommodate the OpenStreetMap mod.
11.1.1.2a	11.1.1-11.1.2	3Sep2018	Some fixes for v12.0.0.2 were omitted from v11.1.1.2. So v11.1.1.2a just brings my TNv11 version of the mod into sync with my TNGv12 version.
12.0.0.2	12.0+	28Jun2018	No functional design changes, but did fix a problem. That is, the program wasn't always working correctly when deciding whether to automatically display place pins and/or placenames when the number of places below the location exceed a certain number. That logic was reworked substantially. Also made technical changes described in the .cfg file. In particular, I made the mod compatible with new TNGv12 Mod Manager specs.
11.1.1.2	11.1.1 - 11.1.1.2	17Dec2017	Implemented the mod parameter,and made these subtle changes: Fixed the location count, which was out of sync with the pin count Inserted call to insertLinks in place of the call to truncateIt so that the entire Place note can be displayed. The pins in the list of places are implemented as backgrounds.
11.1.0.1	11.1.0 - 11.1.0.1	11May2017	New mod.

Sites using this mod

If you download and install this mod, please add your site to the table below.

URL	User	Note	Mod-Version	TNG-Version	User-language
[http://www.robinrichmond.com/family/placesearch.php?Bradley+County,+Tennessee+USA a A Place Profile on "Robin's Roots" See ]	Mod developer	v14.0.0.5j	14	English
The Cole / Tanner Family Tree	David Cole	Public/Private	see here	see here	EN, DE, FR, ES, NL
Hooley Family Links	Rick Hooley	Public/Private	See Here	See Here	EN
Weikops stamtræ	Karsten Weikop	Public/Private	13.0.0.5g	13	DK(Dansk)
Vitter-Weaver Genealogy	Jeffrey Vitter	Public site	13.0.0.5g	13.0.3	EN, FR, CH, DE, ES, IT, NO
Huygens - Van de Moortel	Tom Huygens	Public/Private on WordPress	13.1.0.5h	13.1.2	NL