Cemetery Headstones
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
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,
- 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"
- 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.
- The selected location, which is a is a common suffix in all cemeteries, is removed for display.
- 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)
- 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
- Separate mod options control the visibility of each cemetery's Headstones table and of a "Show nnn Headstones" or "Hide Headstones" button.
- 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:
- Never display the headstones table.
- Hide it behind a button.
- Show it, with a button that would hide it.
- 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
- 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.
- 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
- 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
- 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
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. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Before Installation: The Headstone Photos table in showmap.php | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
After Installation: The list of Cemeteries and Headstone Photos tables in headstones.php Then, when the "Show 4 Headstones" is clicked, the Headstones Photos table is displayed. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
After Installation: The Headstone Photos table in showmap.phpRevision History
Sites using this modIf you download and install this mod, please add your site to the table below.
|