GedFactAssistant module

From PGVWiki
Jump to: navigation, search

A module intended to provide assisted data entry options in various parts of PGV. Each Assistant is designed as a separate sub-module. From PGV ver. 4.2.2 onwards the first sub-module Manage Media Links is available. The next sub-module Census Assistant should be released with PGV ver. 4.3.0.


If you download the package this module is included, and will be correctly installed as part of PhpGedView.

If you originally installed the package this module is not included, but can be downloaded from the same location. Look for, ensuring that you use the same version level (x.x.x) for the module as your PGV installation.

To install the module copy the files to your server in the locations stored in the zip file. In summary:

GEDFact_assistant.php in the phpgedview/modules/ folder

All others in phpgedview/modules/GEDFact_assistant/ folder or its sub-folders:


As new sub-modules are added they will have their own sub-folders, such as:


Sub-module: Manage Media Links (PGV ver 4.2.2 and later)


This gives a method of managing media links, especially where one media item should be linked to multiple individuals or families. It provides a single window where you can add, edit or delete links, as well as tools to help easily find the individuals or families you want to link to.

How to use

To start using this assistant you need to find and click on a Manage Links option. They can be found in a number of places, depending on your configuration:

  1. On the Manage Multimedia page, it is one of the options beside each media item.
  2. Anywhere a media item is displayed, click on its title to go to the View media details page. From there select 'Media Options' -- 'Edit' -- 'Manage links'.
  3. On the Multimedia List, click on View details beside the image thumbnail. As above, from there select 'Media Options' -- 'Edit' -- 'Manage links'.
  4. If you use the Lightbox module: on the Album tab select View details from the drop-down options under the media item thumbnail's title. As above, from there select 'Media Options' -- 'Edit' -- 'Manage links'.

Clicking on Manage links opens a window like this:
This shows:

  • The image you are linking.
  • Any existing links, with options to remove them or add new links (Navigate).
  • A section for adding new links using PGVs normal "Find" features.
  • The option to preserve, or not, the CHAN (Last Change) record.

Clicking on Navigate adds a second window beside the first.

This is similar to the "Navigator pane" on Individual pages, and lists close family members - those most likely to be linked to the same image. This allows you to simply click on as many other names as you need to add them as new links, as shown in the next image:

If the names you need are not displayed, there is either the "Search" window at the top of the "Navigator" window, or the Add Links options on the first window. If you make a mistake and need to remove a link, click on the red X.

Once all the links are in place, click Save to complete the process. The single media item will now be linked to all the individuals (or families, or sources) you chose.

Sub-module: Census Assistant

(Due for release, PGV ver. 4.3.0)


This tool allows you to add all the details from any (currently only US or UK) census page to ALL the people listed on it (providing they exist in your GEDCOM file) in ONE process. It includes tools to help find the relevant individuals, and presents the results in an easy to read, formatted, shared-note, containing all of the key facts from the original census page.

Here is an example of the completed display:

Ca final.jpg

How to Use

To add census data, start from any individual shown on the census page for the household, select Census[CENS] from the Add new fact drop-down at the bottom of the page, then click Add. [Ideally you would start with the 'Head' of the household, but it is not essential]

This will open a Census edit pop-up window
From here, the first steps are:

  1. Enter the date of the census, either directly in the Date field, or by using the Census Date drop-down to select the census you are entering. This will automatically enter the correct date in the Date field.
  2. Enter any other details you require, such as Place, Address, or add a media item if you want one at this level.

Very important: Only enter data here that can be common to all the individuals on the census page / household. So do not enter Age for a single individual otherwise later in the process that age will be copied to all the other individuals.

Next add a Source Citation for this event, by clicking on the Add a new Source Citation option and entering the appropriate details.

At this point there are two options for adding the Shared Note containing the census details:

  1. By clicking on Shared Note using Assistant within the Source details area. This will add the census details as a note to the Source record
  2. By clicking on Add a new Shared Note below the Source details area, then clicking on the Shared Note using Assistant in this area. This will add a shared note at the same level as the Source. [This is the option chosen for the finished example shown above here]

Whichever you choose, Shared Note using Assistant opens the Census Assistant window, a large pop-up. It contains 6 areas of information, which are briefly described here. Detailed instructions for each area will follow below using these numbers as the key. You can see that much of the information already entered has been retained here, so no re-typing is required.

  1. Header information. This identifies the person you started the process from as the "Head"
  2. Summary Information input, where you will enter the key information from the census page related to the whole page.
  3. Person list and search. This presents the person from the header area ("1") plus their close relatives, and a Search option if required
  4. Census data input. This area will be populated later with the line entries for each individual shown on the census page
  5. Shared Note preview panel. This area will display the actual GEDCOM data that will be stored in the shared note record once you complete all steps.
  6. Preview, Save, and Help options

Area 1 - Header information

It is important to identify the correct person in this information. The name is used in the title of the shared note (area 2), and will, if not edited later, be identified as the Head of the household on the individual details later (area 4). If you need to change this person, select someone else from the list in area 3, and click on the small "head" icon beside their name. The screen will refresh, with that new person shown in area 1.
Area 1.jpg

Area 2 - Summary information

This is where you can enter information related to the whole census page.

The items "Country" and "Year" are mandatory, but will generally be filled in automatically from the entries you made on the previous window. They can be changed here though if you want to. You must select the country of the census (currently only UK or USA are available), and the year of the census before any other data can be entered. These are also added in front of the text in the Title box to create the title of the shared note. The Title text can be manually edited here if you want.
Area 2.jpg
The fields, Reference, Locality, and Notes are also optional, and are simple text entry fields. You can add any appropriate text of your own or from the original census pages here, or leave blank if you prefer.

At this point you can click on Preview in area 6 to see how the inputs made so far will appear in the GEDCOM NOTE record, displayed in area 5.

Area 3 - Person List and Search

This area is based on the Family Navigator pane shown on Individual pages of PGV. It lists close relatives of the person set as Head here (marked with a tick). It is designed to include those people most likely to be needed for this census record.
Area 3.jpg
Its use is very simple. Following the order of people listed on the original census page, click on each name in turn. As each name is clicked, their details will be transferred to the Data Input area 4, including any pieces of information that can be deduced automatically at this time.

Once all the required people have been added to area 4, the whole window will look like the example below.

Area 4 - Census Data Input

Area 4.jpg
[Note: on your screen you will see scroll bars, needed to view the full width or height of this area. This is necessary to accommodate large numbers of columns found in census pages in some years, and for large households, while still fitting a pop-up window on most screen sizes.]

The next steps are to:

  1. Manually change any of the deduced information displayed (shown here in blue), such as age, marital condition (MC) to match exactly the contents of the original census page
  2. Enter data in the remaining fields, copying them from the original page.

Other things to know about this area:

  • To know what each of the short header titles, such as FBP actually mean hover your mouse over them to read a tool tip brief explanation. These change according to the Country / Year census chosen in area 2, and will correspond to columns of data on the original census. The same tool tips are also available on the finished presentation in PGV.
  • Above the table is an Add/Insert Blank Row button. This is connected to the Add marker on the right of the area. While Add is marked, the button will add a new, blank row at the bottom of the list. If you click on any marker under the Ins field at the right, the same button will insert a row above the person chosen. These blank rows enable you to add information about people NOT recorded in your GEDCOM file, but present on the census page.
  • Click on the X to the right of any data row to delete that row from the list. You can put it back, or in another position by setting an Ins marker then clicking a name from area 3 again.


When all the data in area 4 is as correct as you want it to be, click on Preview in area 6 for a final review of the output, which will look like this:
Area 5.jpg

If all is well:

  • Click on Save (area 6).
  • You will see another window, confirming the INDI numbers the event is about to be saved to, for information only.
  • Click on Paste the following ID into your editing fields to reference the newly created record N1.
  • You will now be back to the original Add Census window.
  • Make a final check that all entries are complete and correct.
  • Click on any of the Save buttons, then Close window to finalise the operation.

Unless you have auto accept changes set to Yes in your GEDCOM configuration, you will now need to accept these changes in PGV. Once that is complete ALL of the individuals added to area "4" will now have a CENS event much like the one shown at the start of this article.