Scroll-xy

Scroll-xy
Summary	Scrolls TNG pages and charts.
Validation	Latest mod is XHTML compliant.
Mod Updated	13 Sept 2021
Download link	For TNG 12.1.0 TNG 13.0 Scroll-xy__v12.1.6a
Download stats	Downloads Stats
Author(s)	Steven Davis
Homepage	Scroll-xy (This page)
Mod Support	TNG Community Forums
Contact Developer	Steven Davis
Latest Mod	12.1.0.6a for TNG V12.1.0 and above
Min TNG V	12.1.0
Max TNG V	13.1.2
Files modified	genlib.php genstyle​.css
Related Mods	Scrollbox_mod Written by Erik Hoppe
Notes

Purpose of the mod

This mod was developed to scroll pages and charts with overflowing content.
(Thanks to Darrin and Ken for functionality suggestions)

Charts cannot be scrolled horizontally in TNG v13 or v14. Instead of an update, the Scroll Mod was created for vertical scrolling.

Developer

This mod was developed by Steven Davis

Advantages

This mod places four scroll buttons in v13 and up to six scroll buttons in v12 at the lower right side of the display.
Scroll to the top, up, left, right, down and bottom of the page.
Buttons do not appear unless content overflows.
Scrolls Ahnentafel and Register pages.
Adjust the scroll height when scrolling up and down or compensate for a sticky header.
Loads with the inner menu so buttons do not appear on mobile devices.
If a template uses the scroll to top button, it will be hidden when scroll xy buttons are shown.
Includes a scroll-config.php file to control which pages display scroll buttons.
Includes an example scrollpage-info.css file to customize the buttons using mytngstyle.css.
The mod can be used with v12.1.0 through v13. With horizontal scroll exceptions for v13.0 charts.
For those that use Scrollbox_mod, scroll buttons are not shown on any pages where that mod is used.

TNG v12 and v13

Scrolls all pages and charts in TNG v12.0 though v12.3 versions.
Scrolls all pages but does not scroll charts horizontally in TNG v13 due to the new drag feature.
Scrolls all TNG v13 pages and chart pages with overflow vertically.
Since the new charts use a body div with nested outer and inner divs, Scrollx-y cannot scroll nested divs.
Horizontal scroll buttons will not appear on charts that cannot be scrolled.

Appearance

When the mod is first installed, refresh the page to reload the style sheets.
Scroll buttons appear at the lower right but can be moved using css.
Scrolls pages with overflow including person, register, text and chart pages.
Examples to change the buttons are in the scrollpage-info.css file.

VERTICAL OVERFLOW

HORIZONTAL OVERFLOW (v12 Only)

HORIZONTAL AND VERTICAL OVERFLOW (v12 Only)

Requirements

• A working TNG installation.
• A backup of all affected files (see the list in the summary in the upper right corner of the page)
• An installed current version of the Mod Manager.

Revision History

Mod Version	TNG Version	Date	Contents
12.1.2.6a	12.1	13 Sep 2021	Moved inline css to genstyle.css to eliminate W3C HTML validation error
12.1.2.6	12.1	18 Jul 2021	Addded script to scroll v13.3 chart page vertically
12.1.2.5	12.1	05 Dec 2020	Updated CSS styling
12.1.2.4	12.1	23 Oct 2020	When using a template that has a scroll to top button and the scroll select pages option is enabled, pages that do not display scroll-xy buttons will display the scroll to top button instead. Edit scrollconfig.php and add or comment out pages that display scroll-xy buttons. If scroll select pages is disabled, scroll-xy buttons will be used.
12.1.2.3a	12.1	19 Oct 2020	Hides Scroll the Top Button to avoid multiple buttons. Same functional code as v12.1.2.3.
12.1.2.3	12.1	12 Sep 2020	Smaller code, same functionality. Fixed vertical scroll distance override.
12.1.2.2c	12.1	25 May 2020	Combined a few CSS classes to make customizing the buttons easier. Added more detail to the readme.txt file. Default buttons are smaller using less display space The scroll container does not load on files specified in the scrollconfig file.
12.1.2.2b	12.1	20 May 2020	Fixed scrolling vertical chart when there is no vertical overflow and delay scroll is enabled. Added option to adjust the horizontal scroll distance.
12.1.2.2a	12.1	16 May 2020	Updated the ReadMe.txt file. Added horizontal scrolling for vertical charts. Corrected some typos in the optional scrollconfig.php.
12.0.1.1	12.0	13 Apr 2019	Original version of ScrollPage Mod was never added to TNG WIKI

Conflicts and Issues

No known conflicts.

Installation

1. Uninstall and delete previous version of this mod (if installed)
2. Download the appropriate zip file as shown in the mod summary in the upper right corner of the page.
3. Extract the file from the downloaded zip file into the mods folder or FTP the extracted file to your mods folder.
4. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install the mod.
5. Refresh the page to reload the CSS files after installation.

Modmanager Edit options

• Scroll delay hides buttons until page scrolls down
• Number of pixels to scroll down if scroll delay is enabled
• Adjust the horizontal scroll distance in percent of the display width
• Adjust the vertical scroll distance in percent of the display height
• Hides buttons on the homepage if the inner menu is displayed
• Display buttons on specific pages specified in the scrollconfig.php file

In the event of a problem

• Try using the Mod Manager Remove capability
• Copy the backup of the affected files back to your TNG directory
• Contact us through the TNG Community Forums.

Uninstalling the mod

If you want to completely Remove (uninstall) this mod and any tables if created, you should

1. click the Uninstall button to uninstall the mod
2. click the Delete button to delete the config file from the mods folder.

Upgrade

• Uninstall and eventually Delete the current Mod.
• Proceed as for an installation with the new Mod.

Related Links

This mod can be used in conjunction with Scrollbox_mod

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
Family Histories	Steven Davis	Mod developer	12.1.6	12.3.0	EN
Berkshire Family History Society	Paul Barrett	Early tester, before it made it on to the Wiki	12.1.2.2c	12.3.0	EN
MOTYER Family Genealogy	John Mark Motyer	Public site	See here	See here	EN