'''Experienced'''
5.069
redigeringer
Ændringer
ingen ændringskommentar
{{TNGver | ver=13.0 | notes = This article focuses on TextPlus Charts v13.0.0.17, for TNGv13. All earlier versions of the mod are described in and can be downloaded from [[TextPlus Charts pre-TNGv13]].}}
{{TNGver | ver=13.0 | notes = This article focuses on TextPlus Charts v13.0.0.17, for TNGv13. All earlier versions of the mod are described in and can be downloaded from the Wiki article[[TextPlus Charts pre-TNGv13]].}}
{{TNGmod
{{TNGmod
| mod_name = TextPlus Charts
| mod_name = TextPlus Charts
| mod_version = 13.0.0.17
| mod_version = 13.0.0.17
| min_TNG_ver = 13.0
| min_TNG_ver = 13.0
| max_TNG_ver = 13.?
| max_TNG_ver = 13.0.1
| TNG_file_list = '''Updates''' admin_pedconfig.php, admin_updatepedconfig.php,<br>
| TNG_file_list = '''Updates''' admin_pedconfig.php, admin_updatepedconfig.php, tngrobots.php, English & Dutch cust_text.php, plus<br>
Descendant charts (descend.php, descendtext.php, desctracker.php, register.php),<br>
Descendant charts (descend.php, descendtext.php, desctracker.php, register.php), and<br>
Pedigree charts (pedigree.php, pedigreetext.php, verticalchart.php, ahnentafel.php, extrastree.php),<br/> tngrobots.php, <br>
Pedigree charts (pedigree.php, pedigreetext.php, verticalchart.php, ahnentafel.php, extrastree.php),<br>
'''Installs:''' rrtextplus_descend.php, rrtextplus_ancestor.php, rrtextplus_lib.php, rrtextplus_help.php, js/rrtextplus_lib.js, css/rrtextplus.css, English textplus_help.php, plus several icons.
'''Installs:''' rrtextplus_descend.php, rrtextplus_ancestor.php, rrtextplus_lib.php, rrtextplus_help.php, js/rrtextplus_lib.js, css/rrtextplus.css, English textplus_help.php, plus several icons.
| related_mods = [[Count Descendants]], [[Inner Mod Menus]], [[Mod Settings Blocks]], [[TextPlus Charts-French]]
| related_mods = [[Count Descendants]], [[Inner Mod Menus]], [[Mod Settings Blocks]], [[TextPlus Charts-French]]
| notes = Instalsl Czech, Dutch, German, Norwegian, and Spanish translations. French translations require [[TextPlus Charts-French|a separate mod]]
| notes = Installs Czech, Dutch, German, Norwegian, and Spanish translations. French translations require [[TextPlus Charts-French|a separate mod]]
}}== Purpose of the Mod ==
}}== Purpose of the Mod ==
To define two new charts - the Text+ Ancestor Chart, and the Text+ Descendant Chart. Both charts follow a text format (basically an outline layout) but draw lines between parents and children. Links to these charts are placed on the TNG "Inner Menu" (the link menu just below the TNG Tab Bar) on the Person Profile and on Pedigree and Descendant chart pages, which contains the native links to the various types of Ancestor and Descendant charts.
To define two new charts - the Text+ Ancestor Chart, and the Text+ Descendant Chart. Both charts follow a text format (basically an outline layout) but draw lines between parents and children. Links to these charts are placed on the TNG "Inner Menu" (the link menu just below the TNG Tab Bar) on the Person Profile and on Pedigree and Descendant chart pages, which contains the native links to the various types of Ancestor and Descendant charts.
=== Mod Options ===
=== Mod Options ===
There are about 10 settings (depending on how you count them) in the TextPlus Charts "[[Mod Options Blocks|Mod Options Block]]" at '''Admin >> Setup >> Chart Settings >> Mod Options Blocks
There are about 10 settings (depending on how you count them) in the TextPlus Charts "[[Mod Settings Blocks|Mod Settings Block]]" at '''Admin >> Setup >> Chart Settings >> Mod Settings Blocks
[[Image:textplus17-msb.jpg]]
[[Image:textplus17-msb.jpg]]
=== Option Choices ===
=== Option Choices ===
This mod adds ''selection box options'' to two native fields in the options form at '''Admin>>Setup>>Chart Settings''':
This mod adds ''a choice'' to each of two native selection boxes in the options form at '''Admin>>Setup>>Chart Settings''':
# The option to select "Text+" has been added to the "Initial Display" field in the "Pedigree Chart" subform.
# The option to select "Text+" has been added to the "Initial Display" field in the "Pedigree Chart" subform.
# Similarly, the option to select "Text+" has been added to the "Initial Display" field in the "Descendancy Chart" subform,
# Similarly, the option to select "Text+" has been added to the "Initial Display" field in the "Descendancy Chart" subform,
=== Run-time Options ===
=== Run-time Options ===
These options are presented by the two Text+ Chart programs (in the "main" page), to change the charts dynamically, at, well, at run-time. The run-time options are illustrated and described in the [[#Visualizations|Visualizations]] below, and are described with additional detail in [https://www.robinrichmond.com/family/languages/English/rrtextplus_help.php the Text+ Charts help file].
These options are presented by the two Text+ Chart programs to change the charts dynamically, at, well, at run-time. The run-time options are illustrated and described in the [[#Visualizations|Visualizations]] below, and are described with additional detail in [https://www.robinrichmond.com/family/languages/English/rrtextplus_help.php the Text+ Charts help file].
=== Persistent Cookies ===
=== Persistent Cookies ===
<li>The '''Admin>>Setup>>Chart Settings''' form, where both mods add an option to the "Initial Display" selection box in the "Descendancy Chart" section of the Chart Settings form</li>
<li>The '''Admin>>Setup>>Chart Settings''' form, where both mods add an option to the "Initial Display" selection box in the "Descendancy Chart" section of the Chart Settings form</li>
</ol></li>
</ol></li>
<li>This mod coordinates with '''[[Ancestor map]]''' in that the Inner Menus of the TextPlus Charts and [[Ancestors map]] programs contain links to each other, but those links are visible only if the relevant mod is installed.</li>
<li>This mod coordinates with '''[[Ancestor map]]''' in that the Inner Menus of the TextPlus Charts and [[Ancestor map]] programs contain links to each other, but those links are visible only if the relevant mod is installed.</li>
</ol>
</ol>
=== Files Installed ===
=== Files Installed ===
<!---------------------- Files Installed Double Toggle --------------------->
<!-- --------------------- Files Installed Double Toggle ------------------- -->
<div class='mw-collapsible mw-collapsible-content mw-customtoggle-fi1 mw-customtoggle-fi2' id='mw-customcollapsible-fi1'>
<div class='mw-collapsible mw-collapsible-content mw-customtoggle-fi1 mw-customtoggle-fi2' id='mw-customcollapsible-fi1' style='text-decoration:underline;color:#0645ad;'>[See details ]</div>
<div class='mw-customtoggle--fi1 mw-customtoggle--fi2' style='text-decoration:underline;float:right;color:#0645ad;'>[Hide '''Files Installed''' ]</div>
<div class='mw-collapsible mw-collapsible-content mw-collapsed' id='mw-customcollapsible-fi2'>
<div class='mw-customtoggle-fi1 mw-customtoggle-fi2' style='text-decoration:underline;float:right;color:#0645ad;'>[Hide details ]</div>
* PHP
* PHP
*# '''rrtextplus_descend.php''' - The TextPlus Descendand Chart
*# '''rrtextplus_descend.php''' - The TextPlus Descendand Chart
*# '''img/rrtextplus_down.gif''' - Light down-arrow that implies a pull-down menu
*# '''img/rrtextplus_down.gif''' - Light down-arrow that implies a pull-down menu
*# '''img/rrtextplus_down_black.gif''' - Dark down-arrow for use in the b&w Format for Printing page
*# '''img/rrtextplus_down_black.gif''' - Dark down-arrow for use in the b&w Format for Printing page
<div class='mw-customtoggle--fi1 mw-customtoggle--fi2' style='text-decoration:underline;text-align:right;color:#0645ad;'>[Hide '''Files Installed''' ]</div>
<div class='mw-customtoggle-fi1 mw-customtoggle-fi2' style='text-decoration:underline;float:right;color:#0645ad;'>[Hide details ]</div>
</div> <!-- ---------------------End of Files Installed Double Toggle----------------- -->
</div> <!-- ---------------------End of Files Installed Double Toggle----------------- -->
=== Language Files ===
=== Language Files ===
This mod does not add the language strings used by TextPlus Charts programs to conventional cust_text.php files. Instead, they are loaded directly from files named '''{language}_custtext.php ''' in the <code>languages</code> subfolder within the mod subfolder. The mod's help files are also stored in the mod subfolder, and are not installed to the standard TNG "languages" folder. Most of the help files are not translated.
{{RobinBoilerplate |text=install}}
{{RobinBoilerplate |text=install}}
== Visualizations ==
== Visualizations ==
Some of these visualizations are marked up and annotated more thoroughly in the Text+ Charts help file, which can be found on [https://www.robinrichmond.com/family/languages/English/rrtextplus_help.php the mod author's TNG site]
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
# The chart control form, the Expand/Collapse controls at the top of the chart, the <<Print>> link at the top-right, and the popup copy of the chart summary are not printed to a printer.
# The chart control form, the Expand/Collapse controls at the top of the chart, the <<Print>> link at the top-right, and the popup copy of the chart summary are not printed to a printer.
# The plus sign next to "Anna Mary (Mamie) Kuykendall", which indicates that her descendants have been compressed out of the chart, is a carry-over from the chart in the main window. That is, if you compress tree branches in the main window, those branches remain compressed when you open the "Format for Printing" window.
# The plus sign next to "Anna Mary (Mamie) Kuykendall", which indicates that her descendants have been compressed out of the chart, is a carry-over from the chart in the main window. That is, if you compress tree branches in the main window, those branches remain compressed when you open the "Format for Printing" window.
# Note that the icons that link to other charts are still present in the Format for Printing page, but they should not print.
# The end-of-line icons that link to charts showing additional generations are still present in the Format for Printing page, but they are hidden when the page is printed..
<div class='mw-customtoggle-ap1 mw-customtoggle-ap2' style='text-decoration:underline;text-align:right;color:#0645ad;'>['''Close Text+Ancestor Chart Details''']</div>
<div class='mw-customtoggle-ap1 mw-customtoggle-ap2' style='text-decoration:underline;text-align:right;color:#0645ad;'>['''Close Text+Ancestor Chart Details''']</div>
</div> <!-- ================= End of Ancestor Chart double toggle ========== -->
</div> <!-- ================= End of Ancestor Chart double toggle ========== -->
|- style="border-top:3px solid black;" <-- ================================================== -->
|- style="border-top:3px solid black;" <-- ================================================== -->
| 3. <span style="color:brown;">''' Text+ Ancestor Chart'''</span><br>
| 3. <span style="color:brown;">''' Text+ Ancestor Chart'''</span>
|-
|-
| [[Image:textplus16_ancestor_main.jpg]]
| [[Image:textplus16_ancestor_main.jpg]]
|- style="border-top:3px solid black;" <-- ================================================== -->
|- style="border-top:3px solid black;" <-- ================================================== -->
| <div id='v16d'>4. '''<span style='color:brown;'>New features in mod version 16d</span>'''</div>These features are not necessarily visible in the screenshots above
| <div id='v16d'>4. '''<span style='color:brown;'>Details of some featues introduced with TextPlus Charts v16d</span>'''</div>These features are not necessarily visible in the screenshots above
<div class="mw-collapsible mw-customtoggle-16cv1 mw-customtoggle-16cv2" id='mw-customcollapsible-16cv1' style="text-decoration:underline;color:#0645ad;">[Show Details]</div>
<div class="mw-collapsible mw-customtoggle-16cv1 mw-customtoggle-16cv2" id='mw-customcollapsible-16cv1' style="text-decoration:underline;color:#0645ad;">[Show Details]</div>
<div class='mw-collapsible mw-collapsible-content mw-collapsed' id='mw-customcollapsible-16cv2' style="border:thin solid grey;"><!-- BEGIN TOGGLED CONTENT -->
<div class='mw-collapsible mw-collapsible-content mw-collapsed' id='mw-customcollapsible-16cv2' style="border:thin solid grey;"><!-- BEGIN TOGGLED CONTENT -->
|- style="border-top:3px solid black;" <-- ================================================== -->
|- style="border-top:3px solid black;" <-- ================================================== -->
| <div id='v17'>5. '''<span style='color:brown'>New features in mod version 17</span>'''</div>These features are not necessarily visible in the screenshots above
| <div id='v17'>5. '''<span style='color:brown'>New features in TextPlus Charts v17</span>'''</div>These features are not necessarily visible in the screenshots above
<div class="mw-collapsible mw-customtoggle-171 mw-customtoggle-172" id='mw-customcollapsible-171' style="text-decoration:underline;color:#0645ad;">[Show Details]</div>
<div class="mw-collapsible mw-customtoggle-171 mw-customtoggle-172" id='mw-customcollapsible-171' style="text-decoration:underline;color:#0645ad;">[Show Details]</div>
<div class='mw-collapsible mw-collapsible-content mw-collapsed' id='mw-customcollapsible-172' style="border:thin solid grey;"><!-- BEGIN TOGGLED CONTENT -->
<div class='mw-collapsible mw-collapsible-content mw-collapsed' id='mw-customcollapsible-172' style="border:thin solid grey;"><!-- BEGIN TOGGLED CONTENT -->
Note that
Note that
<ol type='i'><li>The details are not displayed as the page loads, as shown above, and can be re-hidden after being displayed.</li>
<ol type='i'><li>The details are not displayed as the page loads, as shown above, and can be re-hidden after being displayed.</li>
<li>Neither the "See details" nor "Omit details" (why didn't I used "hide"???) will print.
<li>The "See details" and "Omit details" hperlinks are not shown in print-outs, and</li>
<li>A mod option suppresses it altogether</li>
<li>A mod option suppresses it altogether</li>
</ol></li>
</ol></li>
<li>I copied the "Locate person in chart" feature from the native Descendant Text chart, and have modified it fairly significantly.
<li>I copied the "Locate person in chart" feature from the native Descendant Text chart, and have modified it fairly significantly.
<ul><li> I considered icons than other than the one used in the native descendant text chart, such as the spyglass shown here. But the production version of v17 uses the original icon.</li>
<ul><li>There is a new, much simpler popup. I find this small popup to be much more handy and understandable than the old one.<br>[[Image:textplus-locatedescendant.jpg]]<br>The "Graphical view of this family line" hyperlink links to the chart that the native descendant text chart links to directly. From my perspective, that chart is overkill in most situations.</li>
<li>There is a new, much simpler popup. I find this small popup to be much more handy and understandable than the old one.<br>[[Image:textplus-locatedescendant.jpg]]<br>The "Graphical view of this family line" hyperlink links to the chart that the native descendant text chart links to directly. From my perspective, that chart is overkill in most situations.</li>
<li>The new "locate in chart" popup has links to the person's ancestor and descendant charts. I tried to implement those two links directly in the Text+ Descendant chart, but they just added too much noise. I still hope to make them handier.</li>
<li>The new "locate in chart" popup has links to the person's ancestor and descendant charts. I tried to implement those two links directly in the Text+ Descendant chart, but they just added too much noise. I still hope to make them handier.</li>
</ul></li>
</ul></li>
<li>I added a very similar "locate person in chart" feature to the Ancestor chart<br>[[Image:textplus-locateancestor.jpg]]</li>
<li>I added a very similar "locate person in chart" feature to the Ancestor chart<br>[[Image:textplus-locateancestor.jpg]]</li>
<li>Both charts can have "floating footers" that hang out at the bottom of the web browser window so that they can always be seen. Both footers can be suppressed through mod options. I think that most admins will want to suppress the floating Text+ Ancestor chart footer, but the floating footing in the descendant chart provides useful dynamic information about the chart branches that can be hidden and re-exposed by tiny + and - icons in the chart.</li>
<li>Both charts can have "floating footers" that hang out at the bottom of the web browser window so that they can always be seen. Both footers can be suppressed through mod options, and can be closed when they are visible. I think that most admins will want to suppress the floating Text+ Ancestor chart footer, but the floating footer in the descendant chart provides useful dynamic information about the chart branches that can be hidden and re-exposed by tiny + and - icons in the chart.</li>
<li>The floating footers include an up-arrow icon that quickly sends the user back to the top of the chart. Darrin has implemented a larger up-arrow for that purpose in all pages ''in some templates''. So my up-arrow may not last forever, but at least it is visually compatible with new new TNG arrow.<br>[[Image:textplus17-summarydescendant.jpg]]</li>
<li>The floating footers include an up-arrow icon that quickly sends the user back to the top of the chart. Darrin has implemented a larger up-arrow for that purpose in all pages ''in some templates''. So my up-arrow may not last forever, but at least it is visually compatible with new new TNG arrow.<br>[[Image:textplus17-summarydescendant.jpg]]</li>
<li>The Inner Menu in the Text+ programs now always starts with the label "Chart Types" instead of the "Generations" selection box, which has been moved down to be with other chart formatting and content controls. By itself, the label "Chart Types" isn't very exciting, but it is enhanced by my new (unpublished as of this writing) "Chart Types Help" mod, which
<li>The Inner Menu in the Text+ programs now always starts with the label "Chart Types" instead of the "Generations" selection box, which has been moved down to be with other chart formatting and content controls. By itself, the label "Chart Types" isn't very exciting, but it is enhanced by my new (unpublished as of this writing) "Chart Types Help" mod, which
|- style="border-top:3px solid black;" <!-- ================================================== -->
|- style="border-top:3px solid black;" <!-- ================================================== -->
| 8. <span style="color:brown">'''The Text+ Charts [[Mod Settings Blocks|Mod Settings Block]] at Admin>>Setup>>Chart Settings'''</span><br>(with some screenshot annotation)
| 8. <span style="color:brown">'''The Text+ Charts [[Mod Settings Blocks|Mod Settings Block]] at Admin>>Setup>>Chart Settings'''</span>
|-
|-
| [[Image:textplus17-msb.jpg]]
| [[Image:textplus17-msb.jpg]]
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
! URL !! User !! Note !! Mod-Version !! TNG-Version !! User-language
! URL !! User !! Note !! Mod-Version !! TNG-Version !! User-language
|-
|-
| [http://www.robinrichmond.com/family/search.php?myfirstname=Clarence&mylastname=Richmond&mybirthyear=1895&tree=rr An example in Robin Richmond's Genealogy Database]
| [http://www.robinrichmond.com/family/search.php?myfirstname=Clarence&mylastname=Richmond&mybirthyear=1895&tree=rr An example in Robin Richmond's Genealogy Database]
| English
| English
|-
|-
| [https://www.kloosterman.be/genealogy/rrtextplus_ancestor.php?personID=I2162&tree=001&generations= Kloosterman Genealogy Example of Text+ Mod]
| [[Cees Kloosterman]]
| Public website
| 13.0.0.17
| 13.0
| English and Dutch
|}
|}
[[Category:Mods for TNG v13]]
[[Category:Mods for TNG v13]]
[[Category:extrastree.php mods]]
[[Category:extrastree.php mods]]
[[Category:tngrobots.php mods]]
[[Category:tngrobots.php mods]]
[[Category:cust_text.php English mods]]
[[Category:cust_text.php Dutch mods]]