=== Simple Scroll to Top Button ===
Contributors: Arthur Gareginyan
Tags: scroll to top, scroll up, scroll back, back to top, smooth scroll, back, to top, back top, back to top, go to top, bottom to top, back to up, scroll top, scroll up, page scroll up, one click scroll to top,link to top, back button, back to top button, arrow, button, navigation, back widget, scroll back to top, scroll me up, scroll to top, scroll to up, scroll top, scroll up, scroll up, scroll widget, scroll, scroller, scrolling, scroll up, simple back to top, simple scroll to top, smooth scroll to top, to top button, top button, top scroll, top, up button, up, vertical scroller,
Donate link: https://www.spacexchimp.com/donate.html
Requires at least: 3.9
Tested up to: 4.9
Stable tag: 4.25
License: GPL3
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Easily add cross browser "Scroll to Top" button to your website. It will be responsive and compatible with all major browsers. It will work with any theme!


== Description ==

An easy to use, with intuitive interface, WordPress plugin that gives you the ability to add a "Scroll to Top" button to your website in a simple and elegant way. This button appears at the bottom-right of the website once the visitors scrolls down a page on your website. It appears only when visitors scroll down the webpage. As a result, your website visitors can easily scroll smoothly back to the very top of a page with one click of the button. This can be particularly handy for pages with a lot of text/content, or in cases wherever a browser's scrollbar is just not good enough (or not present at all, like on tablets) to enable one-click, one-screen scrolling. This gives your website better navigation and also adds a more professional look to your website.

This plugin give you finer control over "Scroll to Top" button, it can be configured on the plugin settings page. You can select where the button will be showed, such as home page or all pages. You can customize the button style using and combining 10 symbols and 4 backgrounds from FontAwesome library, in result you have 40 variations of buttons. You can change the size of button, color (unlimited) of background, color (unlimited) of symbol and etc. If you want more options, then let us know and we will be happy to add them.

Also you don't need to edit any file of your theme, this plugin will do everything for you. It's just plug and play, no tedious configurations or hacks, just install, enable and start enjoying the Scroll To Up button. "Scroll to Top" button will be responsive and compatible with all major browsers. It will work with any theme! No knowledge of any coding (HTML, CSS, JavaScript, PHP) is required at all.

**Features**

* Lightweight and fast
* Secure code with using clear coding standards
* Intuitive interface with many settings
* Cross browser compatible (work smooth in any modern browser)
* Compatible with all WordPress themes
* RTL compatible (right to left)
* Translation ready

**Key features include**

* Retina display support
* FontAwesome integrated (available 40 combinations of icons)
* Background color changer (Unlimited colors)
* Symbol color changer (Unlimited colors)
* Changeable button background and symbol
* Changeable size of button
* Changeable scroll duration
* Option to enable/disable button
* Option to display button in full website or in Home page only
* Auto hide button on top of webpage
* Live preview
* And much, much more!

**Translation**

This plugin is ready for translation and has already been translated into several languages.

* English (default)
* Russian (translation by [Milena Kiseleva](https://www.instagram.com/milava_kiseleva/))
* German (translation by Michael)
* Spanish (translation by Ramiro Garcés and Patricio Toledo)
* Dutch (translation by Peter Leenders)

If you want to help translate this plugin then please visit the [translation page](https://translate.wordpress.org/projects/wp-plugins/simple-scroll-to-top-button).

**Minimum system requirements:**

* [PHP](https://php.net) version **5.2** or higher.
* [MySQL](https://www.mysql.com) version **5.0** or higher.

**Recommended system requirements:**

* [PHP](https://php.net) version **7.0** or higher.
* [MySQL](https://www.mysql.com) version **5.6** or higher.

**Contribution**

Developing plugins is long and tedious work. If you benefit or enjoy this plugin please take the time to:

* [Donate](https://www.spacexchimp.com/donate.html) to support ongoing development. Your contribution would be greatly appreciated.
* [Rate and Review](https://wordpress.org/support/view/plugin-reviews/simple-scroll-to-top-button?rate=5#postform) this plugin.
* [Share with us](https://www.spacexchimp.com/contact.html) or view the [GitHub Repo](https://github.com/ArthurGareginyan/simple-scroll-to-top-button) if you have any ideas or suggestions to make this plugin better.


== Installation ==

Install "Simple Scroll to Top Button" just as you would any other WordPress Plugin.

Automatically via WordPress Admin Area:

1. Log in to Admin Area of your WordPress website.
2. Go to "`Plugins`" -> "`Add New`".
3. Find this plugin and click install.
4. Activate this plugin through the "`Plugins`" tab.

Manually via FTP access:

1. Download a copy (ZIP file) of this plugin from WordPress.org.
2. Unzip the ZIP file.
3. Upload the unzipped catalog to your website's plugin directory (`/wp-content/plugins/`).
4. Log in to Admin Area of your WordPress website.
5. Activate this plugin through the "`Plugins`" tab.

After installation and activation, the "`Scroll to Top`" menu item will appear in the "`Settings`" section of Admin Area. Click on it in order to view the plugin settings page.

[More help installing plugins](http://codex.wordpress.org/Managing_Plugins#Installing_Plugins "WordPress Codex: Installing Plugins")


== Frequently Asked Questions ==

= Q. Will this plugin work on my WordPress.COM website? =
A. Sorry, this plugin is available for use only on self-hosted (WordPress.ORG) websites.

= Q. Can I use this plugin on my language? =
A. Yes. This plugin is ready for translation and has already been translated into several languages. But If your language is not available then you can make one. The POT file is included and placed in the "`languages`" folder. Just [send the PO file to us](https://www.spacexchimp.com/contact.html) and we will include this translation within the next plugin update. Many of plugin users would be delighted if you share your translation with the community. Thanks for your contribution!

= Q. How does it work? =
A. Simply go to the plugin settings page, select the desired settings and click the "Save changes" button. Enjoy your fancy "Scroll to Top" button. It's that simple!
You can find the plugin settings page at "`WordPress Admin Area`" -> "`Settings`" -> "`Scroll to Top`".

= Q. Is it possible to use different buttons/arrows? =
A. This plugin comes with the FontAwesome iconic font. Now you can customize the button style using and combining 10 symbols and 4 backgrounds from FontAwesome library, in result you have 40 variations of buttons. You can change the size of button, color (unlimited) of background, color (unlimited) of symbol and etc. A future version may include more buttons, and/or the option to upload your own button graphics.

= Q. Does this plugin requires any modification of the theme? =
A. Absolutely not. This plugin is configurable entirely from the plugin settings page that you can find in the Admin Area of your WordPress website.

= Q. Does this require any knowledge of HTML or CSS? =
A. Absolutely not. This plugin can be configured with no knowledge of HTML or CSS, using an easy-to-use plugin settings page.

= Q. It's not working. What could be wrong? =
A. As with every plugin, it's possible that things don't work. The most common reason for this is a web browser's cache. Every web browser stores a cache of the websites you visit (pages, images, and etc.) to reduce bandwidth usage and server load. This is called the browser's cache.​ Clearing your browser's cache may solve the problem.

It's impossible to tell what could be wrong exactly, but if you post a support request in the plugin's support forum on WordPress.org, we'd be happy to give it a look and try to help out. Please include as much information as possible, including a link to your website where the problem can be seen.

= Q. The last WordPress update is preventing me from editing my website that is using this plugin. Why is this? =
A. This plugin can not cause such problem. More likely, the problem are related to the settings of the website. It could just be a cache, so please try to clear your website's cache (may be you using a caching plugin, or some web service such as the CloudFlare) and then the cache of your web browser. Also please try to re-login to the website, this too can help.

= Q. Where to report bug if found? =
A. Bug reports are very welcome! Please visit [our contact page](https://www.spacexchimp.com/contact.html) and report. Thank you!

= Q. Where to share any ideas or suggestions to make the plugin better? =
A. Any suggestions are very welcome! Please visit [our contact page](https://www.spacexchimp.com/contact.html) and share. Thank you!

= Q. I love this plugin! Can I help somehow? =
A. Yes, any contributions are very welcome! Please visit [our donation page](https://www.spacexchimp.com/donate.html). Thank you!


== Screenshots ==

1. Plugin page. Sections "Settings" and "Preview".
2. 'Scroll to Top' button displayed on front end of website (Twenty Fifteen theme).
3. 'Scroll to Top' button (with transparency) displayed on front end of website (Twenty Fifteen theme).
4. 'Scroll to Top' button displayed on front end of website (Twenty Sixteen theme).


== Other Notes ==

****

"Simple Scroll to Top Button" is one of the own software projects of [Space X-Chimp](https://www.spacexchimp.com).

**License**

This plugin is licensed under the [GNU General Public License, version 3 (GPLv3)](http://www.gnu.org/licenses/gpl-3.0.html) and is distributed free of charge.
Commercial licensing (e.g. for projects that can’t use an open-source license) is available upon request.

**Credits**

* The icon of plugin is a copyrighted image created by the [Space X-Chimp](https://www.spacexchimp.com) team. (C) All rights reserved.
* The banner of plugin is a copyrighted image created by the [Space X-Chimp](https://www.spacexchimp.com) team. (C) All rights reserved.
* [Bootstrap](http://getbootstrap.com) by Twitter, Inc. released under the [MIT license](https://github.com/twbs/bootstrap/blob/master/LICENSE).
* [Bootstrap-checkbox](https://github.com/vsn4ik/bootstrap-checkbox) is a project of [Vasily A.](https://github.com/vsn4ik), shared under the [MIT license](https://github.com/vsn4ik/bootstrap-checkbox/blob/master/LICENSE).

**Links**

* [Developer website](https://www.spacexchimp.com)
* [Dedicated plugin page on GitHub](https://github.com/ArthurGareginyan/simple-scroll-to-top-button)
* [Dedicated plugin page on WordPress.org](https://wordpress.org/plugins/simple-scroll-to-top-button/)


== Changelog ==

= 4.25 =
* Improvement: Design of the plugin settings page is improved.

= 4.24 =
* Improvement: Design of the plugin settings page is improved.

= 4.23 =
* Content of the "Settings" section updated.
* Content of the "Usage Instructions" section updated.
* CSS code, which is located in the file "admin.css" and is related to the "FAQ" section, is improved.
* Code commenting improved.
* Translation files are updated.

= 4.22 =
* Dutch translation added. (Thanks to Peter Leenders)
* The code block that adds dynamic JavaScript is moved to a separate function '_load_scripts_dynamic_js' within the 'enqueue.php' file.
* The code block that adds dynamic CSS is moved to a separate function '_load_scripts_dynamic_css' within the 'enqueue.php' file.
* The function '_load_scripts_base' is deleted due to uselessness.
* The function '_load_scripts_admin' is improved.
* The function '_load_scripts_frontend' is improved.
* The banner of Space X-Chimp, located on the settings page of the plugin, is updated. The image 'banner.png' is deleted.
* Some texts are updated.
* All translation files are updated.

= 4.21 =
* The extra mention of the constant '_SLUG'  is removed from the file 'enqueue.php'.
* All translation files are updated.

= 4.20 =
* Fixed a bug due to which the plugin data that stored in the database to not be deleted during the uninstallation of the plugin.
* The contents of the file 'uninstall.php' is moved to the file 'core.php'. The file 'uninstall.php' is deleted.
* Some texts are corrected.

= 4.19 =
* Added new constant "_FILE".
* Added a function that runs during the plugin activation. Now the date of the first activation of the plugin is recorded in the database.

= 4.18 =
* Added auto-versioning of the CSS and JavaScript files to avoid cache issues.
* CSS code in the file 'admin.css' is optimized.

= 4.17 =
* Fixed the link "Settings", located in the plugin's meta row on the "Plugins" page. The suffix ".php" was deleted.
* Fixed information stored in the header of the translation files.
* Translation files updated.

= 4.16 =
* Some texts updated, and typos corrected.
* All translation files updated.
* The information about the author of the plugin (including name, links, copyright, etc.) was changed due to the fact that the plugin became the property of SpaceXChimp.
* The human.txt file updated.

= 4.15 =
* Texts updated.
* The year in the copyright text is updated.
* The sidebar items are rearranged.
* Translation files updated.

= 4.14 =
* The plugin is fully tested for compatibility with WordPress version 4.9.
* CSS code improved.

= 4.13 =
* German translation added. (Thanks to Michael)
* Spanish translation updated. (Thanks to Patricio Toledo)
* Fixed an issue where the "Hello" message could not be hidden.

= 4.12 =
* At the request of some users, plugin settings page moved to the submenu item in the top-level menu item "Settings", like before.
* Fixed the issue because of which the HTML code of button was appears on page while the "Display button on" setted to "Home Page Only".

= 4.11 =
* Fixed the issue due to which the 'Space X-Chimp' sub menu item in the brand menu item was displayed.
* Added branded footer text on the plugin's settings page.

= 4.10 =
* The hard coded HTML radio options are replaced with the PHP function that dynamically creates radio.

= 4.9 =
* Added the top level menu item of the brand.
* The submenu item of the plugin has moved to the menu item of the brand.
* The menu item of the plugin is renamed.
* The "Author" tab on the settings page is removed.
* Content of the "Support" tab on the settings page is updated.
* Copyright of plugin files is changed to the "Space X-Chimp".
* The "Support" tab renamed to the "Support Me".
* The "Usage" tab renamed to the "Usage Instructions".

= 4.8 =
* Plugin data that saved in the database upgraded to version 0001.

= 4.7 =
* Added Spanish translation. (Thanks Patricio Toledo)
* Function that render controls on the settings page is moved to a separate file 'controls.php'.
* The '_setting' function divided into two functions: '_control_field' and '_control_switch'.
* Added CSS class 'control-switch' to checkboxes with custom styles. Now the 'bootstrap-checkbox.js' plugin only applies to checkboxes with class 'control-switch'.
* The group name of the '_service_info' option renamed to '_settings_group_si'.
* The 'admin.css' file improved.
* The "Font Awesome" library updated to version 4.7.
* Functions for scripts enqueuing improved.
* The save button is replaced by a new wider button.
* Added an additional save button that fixed in the upper left corner.
* The help text generating is moved to separate PHP function.
* Added PHP function for generating the color picker options.
* Prefixes of the PHP functions changed to ''spacexchimp_p008_.
* Prefixes of the PHP constants changed to ''SPACEXCHIMP_P008_.

= 4.6 =
* Russian translation updated. (Thanks to Milena Kiseleva)
* The navigation of the tabs is rearranged.
* Fixed an issue due to which the sidebar was not hiding on mobile devices.
* Code of sidebar moved to separate file 'sidebar.php'.
* Support page tab moved from external source to plugin code.
* My avatar moved from external source to plugin folder.
* Banner moved from external source to plugin folder.
* Code of PayPal button updated.

= 4.5 =
* Preview section on the settings page changed to live preview.
* Stylesheet in the admin.css file improved.
* The '!important' declarations in the admin.css file removed.
* Code formatting in the admin.js file improved.
* Code commenting improved.
* Load of the additional remote CSS file removed from the admin.js file.
* Some PHP 'if' statements replaced with shorthand.
* Inline CSS code removed, and instead added CSS class. The 'ssttbutton_css_options' function removed.
* Changed the sorting of enqueueing of scripts.
* The 'Family' page tab renamed to 'Store'.
* Added ad banner of my store website.

= 4.4.1 =
* The HTTPS mixed content issue fixed by changing all links to HTTPS.
* Content of the "FAQ" section updated.

= 4.4 =
* On the plugin settings page, text of buttons are corrected.
* On the plugin settings page, the information about the plugin version number moved to header section.
* Some mention of constants replaced with variables for easier access.
* Content of the "Usage" tab updated.
* Content of the "FAQ" tab updated.

= 4.3 =
* To the plugin settings page added information about the plugin version number.
* The "Tested up to:" comment changed to 4.8 after full testing process.
* The "version.php" file renamed to "versioning.php".
* The "versioning.php" file updated to new version.
* The "_plugin_version_number" function renamed to the "_versioning".

= 4.2 =
* Compatibility with PHP version 5.2 improved.
* PHP shorthands improved.
* Added function for generating the plugin constants.
* Some constants now get the value from the plugin header data.
* The "_plugin_version_number" function improved.
* Added file "upgrade.php" for future upgrades.

= 4.1.1 =
* Fixed the bug due to which the "Warning: Constants may only evaluate to scalar values in" warning are displayed.

= 4.1 =
* Added option to select the duration of scrolling.
* Added new constants: "_SLUG", "_PREFIX", "_SETTINGS" and "_NAME".
* Value of the "_VERSION" constant replaced with information from the plugin header data.
* All references to the plugin name, slug, prefix are replaced with constants.
* Added function that render checkboxes and fields for saving plugin settings to database.
* Added default values to empty options.
* Added the "_load_scripts_base" function with the basis of scripts and stylesheets.
* Fixed the enable/disable option.
* Added prefix to the name of the variable in 'wp_localize_script' WordPress function, to prevent conflicts.
* The "name" attribute removed from the "form" tag.
* Code formatting improved.
* F.A.Q. section updated.

= 4.0.1 =
* Fixed the bug due to which the the "Warning: Illegal string offset 'version' in" and the "Warning: Illegal string offset 'old_version' in" warnings are displayed. (Thanks to Sven Brill)

= 4.0 =
* The design of the plugin settings page is completely redone.
* Added additional donate link to the "Plugins" page.
* Translations updated.
* Readme for translations updated.
* Advertisement banner removed.
* The 'Using' section renamed to 'Usage'.
* My Unicode signature added to the main file.
* The 'front.css' file renamed to 'frontend.css'.
* The smoothscroll.js' file renamed to 'frontend.js'.
* The donate button replaced with new.
* The 'Donate' section renamed to 'Support'.
* The 'donate.png' image removed.
* Options from the settings page moved to a separate file.
* Fixed a bug due to which the jQuery library was not loaded on the front end of the website if the visitor did not logged-in.
* The "Usage" section removed from the sidebar area.
* Added stylized descriptions of sections on the "Settings" tab.
* Additional "Support" section added.
* Added tab navigation menu for the settings page.
* Added additional tabs on the settings page.
* Code of the 'admin.css' file improved and better commented.
* The 'bootstrap-checkbox.min.js' file renamed to 'bootstrap-checkbox.js'.
* A full version of the Bootstrap framework is integrated.
* Added the CSS code for the custom list numbers on the plugin settings page.
* The main font is changed to "Verdana".
* All PHP and HTML code is better formatted.
* The header on the settings page of plugin is redesigned.
* The "LICENSE.txt" file renamed to "license.txt".
* The "humans.txt" file added.
* On the plugin settings page, the "valign='top'" attribute removed from the "tr" element of HTML table and added the appropriate analog in CSS .
* The "_service_info" setting added to the data-base.
* Added function for managing information about the version number of the plugin.
* Added the "Hello" message that show when the plugin is just installed.
* Added the "Error" message that show when user is trying to degrade the version number of the plugin.
* Fixed the parameter that contain the path to source files in all translation files.
* The POT file updated.
* Translations updated.

= 3.2 =
* Added Spanish translation. (Thanks [Ramiro Garcés](http://www.ramirogarces.com.ve/))
* Added the Readme.txt file for translation contribution.
* Added global constant for plugin text-domain.

= 3.1 =
* Added prefixes to the stylesheet and script names when using wp_enqueue_style() and wp_enqueue_script().
* Added constant for storing the plugin version number.

= 3.0 =
* The structure of files changed.
* Style sheet of settings page improved and better commented.
* Style sheet of settings page optimized for mobile devices.
* JS code improved.
* The "smoothscroll.js" file enqueued on plugin settings page for preview purpose.
* Added JavaScript function of automatic remove the "successful" message after 3 seconds.
* Checkboxes replaced with cool triggers by using Bootstrap framework and Bootstrap-checkbox component.
* Fixed error that appeared when button is disabled.

= 2.0.1 =
* POT file updated.
* Russian translation updated.
* Image "thanks.png" removed.
* Advertisement replaced by new.
* Added the subject with plugin name to email address on settings page.
* Function "ssttbutton_enqueue_scripts_admin" renamed to "ssttbutton_load_scripts_admin".
* Function "ssttbutton_enqueue_scripts_frontend" renamed to "ssttbutton_load_scripts_frontend".

= 2.0 =
* Some changes in design of settings page.
* Constants variables added.
* Text domain changed to "simple-scroll-to-top-button".
* Added compatibility with the translate.wordpress.org.
* All images are moved to the directory "images".
* Image "btn_donateCC_LG.gif" is now located in the "images" directory.
* Plugin URI changed to GitHub repository.
* Added my personal ad about freelance.
* .pot file updated.
* Russian translation updated.

= 1.2 =
* Fixed: Notice: Undefined index: form_button in .../inc/page.php.
* Some changes in design of settings page.
* Plugin URI changed to GitHub repository.
* Added my personal ad about freelance.
* .pot file updated.
* Russian translation updated.

= 1.1 =
* Added Russian translation.

= 1.0 =
* Initial release.
* Added ready for translation (.pot file included).

= 0.3 =
* Release candidate.

= 0.2 =
* Beta version.

= 0.1 =
* Alpha version.


== Upgrade Notice ==

= 4.0 =
Please update to new release!

= 3.0 =
Please update to new release!

= 2.0 =
Please update to new release!

= 1.0 =
Please update to first stable release!
