Difference between revisions of "Cemetery Edit"

From TNG_Wiki
Jump to navigation Jump to search
(intermediate changes)
Line 1: Line 1:
 
{{construction
 
{{construction
|notes=The article below describes a complete, tested mod.
+
|notes=I now consider version 7 of this mod to have "production" status.  I should upload version 8, with production status within a day or so. Notes for version 8 are included in the [[#latest|Revision History]]
This mod also has a new "beta" version:10.1.0.7 that can be downloaded here:
+
<br/>Robin Richmond 27 Jul 2017
[[Media:cemetery_edit_v10.1.0.7.zip|cemetery_edit_v10.1.0.7.zip]]
 
<br>Here's what the new version does:
 
 
 
# Added a border around the Add New Cemetery form
 
# Added optional Show Mod Names functionality to some of the programs modified by this mod.
 
# 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 then DisplayModNames mod.
 
 
 
I've been using the new version for a while, but
 
* It needs to be tested on other TNG sites,
 
* I haven't completed the description below, and
 
* I haven't created the visualizations this article needs
 
 
 
In truth, I have over 40 new and updated mods in this state, and I'd appreciate whatever help that anyone can offer.
 
So it would be great if you could download the mod, test it, and let me know how it works for you.
 
And if you're up for it, screenshots from before the mod was installed and after (annotated or not) would be a great help.
 
Just email any updates to me.
 
My email username is '''mail'', and my email domain is robinrichmond.com.
 
 
 
Thanks in advance.
 
Robin Richmond 14:57, 7 May 2017 (CDT)
 
 
}}
 
}}
 
 
 
{{TNGmod
 
{{TNGmod
| mod_name        = Cemeteries Edit
+
| mod_name        = Cemetery Edit
|  mod_summary    = Changes the Cemetery Edit form, the Cemetery Search screen, and the Add New Cemetery workflow.
+
|  mod_summary    = Makes workflow and presentation changes to the Cemetery Edit form and the Admin >> Cemeteries Search screen.
 
| mod_validation  =  
 
| mod_validation  =  
| download_link  = For {{Tv1010}}[[Media:cemetery_edit_v10.1.0.5.zip|cemetery_edit_v10.1.0.5.zip]]<hr/>{{Tv1003}}{{Tv922}}[[Media:cemetery_edit_v9.2.2.5.zip|cemetery_edit_v9.2.2.5.zip]]
+
| download_link  = [[Media:cemetery_edit_v10.1.0.7.zip|v10.1.0.7]] {{Tv110}}{{Tv1010}}
 +
<br/>See older versions in the [[#Revision_History]]
 
| download_stats  =
 
| download_stats  =
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
Line 39: Line 14:
 
| mod_contact    = [http://robinr.org/family/mod_support.php My Mod Support form]
 
| mod_contact    = [http://robinr.org/family/mod_support.php My Mod Support form]
 
| mod_support    = [http://robinr.org/family/mod_support.php My Mod Support form] or [http://tng.community/ TNG Community Forums]
 
| mod_support    = [http://robinr.org/family/mod_support.php My Mod Support form] or [http://tng.community/ TNG Community Forums]
| mod_version    = 10.1.0.5 for TNG v10.1 <br/>9.2.2.5 for TNG v9.2.2 thru 10.0.3
+
| mod_version    = 10.1.0.7
| min_TNG_ver    = 9.2.2
+
| min_TNG_ver    = 10.1.0
| max_TNG_ver    = 10.1
+
| max_TNG_ver    = at least 11.1.1
|  TNG_file_list  = admin_cemeteryedit.php<br />
+
|  TNG_file_list  = admin_editcemetery.php, admin_cemeteries.php, admin_cemeteryadd.php, cemeteries_help.php,  nguages/English/admintext.php, English cust_text.php
admin_cemeteries.php <br />
 
admin_cemeteryupdate.php<br />
 
admin_cemeteryadd.php<br />
 
languages/English/admintext.php<br />
 
languages/English-UTF8/admintext.php<br />
 
languages/English/cemeteries_help.php
 
 
| related_mods  = My [[Cemeteries Admin List]] mod
 
| related_mods  = My [[Cemeteries Admin List]] mod
 
| notes    =   
 
| notes    =   
 
}}
 
}}
 
{| style="margin-right:0.5 em;" align="right"
 
| __TOC__
 
 
|}
 
 
 
== Purpose of the Mod ==
 
== Purpose of the Mod ==
 
To allow an administrator who is adding and updating cemeteries to
 
To allow an administrator who is adding and updating cemeteries to
Line 66: Line 29:
 
* whether I need to copy Geocode information from the Cemetery to the Place, from the Place to the Cemetery, or neither.
 
* whether I need to copy Geocode information from the Cemetery to the Place, from the Place to the Cemetery, or neither.
 
I was also confused about the relationship between Cemeteries and Places, and have updated the Cemeteries help file significantly, both to bring it up-to-date, and to explain that relationship.
 
I was also confused about the relationship between Cemeteries and Places, and have updated the Cemeteries help file significantly, both to bring it up-to-date, and to explain that relationship.
 +
__TOC__
  
==Mod Parameter==
+
== Mod Parameters ==
 +
(All parameters apply to admin_editcemetery.php)
 +
# $defaultcountry:USA - The default value when you create a new cemetery.
 +
# $imageFieldsLocation:bottom - The two fields that can used to upload and/or assign a Cemetery map or photo imagecan be displayed near the top or near the bottom of the form, depending on this parameter.
 +
# $mapVisibility:hide - 'hide' means to hide the map when the page first loads <b>only if the Latitude and Longitude fields have already been populated.
 +
 +
== New Inner Menu (help) Options ==
 
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.)
 
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.)
  
Line 97: Line 67:
 
# Try using the [[Mod_Manager_-_Installing_Config_Files#Remove_Mod_Steps|Mod Manager Remove]] capability
 
# Try using the [[Mod_Manager_-_Installing_Config_Files#Remove_Mod_Steps|Mod Manager Remove]] capability
 
# Contact me through [http://robinr.org/family/mod_support.php My Mod Support form].
 
# Contact me through [http://robinr.org/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 from TNGv9.2.2 or TNG10.1, 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.  The green circle marks the text affected by the mod parameter.
 +
 +
Starting from the top: The field prompts are now right-justified closer to the fields. New Save and Cancel buttons. A new table showing existing places that start with this cemetery name. (The column marked with an arrow has a footnote.) There's now a link to open the places editor in a new window, so the user can look more closely at or modify the places listed to the right. The word "Name" has been added to the "Associated Place" label. The Associated Place Name field is longer, and is greyed out because it is disabled so that the user cannot enter a place name directly. The "Copy the geocode information..." label conveys what actually happens more accurately. The Latitude, Longitude, and Zoom fields have been moved from below the clickable map. A new Cancel button has been placed at the bottom of the form. At the very bottom, there are two new footnotes describing the link that opens the place editor and the table column I highlighted with an arrow.
 +
|-
 +
| [[Image:cemetery_edit-after1.png]]
 +
|-
 +
|<span style="color: red"> An AFTER view of the Cemetery Search & Selection page:</span> <br /> The one-line "Add New Cemetery" form is new.  It creates a new Cemetery with nothing but the cemetery name, and immediately invokes the Cemetery Edit form.
 +
|-
 +
| [[Image:cemetery_edit-after2.png]]
 +
|-
 +
|}
  
 
== Mod Change History ==
 
== Mod Change History ==
Line 105: Line 94:
 
! Date
 
! Date
 
! Note
 
! Note
|-
 
| 10.1.0.5
 
| 9.2.2-10.1
 
| 11 Jan 2015
 
| TNG v10.1 compliance - Changed trimreplace directives to replace, and (in v10.1.0.5) changed mysql_* function calls to tng_*
 
 
|-  
 
|-  
| 9.2.2.4
+
| 9.2.0.2
| 9.2.2-10.0.3
+
| TNGv9.2.2-10.0.1
| 04Oct2014
+
| 14Mar2014
| Fixed bug with respect to selection of default country.  Added $defaultcountry parameter so that administrators can pick the default country for new cemeteries.
+
| Initial Release
 
|-  
 
|-  
 
| 9.2.0.3
 
| 9.2.0.3
| 9.2.2-10.0.1
+
| TNGv.2.2-10.0.1
 
| 05Apr2014
 
| 05Apr2014
 
| Restored the "Fill Place" button, and allowed users to enter an associated place directly.
 
| Restored the "Fill Place" button, and allowed users to enter an associated place directly.
 
|-  
 
|-  
| 9.2.0.2
+
| 9.2.2.4
| 9.2.2-10.0.1
+
| TNGv9.2.2-10.0.3
| 14Mar2014
+
| 04Oct2014
| Initial Release
+
| Fixed bug with respect to selection of default country.  Added $defaultcountry parameter so that administrators can pick the default country for new cemeteries.
|}
 
== Visualization of this Mod ==
 
 
 
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
 
 
|-
 
|-
|<span style="color: red"> BEFORE:</span> The unmodified Cemetery edit form from TNGv9.2.2 or TNG10.1, with the map hidden.  (The mod doesn't affect the map.) The areas in red rectangles are moved or removed by the mod.
+
| 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_*
 
|-
 
|-
| [[Image:cemetery_edit-before.png]]
+
| 10.1.0.7
|-
+
| TNGv10.1+
| <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.  The green circle marks the text affected by the mod parameter.
+
| 7 May 2017
 
+
| Beta Status, with numerous changes:
Starting from the top: The field prompts are now right-justified closer to the fields. New Save and Cancel buttons. A new table showing existing places that start with this cemetery name. (The column marked with an arrow has a footnote.) There's now a link to open the places editor in a new window, so the user can look more closely at or modify the places listed to the right. The word "Name" has been added to the "Associated Place" label. The Associated Place Name field is longer, and is greyed out because it is disabled so that the user cannot enter a place name directly. The "Copy the geocode information..." label conveys what actually happens more accurately. The Latitude, Longitude, and Zoom fields have been moved from below the clickable map. A new Cancel button has been placed at the bottom of the form. At the very bottom, there are two new footnotes describing the link that opens the place editor and the table column I highlighted with an arrow.
+
# 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.
| [[Image:cemetery_edit-after1.png]]
+
# 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.
|<span style="color: red"> An AFTER view of the Cemetery Search & Selection page:</span> <br /> The one-line "Add New Cemetery" form is new. It creates a new Cemetery with nothing but the cemetery name, and immediately invokes the Cemetery Edit form.  
+
# 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.
 
|-
 
|-
| [[Image:cemetery_edit-after2.png]]
+
| 11.1.0.8
|-  
+
| 11.0+
 +
| 27 Jul 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.
 
|}
 
|}
  
Line 194: Line 190:
 
|-
 
|-
 
|}
 
|}
[[Category:Mods for TNG v9]]
+
[[Category:Mods for TNG v11]]
 
[[Category:Mods for TNG v10]]
 
[[Category:Mods for TNG v10]]
 
[[Category:Admin_editcemetery.php mods]]
 
[[Category:Admin_editcemetery.php mods]]
Line 200: Line 196:
 
[[Category:Admin_addcemetery.php mods]]
 
[[Category:Admin_addcemetery.php mods]]
 
[[Category:Admin_updatecemetery.php mods]]
 
[[Category:Admin_updatecemetery.php mods]]
 +
[[Category:cust_text.php English mods]]

Revision as of 14:36, 27 July 2017

Construction I now consider version 7 of this mod to have "production" status. I should upload version 8, with production status within a day or so. Notes for version 8 are included in the Revision History


Robin Richmond 27 Jul 2017

Construction


Cemetery Edit
Summary Makes workflow and presentation changes to the Cemetery Edit form and the Admin >> Cemeteries Search screen.
Validation
Mod Updated {{{mod_last_update}}}
Download link v10.1.0.7
TNG 11.0
TNG 10.1.0

See older versions in the #Revision_History
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 10.1.0.7
Min TNG V 10.1.0
Max TNG V at least 11.1.1
Files modified
admin_editcemetery.php, admin_cemeteries.php, admin_cemeteryadd.php, cemeteries_help.php, nguages/English/admintext.php, English cust_text.php
Related Mods
Notes


Purpose of the Mod

To allow an administrator who is adding and updating cemeteries to

  1. view more information about matching places, and
  2. add new cemeteries more easily (without a redundant Add screen)

It was motivated by my troubles with 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 confused about the relationship between Cemeteries and Places, and have updated the Cemeteries help file significantly, both to bring it up-to-date, and to explain that relationship.

Mod Parameters

(All parameters apply to admin_editcemetery.php)

  1. $defaultcountry:USA - The default value when you create a new cemetery.
  2. $imageFieldsLocation:bottom - The two fields that can used to upload and/or assign a Cemetery map or photo imagecan be displayed near the top or near the bottom of the form, depending on this parameter.
  3. $mapVisibility:hide - 'hide' means to hide the map when the page first loads only if the Latitude and Longitude fields have already been populated.

New Inner Menu (help) Options

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.)

However, edits made in that new window will not be reflected in the form, and a user may be tempted to refresh the page or the frame to bring the list of matching place up to date. But refreshing the page or window will lose any unsaved edits, and refreshing the page will return the user to the administrative menu.

The mod parameter thus allows the installer to suppress the "Open the place editor in a new window" prompt.

Related Mods

My Cemeteries Admin List mod is motivated by essentially the same purposes, but focuses on the Cemetery Search/Selection page, where it adds

  1. the Cemetery Notes field, and
  2. the Associated Place and its Geocode information

It can be installed (or not) independently of this mod.

This Cemetery Edit mod changes the form that edits cemeteries and makes further changes to the Cemetery Search/Selection page so that new cemeteries can be added directly from that page.

Requirements

  • A working TNG installation.
  • An installed current version of the Mod Manager.
  • The only other mod that target the cemetery add/edit modules is my Cemeteries Admin List mod, which can be installed (or not) independently.

Automated Installation

  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. Upload and Extract to the mods folder.
  4. 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

  1. Try using the Mod Manager Remove capability
  2. Contact me through My Mod Support form.

Visualizations

BEFORE: The unmodified Cemetery edit form from TNGv9.2.2 or TNG10.1, with the map hidden. (The mod doesn't affect the map.) The areas in red rectangles are moved or removed by the mod.
Cemetery edit-before.png
AFTER: 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. The green circle marks the text affected by the mod parameter.

Starting from the top: The field prompts are now right-justified closer to the fields. New Save and Cancel buttons. A new table showing existing places that start with this cemetery name. (The column marked with an arrow has a footnote.) There's now a link to open the places editor in a new window, so the user can look more closely at or modify the places listed to the right. The word "Name" has been added to the "Associated Place" label. The Associated Place Name field is longer, and is greyed out because it is disabled so that the user cannot enter a place name directly. The "Copy the geocode information..." label conveys what actually happens more accurately. The Latitude, Longitude, and Zoom fields have been moved from below the clickable map. A new Cancel button has been placed at the bottom of the form. At the very bottom, there are two new footnotes describing the link that opens the place editor and the table column I highlighted with an arrow.

Cemetery edit-after1.png
An AFTER view of the Cemetery Search & Selection page:
The one-line "Add New Cemetery" form is new. It creates a new Cemetery with nothing but the cemetery name, and immediately invokes the Cemetery Edit form.
Cemetery edit-after2.png

Mod Change History

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 Beta Status, with numerous changes:
  1. Added a border around the Add New Cemetery form
  2. Fixed a bug where a SQL statement used single quotes instead of double quotes and couldn't handle a value with a single quote.
  3. 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.
  4. There is now a Round button that rounds the geocordinates to 6 decimal places.
  5. Renumbered the locations.
  6. 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.
11.1.0.8 11.0+ 27 Jul 2017 Production version. Additional changes include:
  1. A link to the list of Mod Parameters (i.e. "Options") in the mod's Wiki article has been added to the Inner Menu.
  2. A link to the Visualizations in the mod's Wiki article has been added to the Inner Menu.
  3. 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.
  4. 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.
  5. Several layout changes make the form less cluttered than previous versions of the mod.
  6. 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.
  7. 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.
  8. 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.
  9. 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.
  10. 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.

URL User Note Mod-Version TNG-Version User-language
Robin Richmond's Genealogy Database Robin Richmond Mod developer 9.2.0.4 10.0.3 English
Total Family History Scott Bennett Private Site (For right now) V9.2.0.3 TNG 10.0.1 English
The Dutton's of Vermont Darrin Dutton 10.1.0.5 10.1.0 EN
MOTYER Family Genealogy John Mark Motyer Public site see here see here EN, DE, RU
R G Strong Family Genealogy Russell G Strong Public Site v11.0.0.0 v11.0.0 EN (DE, FR, NL)