Difference between revisions of "Admin Cemetery Edit"
Robinrichm (talk | contribs) (updated the visualizations) |
|||
Line 4: | Line 4: | ||
| mod_validation = | | mod_validation = | ||
| mod_last_update = 10 Feb 2023 | | mod_last_update = 10 Feb 2023 | ||
− | | download_link = | + | | download_link = [[Media:admin_cemetery_edit_v14.0.0.11.zip|14.0.0.11.zip]]{{Tv140}} |
− | + | <hr style="clear: both;"/> | |
<div style='clear:both;font-size:90%'>See older versions in the [[#Revision_History|Revision History]]</div> | <div style='clear:both;font-size:90%'>See older versions in the [[#Revision_History|Revision History]]</div> | ||
| download_stats = | | download_stats = | ||
Line 14: | Line 14: | ||
| mod_version = v14.0.0.11 | | mod_version = v14.0.0.11 | ||
| min_TNG_ver = 10.0.1 | | min_TNG_ver = 10.0.1 | ||
− | | max_TNG_ver = | + | | max_TNG_ver = 14.0.2 |
− | | TNG_file_list = 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<br>Installs rrcemeteryedit_ajx.php, rrcemeteryedit_lib,.php, rrcemeteryedit.css, rrcemeteryedit_right.gif | + | | TNG_file_list = 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<br>Installs rrcemeteryedit_ajx.php, rrcemeteryedit_lib,.php, rrcemeteryedit.css, rrcemeteryedit_right.gif |
| related_mods = [[Admin Cemeteries Search]], [[Admin Places Geocode]] | | related_mods = [[Admin Cemeteries Search]], [[Admin Places Geocode]] | ||
| notes =Requires [[Mod Settings Blocks]] | | notes =Requires [[Mod Settings Blocks]] | ||
Line 385: | Line 385: | ||
| Mod developer | | Mod developer | ||
| 14.0.0.11 | | 14.0.0.11 | ||
− | | | + | | 14 |
| EN | | EN | ||
Revision as of 12:35, 22 September 2023
Admin Cemetery Edit | ||
---|---|---|
Summary | Makes workflow and presentation changes to the Cemetery Edit form and the Cemeteries "Add New" tab. | |
Validation | ||
Mod Updated | 10 Feb 2023 | |
Download link | 14.0.0.11.zip
See older versions in the Revision History | |
Download stats | ||
Author(s) | Robin Richmond | |
Homepage | Admin Cemetery Edit (This page) | |
Mod Support | My Mod Support form | |
Contact Developer | My Mod Support form | |
Latest Mod | v14.0.0.11 | |
Min TNG V | 10.0.1 | |
Max TNG V | 14.0.2 | |
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, rrcemeteryedit_lib,.php, rrcemeteryedit.css, rrcemeteryedit_right.gif | |
Related Mods | ||
Notes | Requires Mod Settings Blocks |
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 now side-by-side above that field.
- There is now an Inner Mod Menu in the page's Inner Menu.
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.
Developer
This mod was developed by Robin Richmond.
Requirements
- A working TNG installation.
- A backup of all affected files (see the list in the summary in the upper right corner of the page)
- An installed current version of the Mod Manager.
Mod Options
These mod options are custom TNG settings, defined and edited in a Mod Settings Block in the form at Admin>>Setup>>General Settings, in a new subform named Mod Settings Blocks. The Mod Settings Blocks mod is a prerequisite for the installation of this mod.
- Default country for new cemeteries
- Put Geocode fields above the map? - The native 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 native 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.
Mod Conflicts
No known conflicts. Admin Cemeteries Search is the only other mod that targets the Cemetery add and edit modules.
Related Mods
- The Mod Settings Blocks mod packages this mod's options into what I call a "Mod Settings Block", which is a set of form fields that formatted and labeled so that it stands out among other options in an Admin>>Setting form. Mod Settings Blocks is a prerequisite for this mod; it must be installed before this mod can be installed.
- Admin Cemeteries Search is a companion to Admin Cemetery Edit (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).
- Admin Places Geocode defines a mod setting that control the number of decimal digits in Place geocoordinates. If that setting exists, this mod will use it to round both old and new Cemetery geocoordinates.
Installation
Files Installed
- 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.
- rrcemeteryedit_lib.php - PHP and Javascript code that handles the new screen widgets such as the count/state/county/city drop-down lists and the Placename Lookup Widget., rrcemeteryedit.css, rrcemeteryedit_right.gif
- css/rrcemeteryedit_css.php - This mod's own CSS (There are already so many rules in genstyle.css that I don't add rules that are used in only one or two pages.)to
- 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.
This mod includes a typical mod subfolder, with the same base name as the mod's .cfg file. The subfolder is atypical in that no files in it are installed to working TNG folders. However, it does contain critical files that contain the mod's language strings, which the mod does not add to standard cust_text.php files. Instead, the PHP code modified by this mod loads the language strings from files in the mod's languages/ subfolder. Read more about this technique.
[Show Standard Installation Process]
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.
In the event of a problem
- Try using the Mod Manager Remove capability
- Copy the backup of the affected files back to your TNG directory
- Contact me using My Mod Support form.
Uninstalling the mod
If you want to completely Remove (uninstall) this mod and all its tables, you should
- click the Uninstall button to uninstall the mod
- click the Delete button to delete the config file from the mods folder.
Upgrade
- Uninstall and eventually Delete the current Mod.
- Proceed as for an installation with the new Mod.
Visualizations
Visualization 1. BEFORE: The unmodified Cemetery edit form, with the Google map hidden. The areas in red rectangles are moved, changed, or removed by the mod. |
Visualization 2. AFTER INSTALLATION: The modified Cemetery edit form. Green rectangles mark what's new , and red rectangles mark things that have been moved or changed . |
[Show lots of details]
[Hide details]
Starting from the top:
[Hide details]
|
Visualization 3. The workflow of the "Placename Lookup & Copy" Widget
Visualization 4. The "Inner Menu" Before: File:AdminCemeteryEditInnerMenu-before.png
After:
|
Visualization 5. After Installation- The Inner Mod Menu In admin_editcemetery.php the Inner Mod Menu links to:
|
Visualization 6. After Installation- The Admin Cemetery Edit Mod Settings Block
A Mod Settings Block is an outlined subform within an Admin>>Setup program that contains the options for a single mod. What is most notable about a Mod Settings Block is that a hyperlink directly to a Mod Settings Block displays only that block (i.e. only one mod's options), not all of the other options in the form or subform. Here, you see the this mod's Mod Settings Block, in admin_genconfig.php, at Admin>>Setup>>General Settings. The triangular arrow next to the subfolder heading Mod Settings Blocks is pointing to the right, meaning that the subform is not open, and that your site's other mod settings blocks are not visible. If you were to open the subform by clicking on the heading, you would see the mod settings blocks for other mods that you have installed. |
Revision History
Mod Version | TNG Version | Date | Contents |
---|---|---|---|
v14.0.0.11.zip |
rrace |
10 Feb 2023 | Upgrade to TNGv14 |
13.0.0.9h | 1.0-13.1.1 | 14 Jan 2022 | Made backward-compatible changes to handle TNGv13.1 and TNGv13.1.1 |
13.0.0.9f | 13 | 22 Nov 2020 | Cleaned up language strings and removed some extra characters from the page |
12.0.0.9d | 13 | 11 Oct 2020 | Upgraded to TNGv13 |
12.0.0.9c | 12.0-12.3 | 28 Mar 020 |
|
Mod Version | TNG Version | Date | Note |
---|---|---|---|
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 TNG site to the table below:
URL | User | Note | Mod-Version | TNG-Version | User-language |
---|---|---|---|---|---|
Robin Richmond's Genealogy Database | Robin Richmond | Mod developer | 14.0.0.11 | 14 | EN |
Total Family History | Scott Bennett | Private Site (For right now) | 9.2.0.3 | 10.0.1 | EN |
R G Strong Family Genealogy | Russell G Strong | Public Site | 11.0.0.0 | 11.0.0 | EN (DE, FR, NL) |
The Cole / Tanner Family Tree | David Cole | Public/Private | see here | see here | EN, DE, FR, ES, NL |
Woking Family Tree Project | Pete Smee | Public/Private Brilliant Mod many thanks | 12.0.0.8b | 12.1 | EN |
Our Family Histories | Bryan S. Larson | Public - T8 customized | see here | see here | EN |
Osage County Cousins | Larry G Banks | Public/Private | 14.0.0.11 | 14.0 | EN |