Difference between revisions of "Cemetery Headstones"

From TNG_Wiki
Jump to navigation Jump to search
(case)
 
(32 intermediate revisions by 10 users not shown)
Line 1: Line 1:
 
{{TNGmod
 
{{TNGmod
| mod_name        =  Headstones Report
+
| mod_name        =  Cemetery Headstones
|  mod_summary    =  Updates the list of cemeteries in the end-user Cemeteries and Headstones report and in the Cemetery Detailed report.
+
|  mod_summary    =  This mod can hide the Headstones table behind a "Show" button or display it along with a "Hide" button. In headstones.php it adds burial counts to each cemetery in the list.
 
| mod_validation  =  
 
| mod_validation  =  
| mod_last_update = 21 Dec 2017
+
| mod_last_update = 13 Mar 2023
| download_link  = [[Media:headstones_report_v11.0.0.2.zip|v11.0.0.2]]{{Tv110}}  
+
| download_link  = [[Media:Cemetery_headstones_v14.0.0.6e.zip|v14.0.0.6e]]{{Tv140}}
 +
<div style='clear:both;'>See the [[#Revision_History|Revision History]] for older versions</div>
 
| download_stats  =
 
| download_stats  =
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
Line 10: Line 11:
 
| mod_contact    = [http://www.robinrichmond.com/family/mod_support.php My Mod Support form]
 
| mod_contact    = [http://www.robinrichmond.com/family/mod_support.php My Mod Support form]
 
| mod_support    = [http://www.robinrichmond.com/family/mod_support.php My Mod Support form] or [http://tng.community/ TNG Community Forums]
 
| mod_support    = [http://www.robinrichmond.com/family/mod_support.php My Mod Support form] or [http://tng.community/ TNG Community Forums]
| mod_version    = v11.0.0.2
+
| mod_version    = 14.0.0.6e
 
| min_TNG_ver    = 11.0
 
| min_TNG_ver    = 11.0
| max_TNG_ver    = at least 11.1.2
+
| max_TNG_ver    =  
|  TNG_file_list  = headstones.php, showmap.php, cust_text.php English, Dutch, & Norwegian
+
|  TNG_file_list  = headstones.php, showmap.php, admin_genconfig.php, admin_updateconfig.php
| related_mods  = [[Show Mod Names]]
+
 
 +
| related_mods  = [[Mod Settings Blocks]]('''required'''), [[Inner Mod Menus]], [[Cemetery Burials Table]], [[Cemetery Map and Images]]
 
| notes    =   
 
| notes    =   
 
}}
 
}}
 
== Purpose of the Mod ==
 
== Purpose of the Mod ==
This mod
+
To reduce clutter in headstones.php and showmap.php, and improve the cemetery navigation in showmap.php.
# Adds a tree column (when appropriate) to the Headstone Photos tables in headstones.php and showmap.php,
+
In headstones.php (which is a cemeteries navigation page that kind of peripherally shows headstones)
# Can hide the Headstone Photos table from either or both programs, and
+
* In the list of cemeteries within the selected location,
# In the list of Cemeteries in headstones.php, it
+
*# The selected location, which is a is a common suffix in all cemeteries, is removed for display.
#* Adds the number of burials in the cemetery, and
+
*#: For instance, in a list of Cemeteries in "Erie County, Ohio, USA":
#* Allows more cemetery names to be displayed on one page.  
+
*#* "Hope Cemetery, Erie County, Ohio, USA" becomes "Hope Cemetery" and
 +
*#* "Old Harbor Burial Ground, Clinton, Erie County, Ohio, USA" becomes "Old Harbor Burial Ground, Clinton"
 +
*# A heading shows the selected location.
 +
*# A button can cause the page to display ''all'' cemeteries within the location.
 +
*# The list includes number of burials in each cemetery,
 +
*# When the headstone tables and the corresponding "Show nnn Headstones" buttons are both suppressed, the list still includes the number of headstones tied to each cemetery.
 +
*# A mod option controls how many cemeteries will normally be listed on a page before the list breaks to another pagefull.
 +
*# More subtly, ''Headstone Photos'' are now defined the same way as they are in showmap.php.  In a native code, a Headstone Photos table in headstones.php can have different contents from the corresponding table in showmap.php.
 +
* A "Select Another Location" button that links back to cemeteries.php has been added at the bottom of the page.
 +
* The "a to b of c items" message for Cemeteries and Headstones is repositioned so that the screen layout is more like most other TNG programs that list search results.
 
{| style="margin-right:0.5 em;" align="right"  
 
{| style="margin-right:0.5 em;" align="right"  
 
| __TOC__
 
| __TOC__
 
|}
 
|}
More specifically:
+
In showmap.php (the similarly oddly-named page that is effectively the "Cemetery Profile" page)
 
+
# As in headstones.php, a (different) mod option controls the visibility of the cemetery's Headstones table and of a "Show nnn Headstones" or "Hide Headstones" button.
Both programs typically are invoked through a Cemetery Search screen that does not specify a tree, and can thus display results from more than one tree.  But the Headstone Photos tables in both programs omit any mention of the Tree that a person and photo belong to.  The mod adds a tree column, if the database has more than one tree and no tree has been selected.
+
In both headstones.php and showmap.php
 
+
# Separate mod options control the visibility of each cemetery's Headstones table and of a "Show nnn Headstones" or "Hide Headstones" button.
Identical Headstone Photos tables are presented by both headstones.php and showmap.php, even though the end-user Cemetery search process runs headstones.php links directly to showmap.php.  That is, the end-user Cemetery search process starts with:
+
# The Headstones table adds a "Tree" column when a tree has not been selected.
# cemeteries.php, which
 
#* Lets the user ''select'' a location (so really, it's not a "search" at all), and links
 
# headstones.php, which
 
#* Displays a paginated list of cemeteries, with only 5 cemeteries per page, because it
 
#* Displays the cemetery's Headstones Photos table ''within'' the list of cemeteries.
 
#* And then it lets the user select a cemetery, at which point, it calls
 
# showmap.php, which
 
#* Displays a map,
 
#* Displays the Headstone Photos table for that cemetery (again), and
 
#* Displays the All Burials table for that cemetery.
 
(FWIW, showmap.php can also be called directly from the admin Cemetery search process, and from other places in TNG where a Cemetery is listed.)
 
  
Also, the native TNG code displays the headings for the Headstone Photos table for each cemetery, even if that cemetery does not have any headstone photos.
+
'''More specifically:'''
 +
Both programs typically are invoked through a Cemetery Search screen that does not specify a tree, and can thus display results from more than one tree.  But the Headstone Photos tables in both headstones.php and showmap.php omit any mention of the Tree that a person and photo belong to.  This mod adds a tree column, if the database has more than one tree and no tree has been selected.
  
And, on TNG sites that do not track Headstone photos (or at least do not track many of them), the redundant display of the Headstone Photos table is even more problematic.
+
Both headstones.php and showmap.php display the headings for the Headstone Photos table for each cemetery, even if that cemetery does not have any headstone photos. That produces a lot of useless text on TNG sites that do not track Headstone photos (or at least do not track many of them)
  
 
So, this mod  
 
So, this mod  
*# Does not display the Headstone Photos table headings unless a cemetery actually has headstone photos,
+
* Does not display the Headstone Photos table headings unless a cemetery actually has headstone photos,
*# Offers a mod parameter for headstones.php that controls whether (and how) to display the Headstone Photos table,
+
* Offers a mod parameter for headstones.php that controls whether (and how) to display the Headstone Photos table,
*# Offers a mod parameter for showmap.php that controls whether (and how) to display the Headstones Photos table, and
+
* Offers a mod parameter for showmap.php that controls whether (and how) to display the Headstones Photos table, and
*# Offers a mod parameter for headstones.php that controls how many cemeteries are to be displayed on one page (assuming that, if a site does have many headstone photos, the headstone photos tables don't take up much space, and it can display more than 5 cemeteries per page).
+
* Offers a mod parameter for headstones.php that controls how many cemeteries are to be displayed on one page (assuming that, if a site does have many headstone photos, the headstone photos tables don't take up much space, and it can display more than the native 5 cemeteries per page).
  
In addition, this mod repositions the "a to b of c items" message for both Cemeteries and Headstones so that the screen layout is more like most other TNG programs that display such a message.
+
=== Headstone Count Discrepancy ===
 +
In the native TNG, there can be a discrepancy between the number of headstones reported by headstones.php versus showmap.php. It turns out that headstones.php ignores the "Link directly to this cemetery" flag in the Media record, and thus counts media items that are marked with that flag as Headstones. On the other hand, showmap.php displays media items that are marked with the flag as "Cemetery Photos"
  
==Mod Parameters==
+
==Mod Options==
* In headstones.php - $headstonesButtonControl provides options that let you
+
These mod options are custom TNG settings, defined and edited in a [[Mod Settings Blocks|Mod Settings Block]] in the form at Admin>>Setup>>General&nbsp;Settings, in a new subform named '''Mod&nbsp;Settings&nbsp;Blocks'''. The options and their effects are described here, and shown in the visualizations.
 +
* Two options, one for headstones.php, and one for showmap.php, control the display of the headstones table. The possible settings for these two options are:
 
*# Never display the headstones table.
 
*# Never display the headstones table.
 
*# Hide it behind a button.
 
*# Hide it behind a button.
 
*# Show it, with a button that would hide it.
 
*# Show it, with a button that would hide it.
 
*# Always show it, without a button
 
*# Always show it, without a button
 +
* A third option controls how many cemeteries will be listed on one page in headstones.php before the list of cemeteries breaks onto a subsequent page. The "pristine" TNG code only provides for 5 cemeteries, but that value is driven by the likelihood that each cemetery will include headstone listings. If you don't track (or don't display) headstone records, then you can raise that value considerably.
  
* Also in headstones.php - $cemeteriesPerPage determines how many cemeteries will be listed on one screen (one web page). The "pristine" TNG code only provides for 5 cemeteries, but that value is driven by the likelihood that each cemetery will include headstone listings. If you don't track (or don't display) headstone records, then you can raise that value considerably.
+
== Mod Conflicts ==
 
+
No known incompatibilities, but please let me know if you encounter any.
# In showmap.php - $headstonesTableParam does the same thing for showmap.php that the $headstonesButtonControl parameter does for headstones.php.
 
 
 
== Compatibility with other Mods ==
 
No known incompatibilities, but ''please'' let me know if you encounter any.
 
  
 
== Related Mods ==
 
== Related Mods ==
# The [[Burials-More Details]] mod makes several changes to the All Burials table in showmods.php, and, in a sense, coordinates with this mod, but they are not at all dependent on each other.
+
<ol>
* This mod saves data that can be used by the [[Show Mod Names]] utility mod, but is ''not dependent on'' that mod.
+
<li>[[Cemetery Burials Table]] makes several changes to the All Burials table in showmap.php, and, in a sense, coordinates with this mod, but they are not at all dependent on each other.
 +
<li>[[Cemetery Map and Images]] changes aspect of the Cemetery Photos table in showmap.php.  That table is tied into the discrepancy between the Headstone Photo tables in headstones.php vs. showmap.php. That discrepancy is cleared up by [[Cemetery Headstones]]
 +
<li>{{RobinBoilerplate | text=msb}}</li>
 +
</ol>
  
 
==Installation==
 
==Installation==
===Requirements===
+
=== Files Installed ===
* A working TNG installation.
+
{{RobinBoilerplate | text=language0}}
* An installed current version of the [[Mod Manager]].
+
{{RobinBoilerplate | text=v12shared}}
* You should backup files listed in the panel on the right.
+
{{RobinBoilerplate | text=install}}
 
 
===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, and 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_-_Installing_Config_Files#Remove_Mod_Steps|Mod Manager Remove]] capability
 
# Contact me through [http://www.robinrichmond.com/family/mod_support.php My Mod Support form].
 
  
 
== Visualizations ==
 
== Visualizations ==
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
+
{| class="wikitable" border="1" cellspacing="1" cellpadding="2"
 
|-
 
|-
| '''<span style='color:red;'>BEFORE:</span> The list of Cemeteries and Headstone Photos table in headstones.php'''<br>
+
| '''<span style='color:red;'>Before Installation:</span> The list of Cemeteries and Headstone Photos table in headstones.php'''<br>In mod v5, the selected placename "Bradley County, Tennessee, USA" has been added as a heading to the cemetery list (below the map), and has been removed from all of the cemeteries.
 
[[Image:headstones_report-before1.jpg]]
 
[[Image:headstones_report-before1.jpg]]
 
|-  
 
|-  
| '''<span style='color:red;'>BEFORE:</span> The Headstone Photos table in showmap.php'''<br>
+
| '''<span style='color:red;'>Before Installation:</span> The Headstone Photos table in showmap.php'''<br>
 
[[Image:headstones_report-before2-showmap.jpg]]
 
[[Image:headstones_report-before2-showmap.jpg]]
 
|-
 
|-
| '''<span style='color:red;'>AFTER:</span> The list of Cemeteries and Headstone Photos tables in headstones.php'''<br>
+
| '''<span style='color:red;'>After Installation:</span> The list of Cemeteries and Headstone Photos tables in headstones.php'''<br>
[[Image:headstones_report-after1.jpg]]
+
[[Image:headstones_report-after1-1.jpg]]
 +
Then, when the "Show 4 Headstones" is clicked, the Headstones Photos table is displayed.
 +
[[Image:headstones_report-after1-2.jpg]]
 
|-
 
|-
| '''<span style='color:red;'>AFTER:</span> The Headstone Photos table in showmap.php'''<br>
+
| '''<span style='color:red;'>After Installation:</span> The Headstone Photos table in showmap.php'''<br>
 
[[Image:headstones_report-after2-showmap.jpg]]
 
[[Image:headstones_report-after2-showmap.jpg]]
  
== Mod Change History ==
+
== Revision History ==
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 +
! Mod Version !! TNG Version !! Date !! Note
 +
|-
 +
|14.0.0.6e
 +
|14
 +
|21Nov2023
 +
|Update from 14.0.0.6d to 14.0.0.6e
 
|-
 
|-
! Mod Version
+
|14.0.0.6d
! TNG Versions
+
|{{RobinBoilerplate| text=rrch}}
! Date
+
|13Mar2023
! Note
+
|Upgrade to TNGv14
|-  
+
|- style="vertical-align:top;" <!-- ############################################################## -->| }
 +
|[[Media:Headstones report v13.0.0.6a.zip|Headstones Report v13.0.0.6a]]
 +
| 13.0.4
 +
| 9Jun2021
 +
| No functional changes, Changed the target location for the default # of cemeteries per page, which TNGv13.0.4 changes from 5 to 100.
 +
 
 +
|- style="vertical-align:top;" <!-- ############################################################## -->| }
 +
|[[Media:Headstones report v13.0.0.6a.zip|Headstones Report v13.0.0.6a]]
 +
| 13.0-13.0.3
 +
| 30Mar2021
 +
| No underlying TNGv13 code changes.<br>Changed the list of cemeteries in headstones.php. Because all of the cemeteries in the list are ''within'' a selected location, that selected location's value is part of every cemetery's location. This version moves the selected location to a heading and removes it from each cemetery.
 +
 
 +
|- style="vertical-align:top;" <!-- ############################################################## -->| }
 +
|[[Media:Cemetery headstones v13.0.0.6.zip|Cemetery Headstones v13.0.0.6]]
 +
| 13.0
 +
| 24Feb2021
 +
|<!-- Double Toggle --><div class="mw-collapsible mw-collapsible-content mw-customtoggle-v6a mw-customtoggle-v6b" style="text-decoration:underline;color:#0645ad;">&#91;Show Details&#93;</div>
 +
<div class="mw-collapsible mw-collapsible-content mw-collapsed" style="border:thin solid grey">
 +
* Renamed to be consistent with other Cemetery mods (and because "Headstones Report" didn't really mean anything).
 +
* In Headstones.php
 +
*# The selected location is shown as a heading for the list of cemeteries.
 +
*# The selection location is removed from each Cemetery location.
 +
*# The "Sorted By" statement in the header and footer of the cemetery list just says "Sorted by Location" instead of "Sorted by{location components}"
 +
*# The Headstones table in headstones.php is now the same as the one in showmap.php.
 +
*#* In the native code, the Headstones table in headstones.php included some Cemetery Photos.
 +
*#* The headstones counts in the show/hide buttons in headstones.php reflect the new content of the Headstones table.
 +
*# The Inner Mod Menu "what changed" text is different from that in showmap.php.
 +
*# In the cemetery list in headstones.php, states the selected location in a header and footer, and removes the selected location from each cemetery location, since the selected location is a suffix of all cemeteries in the list.
 +
*# Added a "Select Another Location" button to the bottom of headstones.php.
 +
* In showmap.php
 +
*# The Cemetery Images table and Headstones table in showmap.php have been reverted their original contents, where any media item flagged with the "Link this media directly to the selected cemetery" flag is in the Cemetery Images table.
 +
*# The Inner Mod Menu "what changed" text is different from that in headstones.php.
 +
<div style="text-decoration:underline;text-align:right;color:#0645ad;" class="mw-customtoggle-v6a mw-customtoggle-v6b">&#91;Hide Details&#93;</div>
 +
</div><!-- END OF DOUBLE TOGGLE -->
 +
 
 +
|- style="vertical-align:top;" <!-- ############################################################## -->| }
 +
|[[Media:Headstones report v13.0.0.5.zip|Headstones Report v13.0.0.5]]
 +
| 13.0-13.0.3
 +
| 24Oct2020
 +
| No changes in functionality.
 +
* Bug fix - Showmap was always operating in the mod where the table is hidden behind a button.
 +
* Cosmetic improvements to the display of the show and hide buttons in showmap.php, and to the options in admin_genconfig.php.
 +
 
 +
|- style="vertical-align:top;" <!-- ############################################################## -->| }
 +
|[[Media:Headstones report v12.0.0.4.zip|Headstones Report v12.0.0.4]]
 +
| 12.0 - 12.3
 +
| 26Jul2020
 +
|
 +
# Renamed the mod options. It may be necessary for admins to redefine the option values after installing the mod.
 +
# Fixed funky behavior of the cemetery link column heading of the headstons table in showmap.php
 +
# Fixed the assignent of a minimum width to the Headstones table link column.
 +
# Redefined the relationship between Cemetery Photos and Headstone Photos so that headstones that are linked directly to the cemtery AND have medialinks are treated as Headstone Photos, not Cemetery Photos. As a result, their status and medialinks are displayed.
 +
# Suppressed Headstone Photo medialinks that duplicate the previous medialink. This occurs if a headstone image is linked to a person AND to an event for that person.
 +
* Internal/Technical
 +
*# Defined Inner Mod Menus in both headstones.php and showmap.php
 +
*# Moved language strings to the mod subfolder.
 +
 
 +
|- style="vertical-align:top;" <!-- ############################################################## -->| }
 +
|[[Media:Headstones report v12.0.0.3.zip|12.0.0.3]]
 +
| 12.0 - 12.2+
 +
| 2Oct2019
 +
| The mod parameters are now implemented through a '''[https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Mod&nbsp;Settings&nbsp;Block]''' that can be accessed through the Edit Options button in Mod Manager as well as atAdmin>>Setup>>General&nbsp;Settings>Robin's&nbsp;Mods
 +
 
 +
|- style="vertical-align:top;" <!-- ############################################################## -->|
 +
|[[Media:Headstones report v12.0.0.2.zip|12.0.0.2]]
 +
| 12.0+
 +
| 15May2018
 +
|
 +
No functional changes; made compatible with TNGv12.
 +
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 11.0.0.2
 
| 11.0.0.2
 
| 11.0-11.1.2+
 
| 11.0-11.1.2+
| 21 Dec 2017
+
| 21Dec2017
 
| Added the tree information to the Headstones table in both programs, and removed the 100% width from the table in showmap.php. Other technical changes.
 
| Added the tree information to the Headstones table in both programs, and removed the 100% width from the table in showmap.php. Other technical changes.
|-  
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 11.0.0.1
 
| 11.0.0.1
 
| 11.0-11.1+
 
| 11.0-11.1+
| 2 Apr 2017
+
| 2Apr2017
 
| New mod.
 
| New mod.
 
|}
 
|}
Line 128: Line 198:
  
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
|-
+
! URL !! User !! Note !! Mod-Version !! TNG-Version !! User-language
! URL
 
! User
 
! Note
 
! Mod-Version
 
! TNG-Version
 
! User-language
 
 
|-
 
|-
 
| [http://www.robinrichmond.com/family/ Robin Richmond's Genealogy Database]
 
| [http://www.robinrichmond.com/family/ Robin Richmond's Genealogy Database]
 
| [[User:Robinrichm|Robin Richmond]]
 
| [[User:Robinrichm|Robin Richmond]]
 
| Mod developer
 
| Mod developer
| v11.0.0.1
+
| v14.0.0.6e
| 11.1.
+
|{{RobinBoilerplate| text=rrch}}
 
| English
 
| English
 
|-
 
|-
 
| [http://www.kks-fam.net/ KK's Family History]
 
| [http://www.kks-fam.net/ KK's Family History]
 
| [[User:Kin_Khronicler|Kathy Kult]]
 
| [[User:Kin_Khronicler|Kathy Kult]]
|  
+
| Public/Private
| v11.0.0.1
+
| v14.0.0.6d
| 11.1.1
+
| {{Tv1402}}
 +
| EN
 +
|-
 +
| [https://SmeeFamily.com/ Pete's Research]
 +
| [[User:TBirdUK|Pete Smee]]
 +
| Private
 +
| v13.0.0.6a
 +
| 13.0.1
 
| English
 
| English
}
+
|-
 
+
|[https://www.leslauzon.com Lauzon families]
 +
|[https://tng.lythgoes.net/wiki/index.php/User:Jean-Luc_Lauzon Jean-Luc Lauzon]
 +
|public
 +
|V13.0.0.6b
 +
|13.1.1
 +
|EN FR
 +
|-
 +
| [https://www.josephoranholtz.com/ Joseph Oran Holtz Genealogy Pages]
 +
| [[User:Stores|Jim Holt]]
 +
| Private
 +
| [[User:Stores|See Here]]
 +
| [[User:Stores|See Here]]
 +
| EN
 +
|-
 +
|[https://tng.adler-wien.eu ADLER-Wien]
 +
|[[User:Stores|Herbert Fischer]]
 +
|Private site
 +
|13.0.4.6b
 +
|14.0
 +
|DE
 +
|-
 +
| [https://ahnenklein.com/ Auf den Spuren meiner Ahnen]
 +
| style="white-space: nowrap;"|[[User:Maikl11|Michael Klein]]
 +
| Public/Private site
 +
| 14​.0​.0​.6d
 +
| {{Tv1403}}
 +
| EN, DE
 +
|}
 +
[[Category:Mods for TNG v14]]
 +
[[Category:Mods for TNG v13]]
 +
[[Category:Mods for TNG v12]]
 
[[Category:Mods for TNG v11]]
 
[[Category:Mods for TNG v11]]
 
[[Category:headstones.php mods]]
 
[[Category:headstones.php mods]]
 
[[Category:showmap.php mods]]
 
[[Category:showmap.php mods]]
[[Category:cust_text.php English mods]]
+
[[Category:admin_genconfig.php mods]]
 +
[[Category:admin_updateconfig.php mods]]
 +
|}

Latest revision as of 19:20, 21 November 2023

Cemetery Headstones
Summary This mod can hide the Headstones table behind a "Show" button or display it along with a "Hide" button. In headstones.php it adds burial counts to each cemetery in the list.
Validation
Mod Updated 13 Mar 2023
Download link v14.0.0.6e
TNG 14.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 or TNG Community Forums
Contact Developer My Mod Support form
Latest Mod 14.0.0.6e
Min TNG V 11.0
Max TNG V
Files modified
headstones.php, showmap.php, admin_genconfig.php, admin_updateconfig.php
Related Mods
Notes


Purpose of the Mod

To reduce clutter in headstones.php and showmap.php, and improve the cemetery navigation in showmap.php. In headstones.php (which is a cemeteries navigation page that kind of peripherally shows headstones)

  • In the list of cemeteries within the selected location,
    1. The selected location, which is a is a common suffix in all cemeteries, is removed for display.
      For instance, in a list of Cemeteries in "Erie County, Ohio, USA":
      • "Hope Cemetery, Erie County, Ohio, USA" becomes "Hope Cemetery" and
      • "Old Harbor Burial Ground, Clinton, Erie County, Ohio, USA" becomes "Old Harbor Burial Ground, Clinton"
    2. A heading shows the selected location.
    3. A button can cause the page to display all cemeteries within the location.
    4. The list includes number of burials in each cemetery,
    5. When the headstone tables and the corresponding "Show nnn Headstones" buttons are both suppressed, the list still includes the number of headstones tied to each cemetery.
    6. A mod option controls how many cemeteries will normally be listed on a page before the list breaks to another pagefull.
    7. More subtly, Headstone Photos are now defined the same way as they are in showmap.php. In a native code, a Headstone Photos table in headstones.php can have different contents from the corresponding table in showmap.php.
  • A "Select Another Location" button that links back to cemeteries.php has been added at the bottom of the page.
  • The "a to b of c items" message for Cemeteries and Headstones is repositioned so that the screen layout is more like most other TNG programs that list search results.

In showmap.php (the similarly oddly-named page that is effectively the "Cemetery Profile" page)

  1. As in headstones.php, a (different) mod option controls the visibility of the cemetery's Headstones table and of a "Show nnn Headstones" or "Hide Headstones" button.

In both headstones.php and showmap.php

  1. Separate mod options control the visibility of each cemetery's Headstones table and of a "Show nnn Headstones" or "Hide Headstones" button.
  2. The Headstones table adds a "Tree" column when a tree has not been selected.

More specifically: Both programs typically are invoked through a Cemetery Search screen that does not specify a tree, and can thus display results from more than one tree. But the Headstone Photos tables in both headstones.php and showmap.php omit any mention of the Tree that a person and photo belong to. This mod adds a tree column, if the database has more than one tree and no tree has been selected.

Both headstones.php and showmap.php display the headings for the Headstone Photos table for each cemetery, even if that cemetery does not have any headstone photos. That produces a lot of useless text on TNG sites that do not track Headstone photos (or at least do not track many of them)

So, this mod

  • Does not display the Headstone Photos table headings unless a cemetery actually has headstone photos,
  • Offers a mod parameter for headstones.php that controls whether (and how) to display the Headstone Photos table,
  • Offers a mod parameter for showmap.php that controls whether (and how) to display the Headstones Photos table, and
  • Offers a mod parameter for headstones.php that controls how many cemeteries are to be displayed on one page (assuming that, if a site does have many headstone photos, the headstone photos tables don't take up much space, and it can display more than the native 5 cemeteries per page).

Headstone Count Discrepancy

In the native TNG, there can be a discrepancy between the number of headstones reported by headstones.php versus showmap.php. It turns out that headstones.php ignores the "Link directly to this cemetery" flag in the Media record, and thus counts media items that are marked with that flag as Headstones. On the other hand, showmap.php displays media items that are marked with the flag as "Cemetery Photos"

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. The options and their effects are described here, and shown in the visualizations.

  • Two options, one for headstones.php, and one for showmap.php, control the display of the headstones table. The possible settings for these two options are:
    1. Never display the headstones table.
    2. Hide it behind a button.
    3. Show it, with a button that would hide it.
    4. Always show it, without a button
  • A third option controls how many cemeteries will be listed on one page in headstones.php before the list of cemeteries breaks onto a subsequent page. The "pristine" TNG code only provides for 5 cemeteries, but that value is driven by the likelihood that each cemetery will include headstone listings. If you don't track (or don't display) headstone records, then you can raise that value considerably.

Mod Conflicts

No known incompatibilities, but please let me know if you encounter any.

Related Mods

  1. Cemetery Burials Table makes several changes to the All Burials table in showmap.php, and, in a sense, coordinates with this mod, but they are not at all dependent on each other.
  2. Cemetery Map and Images changes aspect of the Cemetery Photos table in showmap.php. That table is tied into the discrepancy between the Headstone Photo tables in headstones.php vs. showmap.php. That discrepancy is cleared up by Cemetery Headstones
  3. 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.

Installation

Files Installed

This mod includes a typical mod subfolder, with the same base name as the mod's .cfg file. The subfolder is atypical in that no files in it are installed to working TNG folders. However, it does contain critical files that contain the mod's language strings, which the mod does not add to standard cust_text.php files. Instead, the PHP code modified by this mod loads the language strings from files in the mod's languages/ subfolder. Read more about this technique.


[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

Before Installation: The list of Cemeteries and Headstone Photos table in headstones.php
In mod v5, the selected placename "Bradley County, Tennessee, USA" has been added as a heading to the cemetery list (below the map), and has been removed from all of the cemeteries.

Headstones report-before1.jpg

Before Installation: The Headstone Photos table in showmap.php

Headstones report-before2-showmap.jpg

After Installation: The list of Cemeteries and Headstone Photos tables in headstones.php

Headstones report-after1-1.jpg Then, when the "Show 4 Headstones" is clicked, the Headstones Photos table is displayed. Headstones report-after1-2.jpg

After Installation: The Headstone Photos table in showmap.php

Headstones report-after2-showmap.jpg

Revision History

Mod Version TNG Version Date Note
14.0.0.6e 14 21Nov2023 Update from 14.0.0.6d to 14.0.0.6e
14.0.0.6d

14.0

13Mar2023 Upgrade to TNGv14
Headstones Report v13.0.0.6a 13.0.4 9Jun2021 No functional changes, Changed the target location for the default # of cemeteries per page, which TNGv13.0.4 changes from 5 to 100.
Headstones Report v13.0.0.6a 13.0-13.0.3 30Mar2021 No underlying TNGv13 code changes.
Changed the list of cemeteries in headstones.php. Because all of the cemeteries in the list are within a selected location, that selected location's value is part of every cemetery's location. This version moves the selected location to a heading and removes it from each cemetery.
Cemetery Headstones v13.0.0.6 13.0 24Feb2021
[Show Details]
  • Renamed to be consistent with other Cemetery mods (and because "Headstones Report" didn't really mean anything).
  • In Headstones.php
    1. The selected location is shown as a heading for the list of cemeteries.
    2. The selection location is removed from each Cemetery location.
    3. The "Sorted By" statement in the header and footer of the cemetery list just says "Sorted by Location" instead of "Sorted by{location components}"
    4. The Headstones table in headstones.php is now the same as the one in showmap.php.
      • In the native code, the Headstones table in headstones.php included some Cemetery Photos.
      • The headstones counts in the show/hide buttons in headstones.php reflect the new content of the Headstones table.
    5. The Inner Mod Menu "what changed" text is different from that in showmap.php.
    6. In the cemetery list in headstones.php, states the selected location in a header and footer, and removes the selected location from each cemetery location, since the selected location is a suffix of all cemeteries in the list.
    7. Added a "Select Another Location" button to the bottom of headstones.php.
  • In showmap.php
    1. The Cemetery Images table and Headstones table in showmap.php have been reverted their original contents, where any media item flagged with the "Link this media directly to the selected cemetery" flag is in the Cemetery Images table.
    2. The Inner Mod Menu "what changed" text is different from that in headstones.php.
[Hide Details]
Headstones Report v13.0.0.5 13.0-13.0.3 24Oct2020 No changes in functionality.
  • Bug fix - Showmap was always operating in the mod where the table is hidden behind a button.
  • Cosmetic improvements to the display of the show and hide buttons in showmap.php, and to the options in admin_genconfig.php.
Headstones Report v12.0.0.4 12.0 - 12.3 26Jul2020
  1. Renamed the mod options. It may be necessary for admins to redefine the option values after installing the mod.
  2. Fixed funky behavior of the cemetery link column heading of the headstons table in showmap.php
  3. Fixed the assignent of a minimum width to the Headstones table link column.
  4. Redefined the relationship between Cemetery Photos and Headstone Photos so that headstones that are linked directly to the cemtery AND have medialinks are treated as Headstone Photos, not Cemetery Photos. As a result, their status and medialinks are displayed.
  5. Suppressed Headstone Photo medialinks that duplicate the previous medialink. This occurs if a headstone image is linked to a person AND to an event for that person.
  • Internal/Technical
    1. Defined Inner Mod Menus in both headstones.php and showmap.php
    2. Moved language strings to the mod subfolder.
12.0.0.3 12.0 - 12.2+ 2Oct2019 The mod parameters are now implemented through a Mod Settings Block that can be accessed through the Edit Options button in Mod Manager as well as atAdmin>>Setup>>General Settings>Robin's Mods
12.0.0.2 12.0+ 15May2018

No functional changes; made compatible with TNGv12.

11.0.0.2 11.0-11.1.2+ 21Dec2017 Added the tree information to the Headstones table in both programs, and removed the 100% width from the table in showmap.php. Other technical changes.
11.0.0.1 11.0-11.1+ 2Apr2017 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
Robin Richmond's Genealogy Database Robin Richmond Mod developer v14.0.0.6e

14.0

English
KK's Family History Kathy Kult Public/Private v14.0.0.6d
TNG 14.0.2
EN
Pete's Research Pete Smee Private v13.0.0.6a 13.0.1 English
Lauzon families Jean-Luc Lauzon public V13.0.0.6b 13.1.1 EN FR
Joseph Oran Holtz Genealogy Pages Jim Holt Private See Here See Here EN
ADLER-Wien Herbert Fischer Private site 13.0.4.6b 14.0 DE
Auf den Spuren meiner Ahnen Michael Klein Public/Private site 14​.0​.0​.6d
TNG 14.0.3
EN, DE