Admin Cemeteries Search
Admin Cemeteries Search (formerly Admin Cemeteries List) | ||
---|---|---|
Summary | Adds numerous controls to the Admin Cemeteries Search page to filter the search and include optional data in the results. | |
Validation | ||
Mod Updated | {{{mod_last_update}}} | |
Download link | v11.0.0.8
| |
Download stats | ||
Author(s) | Robin Richmond | |
Homepage | This page | |
Mod Support | My Mod Support form or TNG Community Forums | |
Contact Developer | My Mod Support form | |
Latest Mod | 11.0.0.8 | |
Min TNG V | 11.0 (probably lower) | |
Max TNG V | at least 11.1.2 | |
Files modified | admin_cemeteries.php, adminlib.php, css/genstyle.css,
English cemetery_help.php, English cust_text.php; Installs css/robinmods.css, ajxcemeteriessearchmod.php, admin_cemeteriessearchmod.php | |
Related Mods | ||
Notes |
Purpose of the Mod
This distinctly large and complex mod adds filtering, searching, and formatting options to the Admin >> Cemeteries >> Search page in order to produce what amounts to a variety of what I hope are useful reports.
Among other things, it
- Uses checkboxes to control whether selected result table columns are displayed,
- Can filter results through hierarchical drop-down location boxes,
- Can filter results according to the number of headstones tied to a cemetery, or the number of burial events at the places associated with the cemetery.
- Sorts the results table in several ways,
- Controls which fields are searched by the search string,
- Reveals which database fields are being searched,
- Has location drop down boxes to allow the search to focus on a specific location
Mod Parameters
- Default value for the country selection box. ("USA")
- A list of fieldnames that set the initial state of checkboxes that determine whether optional fields (maplink, notes) are searched.
- A list of fieldnames that set the initial state of checkboxes that control whether optional data (notes, burials, headstones, geocodes] are displayed in the results table.
- A list of names that determine whether certain controls are shown on the search form at all.
Mod Conflicts
I don't know of any conflicts. This mod and its companion mod Cemetery Edit are the only mods that affect the Admin Cemeteries programs. This mod also affects adminlib.php, but I haven't found any conflicts with the specific location in adminlib.php that it modifies.
Related Mods
- My Cemetery Edit mod is closely related, and I recommend it as a companion to this mod. Still, these two mods are independent of each other. Cemetery Edit modifies the Cemetery Edit screen extensively, whereas this mod focuses on the Admin Cemeteries Search screen (and related programs).
- This mod uses the Field Buttons mod, which displays small controls next to some form fieldss. However, it does not require that Field Buttons be installed. If Field Buttons is not installed, then the buttons simply do not appear.
- This mod generates information that can be used by Show Mod Names, but does not require that Show Mod Names be installed.
Requirements
- A working TNG installation.
- An installed current version of the Mod Manager.
- The only other mod that target admin_cemeteries is my [Cemetery Edit] mod, which can be installed (or not) independently.
Automated Installation
- 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. Upload and Extract to the mods folder.
- Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install.
In the event of a problem
- Try using the Mod Manager Remove capability
- Contact me through My Mod Support form.
Visualizations
BEFORE: An unmodified Admin Cemeteries Search page from TNGv9 - v11. |
And older Version: 9.2.0.5
Newest Version: 11.0.0.8
The search page AFTER installing mod version 8
Legend:
|
Mod version 8 Location Selection Controls |
|
Mod version 8: Special Search String Characters |
The screen clip above focuses on the search string field and its placeholder message that notes that caret, dollar sign, single quote, double quote, and space have special meanings.
|
Mod version 8: Burial Count Controls |
(In this screen clip, the blue numbers continue the numbering of new features from the earlier screen clip with numbers 1-14)
|
AFTER installing mod version 8:Showing the effect of two trees with the same Associated Place |
(The blue numbers continue the numbering of new features)
|
AFTER installing mod version 8: Field Buttons |
In the screen clip above, new feature 18 is the field buttons.
Buttons that would not change the value are shaded out, as shown below.
|
Files Modified
- admin_cemeteries.php - The Admin Cemeteries Search page, which is the target of almost all of the changes
- adminlib.php - The function tng_adminheader has been modified to install robinmods.css into the css folder, if an appropriate copy of robinmods.css is not already there.
- genstyle.css - Style rules that define minimum widths for some result table columns
- cemetery_help.php English - Modified fairly extensively to describe the new search form, to describe the meaning of TNG "Cemeteries" vs Burial Places. The help file also now links to two Wiki articles (including this one).
- admintext.php English - Around 50 new strings
Files Installed
- ajx_admincemeterysearch.php - An AJAX program that reads place jurisdiction values (i.e. a set of states, counties, or cities) that are appropriate for the selection that a user has made in a higher-level jurisdication.
- admincemeterysearch.php - A function library used by admin_cemeteries.php and the AJAX program listed just above. It actually has only one function, which is used by admin_cemeteries.php to populate the location drop-down boxes as the page is loaded, and by AJAX OnChange functions that invoke ajx_admincemeterysearch.php to populate lower-ordered location drop-down boxes when a selection is made in a higher-ordered location drop-down box. (See ajx_admincemeterysearch.php for more details.)
- css/robinmods.css - Style rules used my several of my (Robin Richmond's) mods.
Installing robinmods.css
I have created a scheme to define these style rules only once in each program that I modify, even if that program is modified by several of my mods. With this scheme, I can avoid multiple duplicate style definitions in
- genstyles.css,
- Embedded style sheets (where the rules are hard to override), and/or
- Program-specific CSS files (where the rules are also hard to override),
and each mod that uses the rules doesn't have to depend on a mod that does nothing more than install style rules.
This scheme utilizes the two TNG system functions that generate a <link> tag for genstyle.css in every TNG program:
- tng_adminheader (in adminlib.php) for Admin programs, and
- tng_header (in genlib.php) for end-user programs.
It works like this:
- I keep a central copy of robinmods.css in my mods folder.
- robinmods.css starts with comment that contains a version number that I update when I modify the central robinmods.css.
- If a mod needs any of my common styles, I copy the central version of robinmods.css to the mod's subfolder when I update the mod.
- Mod Manager does not install robinmods.css.
- Each mod that uses robinmods.css modifies either tng_adminheader (in adminlib.php) or tng_header (in genlib.php) to:
- Determine whether robinmods.css exists in the css folder,
- Determine whether the mod's copy of robinmods.css is a newer version than the one in the css folder, and
- Copy robinmods.css from the mod subfolder to the css folder if (and only if) it needs to.
- Place a robinmods.css <link> tag right before the genstyle.css <link> tag,
The result of this scheme is that all programs that need the style rules in robinmods.css use one central copy, and site administrators who want to override any of the rules in robinmods.css can do so in their genstyle.css files.
Styles in robinmods.css
- The .rrnoprinter class that prevents printing on a printer.
- Classes for drop-down divs similar to the Search drop-down that is in the topmenu of most end-user programs
- The .rrinfobutton class that formats little blue circular information buttons.
- and others
Revision History
Mod Version | TNG Version | Date | Note |
---|---|---|---|
Admin Cemeteries List v9.2.0.1 | 9.2.0 - 10.0.0.1 | 08 May 2014 | Initial release. |
Admin Cemeteries List 9.2.0.4 | 9.2.0 - 10.1 | 31 Dec 2014 | Updated for conformance with v10.1; Changed the Geocode column to round the values to 3 decimal places, and eliminate the keywords. |
Admin Cemeteries List 9.2.0.5 download | 9.2.0 - 11.0 | 21 Mar 2016 | Converts new lines to <br> tags in the notes field; Depends on [[Show Mod Names|Show Mod Name v2+]; Tested for TNGv11 |
Admin Cemeteries Search v11.0.0.8 | 11.0 - 11.1.1+ | 5 Sep 2017 | Numerous changes:
The controls are:
|
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 | 11.0.0.8 | 11.1.1 | English |
MOTYER Family Genealogy | John Mark Motyer | Public site | see here | see here | EN, DE, RU |
Total Family History | Scott Bennett | Private Site (For right now) | 9.2.0.1 | TNG 10.0.1 | EN |
Mitchell Families Online | Roger Mitchell | Very useful mod | 9.2.0.1 | 10.0.3 | EN |
The Dutton's of Vermont | Darrin Dutton | 9.2.0.4 | 10.1.0 | EN | |
Brady Family Tree in Western Australia | Darryl Brady | Public site | 9.2.0.4 | 10.1.1 | EN, DE |
R G Strong Family Genealogy | Russell Strong | Public site | 9.2.0.5 | 11.0.1 | EN, DE, FR, NL |
Wortelboer Genealogy | Bernard Wortelboer | Public site | 9.2.0.5 | 11.0.0 | NL, EN |
Brabantse Genealogie | Rob van Rij | Public Site | 9.2.0.5 | 11.0.1 | EN,FR,NL |
Woking Family History | Pete Smee | Secure site | 9.2.0.5 | 11.1 | EN |