Difference between revisions of "Cemetery Edit"

From TNG_Wiki
Jump to navigation Jump to search
(redirects to Admin Cemetery Edit)
 
(32 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{construction
+
#REDIRECT [[Admin Cemetery Edit]]
|notes=I'm finalizing v8 of this mod, so this page and its download file will be broken for a day or two.
 
 
 
Robin Richmond 9 Sep 2017
 
}}
 
{{TNGmod
 
| mod_name        = Cemetery Edit
 
|  mod_summary    = Makes workflow and presentation changes to the Cemetery Edit form and the Admin >> Cemeteries >> Search screen.
 
| mod_validation  =
 
| download_link  = [[Media:cemetery_edit_v10.1.0.8.zip|v10.1.0.8]] {{Tv110}}{{Tv1010}}
 
<br/>See older versions in the [[#Revision_History]]
 
| download_stats  =
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
 
| mod_url        = ''this page''
 
| 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_version    = 10.1.0.8
 
| min_TNG_ver    = 10.1.0
 
| max_TNG_ver    = at least 11.1.1
 
|  TNG_file_list  = admin_editcemetery.php, English cemeteries_help.php, English cust_text.php
 
| related_mods  = My [[Admin Cemeteries Search]] mod
 
| notes    = 
 
}}
 
== Purpose of the Mod ==
 
This mod is intended to improve the workflow of the Cemetery Edit form and clarify some confusion about the form and its fields. It was motivated by trouble I had adding cemeteries, and my inability to recognize
 
* which matching cemetery is most appropriate for use as the associated cemetery, and
 
* whether I need to copy Geocode information from the Cemetery to the Place, from the Place to the Cemetery, or neither.
 
I was also initially confused about the relationship between Cemeteries and Places.
 
{| style="margin-right:0.5 em;" align="right"
 
| __TOC__
 
|}
 
Changes made by the mod include:
 
* It adds a lookup tool that helps the user lookup the Associated Placename. The tool
 
** Displays a list of matching Placenames
 
** Displays each Place's Cemetery name, Location, and Geocode, which can automatically be copied to the Cemetery form,
 
** Displays other potentially useful Place data, including the number of Burial events associated with each matching Placename.
 
* Some form fields can (optionally) be moved above and below the map where I think that they fit better.
 
* It adds annotation to the form, and some help links, including new inner menu entries,
 
* Based on a mod parameter, the Edit page can be sure to open the Google map when the page loads if the Geocode fields do not have values, or the Edit page can hide the Google map as the page loads if the Geocode fields do have values.
 
* It provides 7 mod parameters, as described just below.
 
See a detailed list of changes in the Visualizations below.
 
 
 
== Mod Parameters ==
 
# '''Default country for new cemeteries'''
 
# '''Location of Image Fields in the Cemtery Form''' - The pristine code put the Cemetery Image upload and select fields at the beginning of the form. This parameter allows them to be placed there, or at the end of the form, just above the image itself.
 
# '''Location of Geocode Fields in the Cemtery Form''' - This parameter allows them to be below the map, where the pristine form places them, or above the map, where they are closer to the controls that display Placename geocodes and copy geocodes.
 
# ''Is there a Space in the Placename Delimiter?''' - A flag that determines whether spaces should be added after each comma that separates place components.
 
# ''Do Placenames reveal empty Placeparts?'' - That is, if there is, say, no county in a placename, is it represented in a form such as "Bethel Cemetery, Erie, Ohio, USA" or "Bethel Cemetery, Erie, , Ohio, USA". (The final format, of course, depends on the "Space in Placename" parameter, too.)
 
# '''Place Fields to Copy from the Placename Lookup & Copy pop-up''' - This parameter initializes checkboxes that determine which data elements are copied from the Place record that is selected as the Associated Placename.
 
# '''Count Burials in the Placename Lookup & Copy pop-up''' - The mod normally displays the number of Burial events at each Placename that matches the lookup search, but for some large databases, it may take too long to count burials, so the burial count can be suppressed.
 
The effects of Parameters 1 and 7 can be adjusted on the Cemetery Edit page. All of the others take affect silently, and their affects can only be changed by editing the Mod Parameters.
 
 
== New Inner Menu Links ==
 
# '''Cemetery Report''' - This was labeled 'Test', and launches showmap.php, which displays details about a cemetery, including a list of burials there.
 
# '''Edit Places''' - This launches the Admin >> Places program in a pop-up window, using the Cemetery Name as a search key, so that the user can edit the Place that is intended to be used as the Associated Placename without having to leave the Cemetery Edit screen.
 
# '''Options''' - This link opens a menu that can
 
#* Launch a pop-up window that opens this Wiki article to the Mod Parameters section
 
#* Link directly to the Mod Manager page that edits the Cemetery Edit mod options.s Sometimes, it is not clear which place name should match the cemetery, and sometimes, the presence of multiple matching place names reveals a problem that would be resolved by editing, merging, or just looking more closely at the matching places.  Therefore, as a convenience, a link that opens the place editor in a new window has been added to the edit form. (See the circled hyperlink in the AFTER visualization below.)
 
#* '''Cemetery Edit Mod'' - Opens a pop-up window that displays the Visualization from this article where all of the changes made by the mod are listed.
 
 
 
==Related Mods==
 
My '''[[Admin Cemeteries Search]]''' mod is a companion to '''[[Cemetery Edit]]'''.  It was motivated by essentially the same purposes as this mod, and focuses on the Cemetery Search/Selection page, whereas '''[[Edit Cemetery]]''' focuses on the Cemetery Edit page.  Aside from changes it makes to the Admin >> Cemeteries Search form and results,  '''[[Admin Cemeteries Search]]''' places a simple "Add New Cemetery" form on the Search page, removes the "Add New" tab, and consolidates the Add New Cemetery form into the Edit Cemetery form.
 
 
 
Note that the changes to the Add New Cemetery form and workflow were moved from this mod to '''[[Admin Cemeteries Search]]''' with version 8 of both mods, so the version 8 of '''[[Admin Cemeteries Search]]''' is not is not compatible with older versions of this mod.
 
 
 
Also, this mod does save information that can be displayed by [[Show Mod Names]], but is not at all dependent on [[Show Mod Names]].
 
 
 
== Mod Conflicts ==
 
No known conflicts.  '''[[Admin Cemeteries Search]]''' is the only other mod that targets the Cemetery add and edit modules.
 
 
 
==Installation==
 
# Uninstall any previous version of this mod. It does not have to be deleted in order for the new version to be installed.
 
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 from this Wiki article.
 
# Extract the mod's .cfg file <span style='color:brown;'>and the mod's subfolder</span> from the zip file, and copy them to you the 'mods' subfolder on your TNG site.
 
# Refresh the Mod Manager, and click on this mod in the Mod Manager list to reveal this mod's Install button.
 
# Click on the Install button to Install this mod - as shown in the article [[Mod Manager - Installing Config Files]]
 
# <span style='color:brown'>'''This mod requires an extra step. which you may take, either before or after you Install the mod. You need to run a program that installs a required css file by clicking on the bold hyperlink in this mod's description within the Mod Manager</span>.
 
# Finally, select the Edit Options button for this mod in Mod Manager, and modify the Mod Parameters (i.e. "Options") as you see fit.
 
 
 
== In the event of a problem ==
 
# 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 ==
 
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
 
|-
 
|<span style="color: red"> BEFORE:</span> The unmodified Cemetery edit form, with the map hidden.  (The mod doesn't affect the map.) The areas in red rectangles are moved or removed by the mod.
 
|-
 
| [[Image:cemetery_edit-before.png]]
 
|-
 
| <span style="color: red"> AFTER:</span> The Cemetery edit form after installation of the mod. Green rectangles mark what's new; red rectangles mark things that have been moved or changed. 
 
<br/>[[Image:cemetery_edit-after1.png]]<br/>
 
Starting from the top:
 
# The "Cemetery Report" inner menu link used to be labeled 'Test'
 
# Three new inner menu links, as described in the [[#New_Inner_Menu_Links|New Inner Menu Links]] section above.
 
# One of several 'X' buttons attached to fields. Each 'X' button clears that field.
 
# A button that opens the "Place Lookup &amp; Copy" sub-form (See the next few visualizations to find out what happens when you do a Place Lookup.)
 
# "name" has been added to the "Associated Place" label and the Fill button to emphasize that the Associated Placename is not necessarily a single Place, with all of that Place's attributes, but that it can match the same Placename in multiple trees in the same database.
 
# The 'Placename Fill' button now observes the Mod Parameters that determine whether Place delimiters have spaces, and whether empty Place components are shown by adjacent delimiters.
 
# A duplicate Save button near top of the form, for convenience, especially when the map moves the original Save button off the screen.
 
# The "Delete Selected" button for the Country field is disabled when the new Default Country has been selected.
 
# The 3 Geocode fields in this visualization have been moved from their position below the map, as guided by a Mod Parameter.
 
# The wording of the 'Copy this geocode information...' checkbox has been changed to emphasize that the information might be copied to multiple Placenames in the Places table.
 
# Two more 'X' buttons, and a "Round" button that rounds the Latitude and Longitude either to 6 digits or to the number of digits defined by the Geocode digits system parameter installed by the [[Admin Places Geocode]] mod.
 
# The display of the clickable Google Map is affected by a Mod Parameter that allows the map to be hidden as the page loads if the Latitude and Longitude fields already have values - even if the applicable TNG system parameter says that maps should be displayed when Admin pages load.
 
# Changes to the fields that copy and/or select a Cemetery image file:
 
#* As with the Geocode fields, they have been moved (under the direction of a Mod Parameter), in this case, to the bottom of the form.
 
#* They have been reconfigured to more clearly distinguish between the 'Upload Image' process and the 'Select an Existing Image' process.
 
#* The footnotes at the bottom of the form (a long way from the relevant fields) that provided help text for for these fields has been eliminated, and new text is now placed among the fields.
 
# The placement of the 'On save' options has been adjusted to improve readability.
 
|}
 
{| border="2" cellspacing="0" cellpadding="2" class="wikitable"
 
| '''The workflow of the "Placename Lookup &amp; Copy" subform: Step 1:''' Click on the '''"Placename Lookup &amp; Copy"''' button
 
<br/>(We'll focus on the upper part of the form, above the Google map.)<br/>
 
[[Image:cemetery_edit-after-step1.png]]
 
|-
 
| '''Step 2: The Placename Lookup &amp; Copy subform'''
 
* The subform pops up.
 
* The user clicks the 'right-arrow' button next to the City field to to copy the City value to the search key. (The program uses a Mod Parameter to determine that there should be a space after the comma that it inserts before the City value.)
 
* The user then clicks on the "'''Go!'''" button to launch the lookup.
 
[[Image:cemetery_edit-after-step2.png]]
 
|-
 
| '''Step 3: The Placename Search Results'''
 
* The results panel pops up.
 
* The user clicks on the Information button to read the help message.
 
* The user reviews the data, and confirms that all 3 optional data elements will be copied.
 
* The user selects the first result.
 
[[Image:cemetery_edit-after-step3.png]]
 
|-
 
| '''Step 4: Close the Lookup &amp; Copy subform'''
 
* The results panel disappears
 
* The Place data is copied to fields in the Cemetery form.
 
* 'Up' buttons appear on the County, State, and Country fields in case a missing location component in the Placename caused the location components to be copied to the wrong fields.
 
* In this case, no data needs to be moved.
 
* The user clicks on the red X to close the Lookup &amp; Copy subform
 
[[Image:cemetery_edit-after-step4.png]]
 
|-
 
| '''Back at the Cemetery form without the Placename Lookup &amp; Copy subform<br/>
 
[[Image:cemetery_edit-after-step5.png]]
 
|}
 
, which, as revealed by the inset, contains
 
#* The search string for the lookup, and
 
#* A radio button set that controls the type of search:
 
#*# '''Starts With''' - The search string looks only at the beginning of a Place value,
 
#*# '''Contains''' - The search looks anywhere within a Place value, or
 
#*# '''Contains Each'' - The search looks for each place component (the comma-pieces) in each Placename in the database. (This option is disabled if the search string consists only of a Cemetery Name.)
 
|}
 
 
 
== Revision History ==
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
|-
 
! Mod Version
 
! TNG Version
 
! Date
 
! Note
 
|-
 
| 9.2.0.2
 
| TNGv9.2.2-10.0.1
 
| 14Mar2014
 
| Initial Release
 
|-
 
| 9.2.0.3
 
| TNGv.2.2-10.0.1
 
| 05Apr2014
 
| Restored the "Fill Place" button, and allowed users to enter an associated place directly.
 
|-
 
| 9.2.2.4
 
| TNGv9.2.2-10.0.3
 
| 04Oct2014
 
| Fixed bug with respect to selection of default country.  Added $defaultcountry parameter so that administrators can pick the default country for new cemeteries.
 
|-
 
| 10.1.0.5
 
| TNGv9.2.2-10.1+
 
| 11 Jan 2015
 
| TNG v10.1 compliance - Changed trimreplace directives to replace, and changed mysql_* function calls to tng_*
 
|-
 
| 10.1.0.7
 
| TNGv10.1+
 
| 7 May 2017
 
|
 
# Added a border around the Add New Cemetery form
 
# Fixed a bug where a SQL statement used single quotes instead of double quotes and couldn't handle a value with a single quote.
 
# The CopyPlace button copies the City, County, State, and Country from the associated place, and creates database records for the State and Country if necessary.
 
# There is now a Round button that rounds the geocordinates to 6 decimal places.
 
# Renumbered the locations.
 
# The .rrnoprinter style class (which prevents an element from printing on a printer) is now defined locally. This removes a dependency on what is now an obsolete mod.
 
|-
 
| 10.1.0.8
 
| 10.1 - 11.1.1+
 
| 9 Sep 2017
 
| <span id="latest">Production version</span>. Additional changes include:
 
# A link to the list of Mod Parameters (i.e. "Options") in the mod's Wiki article has been added to the Inner Menu.
 
# A link to the Visualizations in the mod's Wiki article has been added to the Inner Menu.
 
# The link to pop-up an Admin Places window (so that burial places can be created or edited as necessary while a Cemetery Edit page is open) has been moved to the Inner Menu.
 
# The fields that upload or assign a Cemetery map or photo image can be displayed at the top or bottom of the form, depending on a mod parameter.
 
# Several layout changes make the form less cluttered than previous versions of the mod.
 
# The table of matching Places (which supplies candidates for the Associated Place value and values for numerous fields on the form) is now placed in a pop-up LITBox, and uses AJAX so that the list of matching Places can be updated when the Cemetery Name and/or Location fields are updated.
 
# The search key for the table of matching Places is now a visible field that is automatically populated by the Cemetery Name as well as the location fields.  It can be changed by the user before doing a Place Lookup.
 
# A new Mod Parameter allows the Map to be hidden (initially) if there are already Geocodes, so that the fields below the map can be more visible.
 
# The 'zoom' field is now numeric, and the checkbox for copying the Cemetery's geocode data to the associated places has been moved next to the zoom field.
 
# The "On save..." radio buttons and the Save button at the bottom of the form are now laid out horizontally.
 
|}
 
 
 
== Sites using this mod ==
 
If you download and install this mod, please add your site to the table below.
 
 
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
|-
 
! URL !! User !! Note !! Mod-Version !! TNG-Version !! User-language
 
|-
 
| [http://www.robinrichmond.com/family/ Robin Richmond's Genealogy Database]
 
| [[User:Robinrichm|Robin Richmond]]
 
| Mod developer
 
| 11.1.1
 
| 10.1.0.8
 
| English
 
|-
 
| [http://www.total-family-history.com Total Family History]
 
| [[User:Fallonman|Scott Bennett]]
 
| Private Site (For right now)
 
| V9.2.0.3
 
| TNG 10.0.1
 
| English
 
|-
 
| [http://www.duttongenealogy.com The Dutton's of Vermont]
 
| [[User:Darrin65|Darrin Dutton]]
 
|
 
| 10.1.0.5
 
| 10.1.0
 
| EN
 
|-
 
| [https://genealogywings.com/ MOTYER Family Genealogy]
 
| [[User:JMM|John Mark Motyer]]
 
| Public site
 
| [[User:JMM|see here]]
 
| [[User:JMM|see here]]
 
| EN, DE, RU
 
|-
 
| [https://www.rgstrong-genes.com/ R G Strong Family Genealogy]
 
| [[User:Rgstrong|Russell G Strong]]
 
| Public Site
 
| v11.0.0.0
 
| v11.0.0
 
| EN (DE, FR, NL)
 
|-
 
|}
 
[[Category:Mods for TNG v11]]
 
[[Category:Mods for TNG v10]]
 
[[Category:Admin_editcemetery.php mods]]
 
[[Category:Admin_cemeteries.php mods]]
 
[[Category:Admin_addcemetery.php mods]]
 
[[Category:Admin_updatecemetery.php mods]]
 
[[Category:cust_text.php English mods]]
 

Latest revision as of 15:41, 14 September 2019