Difference between revisions of "Scrollbox mod"

From TNG_Wiki
Jump to: navigation, search
(Sites using this mod)
(New support link)
 
(26 intermediate revisions by 6 users not shown)
Line 4: Line 4:
 
| mod_summary    = This mod creates a box adapted to the browser window, for ancestors and descendants tree diagrams, with scrollbars if nessecary to avoid scolling to the bottom of the <b><i>diagram</i></b> to find the horizontal scrollbar.
 
| mod_summary    = This mod creates a box adapted to the browser window, for ancestors and descendants tree diagrams, with scrollbars if nessecary to avoid scolling to the bottom of the <b><i>diagram</i></b> to find the horizontal scrollbar.
 
| mod_validation  = The mod is XHTML compliant.[[Image:Valid-xhtml10.png|44px]]
 
| mod_validation  = The mod is XHTML compliant.[[Image:Valid-xhtml10.png|44px]]
| download_link  = for {{Tv110}}<br/>
+
| mod_last_update = 16 Dec 2018
 +
| download_link  = for {{Tv1203}}
 +
[https://xerxx.se/modSupport/click/click.php?id=172&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} Scrollbox_v12.0.3.0.zip]
 +
<hr/>
 +
for {{Tv1201}}
 +
[https://xerxx.se/modSupport/click/click.php?id=142&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} Scrollbox_v12.0.1.0.zip]
 +
<hr/>
 +
for {{Tv120}}
 +
[https://xerxx.se/modSupport/click/click.php?id=115&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} Scrollbox_mod_v12.0.0.1.zip]
 +
<hr/>
 +
for {{Tv110}}
 
[https://xerxx.se/modSupport/click/click.php?id=105&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} Scrollbox_mod_v11.0.1.1.cfg.zip]<br/>
 
[https://xerxx.se/modSupport/click/click.php?id=105&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} Scrollbox_mod_v11.0.1.1.cfg.zip]<br/>
 
[https://xerxx.se/modSupport/click/click.php?id=106&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} Scrollbox_mod_v11.0.1.1.NT.cfg.zip]
 
[https://xerxx.se/modSupport/click/click.php?id=106&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} Scrollbox_mod_v11.0.1.1.NT.cfg.zip]
 
<hr/>
 
<hr/>
for {{Tv1013}}<br/>
+
for {{Tv1013}}
 
[https://xerxx.se/modSupport/click/click.php?id=74&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} Scrollbox_mod_v10.1.3.0.cfg.zip]<br/>
 
[https://xerxx.se/modSupport/click/click.php?id=74&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} Scrollbox_mod_v10.1.3.0.cfg.zip]<br/>
 
[https://xerxx.se/modSupport/click/click.php?id=75&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} Scrollbox_mod_v10.1.3.0.NT.cfg.zip]
 
[https://xerxx.se/modSupport/click/click.php?id=75&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} Scrollbox_mod_v10.1.3.0.NT.cfg.zip]
Line 14: Line 24:
 
| mod_author      = [[User:XerxX|Erik Hoppe]]
 
| mod_author      = [[User:XerxX|Erik Hoppe]]
 
| mod_url        = [[Scrollbox mod]] (this page)
 
| mod_url        = [[Scrollbox mod]] (this page)
| mod_support    = [https://xerxx.se/modSupport/index.php?mod=16 My Mod Support]
+
| mod_support    = [https://tng.community/index.php?/forums/forum/21-addons/ TNG Community Forums: TNG Specific - Code Discussion - Addons]
| mod_contact    = [https://xerxx.se/modSupport/index.php?mod=16 My Mod Support]
+
| mod_contact    =  
| mod_version    = 10.1.3.0 or 10.1.3.0.NT for TNG v10.1.3<br/>11.0.1.1 or 11.0.1.1.NT for TNG v11.0.1 and later
+
| mod_version    = 10.1.3.0 or 10.1.3.0.NT for TNG v10.1.3<br/>11.0.1.1 or 11.0.1.1.NT for TNG v11.0.1<br/>12.0.0.1 for TNG v12.0 (No Cust Templ)<br/>12.0.1.0 for TNG v12.0.1 and 12.0.2 (No Cust Templ)<br/>12.0.3.0 for TNG v12.0.3 (No Cust Templ)
 
| min_TNG_ver    = 10.1.3 (Tested so far)
 
| min_TNG_ver    = 10.1.3 (Tested so far)
| max_TNG_ver    = 11.0.2 (Tested in TNG v11.0.1)
+
| max_TNG_ver    = 12.0.3 (Tested in TNG v12.0 - '''No''' ''CT'' or ''NT'')
 
| TNG_file_list  = See [[Scrollbox_mod#TNG_Modules_Impacted|TNG Modules Impacted]]
 
| TNG_file_list  = See [[Scrollbox_mod#TNG_Modules_Impacted|TNG Modules Impacted]]
 
| notes          = Author of '''[https://xerxx.se/tcb TNG Colouring Book]'''<br/>Mods by me: [[User:XerxX|At my user page]].
 
| notes          = Author of '''[https://xerxx.se/tcb TNG Colouring Book]'''<br/>Mods by me: [[User:XerxX|At my user page]].
Line 25: Line 35:
 
| __TOC__
 
| __TOC__
 
|}
 
|}
 +
 
== Purpose of the mod ==
 
== Purpose of the mod ==
  
 
'''''This was a request from several of my users.'''''<br/><br/>
 
'''''This was a request from several of my users.'''''<br/><br/>
There are two versions:
+
There are two versions for '''TNG v10 - 11''':
* w/o suffix NT: For standard (#1 - #14/#15) and Custom templates
+
* w/o suffix NT: For standard (#1 - #14 / #15) and Custom templates
 
* NT for no Template
 
* NT for no Template
 +
 +
There is only ONE version (w/o suffix) for '''TNG v12''' - only standard templates #1 - #18!<br/>
 +
'''v12 NT and Custom templates may follow later.'''
  
 
Any of the pages that shows an ancestors or descendants diagram will, in high and wide diagrams, &quot;hide&quot; the horizontal scrollbar at the '''bottom of the diagram'''. These pages:<br/>
 
Any of the pages that shows an ancestors or descendants diagram will, in high and wide diagrams, &quot;hide&quot; the horizontal scrollbar at the '''bottom of the diagram'''. These pages:<br/>
''descend.php with 2 diagrams, pedigree.php with 4 diagrams, verticalchart.php, pedigreetext.php and desctracker.php with one diagram each.<br/><br/>
+
''descend.php with 2 diagrams, pedigree.php with 4 diagrams, verticalchart.php, pedigreetext.php, fan.php and desctracker.php with one diagram each.<br/><br/>
 
For many non-Mac users this is annoying as they often only have a vertical scrolling wheel. To scroll horizontally they have to use the scrollbar.
 
For many non-Mac users this is annoying as they often only have a vertical scrolling wheel. To scroll horizontally they have to use the scrollbar.
  
Line 63: Line 77:
 
When TNG detects anything but a ''Standard mode'' (i.e. it's displayed on a phone or a tablet) the '''TNG code is not modified''' at all.<br/>
 
When TNG detects anything but a ''Standard mode'' (i.e. it's displayed on a phone or a tablet) the '''TNG code is not modified''' at all.<br/>
 
The HTML source code that's generated is the TNG original so there is no mod in those cases. So there is no box.
 
The HTML source code that's generated is the TNG original so there is no mod in those cases. So there is no box.
 
 
 
== Maternal & Paternal Lines mod ==
 
 
If you use my [[Maternal_And_Paternal_Lines]] mod those pages will automatically be modified by the ''Scrollbox mod''.<br/>
 
If you want to install it you should install it '''BEFORE''' the ''Scrollbox mod''.<br/>
 
Also remember to Uninstall it '''after''' the ''Scrollbox mod''.
 
  
  
Line 79: Line 85:
  
  
== Template #15 (TNG v11) ==
+
== Template #15 (TNG v11 and above) ==
  
 
If you use template #15 you will find that it shows an extra horizontal scrollbar at the browser bottom, if the browser is between 1118 and 1244 pixels wide.<br/>
 
If you use template #15 you will find that it shows an extra horizontal scrollbar at the browser bottom, if the browser is between 1118 and 1244 pixels wide.<br/>
Line 90: Line 96:
 
This mod was developed by Erik Hoppe.<br/>A list of all my mods is found at [[User:XerxX|my user page]]
 
This mod was developed by Erik Hoppe.<br/>A list of all my mods is found at [[User:XerxX|my user page]]
  
 +
 +
== Mod Conflicts ==
 +
 +
<i><u>The below is added to all involved mods:</u></i><br/>
 +
Of <big><b>my mods</b></big>, some demand a special order to Install and Uninstall. This is one of them.<br/>
 +
Installing / Uninstalling in the wrong order may create chaos at a later stage.<br/>
 +
The mods may signal Okay to Install but nevertheless may not be.<br/><br/>
 +
 +
<b><big>Order to INSTALL:</big></b><br/>
 +
 +
All mods <b>below</b> the one you want to Install, must first be Uninstalled (if you use them).<br/>
 +
See the Uninstall order below. You can Install them after.<br/>
 +
#[[Maternal And Paternal Lines|Maternal And Paternal Lines]]
 +
#'''Scrollbox'''
 +
#'''''[[Public Access Control|Public Access Control]]'''''
 +
#'''''[[Forum for TNG|Forum for TNG]]'''''
 +
#'''''[[Fixed Family Tab|Fixed Family Tab]]'''''
 +
<br/>
 +
 +
<b><big>Order to UNINSTALL:</big></b><br/>
 +
All mods <b>above</b> the one you want to Uninstall, must first be Uninstalled (if you use them).<br/>
 +
You can Install them after. See the Install order above.<br/>
 +
 +
#'''''[[Fixed Family Tab|Fixed Family Tab]]'''''
 +
#'''''[[Forum for TNG|Forum for TNG]]'''''
 +
#'''''[[Public Access Control|Public Access Control]]'''''
 +
#'''Scrollbox'''
 +
#[[Maternal_And_Paternal_Lines|Maternal And Paternal Lines]]
 +
<br/>
 +
<b><big>Example:</big></b><br/>
 +
Suppose you use the ''Scrollbox'' and ''[[Fixed Family Tab|Fixed Family Tab]]'' mods.<br/>
 +
Now you want to install ''[[Maternal And Paternal Lines|Maternal And Paternal Lines]]''.<br/>
 +
As you can see in the ''Install Order'' both the used mods are ''below'' the ''[[Maternal And Paternal Lines|Maternal And Paternal Lines]]'' mod and therefore you must first Uninstall the mods in the Uninstall order:<br/>
 +
First Uninstall the ''[[Fixed Family Tab|Fixed Family Tab]]'' mod and then the ''Scrollbox'' mod.<br/>
 +
Now you can install all three mods in the Install order:<br/>
 +
First you Install ''[[Maternal And Paternal Lines|Maternal And Paternal Lines]]'', second the ''Scrollbox'' mod and finally ''[[Fixed Family Tab|Fixed Family Tab]]''.
  
  
Line 99: Line 141:
 
* A backup of all affected files (see the list below)
 
* A backup of all affected files (see the list below)
 
* An installed current version of the [[Mod Manager]] (is already included in TNG v10.x)
 
* An installed current version of the [[Mod Manager]] (is already included in TNG v10.x)
 +
 +
 +
 +
== Upgrade to v12 for TNG v12 ==
 +
 +
* Note your edited values in Template Settings before you restore them.
 +
* Read below about UN-installing the mod.
 +
* Install and "Create Scrollbox Template Database Settings" (read below).
 +
* Edit your values in Template Settings as you noted them, and Save.
  
  
Line 105: Line 156:
  
 
Select the correct version for your purposes:
 
Select the correct version for your purposes:
* Use '''.NT''' if you use '''''N'''''o '''''T'''''emplate.
+
* Use '''.NT''' if you use '''''N'''''o '''''T'''''emplate. (Only for '''v10.x and v11.x''')
* Otherwise use the version '''without .NT'''
+
* Otherwise use the version '''without .NT''' (For all versions: v10.x, 11.x and 12.x)
 
* Read below about UN-installing the mod.
 
* Read below about UN-installing the mod.
  
Line 114: Line 165:
  
 
# Click on the download link for your preferred version, shown in the summary in the upper  right corner of the page.
 
# Click on the download link for your preferred version, shown in the summary in the upper  right corner of the page.
# Un-zip the downloaded file. (If you find a folder: Don't bother - it's a Mac thing...)
+
# Un-zip the downloaded file.
 
# Move/copy/FTP the '''.cfg''' file  to the  '''mods''' folder of your TNG system.
 
# Move/copy/FTP the '''.cfg''' file  to the  '''mods''' folder of your TNG system.
 +
# (Only '''v12.x''' for TNG v12) Move/copy/FTP the '''Scrollbox_v12''' folder  to the  '''mods''' folder of your TNG system.
 
# Follow the normal automated installation for Mod Manager, as shown in the example [[Mod_Manager_-_Installing_Config_Files]] to install the mod.
 
# Follow the normal automated installation for Mod Manager, as shown in the example [[Mod_Manager_-_Installing_Config_Files]] to install the mod.
 
+
# (Only '''v12.x''' for TNG v12) Click the button "'''Create Scrollbox Template Database Settings'''" to add all values to the database.
  
  
Line 124: Line 176:
 
# 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.
 
# Replace all affected files with the copies you made before the installation.
 
# Replace all affected files with the copies you made before the installation.
# Contact me through [https://xerxx.se/modSupport/index.php?mod=16 My Mod Support].
+
# [https://tng.community/index.php?/forums/forum/21-addons/ TNG Community Forums: TNG Specific - Code Discussion - Addons]
  
  
Line 146: Line 198:
 
|-
 
|-
 
| valign="top" align="left" colspan="3"|[[File:scrollboxC.png]]
 
| valign="top" align="left" colspan="3"|[[File:scrollboxC.png]]
| valign="top" align="left"|The three editable parameters<br/>(Plus the default values: They are there for your convenience if you UNinstall - read below.)
+
| valign="top" align="left"|The three editable parameters<br/>Plus the default values ('''not in v12'''): They are there for your convenience if you UNinstall - read below.
 
|-
 
|-
 
| valign="top"|Space below Horiz. scroll
 
| valign="top"|Space below Horiz. scroll
Line 170: Line 222:
 
== Template default values ==
 
== Template default values ==
  
These values are also found in your ''Template settings''.
+
These values are also found in your ''Template settings'' (v10.x and v11.x).
 
<p>
 
<p>
A = Space below the Horizontal scrollbar.<br/>
+
A = Space below the Horizontal scrollbar. Database field: <span style="color:red;"><b>sbMarginBottom</b></span><br/>
B = Space to the right of the Vertical scrollbar.<br/>
+
B = Space to the right of the Vertical scrollbar. Database field: <span style="color:red;"><b>sbVbarSpace</b></span><br/>
C = Reserved height for Footer (and above box)
+
C = Reserved height for Footer (and above box). Database field: <span style="color:red;"><b>sbFooterHeight</b></span>
 
</p>
 
</p>
 
* No template: A: 16, B: 54, C: 156 (Stored in customconfig.php)
 
* No template: A: 16, B: 54, C: 156 (Stored in customconfig.php)
 
* Custom template: A: 16, B: 54, C: 156
 
* Custom template: A: 16, B: 54, C: 156
* TNG templates #1 - #15:
+
* TNG templates #1 - #18:
 
# A: 16, B: 54, C: 156
 
# A: 16, B: 54, C: 156
 
# A: -6, B: 54, C: 164
 
# A: -6, B: 54, C: 164
Line 194: Line 246:
 
# A: 0, B: 64, C: 168
 
# A: 0, B: 64, C: 168
 
# A: 0, B: 24, C: 134
 
# A: 0, B: 24, C: 134
 +
# A: 16, B: 48, C: 188
 +
# A: 0, B: 74, C: 154
 +
# A: 0, B: 74, C: 154
  
 
<span style="color:red;">'''*'''</span>) Template #5: Depending on outer margins and browser window width, may affect page width.
 
<span style="color:red;">'''*'''</span>) Template #5: Depending on outer margins and browser window width, may affect page width.
Line 201: Line 256:
 
== Custom Text Additions ==  
 
== Custom Text Additions ==  
  
The config file includes the English language custom text.<br />There is a Swedish translation if it is present in your TNG system.<br/>For other languages you can modify the config file to add the custom text or manually add to whatever language you like.<br/>
+
The config file includes the English language custom text.<br />There are Swedish and French translations if present in your TNG system.<br/>For other languages you can modify the config file to add the custom text or manually add to whatever language you like.<br/>
  
 
'''English custom text For Reference Only!'''<br />
 
'''English custom text For Reference Only!'''<br />
 +
{{TNG 12.0|and after}}
 +
<syntaxhighlight lang="php" enclose="div">
 +
/* Start ScrollboxMod v12.0.0.1 m1 */
  
<pre>
+
$admtext['sbMarginBottom'] = "Space below Hor Scroll (also -)";
 +
$admtext['sbVbarSpace'] = "Space to right o Ver Scroll (&gt;=0)";
 +
$admtext['sbFooterHeight'] = "Reserved vert. space (also -)";
 +
$admtext['xerxxScrollnote'] = "Notes: You may have to scroll down or right to see the chart.";
 +
 
 +
/* End ScrollboxMod v12.0.0.1 m1 */
 +
</syntaxhighlight>
 +
 
 +
{{TNG 11.1.2|and before}}
 +
<syntaxhighlight lang="php" enclose="div">
  
 
$admtext['xerxxMarginBottom'] = "Space below H Scroll (also -)";
 
$admtext['xerxxMarginBottom'] = "Space below H Scroll (also -)";
 
$admtext['xerxxVbarSpace'] = "Space to right o V Scroll (&gt;=0)";
 
$admtext['xerxxVbarSpace'] = "Space to right o V Scroll (&gt;=0)";
 
$admtext['xerxxFooterHeight'] = "Reserved vert. space (also -)";
 
$admtext['xerxxFooterHeight'] = "Reserved vert. space (also -)";
$admtext['xerxxDefaults'] = "Default values (keep)";
+
$admtext['xerxxDefaults'] = "Default values (keep)"; // Only v10.x and v11.x
 
$admtext['xerxxScrollnote'] = "Notes: You may have to scroll down or right to see the chart.";
 
$admtext['xerxxScrollnote'] = "Notes: You may have to scroll down or right to see the chart.";
  
</pre>
+
</syntaxhighlight>
 
 
 
 
  
 
==<span style="color:red; background-color:yellow;"> UN-installing the mod: IMPORTANT! </span>==
 
==<span style="color:red; background-color:yellow;"> UN-installing the mod: IMPORTANT! </span>==
  
'''.NT''' users uninstall the normal way (click the button).<br/>
+
'''.NT''' and '''all v12.x''' users uninstall the normal way (click the button).<br/>
 
'''All other''' users who have '''NOT saved''' any altered template setting, uninstall the normal way (click the button).<br/><br/>
 
'''All other''' users who have '''NOT saved''' any altered template setting, uninstall the normal way (click the button).<br/><br/>
 
'''All other''' users who '''HAVE saved''' any altered template setting, will find that the mod cannot be uninstalled.<br/>
 
'''All other''' users who '''HAVE saved''' any altered template setting, will find that the mod cannot be uninstalled.<br/>
Line 234: Line 299:
 
# Use the '''ModManager ''Clean Up''''' button and the mod will be uninstalled.
 
# Use the '''ModManager ''Clean Up''''' button and the mod will be uninstalled.
 
<br/>
 
<br/>
'''Standard template users''':
+
'''Standard template users''' - v10.x and v11.x:
 
# Open up your Template settings.
 
# Open up your Template settings.
 
# Restore all edited values to the '''default'''.
 
# Restore all edited values to the '''default'''.
Line 241: Line 306:
 
<br/>
 
<br/>
 
If you want to completely '''Remove''' (uninstall) this mod and all its tables, you should  
 
If you want to completely '''Remove''' (uninstall) this mod and all its tables, you should  
# Click the '''Uninstall''' button to uninstall the mod and then
+
# Uninstall the mod as descibed above and then
# Click the '''Delete''' button to delete the config file from the mods folder.
+
# (v12.x only) Click the '''Remove Scrollbox Template Database Settings''' and wait for confirmation
 +
# Click the '''Delete''' button to delete the config file from the mods folder
  
  
Line 253: Line 319:
 
! Date
 
! Date
 
! Description
 
! Description
 +
|-
 +
| V12.0.3.0
 +
| 16 Dec 2018
 +
| New version for TNG v12.0.3 standard templates 1 - 18. Fan chart gave "Bad target".
 +
|-
 +
| V12.0.1.0
 +
| 28 June 2018
 +
| New version for TNG v12.0.1 standard templates 1 - 18. Thanks to Ron for the alert.
 +
|-
 +
| V12.0.0.1
 +
| 8 May 2018
 +
| New version for TNG v12 standard templates 1 - 18. Thanks to Ken for Suggestions!<br/>Remember to read UNINSTALL instructions!
 
|-
 
|-
 
| V11.0.1.1<br/>V11.0.1.1.NT
 
| V11.0.1.1<br/>V11.0.1.1.NT
Line 315: Line 393:
 
| [https://www.kmtrees.com Roots & Relatives Remembered]
 
| [https://www.kmtrees.com Roots & Relatives Remembered]
 
| [[User:Tngrlkrz|Ron Krzmarzick]]
 
| [[User:Tngrlkrz|Ron Krzmarzick]]
| Public & Private (added 7 templates)
+
| Public & Private
| 11.0.1.1
+
| 12.0.3.0
| 11.1.2
+
| [https://kmtrees.com/modlist_wiki?whichoptions=basic&cachemethod=3&sortby=filename See Here]
 
| EN,DE,CS,ES
 
| EN,DE,CS,ES
 
|-
 
|-
Line 334: Line 412:
 
| SE, GB, DE , DK, NO, ES, FR,NL
 
| SE, GB, DE , DK, NO, ES, FR,NL
 
|-
 
|-
[http://racine-ad.fr/TNG/index.php racine d'Alsace]
+
| [http://racine-ad.fr/TNG/index.php racine d'Alsace]
 
| J-Louis Valory
 
| J-Louis Valory
| Public/Private - Template 1
+
| Public/Private - Template 17
| 10.1.0.7/11.1.1
+
| 12.0.1.0
| French
+
| 12.0.1
 +
| French
 +
|-
 +
| [http://www.akerman.me/tng/ tobbes familje sidor]
 +
| Torbjörn Åkerman
 +
| Public site
 +
| 11.0.1.1
 +
| 11.1.2
 +
| SE, EN, FI
 +
|-
 +
| [http://colegenealogy.dynu.net/ Cole / Tanner Family Tree]
 +
| [[User:dlcole|David Cole]]
 +
| Public/Private
 +
| [[User:Dlcole|see here]]
 +
| [[User:Dlcole|see here]]
 +
| English
 +
 
 
|}
 
|}
  
Line 350: Line 444:
 
* pedigree.php
 
* pedigree.php
 
* pedigreetext.php
 
* pedigreetext.php
* templateconfig.php (not vers '''.NT''')
+
* templateconfig.php (not vers '''.NT''' or '''v12.x''')
 
* verticalchart.php
 
* verticalchart.php
 
* js/tngpedigree.js
 
* js/tngpedigree.js
Line 362: Line 456:
 
* languages/English/cust_text.php
 
* languages/English/cust_text.php
 
* languages/English-UTF8/cust_text.php
 
* languages/English-UTF8/cust_text.php
 +
* languages/French/cust_text.php - if present
 +
* languages/French-UTF8/cust_text.php - if present
 
* languages/Swedish/cust_text.php - if present
 
* languages/Swedish/cust_text.php - if present
 
* languages/Swedish-UTF8/cust_text.php - if present
 
* languages/Swedish-UTF8/cust_text.php - if present
Line 368: Line 464:
 
[[Category:Mods for TNG v10]]
 
[[Category:Mods for TNG v10]]
 
[[Category:Mods for TNG v11]]
 
[[Category:Mods for TNG v11]]
 +
[[Category:Mods for TNG v12]]
  
 
[[Category:descend.php mods]]
 
[[Category:descend.php mods]]

Latest revision as of 15:50, 13 January 2019

Restricted Downloads of Scrollbox mod are restricted to logged in users. If you do not have a user account on the TNG Wiki use the Request Account link to request a user account Restricted


Scrollbox mod
Summary This mod creates a box adapted to the browser window, for ancestors and descendants tree diagrams, with scrollbars if nessecary to avoid scolling to the bottom of the diagram to find the horizontal scrollbar.
Validation The mod is XHTML compliant.Valid-xhtml10.png
Mod Updated 16 Dec 2018
Download link for
TNG 12.0.3

Scrollbox_v12.0.3.0.zip


for

TNG 12.0.1

Scrollbox_v12.0.1.0.zip


for

TNG 12.0

Scrollbox_mod_v12.0.0.1.zip


for

TNG 11.0

Scrollbox_mod_v11.0.1.1.cfg.zip
Scrollbox_mod_v11.0.1.1.NT.cfg.zip


for

TNG 10.1.3

Scrollbox_mod_v10.1.3.0.cfg.zip

Scrollbox_mod_v10.1.3.0.NT.cfg.zip
Download stats Click here for stats
Author(s) Erik Hoppe
Homepage Scrollbox mod (this page)
Mod Support TNG Community Forums: TNG Specific - Code Discussion - Addons
Contact Developer
Latest Mod 10.1.3.0 or 10.1.3.0.NT for TNG v10.1.3
11.0.1.1 or 11.0.1.1.NT for TNG v11.0.1
12.0.0.1 for TNG v12.0 (No Cust Templ)
12.0.1.0 for TNG v12.0.1 and 12.0.2 (No Cust Templ)
12.0.3.0 for TNG v12.0.3 (No Cust Templ)
Min TNG V 10.1.3 (Tested so far)
Max TNG V 12.0.3 (Tested in TNG v12.0 - No CT or NT)
Files modified
Related Mods
{{{related_mods}}}
Notes
Author of TNG Colouring Book
Mods by me: At my user page.


Purpose of the mod

This was a request from several of my users.

There are two versions for TNG v10 - 11:

  • w/o suffix NT: For standard (#1 - #14 / #15) and Custom templates
  • NT for no Template

There is only ONE version (w/o suffix) for TNG v12 - only standard templates #1 - #18!
v12 NT and Custom templates may follow later.

Any of the pages that shows an ancestors or descendants diagram will, in high and wide diagrams, "hide" the horizontal scrollbar at the bottom of the diagram. These pages:
descend.php with 2 diagrams, pedigree.php with 4 diagrams, verticalchart.php, pedigreetext.php, fan.php and desctracker.php with one diagram each.

For many non-Mac users this is annoying as they often only have a vertical scrolling wheel. To scroll horizontally they have to use the scrollbar.

A very wide and high tree...
Note the size of the scrollbar handle.

Suppose you want to look at some person at the top and to the far right...

ScrollboxA1.png
Scroll to the bottom to find the
horizontal scrollbar...
Scroll to the right,,, And finally all the way up.
ScrollboxA2.png ScrollboxA3.png ScrollboxA4.png

This is not very user friendly.

This mod creates a box, adapted to the browser window, displaying the diagram and if necessary will add scrollbars.
As the scrollbars are connected to the box, not to the page, they are always visible and at hand if needed.
See below for screenshots of this.

If you like to change the browser size to see what happens with the lay-out f.ex, you have to re-load the page as the box does not dynamically adjust to that.


Mobile / Tablet mode

When TNG detects anything but a Standard mode (i.e. it's displayed on a phone or a tablet) the TNG code is not modified at all.
The HTML source code that's generated is the TNG original so there is no mod in those cases. So there is no box.


Descendtree Counter mod

If you use my Descendtree Counter mod, the Scrollbox mod will automatically reserve space for the text.
There are no requirements for the order to install or uninstall the mods.


Template #15 (TNG v11 and above)

If you use template #15 you will find that it shows an extra horizontal scrollbar at the browser bottom, if the browser is between 1118 and 1244 pixels wide.
This is annoying but is not caused by the Scrollbox mod. The mod reserves the space for that scrollbar when it's visible.
Also: This template doesn't scroll to show the Footer as it's way too high.


Developer

This mod was developed by Erik Hoppe.
A list of all my mods is found at my user page


Mod Conflicts

The below is added to all involved mods:
Of my mods, some demand a special order to Install and Uninstall. This is one of them.
Installing / Uninstalling in the wrong order may create chaos at a later stage.
The mods may signal Okay to Install but nevertheless may not be.

Order to INSTALL:

All mods below the one you want to Install, must first be Uninstalled (if you use them).
See the Uninstall order below. You can Install them after.

  1. Maternal And Paternal Lines
  2. Scrollbox
  3. Public Access Control
  4. Forum for TNG
  5. Fixed Family Tab


Order to UNINSTALL:
All mods above the one you want to Uninstall, must first be Uninstalled (if you use them).
You can Install them after. See the Install order above.

  1. Fixed Family Tab
  2. Forum for TNG
  3. Public Access Control
  4. Scrollbox
  5. Maternal And Paternal Lines


Example:
Suppose you use the Scrollbox and Fixed Family Tab mods.
Now you want to install Maternal And Paternal Lines.
As you can see in the Install Order both the used mods are below the Maternal And Paternal Lines mod and therefore you must first Uninstall the mods in the Uninstall order:
First Uninstall the Fixed Family Tab mod and then the Scrollbox mod.
Now you can install all three mods in the Install order:
First you Install Maternal And Paternal Lines, second the Scrollbox mod and finally Fixed Family Tab.


Requirements

TNG version: 10.1.3
  • A working TNG installation.
  • A backup of all affected files (see the list below)
  • An installed current version of the Mod Manager (is already included in TNG v10.x)


Upgrade to v12 for TNG v12

  • Note your edited values in Template Settings before you restore them.
  • Read below about UN-installing the mod.
  • Install and "Create Scrollbox Template Database Settings" (read below).
  • Edit your values in Template Settings as you noted them, and Save.


Before installation

Select the correct version for your purposes:

  • Use .NT if you use No Template. (Only for v10.x and v11.x)
  • Otherwise use the version without .NT (For all versions: v10.x, 11.x and 12.x)
  • Read below about UN-installing the mod.


Installation

  1. Click on the download link for your preferred version, shown in the summary in the upper right corner of the page.
  2. Un-zip the downloaded file.
  3. Move/copy/FTP the .cfg file to the mods folder of your TNG system.
  4. (Only v12.x for TNG v12) Move/copy/FTP the Scrollbox_v12 folder to the mods folder of your TNG system.
  5. Follow the normal automated installation for Mod Manager, as shown in the example Mod_Manager_-_Installing_Config_Files to install the mod.
  6. (Only v12.x for TNG v12) Click the button "Create Scrollbox Template Database Settings" to add all values to the database.


In the event of a problem

  1. Try using the Mod Manager Remove capability.
  2. Replace all affected files with the copies you made before the installation.
  3. TNG Community Forums: TNG Specific - Code Discussion - Addons


After installation

Important note to Custom Template users:
The install is not complete unless you enter the number/name of your template folder(s) in the Mod Manager Edit Options.
(No default value in these versions!)


Edit parameters

Three parameters can be edited to allow for the box to adapt to your template modifications or desires.*

  • The amount of space below the Horizontal scrollbar.
  • The amount of space to the right of the Vertical scrollbar**.
  • Reserved height for the Footer (and more if you want, above the box).


NOTE!

  • .NT users edit the values in the Mod Manager Edit Options.
  • All other users edit the values in Admin >> Setup >> Template settings.
ScrollboxC.png The three editable parameters
Plus the default values (not in v12): They are there for your convenience if you UNinstall - read below.
Space below Horiz. scroll Space right of Vert. scroll Height of Footer (and more if you want, above the box)
ScrollboxD2.png ScrollboxD1.png ScrollboxE1.png ScrollboxE2.png
High values = Push box up
Low values = Push box down
Use any value, also negative.
High values = Move scroll left
Low values = Move scroll right
Use 0 or above.
High values = Show more page contents
Low values = Show less page contents
When there's enough space for the Footer, the rest is reserved above the box.
Use any value, also negative.
The default for all templates when the page is scrolled to the bottom, is to show the Footer and the tabs.
Also to include the message "(Note: You may have to scroll..." to all pages (also to pages that haven't got it originally)
See below for screenshots.

*) Some settings may not work in some Custom Templates.
**) Template #5: Depending on outer margins and browser window width, may also affect page width.


Template default values

These values are also found in your Template settings (v10.x and v11.x).

A = Space below the Horizontal scrollbar. Database field: sbMarginBottom
B = Space to the right of the Vertical scrollbar. Database field: sbVbarSpace
C = Reserved height for Footer (and above box). Database field: sbFooterHeight

  • No template: A: 16, B: 54, C: 156 (Stored in customconfig.php)
  • Custom template: A: 16, B: 54, C: 156
  • TNG templates #1 - #18:
  1. A: 16, B: 54, C: 156
  2. A: -6, B: 54, C: 164
  3. A: 16, B: 54, C: 156
  4. A: 16, B: 138 C: 152
  5. A: 8, B*: 72, C: 238
  6. A: -6, B: 52, C: 152
  7. A: 16, B: 132, C: 168
  8. A: 4, B: 72, C: 136
  9. A: 4, B: 54, C: 200
  10. A: 4, B: 76, C: 200
  11. A: -6, B: 54, C: 188
  12. A: 4, B: 88, C: 164
  13. A: -6, B: 62, C: 200
  14. A: 0, B: 64, C: 168
  15. A: 0, B: 24, C: 134
  16. A: 16, B: 48, C: 188
  17. A: 0, B: 74, C: 154
  18. A: 0, B: 74, C: 154

*) Template #5: Depending on outer margins and browser window width, may affect page width.


Custom Text Additions

The config file includes the English language custom text.
There are Swedish and French translations if present in your TNG system.
For other languages you can modify the config file to add the custom text or manually add to whatever language you like.

English custom text For Reference Only!

TNG version: 12.0.0
/* Start ScrollboxMod v12.0.0.1 m1 */

$admtext['sbMarginBottom'] = "Space below Hor Scroll (also -)";
$admtext['sbVbarSpace'] = "Space to right o Ver Scroll (&gt;=0)";
$admtext['sbFooterHeight'] = "Reserved vert. space (also -)";
$admtext['xerxxScrollnote'] = "Notes: You may have to scroll down or right to see the chart.";

/* End ScrollboxMod v12.0.0.1 m1 */


TNG version: 11.1.2
$admtext['xerxxMarginBottom'] = "Space below H Scroll (also -)";
$admtext['xerxxVbarSpace'] = "Space to right o V Scroll (&gt;=0)";
$admtext['xerxxFooterHeight'] = "Reserved vert. space (also -)";
$admtext['xerxxDefaults'] = "Default values (keep)"; // Only v10.x and v11.x
$admtext['xerxxScrollnote'] = "Notes: You may have to scroll down or right to see the chart.";

UN-installing the mod: IMPORTANT!

.NT and all v12.x users uninstall the normal way (click the button).
All other users who have NOT saved any altered template setting, uninstall the normal way (click the button).

All other users who HAVE saved any altered template setting, will find that the mod cannot be uninstalled.
ModManager says Partially installed. This is because TNG has overwritten templateconfig.php so MM doesn't recognize the modification.

Custom template users:

  • If you have edited any value except for your Custom Template(s):
  1. Open up your Template settings.
  2. Restore all edited values to the default.
  3. Save the settings.
  • In all cases:
  1. Open the file templateconfig.php.
  2. Delete all lines with variables having names that contain xerxx AND the name of your Custom template(s).
    There are four such lines for each custom template, last among each template's other variables.
  3. Save the file.
  4. Use the ModManager Clean Up button and the mod will be uninstalled.


Standard template users - v10.x and v11.x:

  1. Open up your Template settings.
  2. Restore all edited values to the default.
  3. Save the settings.
  4. Open up Mod Manager and the mod can be uninstalled.


If you want to completely Remove (uninstall) this mod and all its tables, you should

  1. Uninstall the mod as descibed above and then
  2. (v12.x only) Click the Remove Scrollbox Template Database Settings and wait for confirmation
  3. Click the Delete button to delete the config file from the mods folder


Revision History

Version Date Description
V12.0.3.0 16 Dec 2018 New version for TNG v12.0.3 standard templates 1 - 18. Fan chart gave "Bad target".
V12.0.1.0 28 June 2018 New version for TNG v12.0.1 standard templates 1 - 18. Thanks to Ron for the alert.
V12.0.0.1 8 May 2018 New version for TNG v12 standard templates 1 - 18. Thanks to Ken for Suggestions!
Remember to read UNINSTALL instructions!
V11.0.1.1
V11.0.1.1.NT
10 Nov 2017 The fan chart (fan.php) is included. Remember to read UNINSTALL instructions!
V10.1.3.0
V11.0.1.0
16 Sept 2016 Slow Scrolling will leave the Tabs visible. Maternal & Paternal lines mod pages are modified if present. Reserves space for Descendtree Counter mod text (if present).
V10.1.3.Beta3
V11.0.1.Beta3
10 July 2016 Verticalchart.php showed no border. Corrected.
All affected pages now auto-scroll to bottom to show the full box. Thanks to Ron for the tip.
V10.1.3.Beta2b
V11.0.1.Beta2b
8 July 2016 Bad target for CT and ST versions. Corrected.
V10.1.3.Beta2
V11.0.1.Beta2
8 July 2016 Introduction.
Six versions made: For Standard (and customized), Custom and No templates.
Looking for beta testers...


Visualization of this mod

The page in these screenshots: xerxx.se - Andersson, Hoppe, Sahlin, Thorell
The size of this browser window is approximately 1200 x 900 pixels.

NOTE! The mod now lets the TABS VISIBLE when scrolled to the bottom. Not so in these screenshots.

Page auto-scrolled to the bottom:
Box height is adapted to the browser window.
Top of page:
Note the size of the page (rightmost) scrollbar handle.
ScrollboxB2.png ScrollboxB1.png


Sites using this mod

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

URL User Note Mod-Version TNG-Version User-language
Andersson, Hoppe, Sahlin, Thorell Erik Hoppe Mod author 11.0.1.1 11.1.2 SE, GB, DE
Roots & Relatives Remembered Ron Krzmarzick Public & Private 12.0.3.0 See Here EN,DE,CS,ES
Our Family Links Chuck Filteau Public site, modified Template 12 v10.1.3.0 v10.1.2 EN
www.blumensaadt-ingemand.dk Ingemand Great mod 11.0.1.0 11.0.2 SE, GB, DE , DK, NO, ES, FR,NL
racine d'Alsace J-Louis Valory Public/Private - Template 17 12.0.1.0 12.0.1 French
tobbes familje sidor Torbjörn Åkerman Public site 11.0.1.1 11.1.2 SE, EN, FI
Cole / Tanner Family Tree David Cole Public/Private see here see here English

TNG Modules Impacted

The following TNG Modules are modified, and should be backed up prior to installing this mod:

  • customconfig.php (only vers .NT)
  • descend.php
  • desctracker.php
  • fan.php
  • pedigree.php
  • pedigreetext.php
  • templateconfig.php (not vers .NT or v12.x)
  • verticalchart.php
  • js/tngpedigree.js
  • xerxxFamilyMaternalLine.php - if present
  • xerxxFamilyPaternalLine.php - if present
  • xerxxIndividMaternalLine.php - if present
  • xerxxIndividPaternalLine.php - if present


The custom texts will be added to these files, which should also be backed up prior to installing this mod:

  • languages/English/cust_text.php
  • languages/English-UTF8/cust_text.php
  • languages/French/cust_text.php - if present
  • languages/French-UTF8/cust_text.php - if present
  • languages/Swedish/cust_text.php - if present
  • languages/Swedish-UTF8/cust_text.php - if present