FindAGrave Links

From TNG_Wiki
Jump to: navigation, search

In TNGv12 and beyond, this mod uses the new guidelines for TNG v12+ cust_text.php files
If you are using TNGv12+, and any cust_text.php file in this mod is marked with a Bad Target error, you need to update your cust_text.php files before you can install this mod. [Show instructions]

If you upgraded to TNGv12+, and did not update your cust_text.php files as instructed in the upgrade readme script, then you must use the TNG Mod Manager to update them. To do so:

  1. Go to Mod Manager, and select its "Recommended Updates" tab.
    (If the "Recommended Updates" tab is not visible, then go to the Mod Manager Options tab, select "Display Settings", and turn on the "Recommended Updates" tab.)
  2. Click the "Update" button in the "Recommended Updates" tab.
    Installed mods do not interfere with the update, and if you already have (or think you may have) run this update, it will not hurt for you to run it again.

[See details in the TNGv12 Change Impacts Article][Hide the instructions]


FindAGrave Links
Summary Causes various TNG programs to display hyperlinks to FindAGrave.com pages when they encounter notes containing the strings GRid=nnnn (for graves), or CRid=nnnn (for cemeteries).
Validation
Mod Updated 22 Nov 2018
Download link v12.0.0.5
TNG 12.0

See the Revision History for older versions
Download stats
Author(s) Robin Richmond
Homepage This page
Mod Support My Mod Support form or TNG Community Forums
Contact Developer My Mod Support form
Latest Mod v12.0.0.5
Min TNG V 12.0
Max TNG V at least 12.02
Files modified
genlib.php (the insertLinks function), globallib.php, admin_genconfig.php, admin_updateconfig.php, cust_text.php English
Related Mods
Notes

Purpose of the Mod

This mod allows users to enter abbreviated references to

  • FindAGrave Grave/Memorial Pages (in the form GRid=nnnn), and
  • FindAGrave Cemetery Pages (in the form CRid=nnnn)

and then converts those abbreviated references into hyperlinks as various TNG pages are displayed.

This mod modifies the TNG system function insertLinks (in genlib.php), which converts URLs in text fields into hyperlinks, so that insertLinks calls a new function that converts FindAGrave references, too. Places in TNG where FindAGrave abbreviations are converted include (but are not at all limited to)

  • Event notes, as displayed by the Person Profile (getperson.php)
  • The Page field of Source Citations, as displayed in the Person Profile,
  • Cemetery notes, as displayed by the Cemetery Detail report (showmap.php).

Some other reports and charts call insertLinks, and convert URL's and FindAGrave references into hyperlinks, only after certain mods are install, e.g.

  • Place notes, as displayed by the Place Details report (placesearch.php), if Placesearch-More Info is installed,
  • Place notes, as displayed by the Admin >> Places screen (admin_places.php), if Admin Places Search is installed,
  • Cemetery notes, as displayed by the Admin >> Cemeteries screen (admin_cemeteries.php), if Admin Cemeteries List is installed.

FindAGrave References in TNG data

TNG users employ a variety of techniques to incorporate references to FindAGrave Memorials in their databases. Some users, for example, prefer to create specific FindAGrave events, or to associate FindAGrave media items with Burial events. This mod will probably not help with those tasks.

However, this mod is quite helpful for users (like me) who

  • Link to FindAGrave pages from Event notes, and/or
  • Define FindAGrave pages as Sources, and link to FindAGrave from Source Citations.

Here's a summary of how I use FindAGrave data in personal events and sources, and where I insert FindAGrave references.

[Show Details]

When I find a FindAGrave Memorial page for a person in my database, I

  1. Add new information from the FindAGrave record the the person's Name, Birth, Death, and Burial events, and
  2. Add new information about marriages, spouses, and children; sometimes by creating Marriage events, Spouses, and Children.

Then I define Source Citations for each relevant event, and

  1. Copy snippets of data (but not the whole pages, or any images) to the Citation "Transcription of Text" field, and
  2. Copy the Grave ID (in the form GRid=nnnn), and the name as stated in FindAGrave to the Citation "Page" field.

Then, less formally, I define a Burial (or maybe Death) note in which I

  1. Record the FindAGrave ID (as GRid=nnnn) and
  2. Describe the contents of the FindAGrave memorial page

More specifically, I describe the gravestone or personal photos, and describe (but do not duplicate) any biography or obituary in the FindAGrave record, making note of significant facts.

[Hide Details]

Compatibility

Numerous mods edit functions in genlib.php, but the only mods that I know of that edit the insertLinks functions are:

The remarkable Burial Website Media Import mod is much more powerful, flexible, and complex than FindAGrave Links, and accomplishes a different task, though with the same goal of making it simple to link to and view FindAGrave pages. Burial Website Media Import, on the other hand, creates a batch-like Secondary Gedcom Import process that scans the TNG database for references (with varying syntax) to FindAGrave and to BillionGraves.com (and perhaps other sites), and creates media items that link directly to the appropriate external web pages.

On the other hand, this mod, (FindAGrave Links) does not change any data or create any objects; it simply turns cryptic FindAGrave references that are already in TNG data fields into hyperlinks to the appropriate FindAGrave pages.

Related Mods

The Notes-Expand WWW Refs mod, like FindAGrave Links modifies the TNG insertLinks function to convert specific strings in text fields into hyperlinks. The native insertLinks function converts full URLs (beginning with http) into hyperlinks, and Notes-Expand WWW Refs does the same with web addresses that start with www.

Also, it turns out that some TNG programs that could take advantage of the hyperlink-creation performed by insertLinks do not call it. In fact, since insertLinks is in genlib.php, which is not generally Included by TNG Admin programs, insertLinks is not even available to Admin programs. The following mods either change specific programs so that they call insertLinks, or add functions of their own to do what insertLinks does.

  • Placesearch-More Info modifies the Place Details report (placesearch.php) to call insertlinks to display the full Place note, and to convert strings within it the note to hyperlinks.
  • Admin Places Search modifies the Admin>>Places program so that it continues to truncate Place Notes (as controlled by other TNG system parameters), but so that it inserts hyperlinks within the portion of the note it that does display.
  • Admin Cemeteries List does the same thing for the Admin>>Cemeteries program that Admin Places Search does for Admin>>Places.

Installation

This mod uses the standard installation process. [Show Installation Details]

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

Person Profile Burial Event BEFORE: FindAGrave links-before1.png
Person Profile Burial Event AFTER: FindAGrave links-after1.png
Person Profile Citation BEFORE: FindAGrave links-before2-citation.png
Person Profile Citation AFTER: FindAGrave links-after2-citation.png
showmap.php (i.e. Cemetery Detail) BEFORE: FindAGrave links-before3-cemetery.png
showmap.php (i.e. Cemetery Detail) AFTER: FindAGrave links-after3-cemetery.png
The pristine showmap.php does not call the insertLinks function. To enable it to expand FindAGrave links (or any URLs), you must install Admin Cemeteries List v11.0.0.8 or above.
placesearch.php (i.e. Place Detail) BEFORE: placesearch.php (i.e. Place Detail) AFTER:
FindAGrave links-before4-place.png
The pristine placesearch.php treats the Place note as though it were being displayed in a results table. That is, it truncates the Place note to the length specified by a TNG configuration parameter, and does not convert any URLs (much less FindAGrave references) to hyperlinks.
FindAGrave links-after4-place.png
The pristine placesearch.php does not call the insertLinks function. To enable placesearch.php to expand FindAGrave links (or any URLs), you must install Placesearch-More Info v11.1.1.2 or above (or Placesearch Entire Note, when it becomes available).

Revision History

Mod Version TNG Version Date Note
12.0.0.5 12.0+ 22Nov2018
  • Removed the admin options, since the old version of FindAGrave that uses GRid and CRid is gone.
  • No longer installs the FindAGrave widget, since the widget depended on the old version of FindAGrave.
  • Includes the correct filename from Show Mod Names
  • Removed case sensitivity of GRid and CRid.
12.0.0.4 12.0+ 15May2018 No functional changes; made compatible with TNGv12.
10.0.1.3b 10.0.1-11.1.2+ 11Dec2017 Now that FindAGrave has moved its new page design to www.FindAGrave.com, and its old design to old.FindAGrave.com, the options to select a FindAGrave URL have changed.
10.0.1.3a 10.0.1-11.1.1+ 29Aug2017 Changes:
  • Handles FindAGrave Cemeteries (as CRid=nnnn) as well as Graves (as Grid=nnnn)
  • Because there are now two FindAGrave sites, the TNG site's preferred FindAGrave Grave and Cemetery URLs are defined by a new TNG system variable that is defined at Admin>>Setup>>Configuration>>General Settings>>Miscellaneous. That option defaults to the original FindAGrave URL formation if no preference has been defined.
  • The code to convert FindAGrave references to hyperlinks is now in a new function in globallib.php where it can be found by mods that affect Admin programs.
10.0.1.1 10.0.1-11.0.2 27Dec2014 Initial Mod Release

Sites using this mod

If you download and install this mod, please add your site to the table below.

Site User Note Mod version TNG version Languages
Schmit Heemskerk genealogy Rudi Schmit Private 12.0.0.4 12.0 EN,NL,DE
[1] Robin Richmond Mod developer 10.0.1.3b 11.1.2 English
Roots & Relatives Remembered Ron Krzmarzick Public & Private 12.0.0.5 See Here EN,DE,CS,ES