Difference between revisions of "TextPlus Charts"

From TNG_Wiki
Jump to navigation Jump to search
(added to Mods for TNG v11 category)
(19 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
{{construction
 +
|notes= I've discovered a minor bug in mod v13b.  In both the Ancestor and Descendant Text+ Charts, you cannot select 'all' as the number of generations. Instead, you must select a number (perhaps the largest number in the selection box) that is sufficient to cover all generations.
 +
}}
 
{{TNGmod
 
{{TNGmod
 
| mod_name        = TextPlus Charts
 
| mod_name        = TextPlus Charts
 
|  mod_summary    = Two new charts: Text+ Descendant Chart, and Text+ Ancestor Chart.
 
|  mod_summary    = Two new charts: Text+ Descendant Chart, and Text+ Ancestor Chart.
 
| mod_validation  =  
 
| mod_validation  =  
−
| download_link  = For {{Tv110}}{{Tv1010}}[[Media:textplus_charts_v10.1.0.12.zip|textplus_charts_v10.1.0.12.zip]]
+
| mod_last_update = 28 Dec 2017
 +
| download_link  = [[Media:textplus_charts_v10.1.0.13b.zip|v10.1.0.13b]]{{Tv110}}{{Tv1010}}
 
<hr/>Language Strings:
 
<hr/>Language Strings:
 
<div style="border:dotted thin grey;">French, Dutch, German, Norwegian UTF8 translations:  
 
<div style="border:dotted thin grey;">French, Dutch, German, Norwegian UTF8 translations:  
−
[[Media:textplus_charts_utf8_v10.1.0.12.zip|textplus_charts_utf8_v10.1.0.12.zip]]</div>
+
[[Media:textplus_charts_utf8_v10.1.0.13.zip|utf8_v10.1.0.13]]</div>
−
<div style="border:dotted thin grey;">French, Dutch, German, Norwegian non-UTF translations: [[Media:textplus_charts_non-utf_v10.1.0.12.zip|textplus_charts_non-utf_v10.0.1.12.zip]]</div>
+
<div style="border:dotted thin grey;">French, Dutch, German, Norwegian non-UTF translations: [[Media:textplus_charts_iso_v10.1.0.13.zip|iso_v10.0.1.13]]</div>
−
<hr/>See body of article for mod versions for TNGv10.0
+
<div style="border:dotted thin grey;">Zip file that includes all three .cfg files: [[Media:textplus_charts_v10.1.0.13b-all.zip|v10.0.1.13b-all]]</div>
 +
<hr/>See the [[#RevisionHistory|Revision History]] for older versions of the mod.
 
| download_stats  =
 
| download_stats  =
 
| mod_author      = [[User:Robinrichm|Robin Richmond]] with translations by Henny Savenije, Hendrik Martius, Bernard Wortelboer, &amp; Jan-Thore Solem, and testing help from Henny Savenije and Alan Wilcox
 
| mod_author      = [[User:Robinrichm|Robin Richmond]] with translations by Henny Savenije, Hendrik Martius, Bernard Wortelboer, &amp; Jan-Thore Solem, and testing help from Henny Savenije and Alan Wilcox
−
| mod_url        = [TextPlus Charts] (''This'' Page)
+
| mod_url        = [[TextPlus Charts]] (''This'' Page)
 
| 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    = 10.1.0.12 for TNGv10.1.* and TNGv11.*<br/>10.0.2.10b for TNG v10.0.2 and 10.0.3
+
| mod_version    = 10.1.0.13b
−
| min_TNG_ver    = 10.0.2
+
| min_TNG_ver    = 10.1.0
−
| max_TNG_ver    = 11.0.1
+
| max_TNG_ver    = 11.0.1.2+
 
|  TNG_file_list  = '''Updates''' admin_pedconfig.php, <br/>Descendant charts (descend.php, descendtext.php, desctracker.php, register.php), <br/>Pedigree charts (pedigree.php, pedigreetext.php, verticalchart.php, ahnentafel.php, extrastree.php),<br/> tngrobots.php, <br/>cust_text.php (English, Dutch, French, German, Norwegian), <br/>css/genstyle.css<br/>
 
|  TNG_file_list  = '''Updates''' admin_pedconfig.php, <br/>Descendant charts (descend.php, descendtext.php, desctracker.php, register.php), <br/>Pedigree charts (pedigree.php, pedigreetext.php, verticalchart.php, ahnentafel.php, extrastree.php),<br/> tngrobots.php, <br/>cust_text.php (English, Dutch, French, German, Norwegian), <br/>css/genstyle.css<br/>
 
'''Installs:''' descendtextplus.php, pedigreetextplus.php, tngdblib_textplus.php, English/textplus_help.php, German-UTF8/textplus_help.php, extensions/textplusmenu.png, extensions/textplusinnermenu.png
 
'''Installs:''' descendtextplus.php, pedigreetextplus.php, tngdblib_textplus.php, English/textplus_help.php, German-UTF8/textplus_help.php, extensions/textplusmenu.png, extensions/textplusinnermenu.png
Line 22: Line 27:
 
| notes    =  
 
| notes    =  
 
}}
 
}}
−
 
+
== Purpose of the Mod ==
 +
To define two new charts - The Text+ Pedigree Chart (on the Pedigree inner menu), and the Text+ Descendant Chart (on the Descendant Charts inner menu).  Both charts follow a text format (basically an outline layout), and are accessed through the TNG "Inner Menu" (the link menu just below the TNG Tab Bar) on the Person Profile and  on Pedigree and Descendant chart pages.
 
{| style="margin-right:0.5 em;" align="right"  
 
{| style="margin-right:0.5 em;" align="right"  
 
| __TOC__
 
| __TOC__
−
 
 
|}
 
|}
−
== Purpose of the Mod ==
 
−
To define two new charts - The Text+ Pedigree Chart (on the Pedigree inner menu), and the Text+ Descendant Chart (on the Descendant Charts inner menu).  Both charts follow a text format (basically an outline layout), and are accessed through the TNG "Inner Menu" (the link menu just below the TNG Tab Bar) on the Person Profile and  on Pedigree and Descendant chart pages.
 
−
 
−
== Mod Options ==
 
−
The options offered by this mod are implemented through the TNG Admin >> Setup >> Chart Settinsg menu.
 
−
# To select the Text+ Pedigree Chart as the default chart to generate when you click the "Pedigree" tab in the Person Profile,
 
−
#* Select "Pedigree Chart" on the "Charts Settings" menu, and
 
−
#* Select "Text+" the "Initial Display drop-down box.
 
−
# To select the Text+ Descendant Chart as the default chart to generate when you click the "Descendant" tab in the Person Profile,
 
−
#* Select "Descendant Chart" on the "Charts Settings" menu, and
 
−
#* Select "Text+" the "Initial Display drop-down box.
 
−
# If you install the TextPlus Charts mod as well as other mods that install links on the TNG Inner Menu, the Inner Menu can become awkwardly long.  To save space on Inner Menu by eliminating the original "Text" links:
 
−
#* Select "Common Elements" on the "Chart Settings" menu, and
 
−
#* Check the "Yes" button next to the new "Hide Plain Text Chart Links" option at the bottom of the Common Elements sub-form.
 
  
 
== Features of the Text+ Charts ==
 
== Features of the Text+ Charts ==
Line 60: Line 51:
 
* Can (optionally) display the siblings of each ancestor, giving a richer view of the family tree, and
 
* Can (optionally) display the siblings of each ancestor, giving a richer view of the family tree, and
 
* Can (optionally) display blank lines at certain points in the chart to improve readability.
 
* Can (optionally) display blank lines at certain points in the chart to improve readability.
 +
 +
== Mod Options ==
 +
The options offered by this mod are implemented through the TNG Admin >> Setup >> Chart Settings menu.
 +
# To select the Text+ Pedigree Chart as the default chart to generate when you click the "Pedigree" tab in the Person Profile,
 +
#* Select "Pedigree Chart" on the "Charts Settings" menu, and
 +
#* Select "Text+" the "Initial Display drop-down box.
 +
# To select the Text+ Descendant Chart as the default chart to generate when you click the "Descendant" tab in the Person Profile,
 +
#* Select "Descendant Chart" on the "Charts Settings" menu, and
 +
#* Select "Text+" the "Initial Display drop-down box.
 +
# If you install the TextPlus Charts mod as well as other mods that install links on the TNG Inner Menu, the Inner Menu can become awkwardly long.  To save space on Inner Menu by eliminating the original "Text" links:
 +
#* Select "Common Elements" on the "Chart Settings" menu, and
 +
#* Check the "Yes" button next to the new "Hide Plain Text Chart Links" option at the bottom of the Common Elements sub-form.
  
 
==Compatibility With Other Mods==
 
==Compatibility With Other Mods==
Line 76: Line 79:
 
<div class='toccolours mw-collapsible-content mw-collapsed'>this this mod required that [[Show Mod Names]] and [[Blue Info Button]] be installed. (Well, the presence of those mods would not affect installation of this mod, but the Text Plus charts would generate a run-time '''warning''' if [[Show Mod Names]] were not installed, and buttona intended to look like a blue information icon would not be formatted properly [[Blue Info Button]] were not installed.</div></div>
 
<div class='toccolours mw-collapsible-content mw-collapsed'>this this mod required that [[Show Mod Names]] and [[Blue Info Button]] be installed. (Well, the presence of those mods would not affect installation of this mod, but the Text Plus charts would generate a run-time '''warning''' if [[Show Mod Names]] were not installed, and buttona intended to look like a blue information icon would not be formatted properly [[Blue Info Button]] were not installed.</div></div>
  
−
== Visualization of this Mod ==
+
== Visualizations ==
 
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
 
|-
 
|-
−
|<span style="color: red">''' Text+ Descendant Chart'''</span>
+
|<span style="color: red">''' Text+ Descendant Chart'''</span> - The "main" screen (as opposed to the "Format for Printing" screen)
−
# This is the "main" screen.  Please note that before you print this chart, you should generally use TNG's "Pretty Print" (or "Print Formatting") screen to finalize the chart format.
+
# The "Text+" link is highlighted within the "Inner Menu" in this visualization. It is placed in the same position on other Descendant chart programs.
−
# This program extends the "Inner Menu" to add some run-time options.
+
# This program extends the "Inner Menu" to add run-time options. The two options on the second line of the Inner Menu are available on the main screen ''and'' the Print Formatting screen.
−
# The "Text+" link is highlighted within the "Inner Menu" in this visualization.
 
−
# The two options on the second line of the Inner Menu are available on the main screen ''and'' the Print Formatting screen.
 
 
# This program has a help file, like many administrative programs.
 
# This program has a help file, like many administrative programs.
−
# There is a reminder to use the Print button.  You'll likely get undesired wrapping if you try to print this screen directly.
+
# Before you print a Text+ chart, you should generally use the "Format for Printing" button in the Innermenu to finalize the chart format.
 
# Note the abbreviations
 
# Note the abbreviations
 
#* "chr." to indicate that this is a christening date
 
#* "chr." to indicate that this is a christening date
Line 91: Line 92:
 
#* "bur" to indicate that this is the burial location.
 
#* "bur" to indicate that this is the burial location.
 
# The vertical dotted line formed by colons connects spouses of one person
 
# The vertical dotted line formed by colons connects spouses of one person
 +
# The little minus signs allow you to collapse a branch of the family. The summary at the bottom of the page reports the number of people who have been hidden by collapsed branches.
 
# The hyperlinked arrows link to subsequent generations of descendants.
 
# The hyperlinked arrows link to subsequent generations of descendants.
−
# Note the summary at the end of the chart. (I have discovered that the line summary assumes that all collapsable branches of the family tree (the minus signs inside a box) are open. That is, when you collapse a branch, the counts do not change. I'll have to try to take care of that in the next release of the mod.)
+
# A chart summary reports the number of people and generations in the chart, the number of people hidden in collapsed branches, and the number of lines that have been wrapped by program logic. Lines that wrap because they bump against the edge of the browser window cannot be counted. They also disrupt the flow of the chart. The "Format for Printing" screen has controls that help you avoid browser-driven line wrapping
 
|-
 
|-
 
| [[Image:textplus_charts-descend.png]]
 
| [[Image:textplus_charts-descend.png]]
 
|-
 
|-
−
|<span style="color: red">''' Text+ Descendant Chart in the "Pretty-Print Window'''</span>
+
|<span style="color: red">''' Text+ Descendant Chart in the "Format for Printing" Window'''</span>
−
# Now, we're in the "Pretty-Print", or "Print Format" window.  Here, the "Print" button actually prints. The options and buttons DO NOT print with the chart.
+
# Here, the "Print" button actually prints. The options and buttons DO NOT print with the chart.
 
# The text size and width options are only available in the Print Format window.
 
# The text size and width options are only available in the Print Format window.
−
# Note that you must click Submit for the options to have an effect in this window. The Save button saves a cookie with your current text and width options.  (The "Hide data" and "Hide descendants" options do not get saved.)
+
# You must click "Submit" for the options to have an effect in this window.
−
# Help is still available.
+
# The "Save Settings" button saves a cookie with your current text and width options.  (The "Hide data" and "Hide descendants" options do not get saved.)
−
# Because this chart uses the "Portrait" setting for the page width, it requires 102 lines, rather than the 81 lines required by the chart in the first visualization.  
+
# The "Hide data..." and "Hide descendants..." checkboxes and the Help button are still available.
 +
# The Expand/Collapse controls are still operational in this window.
 +
# The red arrow points to the Width option, which is "Portrait", meaning that the page is laid out in anticipation of being printed in Portrait orientation on regular 8.5 x 11 paper.
 +
# Because of the "Portrait" width and the font size defined in the Chart Formatting Form, several lines in this chart are wrapped by the program. Three that have not been hidden are outlined.
 +
# Among the distinctive features of the Text+ Descendant chart that were in the screenshot above, but were not mentioned there are
 +
#* Double question marks to indicate that the date of death is "Unknown"
 +
#* The word "alive" to indicate that the person is living, along with the most recent date and place from a Residence event.
 +
# The visualization above referred to trimmed branches, but they were all in the portion of the page that was cut out of the screen clip.  Here, you can see that little minus signs buttons have been changed to plus signs where branches have been trimmed.
 +
# Another feature of the Text+ Descendant chart is that it reports marriage dates and places.
 +
# The summary at the bottom of the chart reports that 5 visible lines have been wrapped by the program.
 
|-
 
|-
 
| [[Image:textplus_charts-descend2.png]]
 
| [[Image:textplus_charts-descend2.png]]
 
|-  
 
|-  
 
| <span style="color: red">'''Text+ Pedigree Chart'''</span>
 
| <span style="color: red">'''Text+ Pedigree Chart'''</span>
−
* This chart was generated with the parameter Generations=0, so that all of the starting person's ancestors are shown.
+
* This chart was generated with the parameter Generations=all, so that all of the starting person's ancestors are shown.
 +
* Four checkboxes control the content of the report. Checkboxes that are not applicable are shown but are disabled - such as the "Sibling Count" checkbox, which only appears if both the 'Siblings' and the "Show Generation #'s" boxes are checked.
 +
* Note that, as with the Text+ Descendant Chart, the chart width for this screen is equivalent to a "Landscape" setting, and all seven generations can fit on the screen without any wrapping.
 
* The summary footer reveals that the chart displayed seven generations.
 
* The summary footer reveals that the chart displayed seven generations.
−
* Note that, as with the Text+ Descendant Chart, the chart width for this screen is equivalent to a "Landscape" setting, and all seven generations can fit ''on the screen'' without any wrapping.
 
 
|-
 
|-
 
| [[Image:textplus_charts-pedigree1.png]]
 
| [[Image:textplus_charts-pedigree1.png]]
 
|-
 
|-
−
| <span style="color: red">'''Text+ Pedigree Chart in the "Pretty-Print" screen'''</span>
+
| <span style="color: red">'''Text+ Pedigree Chart in the "Format for Printing" screen'''</span>
−
* This is the same chart as above.  Note that it is formatted for "Portrait" printing and is therefore narrower than the one above, as illustrated by the arrows that point to 5 lines out of the first 14 that must wrap for Portrait printing.
+
* This is the same chart as above.  
−
* The "Siblings" and "Blank lines" checkboxes (outlined in red) are not present in the Text+ <em>Descendant</em> chart.
+
* The five print-formatting controls in the "Chart Formatting Form" are exactly the same as those in the Text+ Descendant chart.
−
** When "Siblings" is checked, each person's siblings are shown.
+
* The four content-control checkboxes in the "Chart Formatting Form" the same ones that are used in the "main" screen of the Text+ Ancestor chart. These four checkbox value are not saved to a cookie when the user clicks the "Save Settings" button.  Only the print-formatting controls are saved.
−
** When "Blank lines" is checked, blank lines are inserted at strategic points in the chart to improve readability.
+
* The arrows point to places where the program has wrapped the text because the text reached the margin set by the program.  Note that if we simply allowed the browser to wrap text, the text would wrap to the left margin, and interrupt the vertical lines.
−
* The Siblings and Blank Lines checkbox values are NOT saved to a cookie when the user clicks the Save button.
 
 
|-
 
|-
 
| [[Image:textplus_charts-pedigree2.png]]
 
| [[Image:textplus_charts-pedigree2.png]]
 
|-  
 
|-  
−
| <span style="color: red">'''Pedigree Chart with Siblings.'''</span> [http://www.robinrichmond.com/demo/text+pedigree-siblings.pdf Saved as a PDF]<br/>
+
| '''Full Pedigree Chart Examples saved as PDFs'''
−
<span style="color: red">'''12-Generation Text+ Pedigree Chart.''' with extra blank lines</span>
+
* [http://www.robinrichmond.com/demo/text+pedigree-siblings.pdf Pedigree Chart with Siblings]
−
[http://www.robinrichmond.com/demo/text+pedigree-12gens.pdf Saved as a PDF]<br/>(The charts were saved as PDF using Google Chrome's built-in Print-to-PDF capability.)
+
* [http://www.robinrichmond.com/demo/text+pedigree-12gens.pdf 12-Generation Text+ Pedigree Chart, with extra blank lines]
 +
(The charts were saved as PDF using Google Chrome's built-in Print-to-PDF capability.)
 
|-
 
|-
 
| <span style="color: red">'''Text+ Pedigree Setup in the Admin >> Setup >> Chart Settings Form'''</span>
 
| <span style="color: red">'''Text+ Pedigree Setup in the Admin >> Setup >> Chart Settings Form'''</span>
 
|-
 
|-
−
| [[Image:textplus_charts-setup.png | right]] This mod adds a "Text+" option to the "Initial Display" selection for Pedigree Chart and for Descendant chart.  This allows you to set up the Text+ charts as your default Pedigree and/or Descendant charts.  It also adds an option to the "Common Elements" sub-form that allows you to suppress the original plain text chart in case the Inner Menu becomes too crowded with options.
+
| [[Image:textplus_charts-setup.png | right]] This mod adds a "Text+" option to the "Initial Display" selection for Pedigree Chart and for Descendant chart.  This allows you to set up the Text+ charts as your default Pedigree and/or Descendant charts.
 
|}
 
|}
  
Line 133: Line 145:
 
Because the Text+ charts draw lines connecting the generations, these charts cannot simply allow long lines of data to wrap at the browser window's (or printed page's) right margin. The Text+ chart programs have to know the window (or printed page's) width and the font size so that they can wrap lines of data at the appropriate point.
 
Because the Text+ charts draw lines connecting the generations, these charts cannot simply allow long lines of data to wrap at the browser window's (or printed page's) right margin. The Text+ chart programs have to know the window (or printed page's) width and the font size so that they can wrap lines of data at the appropriate point.
  
−
As a result, the Text+ chart programs contain a form with fields that specify printing parameters. Some parameters are visible in the 'main' program window.  Other prameters that deal with font size and page width are visible only in the 'Print Formatting' window (i.e. the window that pop up when you click on the TNG "Print" button.  Those parameters are described in detail in a help page associated with the Text+ chart programs.
+
As a result, the Text+ chart programs contain a form with fields that specify printing parameters. Some parameters are visible in the 'main' program window.  Other parameters that deal with font size and page width are visible only in the 'Format for Printing' window. Those parameters are described in detail in a help page associated with the Text+ chart programs.
  
 
(Author's note: Most web applications with such constraints would generate PDF files, which allow print characteristics to be controlled with more specificity, but I first wrote versions of the Text+ programs long before the PDF format became standard, and I've simply continued to use HTML with each new implementation.)  
 
(Author's note: Most web applications with such constraints would generate PDF files, which allow print characteristics to be controlled with more specificity, but I first wrote versions of the Text+ programs long before the PDF format became standard, and I've simply continued to use HTML with each new implementation.)  
  
−
==Requirements==
+
== Installation ==
 +
===Requirements===
 
* A working TNG installation.
 
* A working TNG installation.
 
* An installed current version of the [[Mod Manager]].
 
* An installed current version of the [[Mod Manager]].
 
* You should backup files listed in the panel on the right.
 
* You should backup files listed in the panel on the right.
  
−
==Automated Installation==
+
===Installation Steps===
−
# Remove and delete previous version of this mod.
+
# Uninstall any previous versions of this mod.
 
# Backup the files updated by this mod.  They are listed in the panel at the upper right.
 
# Backup the files updated by this mod.  They are listed in the panel at the upper right.
 
# Download the .zip file, and extract its .cfg file '''and its subfolder''' to the mods folder.
 
# Download the .zip file, and extract its .cfg file '''and its subfolder''' to the mods folder.
 
# Follow the normal automated installation for Mod Manager, as shown in the example [[Mod Manager - Installing Config Files]].
 
# Follow the normal automated installation for Mod Manager, as shown in the example [[Mod Manager - Installing Config Files]].
  
−
== In the event of a problem ==
+
=== In the event of a problem ===
 
# Try using the [[Mod_Manager_-_Installing_Config_Files#Remove_Mod_Steps|Mod Manager Remove]] capability
 
# Try using the [[Mod_Manager_-_Installing_Config_Files#Remove_Mod_Steps|Mod Manager Remove]] capability
 
# 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].
  
−
== Space-Saving Techniques ==
+
== Reducing Line-wrapping ==
 
I have used the following techniques to reduce the amount of text required to display a person's data end place information, and thus reduce the amount of line-wrapping required to print these charts:
 
I have used the following techniques to reduce the amount of text required to display a person's data end place information, and thus reduce the amount of line-wrapping required to print these charts:
 
* I use "??" instead of "Unknown"
 
* I use "??" instead of "Unknown"
−
* If a person was born and died in the same place, I only display the place name once, like this: (Cleveland, Bradley, Tennessee, USA;15 Nov 1815 - 04 Jan 1887)
+
* If a person was born and died in the same place, I only display the place name once, like this:<br> (Cleveland, Bradley, Tennessee, USA;15 Nov 1815 - 04 Jan 1887)
−
* I use a set of unpublished mods that stores two shorter versions of place names (e.g. "Cleveland, Cuyahoga, OH" and "Cleveland, OH" for "Cleveland, Cuyahoga County, Ohio, USA".  This scheme uses "place normalization" techniques to standardize the format of USA places, and then generates the shorter place names algorithmically. These mods affect several programs, such as the Person Profile and placesearch.php. If you're interested in trying to use this scheme, let me know, and I'll share the mods with you.
+
* I also have use an unpublished mod that stores two shorter versions of place names (e.g. "Cleveland, Cuyahoga, OH" and "Cleveland, OH" for "Cleveland, Cuyahoga County, Ohio, USA".  This scheme uses "place normalization" techniques to standardize the format of USA places, and then generates the shorter place names algorithmically. These mods affect several programs, such as the Person Profile and placesearch.php. If you're interested in trying to use this scheme, let me know, and I'll share the mods with you.
 
   
 
   
−
== Mod for older TNG version ==
+
==Remove an Innermenu Link==
−
This mod was introduced with TNGv10.0.2. If you're still running TNGv10.0.2 or TNGv10.0.3, use these files:
+
If you install the TextPlus Charts mod as well as other mods that place links on the Ancestors or Descendants Inner Menus, those Inner Menus can become awkwardly long. A utility program that eliminates the native Descendant and/or Ancestor Text chart is available through a link in the mod description in Mod Manager. '''Be aware, however, that, with TNGv11, the native Text Descendant chart has a new ancestor-tracking feature that is not found in the Text+ Descendant chart.''' The Text+ Descendant chart can count generations and children, but the native Text+ chart's ancestor-tracking feature conveys more information.
−
* The primary mod: [[Media:textplus_charts_v10.0.2.11.zip|textplus_charts_v10.0.2.11.zip]]
 
−
* French, German, Dutch, and Norwegian Language Strings:
 
−
** [[Media:textplus_charts_utf8_v10.0.2.10b.zip|textplus_charts_utf8_v10.0.2.10b.zip]]
 
−
** [[Media:textplus_charts_non_utf8_v10.0.2.10b.zip|textplus_charts_non_utf8_v10.0.2.10b.zip]]
 
  
−
== Mod Change History ==
+
== Revision History ==
 +
(The most recent mod versions are at the ''top'' of this table.)
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
|-
 
|-
Line 173: Line 183:
 
! Note
 
! Note
 
|-
 
|-
−
| 10.1.0.12
+
| 10.1.0.13b
 +
| 10.1.0 - 11.0.1.2+
 +
| 5 Dec 2017
 +
| * The only meaningful functional enhancement is that, in the Descendant Text+ Chart, the counts in the summary at the bottom of the chart change as you collapse and expand tree branches. <br/>
 +
User interface changes:
 +
# The fontsize, page size, and indentation controls on the "Pretty-print" page are highlighted more clearly, and do not print on a printer.
 +
# Checkboxes on the innermenu now are shaded out when they are not applicable. Previously, they were hidden.
 +
Also:
 +
# The innermenu now has a button labeled 'Format for Printing' that is equivalent to the 'Pretty-Print' button, instead of just a reminder to use the TNG button.
 +
# Reworked the style classes that this mod defines in genstyle.css so that
 +
#* They have a prefix of "cg" and are less likely to affect other programs, and
 +
#* The rrnoprint class is no longer used - removing a dependency on Show Mod Names
 +
# Fixed the fan chart link in the innermenu
 +
# Removed the second line from cust_text.php target location search strings so that
 +
# Added a standalone program to remove or restore the old Text chart links in the innermenus of various programs.
 +
# Removed the mod-parameter that tried to hide the old Text chart link.
 +
# Rewrote the Help file, added several screen clips, and moved the screen clips to the language folder.
 +
# The DisplayModNames mod is now optional
 +
|-
 +
| [[Media:textplus_charts_v10.1.0.12.zip|10.1.0.12]]
 
| 10.1.2 - 11.0.1
 
| 10.1.2 - 11.0.1
 
| 15 Jun 2016
 
| 15 Jun 2016
−
| Added the system parameter that suppresses the link to the plain text charts, and the mod and its install programs now coordinate with the Ancestor Map and the Fan Chart.
+
| Added the system parameter that suppresses the link to the plain text charts, and the mod and its install programs now coordinate with the Ancestor Map and the Fan Chart.<br>
 +
French, Dutch, German, Norwegian UTF-8 translations:
 +
[[Media:textplus_charts_utf8_v10.1.0.12.zip|10.1.0.12.zip]]<br>
 +
French, Dutch, German, Norwegian ISO translations:
 +
[[Media:textplus_charts_non-utf_v10.1.0.12.zip|10.0.1.12]]
 +
|-
 +
| 11.0.0.11 [[Media:textplus_charts_v10.0.2.11.zip|download]]
 +
| 10.0.2 - 10.0.3
 +
| 17 Feb 2016
 +
|
 +
* Fixes a comment typo in css/genstyle.css
 +
* Registers the mod and displays mod names using the Display Mod Names v2 conventions. (Thus requires Show Mod Names) (The dependency was removed in subsequent versions)
 +
* Implements label tags and no-wrap styling to improve the wrapping of the Text+ menus.
 +
* Adds help links to affected fields on the Administration >> Setup >> Chart Settings form, (Thus uses Blue Info Button)(The dependency was removed in subsequent versions)
 
|-
 
|-
−
| Languages 10.0.2.10c
+
| Languages 10.0.2.10b
 
| 10.0.2 - 10.1.2
 
| 10.0.2 - 10.1.2
 
| 14 Sep 2015
 
| 14 Sep 2015
−
| Modified a few German, Dutch, and Norwegian strings that Google Translator messed up.
+
| Modified a few German, Dutch, and Norwegian strings that Google Translator messed up.<br>
 +
UTF-8 language strings [[Media:textplus_charts_utf8_v10.0.2.10b.zip|v10.0.2.10b.zip]]<br>
 +
ISO language strings [[Media:textplus_charts_non_utf8_v10.0.2.10b.zip|v10.0.2.10b.zip]]
 
|-
 
|-
 
| 10.1.0.10b &amp; 10.0.2.10b
 
| 10.1.0.10b &amp; 10.0.2.10b
Line 306: Line 350:
 
| [[User:Tngrlkrz|Ron Krzmarzick]]
 
| [[User:Tngrlkrz|Ron Krzmarzick]]
 
| Public & Private
 
| Public & Private
−
| 10.1.0.14 Beta
+
| 10.1.0.13b w/minor tab chgs
 
| 11.1.2
 
| 11.1.2
 
| EN,DE,CS,ES
 
| EN,DE,CS,ES

Revision as of 08:00, 28 January 2018

Construction I've discovered a minor bug in mod v13b. In both the Ancestor and Descendant Text+ Charts, you cannot select 'all' as the number of generations. Instead, you must select a number (perhaps the largest number in the selection box) that is sufficient to cover all generations. Construction


TextPlus Charts
Summary Two new charts: Text+ Descendant Chart, and Text+ Ancestor Chart.
Validation
Mod Updated 28 Dec 2017
Download link v10.1.0.13b
TNG 11.0
TNG 10.1.0
Language Strings:
French, Dutch, German, Norwegian UTF8 translations: utf8_v10.1.0.13
French, Dutch, German, Norwegian non-UTF translations: iso_v10.0.1.13
Zip file that includes all three .cfg files: v10.0.1.13b-all
See the Revision History for older versions of the mod.
Download stats
Author(s) Robin Richmond with translations by Henny Savenije, Hendrik Martius, Bernard Wortelboer, & Jan-Thore Solem, and testing help from Henny Savenije and Alan Wilcox
Homepage TextPlus Charts (This Page)
Mod Support My Mod Support form or TNG Community Forums
Contact Developer My Mod Support form
Latest Mod 10.1.0.13b
Min TNG V 10.1.0
Max TNG V 11.0.1.2+
Files modified
Updates admin_pedconfig.php,
Descendant charts (descend.php, descendtext.php, desctracker.php, register.php),
Pedigree charts (pedigree.php, pedigreetext.php, verticalchart.php, ahnentafel.php, extrastree.php),
tngrobots.php,
cust_text.php (English, Dutch, French, German, Norwegian),
css/genstyle.css
Installs: descendtextplus.php, pedigreetextplus.php, tngdblib_textplus.php, English/textplus_help.php, German-UTF8/textplus_help.php, extensions/textplusmenu.png, extensions/textplusinnermenu.png
Related Mods
Show Mod Names, Blue Info Button
Notes


Purpose of the Mod

To define two new charts - The Text+ Pedigree Chart (on the Pedigree inner menu), and the Text+ Descendant Chart (on the Descendant Charts inner menu). Both charts follow a text format (basically an outline layout), and are accessed through the TNG "Inner Menu" (the link menu just below the TNG Tab Bar) on the Person Profile and on Pedigree and Descendant chart pages.

Features of the Text+ Charts

  • The Text+ Descendant Chart is very similar to TNG's Text Descendant Chart, but has several additional features.
  • The Text+ Pedigree Chart serves the same purpose as TNG's Text Ancestor Chart, but does not use the standard 4-generations-per-page Pedigree format, and can display at least 15 or so generations in one chart that is one page wide and several pages long. It also has some of the same 'additional features' as the Text plus Descendant Chart.
  • Both charts draw lines to connect people with their children.
  • Both charts display places of birth and death instead of just dates.
  • Both charts display alternate birth date and/or place (i.e. christening date/place) when the birth date and/or place is missing.
  • Both charts display burial date and/or place when the death date and/or place is missing. (In doing so, they remove some cemetery names (by searching for "Cemetery,") from burial place names.)
  • For living people (when allowed by security constraints),both charts display the last known place of residence and the date of that residence event.
  • Both charts can (when the number of generations is set to zero) display ALL of a person's descendants or ancestors rather than a specific number of generations,
  • Both charts display a summary at the bottom of the chart, and
  • Both charts have parameters that control the size and spacing of the charts. Some parameters are available in what I'll refer to as the 'standard' TNG page view, and some parameters are available only in the TNG 'print-format' view.
  • Both charts allow the user to save the chart parameters to a cookie for use by subsequent charts (whether initiated by the "New Chart" link at the end of a line, or by selecting the chart from an inner menu on a profile page or another chart).

The Text+ Descendant Chart also:

  • Displays the date and place of marriage, and
  • Displays the starting person's parents, with date and place of birth and death.

And the Text+ Ancestor Chart:

  • Can (optionally) display the siblings of each ancestor, giving a richer view of the family tree, and
  • Can (optionally) display blank lines at certain points in the chart to improve readability.

Mod Options

The options offered by this mod are implemented through the TNG Admin >> Setup >> Chart Settings menu.

  1. To select the Text+ Pedigree Chart as the default chart to generate when you click the "Pedigree" tab in the Person Profile,
    • Select "Pedigree Chart" on the "Charts Settings" menu, and
    • Select "Text+" the "Initial Display drop-down box.
  2. To select the Text+ Descendant Chart as the default chart to generate when you click the "Descendant" tab in the Person Profile,
    • Select "Descendant Chart" on the "Charts Settings" menu, and
    • Select "Text+" the "Initial Display drop-down box.
  3. If you install the TextPlus Charts mod as well as other mods that install links on the TNG Inner Menu, the Inner Menu can become awkwardly long. To save space on Inner Menu by eliminating the original "Text" links:
    • Select "Common Elements" on the "Chart Settings" menu, and
    • Check the "Yes" button next to the new "Hide Plain Text Chart Links" option at the bottom of the Common Elements sub-form.

Compatibility With Other Mods

No known conflicts with published mods. However, there is a conflict with older versions of an Add New Items mod that was written by Ian Fettes.

This mod adds "Text+" links to the TNG "Inner Menu" of the Person Profile and distributed chart programs (the Pedigree Chart, Vertical Chart, Register Chart, etc). It coordinates with the Count Descendants, World Map, and Fan Chart mods so that

  1. In the Text+ Chart programs, links to the programs by those three mods will appear if and only if those programs are installed.
  2. In the programs installed by those three mods, a Text+ link will be displayed if the TextPlus Charts mod has been installed - no matter whether it was installed before or after the other mod.

However, some other mods also install chart programs that add links to the TNG "Inner Menu". Programs installed by those mods will not have Text+ links, and the Text+ Chart programs will not have links to those programs.

Related Mods

Starting with mod version 14, this mod does not require that Show Mod Names or Blue Info Button be installed. It does use the functionality of Show Mod Names if Show Mod Names is installed, but it does not depend on it.

Through mod version 12...
this this mod required that Show Mod Names and Blue Info Button be installed. (Well, the presence of those mods would not affect installation of this mod, but the Text Plus charts would generate a run-time warning if Show Mod Names were not installed, and buttona intended to look like a blue information icon would not be formatted properly Blue Info Button were not installed.

Visualizations

Text+ Descendant Chart - The "main" screen (as opposed to the "Format for Printing" screen)
  1. The "Text+" link is highlighted within the "Inner Menu" in this visualization. It is placed in the same position on other Descendant chart programs.
  2. This program extends the "Inner Menu" to add run-time options. The two options on the second line of the Inner Menu are available on the main screen and the Print Formatting screen.
  3. This program has a help file, like many administrative programs.
  4. Before you print a Text+ chart, you should generally use the "Format for Printing" button in the Innermenu to finalize the chart format.
  5. Note the abbreviations
    • "chr." to indicate that this is a christening date
    • "b." to indicate that this is the birth place
    • "bur" to indicate that this is the burial location.
  6. The vertical dotted line formed by colons connects spouses of one person
  7. The little minus signs allow you to collapse a branch of the family. The summary at the bottom of the page reports the number of people who have been hidden by collapsed branches.
  8. The hyperlinked arrows link to subsequent generations of descendants.
  9. A chart summary reports the number of people and generations in the chart, the number of people hidden in collapsed branches, and the number of lines that have been wrapped by program logic. Lines that wrap because they bump against the edge of the browser window cannot be counted. They also disrupt the flow of the chart. The "Format for Printing" screen has controls that help you avoid browser-driven line wrapping
Textplus charts-descend.png
Text+ Descendant Chart in the "Format for Printing" Window
  1. Here, the "Print" button actually prints. The options and buttons DO NOT print with the chart.
  2. The text size and width options are only available in the Print Format window.
  3. You must click "Submit" for the options to have an effect in this window.
  4. The "Save Settings" button saves a cookie with your current text and width options. (The "Hide data" and "Hide descendants" options do not get saved.)
  5. The "Hide data..." and "Hide descendants..." checkboxes and the Help button are still available.
  6. The Expand/Collapse controls are still operational in this window.
  7. The red arrow points to the Width option, which is "Portrait", meaning that the page is laid out in anticipation of being printed in Portrait orientation on regular 8.5 x 11 paper.
  8. Because of the "Portrait" width and the font size defined in the Chart Formatting Form, several lines in this chart are wrapped by the program. Three that have not been hidden are outlined.
  9. Among the distinctive features of the Text+ Descendant chart that were in the screenshot above, but were not mentioned there are
    • Double question marks to indicate that the date of death is "Unknown"
    • The word "alive" to indicate that the person is living, along with the most recent date and place from a Residence event.
  10. The visualization above referred to trimmed branches, but they were all in the portion of the page that was cut out of the screen clip. Here, you can see that little minus signs buttons have been changed to plus signs where branches have been trimmed.
  11. Another feature of the Text+ Descendant chart is that it reports marriage dates and places.
  12. The summary at the bottom of the chart reports that 5 visible lines have been wrapped by the program.
Textplus charts-descend2.png
Text+ Pedigree Chart
  • This chart was generated with the parameter Generations=all, so that all of the starting person's ancestors are shown.
  • Four checkboxes control the content of the report. Checkboxes that are not applicable are shown but are disabled - such as the "Sibling Count" checkbox, which only appears if both the 'Siblings' and the "Show Generation #'s" boxes are checked.
  • Note that, as with the Text+ Descendant Chart, the chart width for this screen is equivalent to a "Landscape" setting, and all seven generations can fit on the screen without any wrapping.
  • The summary footer reveals that the chart displayed seven generations.
Textplus charts-pedigree1.png
Text+ Pedigree Chart in the "Format for Printing" screen
  • This is the same chart as above.
  • The five print-formatting controls in the "Chart Formatting Form" are exactly the same as those in the Text+ Descendant chart.
  • The four content-control checkboxes in the "Chart Formatting Form" the same ones that are used in the "main" screen of the Text+ Ancestor chart. These four checkbox value are not saved to a cookie when the user clicks the "Save Settings" button. Only the print-formatting controls are saved.
  • The arrows point to places where the program has wrapped the text because the text reached the margin set by the program. Note that if we simply allowed the browser to wrap text, the text would wrap to the left margin, and interrupt the vertical lines.
Textplus charts-pedigree2.png
Full Pedigree Chart Examples saved as PDFs

(The charts were saved as PDF using Google Chrome's built-in Print-to-PDF capability.)

Text+ Pedigree Setup in the Admin >> Setup >> Chart Settings Form
Textplus charts-setup.png
This mod adds a "Text+" option to the "Initial Display" selection for Pedigree Chart and for Descendant chart. This allows you to set up the Text+ charts as your default Pedigree and/or Descendant charts.

Margins and Line-Wrapping

Because the Text+ charts draw lines connecting the generations, these charts cannot simply allow long lines of data to wrap at the browser window's (or printed page's) right margin. The Text+ chart programs have to know the window (or printed page's) width and the font size so that they can wrap lines of data at the appropriate point.

As a result, the Text+ chart programs contain a form with fields that specify printing parameters. Some parameters are visible in the 'main' program window. Other parameters that deal with font size and page width are visible only in the 'Format for Printing' window. Those parameters are described in detail in a help page associated with the Text+ chart programs.

(Author's note: Most web applications with such constraints would generate PDF files, which allow print characteristics to be controlled with more specificity, but I first wrote versions of the Text+ programs long before the PDF format became standard, and I've simply continued to use HTML with each new implementation.)

Installation

Requirements

  • A working TNG installation.
  • An installed current version of the Mod Manager.
  • You should backup files listed in the panel on the right.

Installation Steps

  1. Uninstall any previous versions 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, and extract its .cfg file and its subfolder to the mods folder.
  4. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files.

In the event of a problem

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

Reducing Line-wrapping

I have used the following techniques to reduce the amount of text required to display a person's data end place information, and thus reduce the amount of line-wrapping required to print these charts:

  • I use "??" instead of "Unknown"
  • If a person was born and died in the same place, I only display the place name once, like this:
    (Cleveland, Bradley, Tennessee, USA;15 Nov 1815 - 04 Jan 1887)
  • I also have use an unpublished mod that stores two shorter versions of place names (e.g. "Cleveland, Cuyahoga, OH" and "Cleveland, OH" for "Cleveland, Cuyahoga County, Ohio, USA". This scheme uses "place normalization" techniques to standardize the format of USA places, and then generates the shorter place names algorithmically. These mods affect several programs, such as the Person Profile and placesearch.php. If you're interested in trying to use this scheme, let me know, and I'll share the mods with you.

Remove an Innermenu Link

If you install the TextPlus Charts mod as well as other mods that place links on the Ancestors or Descendants Inner Menus, those Inner Menus can become awkwardly long. A utility program that eliminates the native Descendant and/or Ancestor Text chart is available through a link in the mod description in Mod Manager. Be aware, however, that, with TNGv11, the native Text Descendant chart has a new ancestor-tracking feature that is not found in the Text+ Descendant chart. The Text+ Descendant chart can count generations and children, but the native Text+ chart's ancestor-tracking feature conveys more information.

Revision History

(The most recent mod versions are at the top of this table.)

Mod Version TNG Versions Date Note
10.1.0.13b 10.1.0 - 11.0.1.2+ 5 Dec 2017 * The only meaningful functional enhancement is that, in the Descendant Text+ Chart, the counts in the summary at the bottom of the chart change as you collapse and expand tree branches.

User interface changes:

  1. The fontsize, page size, and indentation controls on the "Pretty-print" page are highlighted more clearly, and do not print on a printer.
  2. Checkboxes on the innermenu now are shaded out when they are not applicable. Previously, they were hidden.

Also:

  1. The innermenu now has a button labeled 'Format for Printing' that is equivalent to the 'Pretty-Print' button, instead of just a reminder to use the TNG button.
  2. Reworked the style classes that this mod defines in genstyle.css so that
    • They have a prefix of "cg" and are less likely to affect other programs, and
    • The rrnoprint class is no longer used - removing a dependency on Show Mod Names
  3. Fixed the fan chart link in the innermenu
  4. Removed the second line from cust_text.php target location search strings so that
  5. Added a standalone program to remove or restore the old Text chart links in the innermenus of various programs.
  6. Removed the mod-parameter that tried to hide the old Text chart link.
  7. Rewrote the Help file, added several screen clips, and moved the screen clips to the language folder.
  8. The DisplayModNames mod is now optional
10.1.0.12 10.1.2 - 11.0.1 15 Jun 2016 Added the system parameter that suppresses the link to the plain text charts, and the mod and its install programs now coordinate with the Ancestor Map and the Fan Chart.

French, Dutch, German, Norwegian UTF-8 translations: 10.1.0.12.zip
French, Dutch, German, Norwegian ISO translations: 10.0.1.12

11.0.0.11 download 10.0.2 - 10.0.3 17 Feb 2016
  • Fixes a comment typo in css/genstyle.css
  • Registers the mod and displays mod names using the Display Mod Names v2 conventions. (Thus requires Show Mod Names) (The dependency was removed in subsequent versions)
  • Implements label tags and no-wrap styling to improve the wrapping of the Text+ menus.
  • Adds help links to affected fields on the Administration >> Setup >> Chart Settings form, (Thus uses Blue Info Button)(The dependency was removed in subsequent versions)
Languages 10.0.2.10b 10.0.2 - 10.1.2 14 Sep 2015 Modified a few German, Dutch, and Norwegian strings that Google Translator messed up.

UTF-8 language strings v10.0.2.10b.zip
ISO language strings v10.0.2.10b.zip

10.1.0.10b & 10.0.2.10b 10.0.2 - 10.1.2 6 Sep 2015 Added annotation to make the Chart Formatting Form and help text easier to find and use, especially on the pretty-print page. Also fixed a bug that prevented non-English language installations from saving printer formatting settings to a cookie.
languages 10.0.2.8b 10.0.2 - 10.1.1 27 May 2015 New German translations.
10.0.2.10 & 10.1.0.10 10.0.2 - 10.1.1 25 May 2015 In the config file:
  • To avoid conflicts with a new mod from Eric Hoppe, changed a couple of target locations to put my Text+ innermenu link AFTER the text link instead of BEFORE the register link.

In descendtextplus.php and pedigreetextplus.php:

  • No longer changes the font family for the chart - uses the same font family and size as other charts
  • Removes an extra that could have affected the footer of some sites.

In descendtextplus.php:

  • Positions the conditional descendcount.php link after the PDF link, instead of before.
10.0.2.9 & 10.1.0.9 10.0.2 - 10.1.1 12 Apr 2015 Displays christening data if birth data is missing, and burial data if death data is missing.
10.0.2.8 & 10.1.0.8 10.0.2 - 10.1 3 Feb 2015
  • Added two content-control parameters to the Text+ Descendant program.
  • The Text+ content-control parameters are now on the "main" screen as well as the Pretty Print screen.
  • Added the two Text+ programs to tngrobots.php.
  • Minor user interface enhancements.
10.1.0.7 10.1 12 Jan 2015 Updated database function calls for TNG v10.1 compatibility.
10.0.2.7 10.0.2-10.0.3 10 Jan 2015 Moves the printer-configuration form to the "Pretty-Print" page so that users can view charts without having to fuss with the printer configuration settings.
10.0.2.6 10.0.2 12 Aug 2014 First production release

Sites using this mod

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

URL User Note Mod-Version TNG-Version User-language
Robin Richmond's Genealogy Database Robin Richmond Mod developer 10.1.0.12 11.0.1 English
Mitchell Families Online Roger Mitchell Another great tool for visitors, very well implemented! 10.1.0.8 10.1.0 English
Turner mob Margaret Grogan Turner Another great tool for visitors, thanks! 10.0.2.6 10.0.3 English
Hooley Family Links Rick Hooley Public Site 10.1.0.10a 10.1.1 EN
Wortelboer Genealogy Bernard Wortelboer Public site 10.1.0.10b 11.0.0 NL, EN
Solem Jan-Thore Solem Not public 10.1.0.7 10.1.0 Norwegian
Moss family tree Chris Moss Best text-based display. Public. 10.1.0.12a 11.1.2 EN, DE, FR
Brady Family Tree in Western Australia Darryl Brady Public site 10.1.0.12 11.0.1 EN, DE
Roots & Relatives Remembered Ron Krzmarzick Public & Private 10.1.0.13b w/minor tab chgs 11.1.2 EN,DE,CS,ES
Our Family Links Chuck Filteau Public site, modified Template 12 10.1.0.12 v10.1.2 EN
Retrieved from "https://tng.lythgoes.net/wiki/index.php?title=TextPlus_Charts&oldid=46946"