Difference between revisions of "Admin Places Search"

From TNG_Wiki
Jump to navigation Jump to search
(The search string now supports the regular expression anchor characters '^' and '$',The option to search for "Placelevel not set" is now 'Placelevel: yes/no/either'. Display options in the search form are now "Results per page", ShowPlace notes, Show links to cemeteries. Search parameters are shown above the search results. In the results table: The Place Level column shows descriptions, whether Placelevel numbers are displayed,PlaceLevel, Latitude, Longitude, and Tree columns are displayed diff)
 
(23 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
{{construction
+
{{TNGmod
−
|notes=This article is in transition from v3a to v4 of the Admin Places Search mod. Version 4 should be considered a Beta version. It does not change the way that Admin>>Places searches for and displays Places, but it introduces some help features and and handles the mod options differently. Revision notes for version 4 are in the [[#Revision_History|Revision History]] section of this article.}}{{V12_cust_text}}{{TNGmod
 
 
| mod_name        =  Admin Places Search
 
| mod_name        =  Admin Places Search
 
|  mod_summary    = Adds search options and results details to the Admin>>Places>>Search program
 
|  mod_summary    = Adds search options and results details to the Admin>>Places>>Search program
 
| mod_validation  =  
 
| mod_validation  =  
−
| mod_last_update = 19 Aug 2019
+
| mod_last_update = 17 Nov 2023
−
| download_link  = [[Media:admin_places_search_v12.0.0.3a.zip|12.0.0.3a]]{{Tv120}}
+
| download_link  = [[Media:admin_places_search_v14.0.0.6g.zip|14.0.0.6g]]{{Tv140}}
 +
<div style='clear:both;'><div style='clear:both;font-size:90%;'>See [[#Revision_History|the Revision History]] for older versions</div>
 
| download_stats  =
 
| download_stats  =
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
−
| mod_url        = [http://www.robinrichmond.com/family/ Robin Richmond's Genealogy Database]
+
| mod_url        = [http://www.robinrichmond.com/family/ ''Robin's Roots'']
 
| 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]
−
| mod_version    = 12.0.0.3a
+
| mod_version    = 14.0.0.6g
−
| min_TNG_ver    = 12.0
+
| min_TNG_ver    = 11.0
−
| max_TNG_ver    = at least 12.2
+
| max_TNG_ver    = 14
−
|  TNG_file_list  = admin_places.php, cust_text.php English. Installs shared files: rrinnermodmenu1.php, rrsetup_modoptions1_include.php, img/rrmodadmin_wikilogo.png
+
|  TNG_file_list  = admin_places.php, admin_genconfig.php, admin_updateconfig.php, English places_help.php
−
| related_mods  = [[Admin Places Geocode]], [[Admin Places Date]]
+
| related_mods  = [[Mod Settings Blocks]]('''required'''), [[Admin Places Geocode]]
−
| notes    =   
+
| notes    =  }}{| style="margin-right:0.5 em;" align="right"
−
}}
+
| __TOC__
 +
|}
 
== Purpose of the Mod ==
 
== Purpose of the Mod ==
 
Adds features to the '''Admin >> Places >> Search''' form and results list as follows:
 
Adds features to the '''Admin >> Places >> Search''' form and results list as follows:
−
{| style="margin-right:0.5 em;" align="right"  
+
# In the search form
−
| __TOC__
+
#* Draws a fieldset border around the search form to help distinguish it from the action/pagination form.
−
|}
+
#* Changes and adds some Search options:
−
# Adds 3 search options:
+
#*# Adds a '+' button to expand the Search field
−
## "Results Per Page", which overrides the system value ($maxresults)
+
#*# Allows the Regular Expression anchor characters ^ and $ to be placed at the beginning and/or the end of the search string. (See the visualizations for a specific example.)
−
## "Show Place Notes", which are displayed in a new column.
+
#*# Adds a Placeholder text message in the Search field to note that the anchor characters can be used there.
−
## "Show Cemetery Links", which are displayed as an HTML entity in a new column.  When the Cemetery Links column is displayed, a table footnote describes that column.
+
#*# Adds an information icon next to the Search field that pops up help text describing the changes to the Search field
−
# Allows the Regular Expression anchor characters ^ and $ to be placed at the beginning and/or the end of the search string. (See the visualizations for a specific example.)
+
#*# Changes the "Has Geocodes" option to radio buttons for "Geocodes: yes/no/either"
−
# Adds a Placeholder text message in the Search field to note that the anchor characters can be used there.
+
#*# Adds radio buttons for "Place Level: yes/no/either"
−
# Draws a fieldset around the search form to help distinguish it from the action/pagination form.
+
#*# Adds checkbox options to require a cemetery link or notes.
−
# Displays the tree and searchstring parameters (if they have values) at the top of the results table.
+
#* Adds some Display options:
−
# Rounds longitude and latitude values to the number of decimal digits supplied by a mod option defined by the optional [[Admin Places Geocode]] mod.
+
#*# "Results Per Page", which overrides the system value ($maxsearchresults),  but defaults to it.
−
# In the Placelevel column, displays descriptive names such as Location and City/Town). Will also display the numeric Placelevel value if directed by a mod option.
+
#*# "Show Place Notes", which are displayed in a new column.
−
# Omits the Tree column if a tree was selected
+
#*# "Show Cemetery Links", which are displayed as hyperlinks in a new column.  When the Cemetery Links column is displayed, a table footnote describes that column.
−
# Adds text describing these changes to the Places Help file.
+
#*# In TNGv13, "Show Modification Date". That is, the sortable modification date column added by TNG is not displayed by default.
−
# Adds an information icon next to the Search field that hyperlinks to new text in the Places Help file.
+
# Displays the search parameters just above the results table.
 +
# In the results table:
 +
#* Rounds longitude and latitude values to the number of decimal digits supplied by a mod option defined by the optional [[Admin Places Geocode]] mod.
 +
#* In the Placelevel column, optionally displays descriptive names such as "Location" and "City/Town". Handles mods that add placelevels.
 +
#* Omits the Tree column if a tree was selected
  
 
== Mod Options ==
 
== Mod Options ==
−
This mod has one option. The mod displays Place Level names (Not Set, Address, Location, City/Town, etc.) in the Place Level results column, where the native code just displays the Place Level number.  The option is whether to show the Place Level number ''in addition to'' the Place Level description.
+
Mod settings are defined and edited in a [[Mod Settings Blocks|Mod Settings Block]] at Admin>>Setup>>General&nbsp;Settings, in the new subform '''Mod&nbsp;Settings&nbsp;''.<br>[[Image:AdminPlacesSearchMSB.png]]<br>
−
 
+
The mod has three options. Each of them has the ability to turn off one or more features of the mod and simplify the search form.
−
* In version 3 of the mod, this option is a "mod parameter", defined by the Mod Manager <code>%parameter</code> tag, and edited within the Mod Manager.
+
# '''Display Placelevel names as well as numbers''': This option works even if most that increase the number of placelevels have been installed.
−
* In version 4, this option is a custom TNG setting, defined and edited in the form at Admin>>Setup>>General&nbsp;Settings, in the new subform '''[https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Robin's Mods]'''
+
# '''Show Cemetery Options''': Two of the new options on the search form are optional themselves.  Both are checkboxes:
 +
#* The search option "Has a cemetery link" and
 +
#* The display option "Show cemetery links".
 +
# '''Show the "Has Notes" option'''.  This option does affects just the search option. It does not affect the "Show notes" option.
  
 
== Compatibility ==
 
== Compatibility ==
−
This mod is compatible with [[Admin Places Geocode]], [[Places Subject to Deletion]], and [[TreeID-One Column]], as well as with two mods, [[Google Maps - More Place Levels Mod]] and [[Google maps 15]] that add Placelevel definitions. It is '''not compatible with''' [[Tree ID Mod]], but '''is compatible with''' [[TreeID-One Column]], which accomplishes the same purpose as [[Tree ID Mod]].  [[TreeID-One Column]] just uses one column instead of two to display the Tree ID and Tree Name, and avoids a couple of mod conflicts.
+
This mod is compatible with [[Admin Places Geocode]], [[Places Subject to Deletion]], and two mods, [[Google Maps - More Place Levels Mod]] and [[Google maps 15]] that add Placelevel definitions. It is '''not compatible with''' [[Tree ID Mod]], but '''is compatible with''' [[TreeID-One Column]], which accomplishes the same purpose as [[Tree ID Mod]].  [[TreeID-One Column]] just uses one column instead of two to display the Tree ID and Tree Name, and avoids a couple of mod conflicts.
  
 
== Related Mods ==
 
== Related Mods ==
−
* '''[[Admin Places Geocode]]'''
+
<ol>
−
** Defines the Placelevel value of -1 to mean "Do not Geocode". This mod defines the string "Do not Geocode" that is displayed when it sees a value of -1 for the Placelevel.
+
<li>{{RobinBoilerplate |text=msb}}</li>
−
** Installs a mod option that controls the number of decimal digits in Latitude and Longitude values. If that option has been defined, then this mod rounds the Latitude and Longitude as they are read from the database, and as they are written to the database.
+
<li>The optional '''[[Admin Places Geocode]]''' mod defines a mod option that controls the number of decimal digits in Latitude and Longitude values. If that option has been defined, then this mod rounds the Latitude and Longitude as they are read from the database, and as they are written to the database.</li>
−
* '''[[Admin Places Date]]''' also affects ''Admin>>Places'', and coordinates with this mod in that when this mod adds field buttons to the form field it creates, it also adds field buttons for the "Creation Date" form field field that is added by [[Admin Places Date]] - well, ''if'' that field is present in the form when admin_places.php runs.
+
</ol>
−
* The '''[[Field Buttons]]''' mod must be installed for the "Field Buttons" defined by this mod to be visible. The [[Field Buttons]] mod is not required, however.  But, if it is installed, this mod requires [[Field Buttons]] version 3 or higher.
 
−
*: (Field Buttons are small buttons that are attached to some form fields, and that perform small editing tasks, like clearing a field or resetting it to the value it had when the page was loaded.)
 
−
* This mod saves data that can be used by the ''optional'' '''[[Show Mod Names]]''' utility mod.
 
−
 
 
 
== Installation ==
 
== Installation ==
−
This mod uses the standard installation procedure, though it should be noted that this mod contains mod subfolders that are shared with other mods that implement "'''[[Inner Mod Menus]]'''" or whose options are organized as [https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Mod&nbsp;Settings&nbsp;Blocks] in Admin>>Setup forms. Because of these shared folders, as you unzip or copy the mod, you might get a warning noting that a file or folder already exists. You can just ignore that warning.<br>{{RobinInstallationBoilerplate}}
+
{{RobinBoilerplate |text=language}}
 +
{{RobinBoilerplate |text=install}}
  
 
== Visualizations ==
 
== Visualizations ==
−
(These visualizations are from mod version 3a, but most of them also apply well to mod version 4. See update notes in the [[#Revision_History|Revision History]] section of this article.)
+
(These visualizations are not perfectly up-to-date, but they are close.)
 +
from mod version 3a, but most of them also apply well to mod version 4. See update notes in the [[#Revision_History|Revision History]] section of this article.)
 
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
 
|-
 
|-
Line 105: Line 111:
 
== Revision History ==
 
== Revision History ==
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 +
! Mod Version !! TNG Versions !! Date !! Note
 
|-
 
|-
−
! Mod Version !! TNG Versions !! Date !! Note
+
|[[Media:Admin places search v14.0.0.6f.zip|14.0.0.6g]]
−
|- style="vertical-align:top;"
+
|{{RobinBoilerplate | text=rraps }}
−
| [[Media:admin_places_search_v12.0.0.4.zip|12.0.0.4]] (beta)
+
|17Nov2023
 +
|The search string now supports the regular expression anchor characters '^' and '$',The option to search for "Placelevel not set" is now 'Placelevel: yes/no/either'. Display options in the search form are now "Results per page", ShowPlace notes, Show links to cemeteries. Search parameters are shown above the search results. In the results table: The Place Level column shows descriptions, whether Placelevel numbers are displayed,PlaceLevel, Latitude, Longitude, and Tree columns are displayed differently, The "geoignore" field is included when displaying places without a lat or long value. This mod works with the mods that add Place Levels for Google Maps, thanks to changes made by Ken Roy.
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
| [[Media:Admin places search v14.0.0.6f.zip|14.0.0.6f]]
 +
|{{RobinBoilerplate | text=rraps }}
 +
| 10Feb2023
 +
| Upgrade for TNGv14
 +
 
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
| [[Media:Admin places search v13.0.0.6d.zip|13.0.0.6d]]
 +
| 13.1
 +
| 30Oct2021
 +
| Updated the mod for TNGv13.1, and incorporated the changes made by mod v13.0.4.6c so one mod version can handle TNGv13.*
 +
# In TNGv13.0.4, admin_places.php no longer displays the user who made the last change, so one target location had to be changed.
 +
# Updated the help text.
 +
 
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
| [[Media:Admin places search v13.0.4.6c.zip|13.0.4.6c]]
 +
| 13.0.4
 +
| 09Jun2021
 +
|
 +
# In TNGv13.0.4, admin_places.php no longer displays the user who made the last change, so one target location had to be changed.
 +
# Updated the help text.
 +
 
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
| [[Media:Admin places search v13.0.0.6b.zip|13.0.0.6b]]
 +
| 13-13.0.3
 +
| 05Nov2020
 +
|
 +
# It wasn't suppressing the Tree column when the results include only one tree, and was not always displaying the treeName (though it would display the treeID)
 +
# The "Show 'Has Notes'" mod option was affecting the 'Show Notes' display options, not just the 'Has Notes' search option.
 +
# Styled the display of the Placelevel value to improve wrapping. Among other things, the value can now wrap on slashes.
 +
# Fixed the document.ready function, which defines a number of style classes and attributes.
 +
# Added Mod Manager logic to display a %note when the Mod Settings Block is not installed
 +
v6a 18 Oct 2020
 +
# Fixed a hard-coded table name in a SQL query
 +
 
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
| [[Media:Admin places search v14.0.0.6f.zip|14.0.0.6f]]
 +
| 13
 +
| 30Aug2020
 +
|
 +
# Modified one location to handle a new isset() function reference
 +
# Always display the placelevel column and the placelevel number.
 +
# Fixed use of the PlacesDisplayLevelName option. The name was always being displayed.
 +
# Removed all code associated with the the sorting of results and the creation date field.
 +
# Changed the new help file text to accommodate the code changes above.
 +
# Uses the Mod Settings Blocks mod.
 +
 
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
| [[Media:Admin places search v12.0.0.4b.zip|12.0.0.4b]]
 +
| 12.0-12.3
 +
| 26Feb2020
 +
|
 +
* Added a missing %end:% and broken %replace:% in the .cfg file, as required by TNGv12.3
 +
* Uses version 4 of my [[Mod Settings Blocks#Shared_Mod_Libraries|shared mod libraries]].
 +
* Fixed a bug that affected searches for missing placelevels
 +
* Changed the "Place level not set" checkbox into three radio buttons for "Placelevel: yes/no/either"
 +
 
 +
|- style="vertical-align:top;"<!-- ############################################################## -->
 +
| [[Media:Admin places search v12.0.0.4.zip|12.0.0.4]] (beta)
 
| 12.0+
 
| 12.0+
 
| 18Aug2019
 
| 18Aug2019
Line 116: Line 183:
 
** The mod's parameter is now a TNG option, defined through '''Admin>>Setup>>General Settings''', in a new subform named  '''[https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Mod&nbsp;Settings&nbsp;Blocks]'''.
 
** The mod's parameter is now a TNG option, defined through '''Admin>>Setup>>General Settings''', in a new subform named  '''[https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Mod&nbsp;Settings&nbsp;Blocks]'''.
 
** The search form row that contains display options now starts with the label "Display Options".
 
** The search form row that contains display options now starts with the label "Display Options".
−
** New help text that is triggered by an information icon next to the searchstring field.  
+
** New help text that is triggered by an information icon next to the searchstring field.
 
* Internal Changes include:
 
* Internal Changes include:
 
** Improvements to the implementation of [[Field Buttons]] requires version 3 or higher of the '''[[Field Buttons]]'' mod. (Well, that is, if the optional [[Field Buttons]] mod is installed at all.)
 
** Improvements to the implementation of [[Field Buttons]] requires version 3 or higher of the '''[[Field Buttons]]'' mod. (Well, that is, if the optional [[Field Buttons]] mod is installed at all.)
 
** The implementation of the Latitude and Longitude rounding option requires version 4 of '''[[Admin Places Geocode]]]'''. (Again - if the optional [[Admin Places Geocode mod is installed at all.)
 
** The implementation of the Latitude and Longitude rounding option requires version 4 of '''[[Admin Places Geocode]]]'''. (Again - if the optional [[Admin Places Geocode mod is installed at all.)
−
|- style="vertical-align:top;"
+
|- style="vertical-align:top;"<!-- ############################################################## -->
−
| [[Media:admin_places_search_v12.0.0.3a.zip|12.0.0.3a]]
+
| [[Media:Admin places search v12.0.0.3a.zip|12.0.0.3a]]
 
| 12.0+
 
| 12.0+
 
| 14Nov2018
 
| 14Nov2018
 
| No functional changes; made compatible with TNGv12.
 
| No functional changes; made compatible with TNGv12.
−
|- style="vertical-align:top;"
+
|- style="vertical-align:top;"<!-- ############################################################## -->
−
| [[Media:admin_places_search_v11.0.0.3a.zip|11.0.0.3a]]
+
|[[Media:Admin places search v11.0.0.3a.zip|11.0.0.3a]]
 
| 11.0+
 
| 11.0+
 
| 28Dec2017
 
| 28Dec2017
Line 133: Line 200:
 
* Added a "don't print on printer" class to the tab menu and innermenu, and the Action and Select columns of the results table.
 
* Added a "don't print on printer" class to the tab menu and innermenu, and the Action and Select columns of the results table.
 
* A number of the changes to HTML element attributes are now implemented through a (Document).ready function.
 
* A number of the changes to HTML element attributes are now implemented through a (Document).ready function.
−
|- style="vertical-align:top;"
+
|- style="vertical-align:top;" <!-- ############################################################## -->
 
| 11.0.0.2a
 
| 11.0.0.2a
 
| 11.0+
 
| 11.0+
 
| 30May2017
 
| 30May2017
 
| Added the Insert Links function to the Place Notes so that URLs and and FindAGrave ID's are displayed as hyperlinks. First non-beta version
 
| Added the Insert Links function to the Place Notes so that URLs and and FindAGrave ID's are displayed as hyperlinks. First non-beta version
−
|- style="vertical-align:top;"
+
|- style="vertical-align:top;" <!-- ############################################################## -->
 
| 11.0.0.2
 
| 11.0.0.2
 
| 11.0+
 
| 11.0+
 
| 26May2017
 
| 26May2017
 
| Now compatible with [[Google Maps - More Place Levels Mod]] and [[Google maps 15]].  Also added the two mod parameters.
 
| Now compatible with [[Google Maps - More Place Levels Mod]] and [[Google maps 15]].  Also added the two mod parameters.
−
|- style="vertical-align:top;"
+
|- style="vertical-align:top;" <!-- ############################################################## -->
 
| 11.0.0.1
 
| 11.0.0.1
 
| 11.0+
 
| 11.0+
Line 154: Line 221:
  
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 +
! URL!! User !! Note !! Mod-Version !! TNG-Version !! User-language
 
|-
 
|-
−
! URL
+
| [https://robinrichmond.com/familytest/admin_places.php Sample Page on ''Robin's Roots''] userid/pw: a/a
−
! User
 
−
! Note
 
−
! Mod-Version
 
−
! TNG-Version
 
−
! User-language
 
−
|-
 
−
| [http://www.robinrichmond.com/family/ Robin Richmond's Genealogy Database]
 
 
| [[User:Robinrichm|Robin Richmond]]
 
| [[User:Robinrichm|Robin Richmond]]
 
| Mod developer
 
| Mod developer
−
| 11.0.0.3a
+
| [[Media:Admin places search v14.0.0.6f.zip|14.0.0.6g]]
−
| 11.1.1
+
| {{RobinBoilerplate | text=rraps }}
 
| English
 
| English
 
|-
 
|-
Line 176: Line 237:
 
| English, French
 
| English, French
 
|-
 
|-
−
| [http://colegenealogy.dynu.net/ Cole / Tanner Family Tree]
+
| [http://www.colegenealogy.net/ The Cole / Tanner Family Tree]
 
| [[User:dlcole|David Cole]]
 
| [[User:dlcole|David Cole]]
 
| Public/Private
 
| Public/Private
 
| [[User:Dlcole|see here]]
 
| [[User:Dlcole|see here]]
 
| [[User:Dlcole|see here]]
 
| [[User:Dlcole|see here]]
−
| English
+
| EN, DE, FR, ES, NL
 +
|-
 +
| [http://genealogy.oceanwharf.com Hooley Family Links]
 +
| [[User: lastejas|Rick Hooley]]
 +
| Public/Private
 +
| [[User: lastejas|See Here]]
 +
| [[User: lastejas|See Here]]
 +
| EN
 
|}
 
|}
  
 +
[[Category:Mods for TNG v14]]
 +
[[Category:Mods for TNG v13]]
 
[[Category:Mods for TNG v12]]
 
[[Category:Mods for TNG v12]]
 
[[Category:Mods for TNG v11]]
 
[[Category:Mods for TNG v11]]
 
[[Category:admin_places.php mods]]
 
[[Category:admin_places.php mods]]
−
[[Category:cust_text.php English mods]]
+
[[Category:admin_genconfig.php mods]]
 +
[[Category:admin_updateconfig.php mods]]
 +
[[Category:places_help.php mods]]

Latest revision as of 17:36, 17 November 2023

Admin Places Search
Summary Adds search options and results details to the Admin>>Places>>Search program
Validation
Mod Updated 17 Nov 2023
Download link 14.0.0.6g
TNG 14.0
See the Revision History for older versions
Download stats
Author(s) Robin Richmond
Homepage Robin's Roots
Mod Support My Mod Support form
Contact Developer My Mod Support form
Latest Mod 14.0.0.6g
Min TNG V 11.0
Max TNG V 14
Files modified
admin_places.php, admin_genconfig.php, admin_updateconfig.php, English places_help.php
Related Mods
Mod Settings Blocks(required), Admin Places Geocode
Notes

Purpose of the Mod

Adds features to the Admin >> Places >> Search form and results list as follows:

  1. In the search form
    • Draws a fieldset border around the search form to help distinguish it from the action/pagination form.
    • Changes and adds some Search options:
      1. Adds a '+' button to expand the Search field
      2. Allows the Regular Expression anchor characters ^ and $ to be placed at the beginning and/or the end of the search string. (See the visualizations for a specific example.)
      3. Adds a Placeholder text message in the Search field to note that the anchor characters can be used there.
      4. Adds an information icon next to the Search field that pops up help text describing the changes to the Search field
      5. Changes the "Has Geocodes" option to radio buttons for "Geocodes: yes/no/either"
      6. Adds radio buttons for "Place Level: yes/no/either"
      7. Adds checkbox options to require a cemetery link or notes.
    • Adds some Display options:
      1. "Results Per Page", which overrides the system value ($maxsearchresults), but defaults to it.
      2. "Show Place Notes", which are displayed in a new column.
      3. "Show Cemetery Links", which are displayed as hyperlinks in a new column. When the Cemetery Links column is displayed, a table footnote describes that column.
      4. In TNGv13, "Show Modification Date". That is, the sortable modification date column added by TNG is not displayed by default.
  2. Displays the search parameters just above the results table.
  3. In the results table:
    • Rounds longitude and latitude values to the number of decimal digits supplied by a mod option defined by the optional Admin Places Geocode mod.
    • In the Placelevel column, optionally displays descriptive names such as "Location" and "City/Town". Handles mods that add placelevels.
    • Omits the Tree column if a tree was selected

Mod Options

Mod settings are defined and edited in a Mod Settings Block at Admin>>Setup>>General Settings, in the new subform 'Mod Settings .
AdminPlacesSearchMSB.png
The mod has three options. Each of them has the ability to turn off one or more features of the mod and simplify the search form.

  1. Display Placelevel names as well as numbers: This option works even if most that increase the number of placelevels have been installed.
  2. Show Cemetery Options: Two of the new options on the search form are optional themselves. Both are checkboxes:
    • The search option "Has a cemetery link" and
    • The display option "Show cemetery links".
  3. Show the "Has Notes" option. This option does affects just the search option. It does not affect the "Show notes" option.

Compatibility

This mod is compatible with Admin Places Geocode, Places Subject to Deletion, and two mods, Google Maps - More Place Levels Mod and Google maps 15 that add Placelevel definitions. It is not compatible with Tree ID Mod, but is compatible with TreeID-One Column, which accomplishes the same purpose as Tree ID Mod. TreeID-One Column just uses one column instead of two to display the Tree ID and Tree Name, and avoids a couple of mod conflicts.

Related Mods

  1. 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.
  2. The optional Admin Places Geocode mod defines a mod option that controls the number of decimal digits in Latitude and Longitude values. If that option has been defined, then this mod rounds the Latitude and Longitude as they are read from the database, and as they are written to the database.

Installation

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

  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, Extract its .cfg file to the mods folder.
  4. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files.

Problems?

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

Visualizations

(These visualizations are not perfectly up-to-date, but they are close.) from mod version 3a, but most of them also apply well to mod version 4. See update notes in the Revision History section of this article.)

BEFORE: The Pristine Admin >> Places screen, with the system variable $maxresults (Results per page) set to 30.
Note that
  • The three checkboxes immediately below the search string are implemented by the Pristine TNG code and
  • The Place Level of -1 (meaning "Don't geocode") for the Placename "(none)" is implemented by the Admin Places Geocode mod.
    Admin places search-before.png
AFTER: Search results without a search string, highlighting some of the new features

Admin places search-after1.png

  • In the Place Level column where you see the descriptive names rather than numbers, the text value "Don't Geocode" is supplied by this mod to support the internal value -1 that is implemented by the Admin Places Geocode mod,
  • This mod rounds the display of Latitude and Longitude (to the precision specified by a mod parameter), but the Admin Places Geocode mod adds features that round the stored Latitude and Longitude.
AFTER: Results for the search string "cemetery", with the "Show notes" and "Show Cemetery Links" options selected.

Admin places search-after2.png

AFTER: When the "Missing Latitude or Longitude" option is selected.

Admin places search-after3.png

AFTER: The help text added by this mod

Admin places search-help.png

AFTER: Field Buttons

Admin places search-fieldbuttons1.jpg

  • For the search string field:
    • The X button will clear the search string value.
    • The R button will restore the field to the value it had when the page was loaded.
  • For the Results per page field:
    • The R button will restore the field to the value it had when the page was loaded.
    • The D button will assign a default value to the field. In this case, the default value is the TNG system parameter "Max Search Results".
    • The A button will assign a value that means "All Items". In this case, that value is 'all'.

Field buttons are described further in the Field Button mod article. The Field Buttons mod is necessary to make the field buttons visible.

Buttons that would not change the value are shaded out, as shown below.
Admin places search8-fieldbuttons2.jpg
In this screen clip, a search has been done with no search string, and with 35 Results per page. As a result:

  • For the search string field:
    • The X button is shaded out because there is no value to clear.
    • The R button is shaded out because we just loaded the page, and the field value is still in its initial state.
  • For the Results per page field:
    • The R button is shaded out because we just loaded the page.
    • The D button is shaded out because the the field does not have the the default value (the value of the TNG system parameter "Max Search Results").
    • The A button is visible because the value is not 'all'.

Revision History

Mod Version TNG Versions Date Note
14.0.0.6g

rraps

17Nov2023 The search string now supports the regular expression anchor characters '^' and '$',The option to search for "Placelevel not set" is now 'Placelevel: yes/no/either'. Display options in the search form are now "Results per page", ShowPlace notes, Show links to cemeteries. Search parameters are shown above the search results. In the results table: The Place Level column shows descriptions, whether Placelevel numbers are displayed,PlaceLevel, Latitude, Longitude, and Tree columns are displayed differently, The "geoignore" field is included when displaying places without a lat or long value. This mod works with the mods that add Place Levels for Google Maps, thanks to changes made by Ken Roy.
14.0.0.6f

rraps

10Feb2023 Upgrade for TNGv14
13.0.0.6d 13.1 30Oct2021 Updated the mod for TNGv13.1, and incorporated the changes made by mod v13.0.4.6c so one mod version can handle TNGv13.*
  1. In TNGv13.0.4, admin_places.php no longer displays the user who made the last change, so one target location had to be changed.
  2. Updated the help text.
13.0.4.6c 13.0.4 09Jun2021
  1. In TNGv13.0.4, admin_places.php no longer displays the user who made the last change, so one target location had to be changed.
  2. Updated the help text.
13.0.0.6b 13-13.0.3 05Nov2020
  1. It wasn't suppressing the Tree column when the results include only one tree, and was not always displaying the treeName (though it would display the treeID)
  2. The "Show 'Has Notes'" mod option was affecting the 'Show Notes' display options, not just the 'Has Notes' search option.
  3. Styled the display of the Placelevel value to improve wrapping. Among other things, the value can now wrap on slashes.
  4. Fixed the document.ready function, which defines a number of style classes and attributes.
  5. Added Mod Manager logic to display a %note when the Mod Settings Block is not installed

v6a 18 Oct 2020

  1. Fixed a hard-coded table name in a SQL query
14.0.0.6f 13 30Aug2020
  1. Modified one location to handle a new isset() function reference
  2. Always display the placelevel column and the placelevel number.
  3. Fixed use of the PlacesDisplayLevelName option. The name was always being displayed.
  4. Removed all code associated with the the sorting of results and the creation date field.
  5. Changed the new help file text to accommodate the code changes above.
  6. Uses the Mod Settings Blocks mod.
12.0.0.4b 12.0-12.3 26Feb2020
  • Added a missing %end:% and broken %replace:% in the .cfg file, as required by TNGv12.3
  • Uses version 4 of my shared mod libraries.
  • Fixed a bug that affected searches for missing placelevels
  • Changed the "Place level not set" checkbox into three radio buttons for "Placelevel: yes/no/either"
12.0.0.4 (beta) 12.0+ 18Aug2019 No significant changes to the search and display functionality.
  • Visible Changes:
    • An Inner Mod Menu is now floated to the right end of the admin_places.php Inner Menu.
    • The mod's parameter is now a TNG option, defined through Admin>>Setup>>General Settings, in a new subform named Mod Settings Blocks.
    • The search form row that contains display options now starts with the label "Display Options".
    • New help text that is triggered by an information icon next to the searchstring field.
  • Internal Changes include:
    • Improvements to the implementation of Field Buttons requires version 3 or higher of the 'Field Buttons mod. (Well, that is, if the optional Field Buttons mod is installed at all.)
    • The implementation of the Latitude and Longitude rounding option requires version 4 of Admin Places Geocode]. (Again - if the optional [[Admin Places Geocode mod is installed at all.)
12.0.0.3a 12.0+ 14Nov2018 No functional changes; made compatible with TNGv12.
11.0.0.3a 11.0+ 28Dec2017 Visibly, added "field buttons". Technical changes include
  • Removed the Geocode Decimal Digits mod parameter. The code now looks for the TNG system parameter $tngconfig['rrgeocodedecimals'] (installed by Admin Places Geocode)
  • Added a "don't print on printer" class to the tab menu and innermenu, and the Action and Select columns of the results table.
  • A number of the changes to HTML element attributes are now implemented through a (Document).ready function.
11.0.0.2a 11.0+ 30May2017 Added the Insert Links function to the Place Notes so that URLs and and FindAGrave ID's are displayed as hyperlinks. First non-beta version
11.0.0.2 11.0+ 26May2017 Now compatible with Google Maps - More Place Levels Mod and Google maps 15. Also added the two mod parameters.
11.0.0.1 11.0+ 13Apr2017 New mod.

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
Sample Page on Robin's Roots userid/pw: a/a Robin Richmond Mod developer 14.0.0.6g

rraps

English
Our Roy and Boucher Family Ken Roy Modified to display correct Place Level description to support Google Maps - More Place Levels Mod and Google maps 15. 11.0.0.1 11.1.1 English, French
The Cole / Tanner Family Tree David Cole Public/Private see here see here EN, DE, FR, ES, NL
Hooley Family Links Rick Hooley Public/Private See Here See Here EN
Retrieved from "https://tng.lythgoes.net/wiki/index.php?title=Admin_Places_Search&oldid=83621"