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
v13.1.0.5h
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 | |||
| 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
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.
Abbreviated Placenames
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,
- The report will display a button that causes the full placenames to be displayed, and
- 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
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)
- 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.
- 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)
- 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.
Event Focus
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.Subordinate Places
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
- Displays all of those subordinate places on the map, and
- 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
- 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.
- 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.
- 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]
- More than one instance of the selected Place may be shown on the map.
Bubbling Up
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.Full Place Note
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.
- 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.)
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..
- 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".
- 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).
- 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.
- Abbreviate Placenames in the Event tables (yes) - This option works exactly like Abbreviate Placenames in the Places List below the map.
- 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:
- 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.
- The View/Test button on each result line at Admin >> Places runs the Place Detail report.
- In the list of places in the Place Detail report, each Placename is a hyperlink to the Place Detail report.
- 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
- 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.
- Notes-Expand WWW Refs affects the Place Notes field by recognizing web addresses that begin with "www." and converting them into hyperlinks.
- 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
{{{language}}}
[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
- Remove and delete previous version of this mod.
- Backup the files updated by this mod. They are listed in the panel at the upper right.
- Download the .zip file, Extract its .cfg file to the mods folder.
- Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files.
Problems?
- Try using the Mod Manager Remove capability
- Contact me through My Mod Support form.
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.
| 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
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
|
|
| After Installation: 3. Focusing on an Event
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.
|
|
| 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.
|
|
| 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.)
|
|
| After Installation: 7. The Placesearch-More Info options in a Mod Settings Block
msbviz1
msbgenconfigboth
|
|
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;
}
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 |
|
| v13.0.0.5e | 13 | 10Nov2020 |
|
| v13.0.0.5d | 13 | 07Nov2020 |
|
| v12.0.0.5 | 12.0-12.3 | 29Mar2020 |
|
| 12.0.0.3 | 12.0-12.0.1+ | 15Nov2018 |
|
| 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.
|
| 11.1.1.2 | 11.1.1 - 11.1.1.2 | 17Dec2017 | Implemented the mod parameter,and made these subtle changes:
|
| 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 TNG 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 |
