Difference between revisions of "Gedcom Converter"

From TNG_Wiki
Jump to navigation Jump to search
m (Robinrichm moved page FTM-to-TNG Gedcom Converter to Gedcom Converter: new name for mod)
Line 1: Line 1:
 
{{TNGmod
 
{{TNGmod
| mod_name        = FTM-to-TNG Gedcom Converter
+
| mod_name        = Gedcom Converter
|  mod_summary    = This mod read a Family Tree Maker 2012 (FTM2012) Gedcom file, and creates a new Gedcom file that corrects some errors and problems in the source Gedcom.
+
|  mod_summary    = This mod reads a Gedcom file, modifies some tags and data, and creates a new Gedcom file.  It was initially (and is still primarily) designed to make some essential modification to Gedcom files produced by Ancestry.com's Family Tree Maker 2012.
 
| validation      =   
 
| validation      =   
| download_link  = For {{Tv1012}}{{Tv80}}<br /> [[Media:ftm-to-tng_gedcom_converter_v9.0.0.11d.zip|ftm-to-tng_gedcom_converter_v9.0.0.11d.zip]]
+
| download_link  = [[Media:gedcom_converter_v9.0.0.12.zip|gedcom_converter_v9.0.0.12.zip]] {{Tv80}}
 
| download_stats  =
 
| download_stats  =
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
Line 9: Line 9:
 
| 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] or [http://tng.community/ TNG Community Forums]
| mod_version    = 9.0.0.11d
+
| mod_version    = 9.0.0.12
| min_TNG_ver    = 8.0.
+
| min_TNG_ver    = 8.0
| max_TNG_ver    = 10.1.2
+
| max_TNG_ver    = 10.1.3
 
|  TNG_file_list  = '''Updates:''' admin_dataimport.php, admin_export.php, admin_secondmenu.php, admin_secondary.php, admin_leftbanner.php, admin_main.php, languages/English/admintext.php<br />
 
|  TNG_file_list  = '''Updates:''' admin_dataimport.php, admin_export.php, admin_secondmenu.php, admin_secondary.php, admin_leftbanner.php, admin_main.php, languages/English/admintext.php<br />
'''Installs:''' ftm2tng.php, ftm2tngform.php, ftm2tngsaveoptions.php, languages/English/ftm2tng_help.php, extensions/ftm2tngconfig-distrib.php, extensions/upload.class.php
+
'''Installs:''' gedcom2tng.php, gedcom2tngform.php, gedcom2tngsaveoptions.php, languages/English/gedcom2tng_help.php, extensions/gedcom2tngconfig-distrib.php, extensions/upload.class.php
| related_mods  =  
+
| related_mods  = [[Place Normalization]], [[Gedcom Import Mediatype]]
 
| notes    =   
 
| notes    =   
 
}}
 
}}
 
 
{| style="margin-right:0.5 em;" align="right"  
 
{| style="margin-right:0.5 em;" align="right"  
 
| __TOC__
 
| __TOC__
 
 
|}
 
|}
  
 
== Purpose of the Mod ==
 
== Purpose of the Mod ==
This mod implements a Gedcom converter that reads Family Tree Maker 2012 (FTM2012) Gedcoms, and outputs another Gedcom file for import to TNG.  It makes two basic types of changes:
+
This mod implements a TNG program that makes two basic types of changes to Gedcom files:
# Fixes errors in the way FTM2012 creates Gedcom files.  These changes enable TNG to import media links, birth and death notes, and media records correctly.  These changes are essentially the same as the changes that Stephen Connor's converter makes.  See the TNG Wiki article on [[Desktop_gotchas]] and the help page for Stephen's converter at http://connergenealogy.com/LoadFTMintoTNG.html.
+
# (Optionally, but primarily) Fixes specific errors in Gedcom files produced by Ancestry.com's Family Tree Maker 23012 (FTM2012).  These changes enable TNG to import media links, birth and death notes, and media records correctly.  These changes are essentially the same as those made by a converter program hosted by Stephen Connor, which is described in the [[Desktop_gotchas]] TNG Wiki page, and in the help page at http://connergenealogy.com/LoadFTMintoTNG.html.
# Makes changes to Gedcom event data to clean up inconsistencies in the way FTM and Ancestry.com generate data.  These changes can be applied to non FTM-Gedcoms, as well.
+
# Makes several optional edits to Gedcom tags and event data to clean up a number of common inconsistencies.  These changes can potentially be applied to any Gedcom file.  
  
The program options screen and help file can be viewed at http://www.robinrichmond.com/family/ftm2tngform.php.  (The form cannot be submitted if you are not logged in.)
+
The program's options screen and help file can be viewed at http://www.robinrichmond.com/family/ftm2tngform.php.  (The form can be viewed but not be submitted if you are not logged in.)
  
Note that the application created by this mod does not touch the TNG database.  It simply cleans up Gedcom files. So it really should be independent of TNG changes, and should work for TNG version before 9.0 and after 10.1.1.
+
Note that the application created by this mod does not touch the TNG database.  It simply cleans up Gedcom files. So it really should be independent of TNG changes, and should work for TNG version before 9.0 and after 10.1.3.
  
 
==Requirements==
 
==Requirements==
Line 49: Line 47:
 
# Contact me through [http://robinr.org/family/mod_support.php My Mod Support form].
 
# Contact me through [http://robinr.org/family/mod_support.php My Mod Support form].
  
== The configuration file ==
 
If you use the "Save these options" button, the application will write the current options to extensions/ftm2tngconfig.php. The FTM-to-TNG converter application reads the config file extensions/ftm2tngconfig.php ''if it exists'', and reads the distribution config file /extensions/ftm2tngconfig-distrib.php if ftm2tngconfig.php does not exist.  This mod installs only the distibution config file ftim2tngconfig-distrib.php.
 
 
This scheme allows sites to keep their configuration settings between versions, while still supplying configuration defaults to new installations. 
 
 
Before v10, this mod installed ftm2tngconfig.php, not ftm2tngconfig-distrib.php.  Removing (unistalling) those versions of the mod will remove the existing config file, and prohibit you from keeping your configuration settings, unless you make a copy of exensions/ftn2tngconfig.php before you uninstall the mod.
 
  
 
== Visualization of this Mod ==
 
== Visualization of this Mod ==
  
 +
After installation:
 
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
 
|-
 
|-
Line 63: Line 56:
 
|-
 
|-
 
| [[Image:ftm_to_tng-step1.png]]
 
| [[Image:ftm_to_tng-step1.png]]
 +
The mod changes the Import/Export links on the TNG Administration menus to link directly to the Gedcom Converter instead of the Gedcom Import, under the assumption that you need to convert your file before you import it.
 
|-  
 
|-  
| '''Step 2'''. The standard Import Gedcom screen will appear, with a new "Gedcom Converter" tab.<br /> 
+
| '''Step 2'''. Gedcom Converter options.
Select that tab to get the Gedcom Converter screen.
 
 
|-
 
|-
| [[Image:ftm_to_tng-step2.png]]
+
| [[Image:gedcom_converter-step2.png]]  
 +
First, select a Gedcom file as you would in the Gedcom Import screen - either a PC file, or a file that has been uploaded to your web server. You must also enter an output filename, but as soon as you click on the output filename field, a default value will be displayed for you. The options are described in more detail in [http://www.robinrichmond.org/family/languages/English/gedcom2tng_help.php The Gedcom Converter help file].
 
|-
 
|-
| '''Step 3a'''. This is the FTM-to-TNG Gedcom Converter options screen, with only the essential FTM-to-TNG option set. <br />You'll need to select a file, and when you do, the program will offer a default filename for the new converted Gedcom file.
+
| '''Step 3'''.  Normalize USA Places
Note the highlighted Help link.  The help page for the converter describes all of the options in detail.
 
Also note the highlighted "Save settings" buttonThe default options are read from a configuration file, and you can save your preferred values in that configuration file.
 
 
|-
 
|-
| [[Image:ftm_to_tng-step3a.png]]  
+
| Place normalization and the Place normalization options are described in more detail in [http://www.robinrichmond.org/family/languages/English/gedcom2tng_help.php The Gedcom Converter help file].  The point here is twofold:
|-
+
# The "Normalize USA Places" options are used by (modded) programs other than the converter, and are installed by the optional [[Place Normalization]] mod.  Without that mod, the "Normalize USA Places" option is not available.
| '''Step 3b'''. When option 3, "Normalize USA Places" is checked, additional options pop-up.
+
# If you click on the "Normalize USA Places" option (or if it is selected by default), '''more''' options will appear.
|-
+
  [[Image:ftm_to_tng-step3b.png]]  
| [[Image:ftm_to_tng-step3b.png]]  
 
|-
 
| '''Step 3c'''. Another look at the optional event value changes. Again, these are described in some detail in the help file.
 
|-
 
| [[Image:ftm_to_tng-step3c.png]]  
 
 
|-
 
|-
 
| '''Step 4'''. When the converter runs, it generates a list of option values (behind a button), displays record counts as it processes records, and then, depending on the options you have selected, it may offer to display lists of places that may not have been successfully normalized.
 
| '''Step 4'''. When the converter runs, it generates a list of option values (behind a button), displays record counts as it processes records, and then, depending on the options you have selected, it may offer to display lists of places that may not have been successfully normalized.
Line 89: Line 76:
  
 
== For Additional Help ==
 
== For Additional Help ==
[http://www.robinr.org/family/languages/English/ftm2tng_help.php The help file] for the Gedcom Converter form has very detailed explanations of all of the Converter options.   
+
[http://www.robinrichmond.org/family/languages/English/gedcom2tng_help.php The help file] for the Gedcom Converter form has very detailed explanations of all of the Converter options.   
  
 
== Mod Change History ==
 
== Mod Change History ==
Line 98: Line 85:
 
! Date
 
! Date
 
! Note
 
! Note
 +
|-
 +
| 9.0.0.12
 +
| 9.0 - 10.1.3
 +
| 22 Feb 2016
 +
| Changed mod name. Separated language strings, configuration variables, and code for Place Normalization into different files, which are installed by the new [[Place Normalization]] mod. Added several Gedcom tags to the converter logic.
 
|-  
 
|-  
 
| 9.0.0.11d
 
| 9.0.0.11d
Line 116: Line 108:
 
| 9.2.2.9
 
| 9.2.2.9
 
| 9.2.2 - 10.0.2
 
| 9.2.2 - 10.0.2
| 17Aug2014
+
| 17 Aug 2014
 
| Fixed some strings that weren't internationalized. Added a warning to the "Compress dates" option noting that compressing dates breaks date internationalization. Modified the mod subfolder for new files so that it has the same folder structure as the TNG site.  I thus added the version suffix to that subfolder.
 
| Fixed some strings that weren't internationalized. Added a warning to the "Compress dates" option noting that compressing dates breaks date internationalization. Modified the mod subfolder for new files so that it has the same folder structure as the TNG site.  I thus added the version suffix to that subfolder.
 
|-  
 
|-  
 
| 9.2.2.8
 
| 9.2.2.8
 
| 9.2.2 - 10.0.2
 
| 9.2.2 - 10.0.2
| 25Jul2014
+
| 25 Jul 2014
 
| Fixed a bug in the handling of Individual TITL events.  
 
| Fixed a bug in the handling of Individual TITL events.  
 
|-  
 
|-  
 
| 9.2.2.7
 
| 9.2.2.7
 
| 9.2.2 - 10.0.2
 
| 9.2.2 - 10.0.2
| 30Jun2014
+
| 30 Jun 2014
 
| Cleanup. Improved error handling &amp; handling of form options. The converter configuration file lists the options in (essentially) the same order as the options form. Shows more information while the converter is running.  
 
| Cleanup. Improved error handling &amp; handling of form options. The converter configuration file lists the options in (essentially) the same order as the options form. Shows more information while the converter is running.  
 
|-  
 
|-  
 
| 9.2.2.4
 
| 9.2.2.4
 
| 9.2.2 - 10.0.2
 
| 9.2.2 - 10.0.2
| 25Jun2014
+
| 25 Jun 2014
 
| Added an option to suppress secondary events for selected event types. Improved handling of the media object path.  Fixed a couple of bugs that caused some conversions to be performed even if their checkbox was unchecked.
 
| Added an option to suppress secondary events for selected event types. Improved handling of the media object path.  Fixed a couple of bugs that caused some conversions to be performed even if their checkbox was unchecked.
 
|-  
 
|-  
 
| 9.2.2.3
 
| 9.2.2.3
 
| 9.2.2 - 10.0.2
 
| 9.2.2 - 10.0.2
| 12May2014
+
| 12 May 2014
 
| Improved handling of the media object path so that it doesn't get in the way of simple TNG installations. Added the "locales that act as counties" concept so it could be more thorough in making sure that counties have the county designator. Added option 5e, which was previously always done along with Date compression. Added the upload module, which was missing in the first release.
 
| Improved handling of the media object path so that it doesn't get in the way of simple TNG installations. Added the "locales that act as counties" concept so it could be more thorough in making sure that counties have the county designator. Added option 5e, which was previously always done along with Date compression. Added the upload module, which was missing in the first release.
 
|-  
 
|-  

Revision as of 11:16, 24 February 2016

Gedcom Converter
Summary This mod reads a Gedcom file, modifies some tags and data, and creates a new Gedcom file. It was initially (and is still primarily) designed to make some essential modification to Gedcom files produced by Ancestry.com's Family Tree Maker 2012.
Validation {{{mod_validation}}}
Mod Updated {{{mod_last_update}}}
Download link gedcom_converter_v9.0.0.12.zip
TNG 8.0
Download stats
Author(s) Robin Richmond
Homepage Robin Richmond's Genealogy Database
Mod Support My Mod Support form or TNG Community Forums
Contact Developer My Mod Support form
Latest Mod 9.0.0.12
Min TNG V 8.0
Max TNG V 10.1.3
Files modified
Updates: admin_dataimport.php, admin_export.php, admin_secondmenu.php, admin_secondary.php, admin_leftbanner.php, admin_main.php, languages/English/admintext.php
Installs: gedcom2tng.php, gedcom2tngform.php, gedcom2tngsaveoptions.php, languages/English/gedcom2tng_help.php, extensions/gedcom2tngconfig-distrib.php, extensions/upload.class.php
Related Mods
Notes


Purpose of the Mod

This mod implements a TNG program that makes two basic types of changes to Gedcom files:

  1. (Optionally, but primarily) Fixes specific errors in Gedcom files produced by Ancestry.com's Family Tree Maker 23012 (FTM2012). These changes enable TNG to import media links, birth and death notes, and media records correctly. These changes are essentially the same as those made by a converter program hosted by Stephen Connor, which is described in the Desktop_gotchas TNG Wiki page, and in the help page at http://connergenealogy.com/LoadFTMintoTNG.html.
  2. Makes several optional edits to Gedcom tags and event data to clean up a number of common inconsistencies. These changes can potentially be applied to any Gedcom file.

The program's options screen and help file can be viewed at http://www.robinrichmond.com/family/ftm2tngform.php. (The form can be viewed but not be submitted if you are not logged in.)

Note that the application created by this mod does not touch the TNG database. It simply cleans up Gedcom files. So it really should be independent of TNG changes, and should work for TNG version before 9.0 and after 10.1.3.

Requirements

  • A working TNG installation.
  • An installed current version of the Mod Manager.

Automated Installation

  1. Remove and delete current (if any) version of this mod.
  2. Download the .zip file. Upload and Extract to the mods folder.
  3. Backup the files listed to the right that are modified by this Mod.
  4. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install.

In the event of a problem

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


Visualization of this Mod

After installation:

Step 1. From the TNG Admin home page, select the Import/Export Gedcom option.
Ftm to tng-step1.png

The mod changes the Import/Export links on the TNG Administration menus to link directly to the Gedcom Converter instead of the Gedcom Import, under the assumption that you need to convert your file before you import it.

Step 2. Gedcom Converter options.
Gedcom converter-step2.png

First, select a Gedcom file as you would in the Gedcom Import screen - either a PC file, or a file that has been uploaded to your web server. You must also enter an output filename, but as soon as you click on the output filename field, a default value will be displayed for you. The options are described in more detail in The Gedcom Converter help file.

Step 3. Normalize USA Places
Place normalization and the Place normalization options are described in more detail in The Gedcom Converter help file. The point here is twofold:
  1. The "Normalize USA Places" options are used by (modded) programs other than the converter, and are installed by the optional Place Normalization mod. Without that mod, the "Normalize USA Places" option is not available.
  2. If you click on the "Normalize USA Places" option (or if it is selected by default), more options will appear.
Ftm to tng-step3b.png 
Step 4. When the converter runs, it generates a list of option values (behind a button), displays record counts as it processes records, and then, depending on the options you have selected, it may offer to display lists of places that may not have been successfully normalized.
Ftm to tng-step4.png

For Additional Help

The help file for the Gedcom Converter form has very detailed explanations of all of the Converter options.

Mod Change History

Mod Version TNG Versions Date Note
9.0.0.12 9.0 - 10.1.3 22 Feb 2016 Changed mod name. Separated language strings, configuration variables, and code for Place Normalization into different files, which are installed by the new Place Normalization mod. Added several Gedcom tags to the converter logic.
9.0.0.11d 9.0 - 10.12 6 Sep 2015 No real significant changes. Tweaked the Converter Setup form & the tabs. Admin >> Import/Export now takes you directly to the Converter form rather than the Input form. The converter now handles some Gedcom tags that FTM doesn't generate. (I use it occasionally to modify other Gedcoms.)
9.0.0.11a 9.0.0 - 10.1.0 24 Jun 2015 Tweaked the options form to allow it to be viewed, but not submitted, without logging in.
9.0.0.11 9.0.0 - 10.0.3 16 Dec 2014 Removed some options that addressed my personal data entry habits. Improved the place normalization. Cleaned up code and added documentation.
9.2.2.9 9.2.2 - 10.0.2 17 Aug 2014 Fixed some strings that weren't internationalized. Added a warning to the "Compress dates" option noting that compressing dates breaks date internationalization. Modified the mod subfolder for new files so that it has the same folder structure as the TNG site. I thus added the version suffix to that subfolder.
9.2.2.8 9.2.2 - 10.0.2 25 Jul 2014 Fixed a bug in the handling of Individual TITL events.
9.2.2.7 9.2.2 - 10.0.2 30 Jun 2014 Cleanup. Improved error handling & handling of form options. The converter configuration file lists the options in (essentially) the same order as the options form. Shows more information while the converter is running.
9.2.2.4 9.2.2 - 10.0.2 25 Jun 2014 Added an option to suppress secondary events for selected event types. Improved handling of the media object path. Fixed a couple of bugs that caused some conversions to be performed even if their checkbox was unchecked.
9.2.2.3 9.2.2 - 10.0.2 12 May 2014 Improved handling of the media object path so that it doesn't get in the way of simple TNG installations. Added the "locales that act as counties" concept so it could be more thorough in making sure that counties have the county designator. Added option 5e, which was previously always done along with Date compression. Added the upload module, which was missing in the first release.
9.2.2.1 9.2.2 15Apr2014 Initial release.

TNG User sites using this mod

Please add your site if you use this modification.

URL User Note Mod-Version TNG-Version User-language
Robin's Genealogy Database Robin Richmond Mod developer 9.0.0.11d TNGv10.1.2 EN
Total Family History Scott Bennett Private Site (For right now) 9.1.0.0 TNG 10.0.1 EN
Wilcox, Eskelson, and Related families Alan Wilcox Private Site (Password required - relatives only) 9.2.2.3 TNG 10.0.2 EN