Difference between revisions of "FindAGrave Links"

FindAGrave Links
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
	TNG 12.0
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	Burial Website Media Import, Notes-Expand WWW Refs
Notes

Revision as of 23:04, 22 November 2018

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.

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

Add new information from the FindAGrave record the the person's Name, Birth, Death, and Burial events, and
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

Copy snippets of data (but not the whole pages, or any images) to the Citation "Transcription of Text" field, and
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

Record the FindAGrave ID (as GRid=nnnn) and
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.

Compatibility

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

Notes-Expand WWW Refs, a mod that I wrote and that is compatible with FindAGrave Links.
Burial Website Media Import, which conflicts directly with FindAGrave Links, both in the code and in its functionality.

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

Remove and delete previous version of this mod.
Backup the files updated by this mod. They are listed in the panel at the upper right.
Download the .zip file, Extract its .cfg file to the mods folder.
Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files.

Problems?

Try using the Mod Manager Remove capability
Contact me through My Mod Support form.

[Hide Details]

Visualizations

Person Profile Burial Event BEFORE:
Person Profile Burial Event AFTER:

Person Profile Citation BEFORE:
Person Profile Citation AFTER:

showmap.php (i.e. Cemetery Detail) BEFORE:
showmap.php (i.e. Cemetery Detail) AFTER:	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:
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.	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 ;Excellent Mod	12.0.0.4	12.0.2	EN,DE,CS,ES

@@ Line 1: / Line 1: @@
-{{TNGmod
+{{V12_cust_text}}{{TNGmod
 | mod_name        =  FindAGrave Links
 |  mod_summary     = Causes various TNG programs to display hyperlinks to FindAGrave.com pages when they encounter notes containing the strings '''G'''Rid=''nnnn'' (for graves), or '''C'''Rid=''nnnn'' (for cemeteries).
 | mod_validation  =
-| mod_last_update = 15 May 2018
+| mod_last_update = 22 Nov 2018
-| download_link   =  <div>[[Media:findagrave_links_v12.0.0.4.zip|v12.0.0.4]]{{Tv120}}</div>
+| download_link   =  [[Media:findagrave_links_v12.0.0.5.zip|v12.0.0.5]]{{Tv120}}<br>See the [[#Revision_History|Revision History]] for older versions
-<div>[[Media:findagrave_links_v10.0.1.3b.zip|v10.0.1.3b]] {{Tv100}}</div>
 | download_stats  =
 | mod_author      = [[User:Robinrichm|Robin Richmond]]
@@ Line 11: / Line 10: @@
 | 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_version     = v10.1.0.3b & v12.0.0.4
+| mod_version     = v12.0.0.5
-| min_TNG_ver     = 10.1
+| min_TNG_ver     = 12.0
-| max_TNG_ver     = at least 12.0
+| max_TNG_ver     = at least 12.02
 |   TNG_file_list   = genlib.php (the insertLinks function), globallib.php, admin_genconfig.php, admin_updateconfig.php, cust_text.php English
 | related_mods   = [[Burial Website Media Import]], [[Notes-Expand WWW Refs]]
@@ Line 33: / Line 32: @@
 * 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.
-This mod also installs fagwidget.php - the FindAGrave Widget - which is a non-TNG php application that works with any genealogy application to help you copy information from a FindAGrave cemetery page to the genealogy application. The Widget is described a bit in this Wiki article, and documented by a Word document in the mod subfolder and extensive source code comments.
-Note that FindAGrave updated their page design and the URL format, including the URL format, in October 2017. The old site design is still available at old.findagrave.com, and the widget will work as long as the old site is available.  I hope to have a new version of the Widget working by then.
-== Options ==
-Because of FindAGrave's transition to a new site design, this mod needs to be able to use one of at least two possible URLs to reach the ''new'' site design, and the ''old'' site design. Therefore, this mod installs two options in the Admin >> Setup >> General Settings >> Miscellaneous form that lets you select an URL for FindAGrave memorial pages (i.e. burials) and FindAGrave cemetery pages. For each type of FindAGrave pages, you may select one of two specific URLs, or to enter any URL that you wish.  The intent of the custom URL was to handle the possibility that the new FindAGrave site design might have an URL that I did not anticipate, but now, it is there for the possibility that you may want to use GRid=nnn and/or CRid=nnn to link to some other site (say, perhaps BillionGraves.com).  There are ac
 == FindAGrave References in TNG data ==
@@ Line 56: / Line 48: @@
 Then I define Source Citations for each relevant event, and
 # Copy snippets of data (but not the whole pages, or any images) to the Citation "Transcription of Text" field, and
-# Copy the Grave ID (in the form GRid=''nnnn''), and the name as stated in FindAGrave to the Citation "Page" field).
+# 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
-# Record he FindAGrave ID (as GRid=''nnnn'') and
+# Record the FindAGrave ID (as GRid=''nnnn'') and
 # 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.
 </div>
-==Compatibility With Other Mods==
+==Compatibility==
-Numerous mods edit several functions in genlib.php, but the only mods that I know of that edit the insertLinks functions are:
+Numerous mods edit functions in genlib.php, but the only mods that I know of that edit the insertLinks functions are:
 * [[Notes-Expand WWW Refs]], a mod that I wrote and that is compatible with FindAGrave Links.
-* [[Burial Website Media Import]], which conflicts directly with FindAGrave Links, both in the code and in its functionality.  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. <br/><br/>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. [[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.
+* [[Burial Website Media Import]], which conflicts directly with FindAGrave Links, both in the code and in its functionality.
+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]], 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.
+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 non-admin programs. The following mods either change specific programs to call insertLinks, or add functions of their own to do what insertLinks does.
+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 display the full place note, and covert strings within it to hyperlinks.
+* [[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.
-==Requirements==
+==Installation==
-* A working TNG installation.
+This mod uses the standard installation process. {{RobinInstallationBoilerplate}}
-* An installed current version of the [[Mod Manager]].
-* You should backup files listed in the panel on the right.
-==Automated Installation==
-# Remove and delete previous version of this mod.
-# Backup the files updated by this mod.  They are listed in the panel at the upper right.
-# Download the .zip file, Extract its .cfg file to the mods folder.
-# Follow the normal automated installation for Mod Manager, as shown in the example [[Mod Manager - Installing Config Files]].
-== In the event of a problem ==
-# Try using the [[Mod_Manager_-_Installing_Config_Files#Remove_Mod_Steps|Mod Manager Remove]] capability
-# Contact me through [http://www.robinrichmond.com/family/mod_support.php My Mod Support form].
 == Visualizations ==
@@ Line 122: / Line 106: @@
 | style="vertical-align:top;" | [[Image:FindAGrave_links-after4-place.png]]<br>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|Placesearch-More Info v11.1.1.2 or above]] (or [[Placesearch Entire Note]], when it becomes available).
 |}
-{|border="1" cellspacing="1" cellpadding="2" class="wikitable"
-| '''Admin>>Setup>>General Settings>>Miscellaneous <span style="color: red">AFTER:</span>'''
-|-
-| style="vertical-align:top;" |
-Because FindAGrave has a new beta version with a new URL format, this mod now adds two rows to the Admin>>Setup>>General Settings>>Miscellaneous screen to set up the desired URLs for FindAGrave Graves and FindAGrave Cemeteries<br>
-[[Image:FindAGrave_links-after5-setup.png]]
-|}
-=== The FindAGrave Widget ===
-To help with the task of documenting FindAGrave citations, I use the FindAGrave Widget that is installed by this mod.  Given a FindAGrave Memorial ID, the Widget pulls data from the Memorial page, and organizes it in text fields and divs that can be copied to TNG, or to any other data entry program.  Notably, '''the FindAGrave Widget is not a TNG program, and does not touch the TNG Database'''.  The Widget ''could'' easily take the information it extracts from FindAGrave pages, and save that information to TNG Events, Notes, and Citations.rave, but there two significant barriers to that:
-# I summarize rather than copy much of the information in the FindAGrave Memorial Page, and
-# I am too addicted to the Hints offered by Ancestry.com and its companion desktop program Family Tree Maker (FTM) to use TNG data entry.  (I've not been able to figure a way to do some data entry in Ancestry.com/FTM and other data entry in TNG.)
-As a result, I perform the data entry tasks involving Events, Notes, and Citations that I described a couple of paragraphs above in Ancestry.com or FTM, not in TNG.
-=== FindAGrave and Ancestry.com ===
-(Essentially everything I say in this section applies equally to Family Tree Maker.)<br/>
-Conveniently, FindAGrave hints often point me to a FindAGrave record for a person in my database.  (Inconveniently, Ancestry.com has several FindAGrave interfaces, and it often offers FindAGrave hints even though I already have incorporated FindAGrave information.  I've learned to live with that.)
-Significantly, in TNG (and in the Gedcom model), a Citation links one specific Event with a Source, and when a source such as FindAGrave provides data for a persons Name, Birth, Death, and Burial, TNG needs separate but nearly identical Citations for each of those Events. And then, if that same FindAGrave record provides information about marriages, spouses, parents, and children, separate (but again, nearly identical) Citations must be created and populated in the the context of those other events.
-In Ancestry.com, a single Citation can connect multiple Events (even in multiple records) to a Source. So, conveniently, in Ancestry.com, when a FindAGrave record supplies data to several Events, I only have to edit one Citation.  The FTM Gedcom export then creates multiple Gedcom events, as needed for import into TNG.
-Notably, the "Detail" and "Transcription of Text" fields in Ancestry.com's Source Citations (equivalent to the "Page" and "Actual Text" field in TNG Citations) are '''the only''' Source Citation fields (other than the SourceID) that are written to a Gedcom Export from Ancestry.com or FTM.  No data in the Date, Web Address, or Other Information fields in an Ancestry.com or FTM Source Citation reaches TNG via Gedcom.
 == Revision History ==
-*** The latest version of the mod is at the top of this table ***
 {| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 |-
 ! Mod Version !! TNG Version !! Date !! Note
-|-
+|- style='vertical-align:top;'
+| [[Media:findagrave_links_v12.0.0.5.zip|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.
+|- style='vertical-align:top;'
 | [[Media:findagrave_links_v12.0.0.4.zip|12.0.0.4]]
 | 12.0+
-| 15 May 2018
+| 15May2018
 | No functional changes; made compatible with TNGv12.
-|-
+|- style='vertical-align:top;'
 | 10.0.1.3b
 | 10.0.1-11.1.2+
-| 11 Dec 2017
+| 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.
-|-
+|- style='vertical-align:top;'
 | 10.0.1.3a
 | 10.0.1-11.1.1+
-| 29 Aug 2017
+| 29Aug2017
 | Changes:
 * Handles FindAGrave Cemeteries (as '''''C'''''Rid=''nnnn'') as well as Graves (as '''''G'''''rid=''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.
-|-
+|- style='vertical-align:top;'
 | 10.0.1.1
 | 10.0.1-11.0.2
-| 27 Dec 2014
+| 27Dec2014
 | Initial Mod Release
 |}

Difference between revisions of "FindAGrave Links"

Revision as of 23:04, 22 November 2018

Purpose of the Mod

Contents

FindAGrave References in TNG data

Compatibility

Related Mods

Installation

Requirements

Procedure

Problems?

Visualizations

Revision History

Sites using this mod

Navigation menu

Personal tools

Namespaces

Variants

Views

More

Search

Navigation

Language

Translate

TNG Guides

Items of Interest

Categories

External links

Translators

Tools