Ændringer

|  mod_summary    = Adds numerous controls to the Admin Cemeteries Search page to filter the search and include optional data in the results.

|  mod_summary    = Adds numerous controls to the Admin Cemeteries Search page to filter the search and include optional data in the results.

| mod_validation  =  

| mod_validation  =  

| mod_last_update = 1 Dec 2019

| mod_last_update = 12 Dec 2019

| download_link  =  [[Media:admin_cemeteries_search_v12.0.0.9.zip|v12.0.0.9]]{{Tv120}}

| download_link  =  [[Media:admin_cemeteries_search_v12.0.0.9a.zip|v12.0.0.9a]]{{Tv120}}

| download_stats  =

| download_stats  =

| mod_author      = [[User:Robinrichm|Robin Richmond]]

| mod_author      = [[User:Robinrichm|Robin Richmond]]

| mod_contact    = [http://www.robinrichmond.com/family/mod_support.php My Mod Support form]

| 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_support    = [http://www.robinrichmond.com/family/mod_support.php My Mod Support form] or [http://tng.community/ TNG Community Forums]

| mod_version    = 12.0.0.9

| mod_version    = 12.0.0.9a

| min_TNG_ver    = 12.0

| min_TNG_ver    = 12.0

| max_TNG_ver    = at least 12.2

| max_TNG_ver    = at least 12.2

|  TNG_file_list  = admin_cemeteries.php, adminlib.php, css/genstyle.css,  

|  TNG_file_list  = admin_cemeteries.php, adminlib.php, css/genstyle.css,  

English cemetery_help.php, English cust_text.php; <br/>'''Installs''' rrcemeteriessearch_ajx.php, rrcemeteriessearch_lib.php;<br>'''May Install''' rrinnermodmenu1.php, rrshared_modsettings1_include.php, rrshared_wikilogo.png

English cemetery_help.php, English cust_text.php; <br/>'''Installs''' rrcemeteriessearch_ajx.php, rrcemeteriessearch_lib.php;<br>'''May Install''' rrshared_innermodmenu3.php, rrshared_modsettingsblocks3.php, rrshared_wikilogo.gif

| related_mods  = [[Cemetery Edit]], [[Field Buttons]], [[Admin Places Geocode]]

| related_mods  = [[Cemetery Edit]], [[Admin Places Geocode]], [[Field Buttons]]

| notes    =   

| notes    =   

}}

}}

== Purpose of the Mod ==

== Purpose of the Mod ==

This distinctly large and complex mod adds filtering, searching, and formatting options to the Admin >> Cemeteries >> Search page in order to produce what amounts to a variety of what I hope are a variety of useful reports.

This distinctly large and complex mod adds filtering, searching, and formatting options to the Admin>>Cemeteries>>Search page to produce what amounts to a variety of what I hope are a variety of useful reports.

{| style="margin-right:0.5 em;" align="right" ; "font-size:120%";  

{| style="margin-right:0.5 em;" align="right" ; "font-size:120%";  

| __TOC__

| __TOC__

== Mod Options ==

== Mod Options ==

# Default value for the country selection box. ("USA")

* Default value for the country selection box. ("USA")

# A list of fieldnames that set the initial state of checkboxes that determine whether optional fields (maplink, notes) are searched.  

* Two checkboxes for database fieldnames that can be searched. These selections set the initial state of checkboxes in the Search form.

# A list of fieldnames that set the initial state of checkboxes that control whether optional data (notes, burials, headstones, geocodes] are displayed in the results table.

* Three checkboxes for fields that can be added to the results table. These selections set the initial state of checkboxes in the Search form.

# A list of names that determine whether certain controls are shown on the search form at all.

** Note that one of the checkboxes (Geocodes) covers 3 fields.

* Two checkboxes that determine whether certain new controls are shown on the search form at all.

The mod options are illustrated in a visualization below.

The mod options are illustrated in a visualization below.

The mod options are custom TNG settings, defined and edited in the form at Admin>>Setup>>General&nbsp;Settings, in a new subform named '''Robin's Mod's'''. This subform takes advantage of a scheme that I call '''[https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Mod Settings Blocks]'''. See the last Visualization below.

 

These mod options are custom TNG settings, defined and edited in the form at Admin>>Setup>>General&nbsp;Settings, in a new subform named '''Robin's Mod's'''. This subform takes advantage of a scheme that I call '''[https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Mod Settings Blocks]'''.

== Mod Conflicts ==

== Mod Conflicts ==

## rradmincemeterysearch_ajx.php - An AJAX program that reads place jurisdiction values (i.e. a set of states, counties, or cities) that are appropriate for the selection that a user has made in a higher-level jurisdiction.

## rradmincemeterysearch_ajx.php - An AJAX program that reads place jurisdiction values (i.e. a set of states, counties, or cities) that are appropriate for the selection that a user has made in a higher-level jurisdiction.

## rradmincemeterysearch_lib.php - A function library used by admin_cemeteries.php and the AJAX program listed just above. It actually has only one function, which is used by admin_cemeteries.php to populate the location drop-down boxes as the page is loaded, and by AJAX OnChange functions that invoke rradmincemeterysearch_ajx.php to populate lower-ordered location drop-down boxes when a selection is made in a higher-ordered location drop-down box. (See comments within rradmincemeterysearch_ajx.php for more details.)

## rradmincemeterysearch_lib.php - A function library used by admin_cemeteries.php and the AJAX program listed just above. It actually has only one function, which is used by admin_cemeteries.php to populate the location drop-down boxes as the page is loaded, and by AJAX OnChange functions that invoke rradmincemeterysearch_ajx.php to populate lower-ordered location drop-down boxes when a selection is made in a higher-ordered location drop-down box. (See comments within rradmincemeterysearch_ajx.php for more details.)

# The shared folder '''RR-shared_mod_includes_v12.0.0.2''', which contains files that support functionality that is implemented in many of my mods:

# The shared folder '''RR-shared_mod_includes_v12.0.0.3''', which contains files that support functionality that is implemented in many of my mods:

## '''rrshared_innermodmenu2.php''' - [https://tng.lythgoes.net/wiki/index.php?title=Inner_Mod_Menus Inner&nbsp;Mod&nbsp;Menus]

## '''rrshared_innermodmenu3.php''' - [https://tng.lythgoes.net/wiki/index.php?title=Inner_Mod_Menus Inner&nbsp;Mod&nbsp;Menus]

## '''rrshared_modsettingsblocks2.php''' - [https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Mod Settings Blocks]

## '''rrshared_modsettingsblocks3.php''' - [https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Mod Settings Blocks]

## '''img/rrshared_wikilogo.gif''' - An icon that links to a mod's TNG Wiki page.

## '''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.  

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.2''' (well, unless you are confident that it is already in your mods folder because it was part of another mod).

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.3''' (well, unless you are confident that it is already in your mods folder because it was part of another mod).

{{RobinInstallationBoilerplate}}

{{RobinInstallationBoilerplate}}

|-

|-

! Mod Version !! TNG Version !! Date !! Note

! Mod Version !! TNG Version !! Date !! Note

|- style="vertical-align:top;" <!-- ############################################################## -->

|- style="vertical-align:top;"

| [[Media:admin_cemeteries_search_v12.0.0.9a.zip|12.0.0.9a]]

| [[Media:admin_cemeteries_search_v12.0.0.9a.zip|12.0.0.9a]]

| 12.0+

| 12.0+

| 1Dec2019

| 12Dec2019

| (Not yet uploaded.) This update uses a new version of the shared [https://tng.lythgoes.net/wiki/index.php?title=Inner_Mod_Menus Inner Mod Menus] and [https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Mod Settings Blocks], but none of the library changes are relevant to this mod.

| No functional changes. It uses version 3 of myshared mods libraries, but none of the library changes affect this mod.

 

|- style="vertical-align:top;" <!-- ############################################################## -->

|- style="vertical-align:top;" <!-- ############################################################## -->

| [[Media:admin_cemeteries_search_v12.0.0.9.zip|12.0.0.9]]

| [[Media:admin_cemeteries_search_v12.0.0.9.zip|12.0.0.9]]