Cemetery Headstones

Aus TNG_Wiki
(Weitergeleitet von Headstones Report)
Zur Navigation springen Zur Suche springen
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
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

rrch

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

rrch

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