Difference between revisions of "Cemetery Edit"
Robinrichm (talk | contribs) |
Robinrichm (talk | contribs) (intermediate changes) |
||
Line 1: | Line 1: | ||
{{construction | {{construction | ||
− | |notes= | + | |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]] |
− | + | <br/>Robin Richmond 27 Jul 2017 | |
− | [[ | ||
− | <br> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | Robin Richmond | ||
}} | }} | ||
− | |||
− | |||
{{TNGmod | {{TNGmod | ||
− | | mod_name = | + | | mod_name = Cemetery Edit |
− | | mod_summary = | + | | mod_summary = Makes workflow and presentation changes to the Cemetery Edit form and the Admin >> Cemeteries Search screen. |
| mod_validation = | | mod_validation = | ||
− | | download_link = | + | | 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. | + | | mod_version = 10.1.0.7 |
− | | min_TNG_ver = | + | | min_TNG_ver = 10.1.0 |
− | | max_TNG_ver = | + | | max_TNG_ver = at least 11.1.1 |
− | | TNG_file_list = | + | | 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 | ||
− | |||
− | admin_cemeteryadd.php | ||
− | |||
− | |||
− | |||
| related_mods = My [[Cemeteries Admin List]] mod | | related_mods = My [[Cemeteries Admin List]] mod | ||
| notes = | | notes = | ||
}} | }} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== 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 | + | == 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 | ||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | 9.2.2 | + | | 9.2.0.2 |
− | | | + | | TNGv9.2.2-10.0.1 |
− | | | + | | 14Mar2014 |
− | | | + | | Initial Release |
|- | |- | ||
| 9.2.0.3 | | 9.2.0.3 | ||
− | | | + | | 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. | + | | 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: | |
− | + | # 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. | ||
|- | |- | ||
− | | | + | | 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 | + | [[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
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
|
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
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 | My Cemeteries Admin List mod | ||
Notes |
Purpose of the Mod
To allow an administrator who is adding and updating cemeteries to
- view more information about matching places, and
- 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)
- $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 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
- the Cemetery Notes field, and
- 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
- 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
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:
|
11.1.0.8 | 11.0+ | 27 Jul 2017 | Production version. Additional changes include:
|
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) |