'''Experienced''', Administrators, sysops
3,346
edits
Changes
Jump to navigation
Jump to search
Line 1:
Line 1: − + − + − + − + − + − + − + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Line 30:
Line 144: − ==Examples== − The quick search box with the broad search box ticked. − + + + + + − Here is an example of a search for Elizabeth Sarah. Of the five results only one person was born with the surname Sarah. For the others it was a married name.+ + − [[File:broad_search_Elizabeth_Sarah.png]]+ + + + + + − A search for "William Sarra" shows a change of name from Sarah to Sarra. One of these was defined using ALIA and the other NAME.+ − + + + + + − This search for "Lizzie" shows that the name was more common on the birth certificate than you might expect, and only once is a nickname.+ + + + − [[File:broad_search_Lizzie.png]]+ − + − + − − Unzip the file and put the .cfg file in the mods directory and install with the mod manager in the normal way. + Line 57:
Line 185: − + − + + + + − # If you use events other than NAME and ALIA to record alternative names (e.g. AKA) then you can substitute one or the other of these. Change the name in the one of the first two boxes and click the Update button corresponding to it.+ − # If you want to make broad search the default method for quick searches, then you can set this up. In this case the box will appear with a tick but the user can untick it if the broad search is not wanted. You need to customise the particular template you are using. Templates vary, having a dropdown search box on pages other than the front page, but they may a menu on the front page or the top menu or both. You can choose which of these boxes are ticked. − ##To set the default for the dropdown menu, put "checked" in the box for the dropdown search menu (variable $checked0) and click the Update button. − ##To set the box on the front page, put "checked" in the box for the templateX/index.php file corresponding to your template and click the Update button. − ##If there is a topmenu for your template then put "checked" in the box for the templateX/topmenu.php file and click the Update button. − :If you subsequently decide you don't want these set, then remove the "checked" entry and click the corresponding Update button(s). − + + − == Revision History ==+ − {| border="1" cellspacing="5" cellpadding="2" width="100%" class="wikitable"+ − |- − ! Version − ! Date − ! Contents − |- − | 14.0.2.4d − | 30 May 2023 − | updated for TNG 14 & edit option fixes, tested with Expand Search mod by [[User:Tngrlkrz|Ron Krzmarzick]] − |- − | 13.1.0.5 − | 9 Sep 2021 − | updated for TNG 13 including eliminating warnings, so more future-proof − |- − | 13.1.0.4c − | 02 Oct 2020 − | updated for TNG 13 by [[User:Tngrlkrz|Ron Krzmarzick]] − |- − | 11.1.0.4c − | 19 Jul 2018 − | template 7 top menu option didn't show. Thanks Gershon. − |- − | 11.1.0.4a, 4b − | 9 Feb 2018 − | corrections for bugs in search query − |- − | 11.1.0.4 − | 27 Dec 2017 − | More efficient search, particularly first name or last name only − |- − | 11.1.0.3 − | 7 Nov 2017 − | Optimise search, use variable names for tables − |- − | 11.1.0.2b/ 11.0.0.1e − | 20 Jun 2017 − | make XHTML 1.0 compliant and correct search for ids and searches with quotes − |- − | 11.1.0.2a − | 12 Jan 2017 − | correct version number − |- − | 11.1.0.2 − | 11 Jan 2017 − | adjust for TNG v11.1 and regularise tick boxes − |- − | 11.0.0.1d − | 15 Dec 2016 − | make searches in large databases efficient − |- − | 11.0.0.1b − | 12 Dec 2016 − | correct continuation search pages & syntax error in translations − |- − | 11.0.0.1a − | 11 Dec 2016 − | correct numbering for multiple solutions and minimise conflict with Married Name in Search Mod − |} − == TNG User sites using this mod ==+ − + + − + − + + − + − |[https://www.vanderhorde.nl Familiegeschiedenis van der Horde]+ − |[[User:Wvdhorde|Wim van der Horde]] − |Templte 20, Private − |13.1.0.4c − |NL − |- − |[http://drzewo.online/ Family tree of Marcin & Emilia Senderski] − |[[User:Mycroft|Marcin Senderski]] − |Template 15; only home page is public − |13.1.0.4c/13.0.4 − |EN, PL − |- − + − + − + + + + + + + + + + + + + + + + + + + − + − + − + + + − + − + − + + + − + − + − + − + + + − + − + − + − + + + − + − + − + − + + + − + − + + − + − + − + − + − + + + − + − + − + − + + + − + − + − + − + + + − + − + − + + + − + − + − + − |-+ + + + + − [[Category:Mods for TNG v12]]+ − [[Category:Mods for TNG v13]] − [[Category:Mods for TNG v14]] − [[Category:cust_text.php English mods]]+ − [[Category:cust_text.php Dutch mods]] − [[Category:cust_text.php French mods]] − [[Category:cust_text.php German mods]] − [[Category:cust_text.php Spanish mods]] Line 257:
Line 353: + + + + + +
Display change
{{TNGmod
{{TNGmod
| mod_name = Broad Search mod
| mod_name = {{PAGENAME}}
| mod_summary = Allows quick search for a name using nicknames, aliases, married names
| mod_summary = Allows quick search for a name using nicknames, aliases, married names
| mod_validation =
| mod_validation =
| mod_last_update = 30 May 2023
| mod_last_update = 30 May 2023
| download_link = [[Media:Broad_search_mod_14.02.4d.zip|Broad_search_mod_14.0.2.4d.zip]]<hr />for {{Tv1402}}[[Media:Broad_search_mod_13.1.0.4c.zip|Broad_search_mod_13.1.0.4c.zip]]<hr />for {{Tv1301}}[http://mossfamilytree.info/download.php?mod=broad_search_mod&version=11.1.0.5 Broad Search mod 11.1.0.5]<br>For {{Tv111}} {{Tv120}}
| download_link = For{{Tv1402}}<br />[[Media:Broad_search_mod_14.02.4d.zip|Broad_search_mod_14.0.2.4d.zip]]<hr style="clear: both;"/>For{{Tv1301}}<br />[[Media:Broad_search_mod_13.1.0.4c.zip|Broad_search_mod_13.1.0.4c.zip]]<hr style="clear: both;"/>For{{Tv111}}{{Tv120}}<br />[http://mossfamilytree.info/download.php?mod=broad_search_mod&version=11.1.0.5 Broad Search mod 11.1.0.5]
| download_stats = [http://mossfamilytree.info/downloadstats.php?mod=broad_search_mod Statistics]
| download_stats = [http://mossfamilytree.info/downloadstats.php?mod=broad_search_mod Statistics]
| mod_author = [[User:Chris Moss|Chris Moss]]
| mod_author = [[User:Chris Moss|Chris Moss]]
| mod_url = [[Broad Search mod]] (This page)
| mod_url = '''{{PAGENAME}}''' (This page)
| mod_support = [http://mossfamilytree.info/suggest.php contact author]
| mod_support = [https://tng.community/index.php?/forums/forum/21-addons/ TNG Community Forums]
| mod_contact = [http://mossfamilytree.info/suggest.php contact author]
| mod_contact = [https://tng.community/index.php?/forums/forum/21-addons/ TNG Community Forums]
| mod_version = 14.0.2.4d
| mod_version = 14.0.2.4d
| min_TNG_ver = 11.1.0
| min_TNG_ver = 11.1.0
| max_TNG_ver = 14.0+
| max_TNG_ver = 14.0+
| TNG_file_list = search.php, genlib.php, cust_text.php (supported languages), index.php (all templates), topmenu.php (some templates), templatestyle.css (template 4),
| TNG_file_list = search.php<br />genlib.php<br />cust_text.php (supported languages)<br />index.php (all templates)<br />topmenu.php (some templates)<br />templatestyle.css (template 4),
| related_mods = [[Married Name in Search Mod]] (incompatible)
| related_mods = [[Married Name in Search Mod]] (incompatible)
| notes = None
| notes = None
}}
}}{| style="margin-right:0.5 em;" align="right"
| __TOC__
|}
== Purpose of the mod ==
This TNG modification allows quick search for a name using nicknames, aliases, married names.
== Developer ==
This mod was developed by [[User:Chris Moss|Chris Moss]].
==Requirements==
* A working TNG installation.
* A backup of all affected files (see the list in the summary to the right)
* An installed current version of the [[Mod Manager]].
* Both '''English''' and '''English-UTF8''' folders be on your site
== Revision History ==
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
|-
! Mod Version
! TNG Version
! Date
! Contents
|- style="vertical-align:top;"
| 14.0.2.4d
| 14
| style="white-space: nowrap;"|30 May 2023
| Updated for TNG 14 & edit option fixes, tested with Expand Search mod -- [[User:Tngrlkrz|Ron Krzmarzick]]
|- style="vertical-align:top;"
| 13.1.0.5
| 13.1
| style="white-space: nowrap;"|09 Sep 2021
| Updated for TNG 13 including eliminating warnings, so more future-proof
|- style="vertical-align:top;"
| 13.1.0.4c
| 13.1
| style="white-space: nowrap;"|02 Oct 2020
| Updated for TNG 13 -- [[User:Tngrlkrz|Ron Krzmarzick]]
|- style="vertical-align:top;"
| 11.1.0.4c
| 11.1
| style="white-space: nowrap;"|19 Jul 2018
| Template 7 top menu option didn't show. Thanks Gershon.
|- style="vertical-align:top;"
| 11.1.0.4b
| 11.1
| style="white-space: nowrap;"|09 Feb 2018
| Corrections for bugs in search query
|- style="vertical-align:top;"
| 11.1.0.4a,
| 11.1
| style="white-space: nowrap;"|09 Feb 2018
| Corrections for bugs in search query
|- style="vertical-align:top;"
| 11.1.0.4
| 11.1
| style="white-space: nowrap;"|27 Dec 2017
| More efficient search, particularly first name or last name only
|- style="vertical-align:top;"
| 11.1.0.3
| 11.1
| style="white-space: nowrap;"|07 Nov 2017
| Optimise search, use variable names for tables
|- style="vertical-align:top;"
| 11.1.0.2b
| 11.1
| style="white-space: nowrap;"|20 Jun 2017
| Make XHTML 1.0 compliant and correct search for ids and searches with quotes
|- style="vertical-align:top;"
| 11.0.0.1e
| 11.0
| style="white-space: nowrap;"|20 Jun 2017
| Make XHTML 1.0 compliant and correct search for ids and searches with quotes
|- style="vertical-align:top;"
| 11.1.0.2a
| 11.1
| style="white-space: nowrap;"|12 Jan 2017
| Correct version number
|- style="vertical-align:top;"
| 11.1.0.2
| 11.1
| style="white-space: nowrap;"|11 Jan 2017
| Adjust for TNG v11.1 and regularise tick boxes
|- style="vertical-align:top;"
| 11.0.0.1d
| 11.0
| style="white-space: nowrap;"|15 Dec 2016
| Make searches in large databases efficient
|- style="vertical-align:top;"
| 11.0.0.1b
| 11.0
| style="white-space: nowrap;"|12 Dec 2016
| Correct continuation search pages & syntax error in translations
|- style="vertical-align:top;"
| 11.0.0.1a
| 11.0
| style="white-space: nowrap;"|11 Dec 2016
| Correct numbering for multiple solutions and minimise conflict with Married Name in Search Mod
|}
==Introduction==
'''Broad Search mod''' adds an option button to the quick search which generalises the search to include:
'''Broad Search mod''' adds an option button to the quick search which generalises the search to include:
# the married name of women
# the married name of women
'''Caution:''' in earlier versions with large databases (>10,000 individuals) this mod could increase MySQL execution time for searches that could lead to MySQL execution time quotas being exceeded but v4 largely solved this problem.
'''Caution:''' in earlier versions with large databases (>10,000 individuals) this mod could increase MySQL execution time for searches that could lead to MySQL execution time quotas being exceeded but v4 largely solved this problem.
[[File:Broad_search_dropdown_box.png]]
== Installation ==
# Uninstall and delete previous version of this mod (if installed)
# Download the appropriate zip file as shown in the mod summary in the upper right corner of the page.
# Extract the file from the downloaded zip file into the '''mods''' folder or FTP the extracted file to your mods folder.
# Follow the normal automated installation for Mod Manager, as shown in the example [[Mod Manager - Installing Config Files]] to install the mod.
==Options==
The behaviour of the mod can be changed in several ways by clicking on "Installed [Options]" then the "Edit options" button in the mod list.
# If you use events other than NAME and ALIA to record alternative names (e.g. AKA) then you can substitute one or the other of these. Change the name in the one of the first two boxes and click the Update button corresponding to it.
# If you want to make broad search the default method for quick searches, then you can set this up. In this case the box will appear with a tick but the user can untick it if the broad search is not wanted. You need to customise the particular template you are using. Templates vary, having a dropdown search box on pages other than the front page, but they may a menu on the front page or the top menu or both. You can choose which of these boxes are ticked.
##To set the default for the dropdown menu, put "checked" in the box for the dropdown search menu (variable $checked0) and click the Update button.
##To set the box on the front page, put "checked" in the box for the templateX/index.php file corresponding to your template and click the Update button.
##If there is a topmenu for your template then put "checked" in the box for the templateX/topmenu.php file and click the Update button.
:If you subsequently decide you don't want these set, then remove the "checked" entry and click the corresponding Update button(s).
[[File:Broad_search_options.png]]
[[File:broad_search_William_Sarra.png]]
== In the event of a problem ==
* Try using the [[Mod_Manager_-_Installing_Config_Files#Remove_Mod_Steps|Mod Manager Remove]] capability.
* Copy the backup of the affected files back to your TNG directory.
* Retry installing mod.
* Contact us through the [https://tng.community/index.php?/forums/forum/21-addons/ TNG Community Forums].
== 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.
==Installation==
*Proceed as for an installation with the new Mod.
== Conflicts and Issues ==
'''Caution''' This mod involves a number of changes to template files such as index.php which people often change more than any other file in the TNG system. It's possible that this will cause the Mod Manager to say the mod cannot be installed. If this is the case I'll try and help if you can send me a copy of the file concerned (such as templateX/index.php).
'''Caution''' This mod involves a number of changes to template files such as index.php which people often change more than any other file in the TNG system. It's possible that this will cause the Mod Manager to say the mod cannot be installed. If this is the case I'll try and help if you can send me a copy of the file concerned (such as templateX/index.php).
The quick search will search all trees unless the "Default Tree" is set in 'Admin >> Configuration >> General Settings >> Site Design and Definition'.
The quick search will search all trees unless the "Default Tree" is set in 'Admin >> Configuration >> General Settings >> Site Design and Definition'.
==Options==
== Visualization ==
The behaviour of the mod can be changed in several ways by clicking on "Installed [Options]" then the "Edit options" button in the mod list.
The following screen captures show the changes made by the mod:<br />
The quick search box with the broad search box ticked.
[[File:Broad_search_dropdown_box.png]]
Here is an example of a search for Elizabeth Sarah. Of the five results only one person was born with the surname Sarah. For the others it was a married name.
[[File:Broad_search_options.png]]
[[File:broad_search_Elizabeth_Sarah.png]]
A search for "William Sarra" shows a change of name from Sarah to Sarra. One of these was defined using ALIA and the other NAME.
[[File:broad_search_William_Sarra.png]]
This search for "Lizzie" shows that the name was more common on the birth certificate than you might expect, and only once is a nickname.
[[File:broad_search_Lizzie.png]]
If you download and install this mod, please add your TNG sites to the table below.
== Sites using this mod ==
If you download and install this mod, please add your TNG site to the table below:
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
{| border="0" cellspacing="1" cellpadding="2" class="wikitable" width="100%"
|-
|-
! URL
! URL
! User
! User
! Note
! Note
! Mod-Version/TNG-Version
! Mod-Version
! TNG-Version
! User-language
! User-language
|-
|- style="vertical-align:top;"
| [http://mossfamilytree.info Moss Family Tree]
| [http://mossfamilytree.info Moss Family Tree]
| [[User:Chris Moss|Chris Moss]]
| style="white-space: nowrap;"|[[User:Chris Moss|Chris Moss]]
| Template 5
| Template 5
| 11.0.0
| 11.0.0
| EN, FR, DE
|
|-
| style="white-space: nowrap;"|EN, FR, DE
|- style="vertical-align:top;"
|[https://www.vanderhorde.nl Familiegeschiedenis van der Horde]
| style="white-space: nowrap;"|[[User:Wvdhorde|Wim van der Horde]]
|Template 20, Private
|13.1.0.4c
|
| style="white-space: nowrap;"|NL
|- style="vertical-align:top;"
| [http://drzewo.online/ Family tree of Marcin & Emilia Senderski]
| style="white-space: nowrap;"|[[User:Mycroft|Marcin Senderski]]
| Template 15; only home page is public
| 13.1.0.4c
| 13.0.4
| style="white-space: nowrap;"|EN,PL
|- style="vertical-align:top;"
| [https://www.kmtrees.com Roots & Relatives Remembered]
| [https://www.kmtrees.com Roots & Relatives Remembered]
| [[User:Tngrlkrz|Ron Krzmarzick]]
| style="white-space: nowrap;"|[[User:Tngrlkrz|Ron Krzmarzick]]
| Public & Private
| Public & Private
| [https://www.kmtrees.com/mods-installed See Here]
| [https://www.kmtrees.com/mods-installed See Here]
| EN,DE,CS
| [https://www.kmtrees.com/mods-installed See Here]
|-
| style="white-space: nowrap;"|EN,DE,CS
|- style="vertical-align:top;"
| [https://www.wortelboer.tk Wortelboer genealogy]
| [https://www.wortelboer.tk Wortelboer genealogy]
| [[User:Bernard57|Bernard Wortelboer]]
| style="white-space: nowrap;"|[[User:Bernard57|Bernard Wortelboer]]
| Template 12
| Template 12
| 11.0.2
| 11.0.2
| NL, EN
|
|-
| style="white-space: nowrap;"|NL,EN
|- style="vertical-align:top;"
| [https://www.royandboucher.com Our Roy and Boucher Family]
| [https://www.royandboucher.com Our Roy and Boucher Family]
| [[User:Ken Roy|Ken Roy]]
| style="white-space: nowrap;"|[[User:Ken Roy|Ken Roy]]
| I no longer user this mod since it causes excessive MySQL utilization on my multi-tree sites. Will revert back to using the [[Married Name in Search Mod]]
| I no longer user this mod since it causes excessive MySQL utilization on my multi-tree sites. Will revert back to using the [[Married Name in Search Mod]]
| n/a / 11.1.1
| n/a
| FR, EN
| 11.1.1
|-
| style="white-space: nowrap;"|FR,EN
|- style="vertical-align:top;"
| [https://www.katiandgraham.com/genealogy Chamberlain & Eidenbenz Genealogy]
| [https://www.katiandgraham.com/genealogy Chamberlain & Eidenbenz Genealogy]
| [[User:Hiraeth|Graham Chamberlain]]
| style="white-space: nowrap;"|[[User:Hiraeth|Graham Chamberlain]]
| Template 8 Modified to enable broad search in home-page custom search box
| Template 8 Modified to enable broad search in home-page custom search box
| 11.0.0.1d / 11.0.2
| 11.0.0.1d
| EN,FR,DE,ES,NL
| 11.0.2
|-
| style="white-space: nowrap;"|EN,FR,DE,ES,NL
|- style="vertical-align:top;"
| [http://www.ennever.com/ Ennever/Enever Family History]
| [http://www.ennever.com/ Ennever/Enever Family History]
| [[User:bennever|Barry Ennever]]
| style="white-space: nowrap;"|[[User:bennever|Barry Ennever]]
| Customised template 4
| Customised template 4
| 13.1.0.4c / TNGV13.0
| 13.1.0.4c
| English
| 13.0
|-
| style="white-space: nowrap;"|EN
|- style="vertical-align:top;"
| [http://www.colegenealogy.net/ The Cole / Tanner Family Tree]
| [http://www.colegenealogy.net/ The Cole / Tanner Family Tree]
| [[User:dlcole|David Cole]]
| style="white-space: nowrap;"|[[User:dlcole|David Cole]]
| Public/Private
| Public/Private
| [[User:Dlcole|see here]]
| [[User:Dlcole|see here]]
| EN, DE, FR, ES, NL
| [[User:Dlcole|see here]]
| style="white-space: nowrap;"|EN,DE,FR,ES,NL
|-
|- style="vertical-align:top;"
| [http://teresa-goatham.me.uk/genealogy/home.php Teresa's Tree]
| [http://teresa-goatham.me.uk/genealogy/home.php Teresa's Tree]
| [[User:Teresa|Teresa Goatham]]
| style="white-space: nowrap;"|[[User:Teresa|Teresa Goatham]]
| Public site
| Public site
| 11.1.0.4c/12.3
| 11.1.0.4c
| EN
| 12.3
|-
| style="white-space: nowrap;"|EN
|- style="vertical-align:top;"
| [https://journeysingenealogy.com Journeys in Genealogy]
| [https://journeysingenealogy.com Journeys in Genealogy]
| [[User:PapaTango|Patrick Thrush]]
| style="white-space: nowrap;"|[[User:PapaTango|Patrick Thrush]]
| Public WordPress/TNG bundle
| Public WordPress/TNG bundle
| 11.1.0.4c/12.1
| 11.1.0.4c
| EN
| 12.1
|-
| style="white-space: nowrap;"|EN
|- style="vertical-align:top;"
| [https://WokingFamily.com/ Woking Family Tree Project]
| [https://WokingFamily.com/ Woking Family Tree Project]
| [[User:TBirdUK|Pete Smee]]
| style="white-space: nowrap;"|[[User:TBirdUK|Pete Smee]]
| Public/Private
| Public/Private
| 11.1.0.4c/12.1
| 11.1.0.4c
| EN
| 12.1
|-|-
| style="white-space: nowrap;"|EN
|- style="vertical-align:top;"
| [https://www.josephoranholtz.com/ Joseph Oran Holtz Genealogy Pages]
| [https://www.josephoranholtz.com/ Joseph Oran Holtz Genealogy Pages]
| [[User:Stores|Jim Holt]]
| style="white-space: nowrap;"|[[User:Stores|Jim Holt]]
| Private
| Private
| [[User:Stores|See Here]]
| [[User:Stores|See Here]]
| EN
| [[User:Stores|See Here]]
|-
| style="white-space: nowrap;"|EN
|- style="vertical-align:top;"
|[https://Chagnontrees.com Chagnontrees]
|[https://Chagnontrees.com Chagnontrees]
|Barb Beauregard
| style="white-space: nowrap;"|[[User:Bbregard20|Barb Beauregard]]
|Template 21 public site
|Template 21 public site
|13.1.0.4c/13.0.4
|13.1.0.4c
|EN
| 13.0.4
| style="white-space: nowrap;"|EN
|}
|}
[[Category:Mods for TNG v14]]
[[Category:Mods for TNG v13]]
[[Category:Mods for TNG v12]]
[[Category: Mods for TNG v11]]
[[Category: Mods for TNG v11]]
[[Category:search.php mods]]
[[Category:search.php mods]]
[[Category:genlib.php mods]]
[[Category:genlib.php mods]]
[[Category:index.php Template 1 mods]]
[[Category:index.php Template 1 mods]]
[[Category:index.php Template 2 mods]]
[[Category:index.php Template 2 mods]]
[[Category:topmenu.php Template 8 mods]]
[[Category:topmenu.php Template 8 mods]]
[[Category:topmenu.php Template 12 mods]]
[[Category:topmenu.php Template 12 mods]]
[[Category:cust_text.php English mods]]
[[Category:cust_text.php Dutch mods]]
[[Category:cust_text.php French mods]]
[[Category:cust_text.php German mods]]
[[Category:cust_text.php Spanish mods]]
