Thumbnail Scroller
WordPress Plugin

Getting Started

This Plugin will help you to easily add a thumbnail scroller to your WordPress website or blog. The scroller is completely customizable, resizable and it is compatible with all browsers and devices (iPhone, iPad and Android smartphones). You will be able to insert it in any page or post you want with an inbuilt short code generator.

If you like this plugin, feel free to rate it five stars     at your CodeCanyon account in Downloads section. If you encounter any problems, before rating the item, contact us so we can help you fix them.

Licence

This item is sold under Envato Licences. Please read them and contact Envato Support if you have any questions.

Installation

Upload the folder dopts from the zip file to wp-content/plugins/ and activate the plugin in your admin panel or upload dopts.zip in the Add new section. Make sure that folder dopts/uploads/ has write permissions.

How to use it

After installation, go to Thumbnail Scroller Area (left menu bottom) and hover/click the mouse over the Question Mark icons for instructions.

Settings descriptions

General Styles & Settings
  • Name
    Change scroller name.

  • Scroller Data Parse Method
    (AJAX, HTML). Default value: AJAX. Set the method by which the data will be parsed to the scroller.

  • Width
    (value in pixels). Default value: 900. Set the width of the scroller.

  • Height
    (value in pixels). Default value: 128. Set the height of the scroller.

  • Background Color
    (color hex code). Default value: ffffff. Set scroller background color.

  • Background Alpha
    (value from 0 to 100). Default value: 100. Set scroller alpha.

  • Background Border Size
    (value in pixels). Default value: 1. Set the size of the scroller border.

  • Background Border Color
    (color hex code). Default value: e0e0e0. Set the color of the scroller border.

  • Thumbnails Order
    (Normal, Random). Default value: Normal. Set thumbnails order.

  • Responsive Enabled
    (Enabled, Disabled). Default value: Enabled. Enable responsive layout. Resize only width or height.

  • Ultra Responsive Enabled
    (Enabled, Disabled). Default value: Disabled. Enable ultra responsive layout. Resize both width and height. It is a boost to normal response function which you must have enabled.

Thumbnails Styles & Settings
  • Thumbnails Position
    (Horizontal, Vertical). Default value: Horizontal. Set the position of the thumbnails.

  • Thumbnails Background Color
    (color hex code). Default value: ffffff. Set the color for the thumbnails background.

  • Thumbnails Background Alpha
    (value from 0 to 100). Default value: 0. Set the transparancy for the thumbnails background.

  • Thumbnails Background Border Size
    (value in pixels). Default value: 0. Set the size of the thumbnails border.

  • Thumbnails Background Border Color
    (color hex code). Default value: e0e0e0. Set the color of the thumbnails border.

  • Thumbnails Spacing
    (value in pixels). Default value: 10. Set the space between thumbnails.

  • Thumbnails Margin Top
    (value in pixels). Default value: 10. Set the top margin for the thumbnails.

  • Thumbnails Margin Right
    (value in pixels). Default value: 0. Set the right margin for the thumbnails.

  • Thumbnails Margin Bottom
    (value in pixels). Default value: 10. Set the bottom margin for the thumbnails.

  • Thumbnails Margin Left
    (value in pixels). Default value: 0. Set the left margin for the thumbnails.

  • Thumbnails Padding Top
    (value in pixels). Default value: 0. Set the top padding for the thumbnails.

  • Thumbnails Padding Right
    (value in pixels). Default value: 0. Set the right padding for the thumbnails.

  • Thumbnails Padding Bottom
    (value in pixels). Default value: 0. Set the bottom padding for the thumbnails.

  • Thumbnails Padding Left
    (value in pixels). Default value: 0. Set the left padding for the thumbnails.

  • Info Thumbnails Display
    (None, Tooltip, Label). Default value: Label. Display a small info text on the thumbnails, a tooltip or a label.

Thumbnails Navigation Styles & Settings
  • Thumbnails Navigation Easing
    (linear, swing, easeInQuad, easeOutQuad, easeInOutQuad, easeInCubic, easeOutCubic, easeInOutCubic, easeInQuart, easeOutQuart, easeInOutQuart, easeInQuint, easeOutQuint, easeInOutQuint, easeInSine, easeOutSine, easeInOutSine, easeInExpo, easeOutExpo, easeInOutExpo, easeInCirc, easeOutCirc, easeInOutCirc, easeInElastic, easeOutElastic, easeInOutElastic, easeInBack, easeOutBack, easeInOutBack, easeInBounce, easeOutBounce, easeInOutBounce). Default value: linear. Set thumbnails navigation easing.

  • Enable Thumbnails Loop
    (Enabled, Disabled). Default value: Disabled. Enable thumbnails loop ... scroll will be disabled.

  • Enable Thumbnails Mouse Navigation
    (Enabled, Disabled). Default value: Disabled. Enable thumbnails mouse navigation.

  • Enable Thumbnails Scroll Navigation
    (Enabled, Disabled). Default value: Disabled. Enable thumbnails scroll navigation.

  • Thumbnails Scroll Position
    (Bottom/Right, Top/Left). Default value: Bottom/Right. Set thumbnails scroll position.

  • Thumbnails Scroll Size
    (value in pixels). Default value: 5. Set the scroll size color.

  • Thumbnails Scroll Scrub Color
    (color hex code). Default value: 808080. Set the scroll scrub color.

  • Thumbnails Scroll Bar Color
    (color hex code). Default value: e0e0e0. Set the scroll bar color.

  • Enable Thumbnails Arrows Navigation
    (Enabled, Disabled). Default value: Enabled. Enable thumbnails arrows navigation.

  • Thumbnails Navigation Arrows Number Items Slide
    (number of thumbnails). Default value: 1. The number of thumbnails that will slide when you click the arrows.

  • Thumbnails Navigation Arrows Speed
    (time in miliseconds). Default value: 600. The time the thumbnails will slide after you click the arrows.

  • Thumbnails Navigation Previous Button Image
    (path to image). Upload the image for thumbnails navigation previous button.

  • Thumbnails Navigation Previous Button Hover Image
    (path to image). Upload the image for thumbnails navigation previous hover button.

  • Thumbnails Navigation Previous Button Disabled Image
    (path to image). Upload the image for thumbnails navigation previous disabled button.

  • Thumbnails Navigation Next Button Image
    (path to image). Upload the image for thumbnails navigation next button.

  • Thumbnails Navigation Next Button Hover Image
    (path to image). Upload the image for thumbnails navigation next hover button.

  • Thumbnails Navigation Next Button Disabled Image
    (path to image). Upload the image for thumbnails navigation next disabled button.

Styles & Settings for a Thumbnail
  • Thumbnail Loader
    (path to image). Set the loader for the thumbnails.

  • Thumbnail Width
    (the size in pixels). Default value: 100. Set the width of a thumbnail.

  • Thumbnail Height
    (the size in pixels). Default value: 100. Set the height of a thumbnail.

  • Thumbnail Alpha
    (value from 0 to 100). Default value: 100. Set the transparancy of a thumbnail.

  • Thumbnail Alpha Hover
    (value from 0 to 100). Default value: 100. Set the transparancy of a thumbnail when hover.

  • Thumbnail Background Color
    (color hex code). Default value: f1f1f1. Set the color of a thumbnail background.

  • Thumbnail Background Color Hover
    (color hex code). Default value: f1f1f1. Set the color of a thumbnail background when hover.

  • Thumbnail Border Size
    (value in pixels). Default value: 1. Set the size of a thumbnail border.

  • Thumbnail Border Color
    (color hex code). Default value: d0d0d0. Set the color of a thumbnail border.

  • Thumbnail Border Color Hover
    (color hex code). Default value: 303030. Set the color of a thumbnail border when hover.

  • Thumbnail Padding Top
    (value in pixels). Default value: 2. Set top padding value of a thumbnail.

  • Thumbnail Padding Right
    (value in pixels). Default value: 2. Set right padding value of a thumbnail.

  • Thumbnail Padding Bottom
    (value in pixels). Default value: 2. Set bottom padding value of a thumbnail.

  • Thumbnail Padding Left
    (value in pixels). Default value: 2. Set left padding value of a thumbnail.

Lightbox Styles & Settings
  • Enable Lightbox
    (Enabled, Disabled). Default value: Enabled. Enable the lightbox.

  • Lightbox Display Time
    (time in miliseconds). Default value: 600. The time the lightbox will be displayed.

  • Lightbox Window Color
    (color hex code). Default value: ffffff. Set the color for the lightbox window.

  • Lightbox Window Alpha
    (value from 0 to 100). Default value: 80. Set the transparancy for the lightbox window.

  • Lightbox Loader
    (path to image). Set the loader for the lightbox image.

  • Lightbox Background Color
    (color hex code). Default value: ffffff. Set the color for the lightbox background.

  • Lightbox Background Alpha
    (value from 0 to 100). Default value: 100. Set the transparancy for the lightbox background.

  • Lightbox Border Size
    (value in pixels). Default value: 1. Set the size of a lightbox border.

  • Lightbox Border Color
    (color hex code). Default value: e0e0e0. Set the color of a lightbox border.

  • Lightbox Caption Text Color
    (color hex code). Default value: 999999. Set the color for the lightbox caption.

  • Lightbox Margin Top
    (value in pixels). Default value: 30. Set top margin value for the lightbox.

  • Lightbox Margin Right
    (value in pixels). Default value: 30. Set right margin value for the lightbox.

  • Lightbox Margin Bottom
    (value in pixels). Default value: 30. Set bottom margin value for the lightbox.

  • Lightbox Margin Left
    (value in pixels). Default value: 30. Set top left value for the lightbox.

  • Lightbox Padding Top
    (value in pixels). Default value: 10. Set top padding value for the lightbox.

  • Lightbox Padding Right
    (value in pixels). Default value: 10. Set right padding value for the lightbox.

  • Lightbox Padding Bottom
    (value in pixels). Default value: 10. Set bottom padding value for the lightbox.

  • Lightbox Padding Left
    (value in pixels). Default value: 10. Set left padding value for the lightbox.

Lightbox Navigation Styles & Settings
  • Lightbox Navigation Previous Button Image
    (path to image). Upload the image for lightbox navigation previous button.

  • Lightbox Navigation Previous Button Hover Image
    (path to image). Upload the image for lightbox navigation previous hover button.

  • Lightbox Navigation Next Button Image
    (path to image). Upload the image for lightbox navigation next button.

  • Lightbox Navigation Next Button Hover Image
    (path to image). Upload the image for lightbox navigation next hover button.

  • Lightbox Navigation Close Button Image
    (path to image). Upload the image for lightbox navigation close button.

  • Lightbox Navigation Close Button Hover Image
    (path to image). Upload the image for lightbox navigation close hover button.

  • Lightbox Navigation Info Background Color
    (color hex code). Default value: ffffff. Set the color for the lightbox info background.

  • Lightbox Navigation Info Text Color
    (color hex code). Default value: c0c0c0. Set the color for the lightbox info text.

  • Lightbox Navigation Display Time
    (time in miliseconds). Default value: 600. The time the lightbox navigation will be displayed.

  • Swipe Lightbox Navigation Enabled
    (Enabled, Disabled). Default value: Enabled. Enable swipe lightbox navigation on touch devices.

Social Share Styles & Settings
  • Social Share Enabled
    (Enabled, Disabled). Default value: Enabled. Enable AddThis Social Share.

  • Lightbox Social Share Button Image
    (path to image). Upload the image for lightbox social share button.

Tooltip Styles & Settings
  • Tooltip Background Color
    (color hex code). Default value: ffffff. Set tooltip background color.

  • Tooltip Stroke Color
    (color hex code). Default value: 000000. Set tooltip stroke color.

  • Tooltip Text Color
    (color hex code). Default value: 000000. Set tooltip text color.

Label Styles & Settings
  • Label Position
    (Bottom, Top, Under). Default value: Bottom. Set label position.

  • Label Always Visible
    (Enabled, Disabled). Default value: Disabled. On true the label is always visible, on false it will be visible only on hover.

  • Height for Under Label
    (the size in pixels). Default value: 50. Set the height only for the label under a thumbnail.

  • Label Background Color
    (color hex code). Default value: 000000. Set label background color.

  • Label Background Alpha
    (value from 0 to 100). Default value: 80. Set label background transparancy.

  • Label Text Color
    (color hex code). Default value: ffffff. Set label text color.

Slideshow Settings
  • Slideshow Enabled
    (Enabled, Disabled). Default value: Disabled. Enable or disable the slideshow.

  • Slideshow Time
    (time in miliseconds). Default: 5000. How much time a thumbnail stays until it passes to the next one.

  • Slideshow Loop
    (Enabled, Disabled). Default: false. Set it to true if you do not want the slideshow to stop when it reaches the last thumbnail.

FAQ

  • 1. How do I install the plugin with FTP?

    Please watch this video.

  • 2. How do I install the plugin with Upload Manager?

    Please watch this video.

  • 3. How do I create a scroller and add thumbnails to it?

    Please watch this video.

  • 4. How do I create a new thumbnail?

    Please watch this video.

  • 5. How do I add a link to a thumbnail?

    Please watch this video.

  • 6. How do I add media to a gallery item? (Embed videos - YouTube, Vimeo - , add HTML code etc.)

    Please watch this video.

  • 7. How do I add the scroller in my theme (header, footer, etc.)?

    Add the following code in your theme files:


    where x is the id.

  • 8. Why cannot I upload images to my scroller?

    Make sure that folder dopts/uploads/ and all subfolders inside it have the permissions set to 777. If the folder has the right permissions, try another upload method from the ones provided (WordPress, AJAX, Uploadify, FTP).

  • 9. Why do not the images appear after the upload is complete?

    Make sure that you have the GD Library enabled in PHP.

  • 10. Why do I receive an IO Error when I upload images using Uploadify?

    The IO Error is a Flash error caused when the upload connection gets cut short. It usually happens with slow internet connections.

  • 11. Why does not the scroller appear in my website?

    1. If the scroller s does not appear, it might be because there is a problem with the JavaScript in your website. If you cannot identify the problem, contact us, including in the message a link to the page where the problem appears. We will identify and fix the issue for you. However, we will not fix the problems that are not caused by this plugin.

    2. Another reason might be that you load more than one jQuery file into your theme. The proper way to load jQuery into your theme or plugin is the following (your add it into your theme's header):

  • 12. How do I remove rounded corners from thumbnails & images?

    Open file dopts/assets/gui/css/jquery.dop.ThumbnailScroller.css in an editor and change or remove border-radius properties.

  • 13. How do I change the language?

    You can change the translation in the file dopts/views/lang.php.

Known issues

On localhost servers, depending on the configuration admin might be slow, you will not be able to upload media files as pictures or videos.

Uploadify will not display the progress bar and image processing will go slower if you have a firewall enabled.

On some servers the images names that contain other characters different from alphanumeric ones will not be uploaded. Change the names in order for them to work.

The Back End section has some display issues in IE 7 (please update to a new version).

How to update

Latest Version: 1.6

Please note:
Make a backup of the Plugin inside your WordPress installation folder /wp-content/plugins/dopts/

Warning:
DO NOT DELETE THE OLD FILES BECAUSE IT IS POSSIBLE TO LOSE ALL YOUR DATA.

To update the Plugin, login to CodeCanyon, head over to your Downloads section and re-download the plugin like you did when you bought it.

Extract the zip's contents, look for the extracted plugin folder, and after you have all the new files upload them using FTP to the /wp-content/plugins/dopts/ folder overwriting the old ones (this is why it's important to backup any changes you've made to the plugin files).
If you didn't make any changes to the plugin files, you are free to overwrite them with the new ones without the risk of losing any plugins settings, and backwards compatibility is guaranteed.

Changelog

  • Version 1.6  -  01 October 2013

    • New Features:
    • Admin interface changes.
    • Delete/Enable/Disable multiple images.
    • Help tooltip updated.
    • Translation structure has changed.
    • Bug Fixes:
    • CSS fixes.
    • Small bugs fixed.
  • Version 1.5  -  05 May 2013

    • New Features:
    • 2 responsive levels added
    • Bug Fixes:
    • SEO fixes.
    • Responsive Media bug fix.
    • AddThis fixed.
  • Version 1.4  -  30 March 2013

    • New Features:
    • Database is deleted when you delete the plugin.
    • Display a list with default settings & all settings you created.
    • You have the option to add the label under the thumbnail.
    • Small Admin changes.
    • Social Share added.
    • Update notification added.
    • Bug Fixes:
    • Scroller resize on hidden elements bug fix.
    • Slow admin bug fix.
    • Uploading Settings Images on MU bug fix.
  • Version 1.3  -  10 December 2012

    • New Features:
    • Remove lightbox margins on mobile devices.
    • Bug Fixes:
    • Lightbox display bug on Chrome is fixed.
    • Small bugs fixes.
  • Version 1.2  -  11 October 2012

    • New Features:
    • Data can be parsed in the scroller using HTML.
    • Upload methods script changes.
    • Bug Fixes:
    • Small bugs fixes.
  • Version 1.1  -  15 May 2012

    • New Features:
    • Loop added.
    • Mouse navigation speed change added.
    • Responsive layout added.
    • Bug Fixes:
    • Minor bugs fixes.
  • Version 1.0  -  01 April 2012

    • Initial release.

Assets

Support

If you did not find the answer you were looking for in the given documentation, please access our Support Forums. If you cannot find the answer to your issue, post a new topic, describing the problem you are having. Please add in your message a link to where you use the item or any other stuff that might be relevant (don’t include any passwords or any confidential information).

Note:
On our Support Forums you need to login and confirm the Item Purchase Code for the item you need help with.

Work time:
07:00 (07:00 AM) – 16:00 (04:00 PM) GMT | Working days only (Monday – Friday)

We do NOT provide support in comments section. Please use it for presale questions only.

Disclaymer

If you buy an Envato item, according to Envato rules, you are not entitled to support or free customizations.
WE WILL OFFER FREE SUPPORT only for bugs, item related issues and very small modifications(a few minutes of work). Everything else will be considered as custom work, for which we charge $35/hour.
Offering support will help us improve and fix the bugs in our products and a great way to do this is to see what problem appear when people use them.
If your request for a feature has been made by other people is it possible, but not a rule, to add that feature in a future update. Please don't buy the item if a feature doesn't exist and you need it. We will not add it for you in record time. If you are not sure if the feature exists please ask first.

PS: Do not forget to rate this item   .