Addon:WebSearch

From Gramps
Gramps-notes.png
This is a Third-party Addon. The Addon/Plugin system is controlled by the Plugin Manager.

Please use carefully on data that is backed up, and help make it better by reporting any issues to the bug tracker.
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.

WebSearch Gramplet - detached - example - showing context menu
WebSearch Gramplet - in People category (Groupled people) - sidebar example
WebSearch Gramplet - Configuration tab

The WebSearch Gramplet allows searching for information about people, places, and sources in popular genealogy databases. It automatically generates search links based on data from your genealogy records. The search parameters are filled in from the data objects in your Family Tree.

When you select a person or place in Gramps, WebSearch generates a list of links leading to relevant genealogy websites such as FamilySearch, MyHeritage, Ancestry, and more.

The WebSearch Gramplet is an evolution of the Web Connect Pack addons which created a set of Context Menus for Persons. The original interface for searching web databases proved too fussy. And the backend was too limited and linkrot maintenance was too convoluted. It is hoped that the CSV files will be easier to maintain and expand.

Usage

After installing, then use the Add a gramplet menu to select the WebSearch entry in the sidebar as the gramplet's layout is oriented vertically with a list at the top and buttons at the bottom. So the sidebar container for Gramplets will be more effective than the bottombar.

The WebSearch Gramplet focuses on the active record in the People, Families, Places or Sources categories. It determines if that record contains the data needs to do various targeted searches. If so, the gramplet creates a query link to search that online database. It automatically offers a collated list of search links related to the selected object.

Select a different Person, Family, Place or Source and then in the WebSearch Gramplet double-click on the desired weblink, and that search will open in your browser with the results.

Select a different Person, Family, Place or Source and the list in the gramplet updates.

If performing searches on a series of objects, undock the Gramplet. This will ensure that the list of available searches will update and remain accessible as you navigate between view categories and navigate the active record focus.

WebSearch Context menu

The WebSearch Context menu options when selecting a link are:


  • Add link to note : Person links only
  • Add link to attribute :
  • Show QR-code : Quickly open links on a mobile device via a camera application
  • Copy link to clipboard
  • Hide link for selected item
  • Hide link for all items

WebSearch Configuration

Use the View -> Configure menu access the WebSearch tab where you can change the selected sets of searches that are to be considered.

You can limit to specific lists (saved in Comma Separated Value or CSV files) of databases for different locales and special interests. Some lists are for databases in specific locales (regions.countries) and others are for global databases.

What search parameters are available

WebSearch supports multiple navigation types with basic pre-defined parameters:

  • Person: given name (with basic parsing into forename and middle names), surname, birth year, death year, birth place, et cetera
  • Place: name, geographic coordinates (longitude and latitude), administrative place type
  • Family: parent details, marriage place and year, divorce details
  • Source: source title

Extensive parameters are also available for each type of record. The additional options are listed in the documentation for the WebSearch repository. But these basic parameters are the most common fields found in online genealogical search forms.

How to customize?

WebSearch works immediately after installation, but you can customize it:

Choose which websites to use for searches.

Modify the format of generated search URLs.

Use additional variables for search queries.

More detailed information about configuration can be found in the full README.

Additional Features

Custom links based on Attributes

Custom links based on Attributes : substitutes values from named unique identifiers into a URL)

As an example, many genealogy application files export the FamilySearch profile IDs in a _FSFTID custom GEDCOM tag. If WebSearch finds an Attribute named _FSFTID and is configured to show the UID CSV records, it will offer a series of FamilySearch links to this Profile identifier: the person details, sources, pedigree charts. Users who are logged into the FamilySearch system can navigate to those pages with a simple double-click.


Recognized UIDs include:
Attribute name Website Description Example value
_FSFTID FamilySearch.org person profile KNDX-MKG
FacebookID Facebook.com account groups/370692133138445
FindAGraveID FindAGrave.com memorial profile 1075
GeneeeID Geneee.org (Geneweb) person profile george/washington
GeniID Geni.com person profile George-Washington-1st-President-of-the-United-States/6000000008211776777
GNDID d-nb.info Dun & Bradstreet business profile 54-0564701 (Mount Vernon Ladies' Association of the Union)
InstagramID Instagram.com account @mount_vernon
LinkedInID LinkedIn.com person professional profile mountvernon
RogloID Roglo.eu (Rauglaudre collaborative GeneWeb database) person profile 1825727
VIAFID viaf.org (Virtual International Authority File) OCLC identifier 31432428
WeRelateID WeRelate.org person profile George_Washington_(6)
WikidataID Wikidata.org knowledgebase article name Q23
WikipediaID wikipedia.org knowledgebase article name George_Washington
WikiTreeID WikiTree.com person profile Washington-11
XINGID XING.com job listing


Sorting and filtering – Easily find the necessary links. Use OpenAI (optional) – Get additional search recommendations (may require an OpenAI API key).

Installation

Stable versions are published for installation from a personal curated addon collection via the Addon Manager. Experimental version are updated more frequently but require manual download and installation.

Addon Manager project settings


  • Project name: WebSearch (5.2)
URL
https://raw.githubusercontent.com/jurchello/WebSearch/dist/gramps52

  • Project name: WebSearch (6.0)
URL
https://raw.githubusercontent.com/jurchello/WebSearch/dist/gramps60

WebSearch installs as a standard Gramplet for Gramps via the Addon Manager. Experimental versions can be manually installed after downloading the compressed package from JUrchello's WebSearch development repository.

See also

Discourse community support forum

GitHub