Difference between revisions of "Admin Cemetery Edit"
Robinrichm (talk | contribs) (mod v9c - bug fix, mod includes v5, etc) |
Robinrichm (talk | contribs) |
||
Line 179: | Line 179: | ||
{| border="3" cellspacing="1" cellpadding="2" class="wikitable" | {| border="3" cellspacing="1" cellpadding="2" class="wikitable" | ||
|- | |- | ||
− | |'''Cemetery Edit form <span style="color: red">After Installation</span> - The Inner Mod Menu''' | + | |'''Cemetery Edit form <span style="color: red">After Installation</span> |
+ | |- | ||
+ | | The Inner Mod Menu''' | ||
<br>In admin_editcemetery.php the Inner Mod Menu links to: | <br>In admin_editcemetery.php the Inner Mod Menu links to: | ||
* The [[Admin Branches]] Wiki article. | * The [[Admin Branches]] Wiki article. | ||
* The [[#Mod_Options|Mod Options]] section of the Wiki article, and | * The [[#Mod_Options|Mod Options]] section of the Wiki article, and | ||
− | * The | + | * The mod setting block for this mod. (See the next visualization). |
|- | |- | ||
− | [[Image:admin_branches-after-innermodmenu.jpg]] | + | | [[Image:admin_branches-after-innermodmenu.jpg]] |
|- | |- | ||
− | |'''The Admin | + | |'''The Admin Cemetery Edit options - in a "Mod Settings Block" |
− | <br>The Mod Settings Block for Admin Branches (like most other Mod Settings Blocks) is at '''Admin>>Setup>>General Settings''' in a new subform named '''Robin's Mods'''. | + | <br>The Mod Settings Block for Admin Branches (like most other Mod Settings Blocks) is at '''Admin>>Setup>>General Settings''' in a new subform named '''Robin's Mods'''. |
− | + | The Mod Manager "Edit Options" button in this mods "Mod List" row opens the Admin>>Settings form directly to this mod's Mod Setting Block, like this: | |
|- | |- | ||
− | [[Image:admin_branches-after-modsettingsblock.jpg]] | + | | [[Image:admin_branches-after-modsettingsblock.jpg]] |
|} | |} | ||
Revision as of 06:42, 29 March 2020
Admin Cemetery Edit | ||
---|---|---|
Summary | Makes workflow and presentation changes to the Cemetery Edit form and the Cemeteries "Add New" tab. | |
Validation | ||
Mod Updated | 28 Mar | |
Download link | 12.0.0.9c.zip
See older versions in the Revision History | |
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 | v12.0.0.9c | |
Min TNG V | 10.0.1 | |
Max TNG V | 12.3 | |
Files modified | Modifies: admin_editcemetery.php, admin_updatecemetery.php, admin_cemeteries.php, admin_newcemetery.php, admin_addcemetery.php, cemeteries_help.php, admin_genconfig.php, admin_updateconfig.php, English cust_text.php. Installs: rrcemeteryedit_ajx.php, img/rrcemeteryedit_right.gif | |
Related Mods | ||
Notes |
Purpose of the Mod
This mod is intended to improve the workflow and layout of the Cemetery Edit form, and, particularly to clarify the differences among the buttons that fill in the Associated Placename field.
Functional changes in the Cemetery Edit page include:
- A new Associated Placename lookup tool (in addition to the one in the native Edit form). The new "Place Lookup & Copy" form:
- Provides buttons that copy Cemetery city, county, state, and country values to the search field,
- Has more search options,
- In the search results:
- Displays Geocodes, Tree, Number of Burials
- Separates the Cemetery Name from the City, County, State, and Country in the Placename
- Provides a way to copy the new Associated Placename's Cemetery Name, City, County, State, Country, and Geocodes to Cemetery fields.
Other page layout and content changes include:
- Mod settings control whether some form fields appear above or below the Gooogle map.
- New help links and annotation,
- The two old buttons and one new button that populate the Associated Place field are side-by-side above that field.
- There is now an Inner Mod Menu in the page's Inner Menu. (See Inner Menu Links below.)
See a detailed list of changes in the Visualizations below.
This mod also changes the Admin Cemeteries "Add New" tab so that the "Add New" tab invokes the Cemetery Edit page instead of the nearly-identical (in pristine form) Cemetery Add form. As a result, the changes this mod makes to the Cemetery Edit form do not need to be made to the Cemetery Add form.
Mod Options
- Default country for new cemeteries
- Put Geocode fields above the map? - The pristine code put the Cemetery Image fields at the bottom of the form, below the Google map. This parameter allows them to be placed before or after the map.
- Put Image Upload fields above the map? - The pristine code put the Cemetery Image fields at the beginning of the form. This parameter allows them to be placed before or after the Google map.
- Delimiter within Placenames - Just a comma ("Erie County,Ohio,USA") or comma-space ("Erie County, Ohio, USA").
- When filling the Associated Placename, include the extra delimiter if a place-part is missing?
This is invoked when the Cemetery form fields (cemetery name, city, county, state, country) are used to create a new Associated Placename. If, say, the city is missing, the new Associated Placename can be- "Bethel Cemetery, , Erie County, Ohio, USA" (with an empty placeholder for the City), or
- "Bethel Cemetery, Erie County, Ohio, USA" (with no City placeholder).
- Count burials at the Associated Place in the Placename Lookup and Copy Widget? - The widget normally displays the number of Burial events at each Placename that matches the search, but for some large databases, it may take too long to count burials, so the burial count can be suppressed.
- In the Placename Lookup and Copy Widget results, check the boxes that copy these values to the Cemetery fields - Checkboxes cause specific (groups of) values to be copied to the Cemetery form when an Associated Placename is selected. The checkbox value are:
- Cemetery Name (which is extracted from the Associated Placename),
- City,County,State,Country (also extracted from the Associated Placename),
- Geocodes - Latitude, Longitude, Zip
These mod options are custom TNG settings, defined and edited in the form at Admin>>Setup>>General Settings, in a new subform named Robin's Mod's. This subform takes advantage of a scheme that I call Mod Settings Blocks. See the last visualization below.
Inner Menu Links
In admin_editcemetery.php, some links in the Inner Menu have been modified:
- Cemetery Report - This was labeled 'Test' in the native page, and launches showmap.php, which is effectively the "Cemetery Detail Report".
- Places Search - A pop-up link to Admin>>Places. This link makes it easy for you to find and edit a Burial Place record that you wish to associate with this Cemetery.
- Mod Information - This link drops down what I call an Inner Mod Menu, which contains these links to information about this mod:
- This Wiki Article,
- The "Mod Options" section of this Wiki article,
- The mod options editor (Admin>>Setup>>General Settings>>Robin's Mods). When you follow this link, the options edit form display only this mods options. If you want to see tall of the mod options in the subform, just click on the heading Robin's Mods. (See the visualization below, or at Inner_Mod_Menus.
- The Add/Edit section of the Cemetery help file, which has been modified to reflect the changes made by this mod.
- This mod's changes have also been highlighted with blue outlines.
Related Mods
- This mod uses the Field Buttons mod to attach small 'field buttons' to several text fields, but it is not dependent on Field Buttons. Field buttons are configurable (and generally one-character) buttons that are attached to HTML form fields, and that reduce the typing or mouse movements needed to perform several common editing tasks. This mod is not compatible with Field Buttons mod versions earlier than version 3.
- Admin Cemeteries Search is a companion to Admin Cemetery Search (this mod). It was motivated by essentially the same purposes as this mod, and focuses on the Cemetery Search/Selection page, whereas this mod focuses on the Cemetery Edit page. Admin Cemeteries Search also changes the Cemeteries>>Add New tab to use admin_editcemetery.php rather than admin_newcemetery.php (no matter whether admin_editcemetery.php has been modified by this mod).
- This mod will round Cemetery geocoordinates to the number of decimal digits specified by the mod option for Admin Places Geocode, if and only if Admin Places Geocode version 4+ is installed.
- This mod saves 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
Files Installed
This mod has two mod subfolders:
- admin_cemeteries_edit_v12.0.0.9a - The subfolder that you expect to exist for any mod that installs files. It contains
- rrcemeteryedit_ajx.php - An AJAX program that helps to populate the Cemetery's "Associated Place" field. It finds Cemeteries that match specifications provided in the edit page, lists them with some of their data, and allows the user to select one.
- img/rrcemeteryedit_right.gif - A small image the points to the right when field values can be copied to the right to add specifications to the Associate Place lookup described above.
- The shared folder RR-shared_mod_includes_v12.0.0.5, which contains files that support mod option management in many of my mods:
- rrshared_innermodmenu5.php - Inner Mod Menus
- rrshared_modsettingsblocks5.php - Mod Settings Blocks
- img/rrshared_wikilogo.gif - An icon that links to a mod's TNG Wiki page from an Inner Mod Menu or Mod Settings Block
The shared folder is packaged with several mods, each of which may install some or all of its files. Once a file from this folder has been installed (by any mod), that file will not be overwritten or removed by the subsequent installation or un-installation of any mod (including this one), nor will its presence generate any Mod Manager errors.
If you unzip mod distribution files directly into your mods folder, then the presence of this second subfolder and the installation of its files should be invisible to you. But if you generally copy mod subfolders to your mods folder, you need to make sure to copy the folder RR-shared_mod_includes_v12.0.0.5 (well, unless you are confident that it is already in your mods folder because it was part of another mod).
[Show Installation Details]
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: The unmodified Cemetery edit form, with the Google map hidden. The areas in red rectangles are moved, changed, or removed by the mod. |
- The "Cemetery Report" inner menu link used to be labeled 'Test'
- The new "Place Search" link opens the Admin>>Places>>Search in a new window. This link's purpose is to allow you to find and modify Places that will be used as as Cemetery's Associated Placename.
- The "Mod Information" link pulls down the Inner Mod Menu.
- The Cemetery Name, City, and County/Parish fields now have "field buttons", which are one-character buttons that perform editing shortcuts such as "Clear the field" and "Restore the field's initial value". The field buttons are visible only if the optional Field Buttons mod has been installed.
- The "Save and Exit" button duplicates one of the Save options at the bottom of the screen. It is most handy when the map is visible and the original Save button is not.
- The "Delete Selected" button for the Country field is disabled when the current Country value is the same as the Default Country value that is specified by a mod option. (That is, in this case, "USA" is the default Country, and cannot be deleted from the Countries table.)
- The Fill Placename button has been moved. It does virtually the same thing as before, but its action is now affected by two mod options
1. Whether Place delimiters have spaces, and
2. Whether empty Place components are shown by adjacent delimiters.
That is, it can generate names such as 'Huron County,Ohio,USA' (without spaces), 'Huron County, Ohio, USA' (with spaces), 'Peace Cemetery, , Dover County, Utah, USA', (with a placeholder for the missing city), and 'Peace Cemetery, Dover County, Utah' (with no indication of the missing city). - The spyglass button has moved, but still invokes the native Find Placename function.
- A new button opens the "Place Lookup & Copy" Widget, which is essentially an enhancement to the native Find Placename function.
- There are some enhancements to the lookup itself.
- The key enhancements affect what happens when a Placename in the lookup results is selected, and are especially useful when new Cemetery records are being created. The core purpose of the "Find Placename" and "Place Lookup & Copy" buttons is to select the Associated Placename for a Cemetery. The key "Place Lookup & Copy" enhancements, unsurprisingly, add "Copy" functionality, that is, the Place Lookup & Copy widget can use values in the selected Place record to populate
- The Cemetery name,
- The Cemetery's location components (City, State, County, Country), and/or
- The Cemetery' Geocoordinates (Latitude, Longitude, and Zoom).
- The "Associated Placename" label used to be "Associated Place". The change emphasizes that the Associated Placename is not necessarily a single Place (in a single Tree), but rather is a Placename that can match Places in multiple trees.
- The the three Geocoordinates fields are enclosed in a Fieldset, and have been moved above the map. A mod option controls whether they are above or below the map. In addition, the wording of the 'Copy this geocode information...' checkbox has been changed to emphasize that the information might be copied to multiple Place records in the Places table.
- The Cemetery Image fields are now enclosed in a Fieldset, and have been moved so that they are below the map. Their position on the page is controlled by a mod option.
- The placement of the 'On save' options and "Save" button have been adjusted to improve readability.
- The Cemetery Image is now scaled to the browser window.
AFTER INSTALLATION: The modified Cemetery edit form. Green rectangles mark what's new , and red rectangles mark things that have been moved or changed . |
The workflow of the "Placename Lookup & Copy" Widget
Cemetery Edit form After Installation |
The Inner Mod Menu
|
The Admin Cemetery Edit options - in a "Mod Settings Block"
|
Revision History
Mod Version | TNG Version | Date | Note |
---|---|---|---|
12.0.0.9c | 12.0-12.3 | 28Mar2020 |
|
12.0.0.9b | 12.0-12.3 | 26Feb2020 | No functional changes.
|
12.0.0.9 | 12.0 - 12.2 | 28 Sep 2019 | No significant functional changes; but several user interface and help file changes. Also see the .cfg file for bug fixes and other internal changes.
|
12.0.0.8b | 12.0-12.2 | 15 May 2018 | No functional changes; made compatible with TNGv12. |
10.1.0.8b | 10.1 - 11.1.2+ | 10 Feb 2017 | No visible changes on-screen, though the page as printed is different. Specifically:
|
10.1.0.8 | 10.1 - 11.1.1+ | 9 Sep 2017 | Production version. Additional changes include:
|
10.1.0.7 | TNGv10.1+ | 7 May 2017 |
|
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_* |
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. |
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.0.2 | TNGv9.2.2-10.0.1 | 14Mar2014 | Initial Release |
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 | 12.0.0.9c | 12.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) |
Cole / Tanner Family Tree | David Cole | Public/Private | see here | see here | English |
Woking Family Tree Project | Pete Smee | Public/Private Brilliant Mod many thanks | v12.0.0.8b | v12.1 | English |
Our Family Histories | Bryan S. Larson | Public - T8 customized | see here | see here | EN |