| The latest version of this mod uses the 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:
[See details in the TNGv12 Change Impacts Article][Hide the instructions]
|Summary||Counts the descendants of a person, and prints a report broken down by generation.|
|Mod Updated||25 Oct 2018|
See the Revision History for older versions
|Homepage||Robin Richmond's Genealogy Database|
|Mod Support||My Mod Support form or TNG Community Forums|
|Contact Developer||My Mod Support form|
|Min TNG V||12|
|Max TNG V||at least 12.0.2|
descend.php, descendtext.php, desctracker.php, register.php, tngrobots.php, English pedconfig_help.php, English, Danish, German, and Dutch cust_text.php
Purpose of the Mod
To implement a new chart that contains a table of counts of a person's descendants, broken out by generation, plus
- The count and a list of marriages between cousins,
- The count and a list of spouses who married more than one descendant,
- The count and a list of descendants who have two sets of parents,
- The count of descendant surnames, and a Surname Cloud.
- The count of descendants' spouses' surnames, and a Surname Cloud.
- A table of descendant surname counts, by generation.
- This mod
- Installs a new PHP program (rrcount_descendants.php) that generates the Descendant Count chart, and
- Places a link to the Descendant Count program in the Inner Menu of all of the native Descendant Chart programs, e.g.
Standard | Compact | Text | Register | PDF | Count.
- When cousins marry, their descendants are displayed twice by the native TNG descendant charts, but the Count Descendants program counts them only once.
- The native TNG Descendant Charts all pass their Generation count to any other native Descendant Charts when the second chart program is invoked from the first chart program's Inner menu. But the Count Descendant program ignores the generation count that is passed it. It always starts by processing all generations. Once the initial chart showing all generations is displayed, the user can select another value for the generation count. The Count Descendants program does, however, pass its generation count to the other chart programs.
- When cousins marry, they are counted both as a descendant and as a spouse. Since the program shows a count and a list of marriages between cousins, users who really want to count unique people can adjust the count accordingly.
- The program also keeps track of "descendants who have two sets of parents", which is the same as saying "descendants who appear twice in the tree as descendants. This typically occurs when a descendant's spouse adopts the children of an earlier spouse of that same descendant. As with the descendants of cousins who marry, descendants who appear twice in the list are counted only once.
This mod coordinates with TextPlus Charts v15 in two distinct ways.
- Inner menu links:
- The Count Descendants chart program installed by this mod contains a link to the Text+ Descendant chart. That link is displayed only if the TextPlus Charts mod is installed.
- Similarly, the Text+ Descendant Chart installed by TextPlus Charts contains a link to the Count Descendants chart, and that link is displayed only if the this mod (Count Descendants is installed.
- The Admin >> Setup >> Chart Settings form
- Both mods add
- (1) An option to the "Initial Display" selection box in the "Descendancy Chart" section of the Chart Settings form, and
- (2) A help link next to that selection box
- The two mods coordinate over that help link in two ways:
- Both mods add text to the Chart Setting help file describing the choice(s) they add to the Chart Settings form.
- The two help file links to the help text necessarily use different anchors in the Chart Settings help file, and that only one of the two help file links get created. However, since both new blocks of text are small, and at the bottom of the help file, the text created by both mods should be visible no matter which link has been created and followed by a user.
Show Mod Names
Like almost all of my mods, the code installed by TextPlus Charts collects information that can be used by Show Mod Names, but only if Show Mod Names is installed. TextPlus Charts is not dependent on Show Mod Names.
Compatibility with other mods
No conflicts that I know of. Most of the installation problems that have been reported to me have been caused by the cust_text.php issue described in the notice at the top of this Wiki article.
This mod uses the standard installation process. [Show Installation Details]
- A working TNG installation.
- An installed current version of the Mod Manager.
- You should backup files listed in the panel on the right.
- 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.
This is a new chart, so there is no 'Before' visualization for the chart. However, this mod does add a new Innermenu option called 'Count' to the Descendants Inner Menu associated with the Person Profile and other Descendancy report. This mod also adds a new Chart Settings option, as shown below.
|1. AFTER: A screenshot of the report|
Note that the default number of generations is "All". This screenshot shows the message that is displayed when you choose fewer generations than exist.
|2. AFTER: Some details from the counts below the results table|
The first two "Show them" buttons have been clicked. Note that "Descendants who married cousins" always come in pairs. The details link to the family record and to each spouse's record.
|3. AFTER: More details from the counts below the results table|
This screenclip shows the descendant surname cloud (with 79 names), and a portion of the pop-up panel that results from clicking on the name "HUTCHESON". In the pop-up panel, you can see that not all of my surnames are fully capitalized. In the data, I only capitalize my ancestors' surnames. But to avoid confusion between "MACINTYRE", "Macintyre" and, "MacIntyre", the Count Descendants chart uses all-caps for all surnames.
|4. AFTER: A portion of the Surname Counts by Generation|
|5. AFTER: Admin>>Setup>>Chart Settings options form|
You can see the new option "Count", and the help icon. When you mouse over the help icon, the text "New Option(s)" is displayed.
|Mod Version||TNG Version||Date||Note|
|v18.104.22.168a||12.0 - 12.0.2+||25 Oct 2018||Added surname clouds and a breakdown of descendant surname clouds by generation. Also replaced my little blue information icon style with the new image that was distributed with TNGv12. (See the last visualization above.) The mod is now fully compatible with TNGv12, and, as described above, coordinates more closely with TextPlus Charts v15.|
|v10.1.0.7c||10.1 - 11.1.2+||25 Jan 2018||Again, no functional changes; just removed the second line of cust_text.php target location strings for compatibility with anticipated changes in TNGv12.|
|v10.1.0.7b||10.1 - 11.1.2+||11 Jun 2017||No real function changes; just changed the font size of the help button and hyperlink on the Admin>>Options>Charts screen.|
|v7a||10.1+||10 May 2017|| No real function changes
|Count Descendants v6||10.0 - 10.0.3||25 May 2015|| Moved the "Count" innermenu link from before the "PDF" link to the end of the inner menu, to avoid conflicts with a new mod.|
Added a right-justified footer that displays the program name and version number.
For the TNGv10 variant only, fixed the database calls that were broken in v5 of the mod. [[Media:count_descendants-languages_v10.0.0.5.zip|Download Modv6 for TNGv10.0]
|Languages v5||10.0 - 10.1.1||25 May 2015||Small changes to German translation; added HTML entities to German non-UTF8.|
|Count Descendants v5||10.0 - 10.1.1||1 May 2015||Martin Pannier found two HTML typos that caused the copyright footer to be mispositioned.|
|v4a & languages file||10.0 - 10.1.1||30 Apr 2015|| - The base mod with English strings is unchanged.|
- The Danish, German, and Dutch translations are in a separate file.
- Adds the option in Administration >> Setup >> Charts to allow Count Descendants to be the default descendants chart, and
|v4||10.0 - 10.1.1||18 Apr 2015|| - A new, more understandable (and more translatable) way of displaying special counts below the table of descendant counts,|
- Handles Danish terminology that counts great*(n)grandparents differently,
|v3||10.0 - 10.1.1||15 Apr 2015||Eliminated the duplicates caused when cousins marry each other, and displays other duplicates.|
|v2||10.0 - 10.1.1||12Apr2015||Bernard Wortelboer added Dutch translations and caught some untranslated strings.|
|v1||10.0 - 10.1||4Apr2015||Initial Release|
Sites using this mod
If you download and install this mod, please add your site to the table below.
|Robin Richmond's Genealogy Database||Robin Richmond||Mod developer||10.1.0.7s||10.1.1||English|
|Brady Family Tree in Western Australia||Darryl Brady||Public site||10.1.0.6||10.1.1||EN, DE|
|MOTYER Family Genealogy||John Mark Motyer||Public site||see here||see here||EN, DE, RU|
|Wortelboer Genealogy||Bernard Wortelboer||Public site||10.1.0.6||11.0.0||NL, EN|
|DJCM.DK||Claus Martinussen||Public site||10.1.0.6||10.1.3||DA, EN|
|Kemp(e) Family History||Andrew Kemp||Public site||see User:Kempons||see User:Kempons||EN|
|Kleinmann Genealogy||John Kleinmann||10.1.0.7c||12.0||EN|
|An Aotearoa Genealogy Website||Merv Priestley||Public & Private, modified||v10.1.0.7c||12.0.2||EN|
|Roots & Relatives Remembered||Ron Krzmarzick||Public & Private||10.1.0.7c||22.214.171.124||EN,DE,CS,ES|
|Racine d'Alsace||J-Louis Valory||Public/Private - T17 customized||126.96.36.199||12.0.2||FR|