SJ Scrollbar for SobiPro

This guide is intended for SobiPro Scrollbar module

When you buy the module the first time, you will have the latest version. After the first release, we will update this module regularly, then please check newer versions when informed

REQUIREMENTS

1. Joomla! v1.7.x or Joomla! 2.5.x, latest stable version is recommended.
2. Specific component; SobiPro component reflects the name of module.

INSTALLATION

1. Prepare your module package (zip file; please UNZIP first if it is indicated in the file name)
2. All steps are in administrator backend of Joomla!:

  • In your Administrator page, go to Extensions -> Extension Manager
    In this page, click Choose File, select module package.
  • Then click Upload & Install

  • Please wait for module being installed, usually within several seconds
  • Now go to Extensions -> Module Manager, click Select Type box and choose the module you have installed
  • Then click the module listed below to configure it as SETTINGS part hereafter

SETTINGS

1. This module with sample layout is below:

  • Viewport: Where the module shows entries and bar, configured under Basic Options
  • Bar: Navigation of module, called scrollbar with many options that can be configured under Basic Options
  • Entry Details: A large image, title, description and price of entries… to show with module, configured under other Options

2. The parameters are divided up into the following areas:

  • Basic Options
  • Source Options
  • Field Options
  • Entry Options
  • Image Options
  • Advanced Options
BASIC OPTIONS

  • Module Class Suffix – Allow you to choose CSS class that suits your template
  • Select a Layout – Allow you to choose one of two available with horizontal bar OR vertical bar
  • Scrollbar Skin – Allow you to choose one of 5 available skins for the scrolling bar
  • For vertical only

  • Pane Height – Allow you to set height of the viewport
  • # Columns – Allow you to set number of columns to be shown with module
  • For horizontal only

  • Pane Width – Allow you to set width of the module
  • # Rows – Allow you to set number of rows to be shown with module
  • Scrollbar Params

  • Show Arrows – Allow you to show arrows over the bar OR not
  • Arrow Positions – Set position for arrows:
    • Split: Next button before dragger and Previous button after dragger
    • Before: Two buttons before dragger
    • After: Two buttons after dragger
    • OS
  • Dragger Min (px) – Allow you to set min width (with horizontal layout) OR min height (with vertical layout) of dragger
  • Dragger Max (px) – Allow you to set min width (with horizontal layout) OR min height (with vertical layout) of dragger
SOURCE OPTIONS

  • Select Section - Choose the source of content that is used with this module
  • Section ID - ID of the SobiPro section chosen above
  • Category Filter – Allow to show entries that meet some factors:
    • None: Show all entries of section chosen above
    • Include: Only those that are from categories below
    • Exclude: Only those that are NOT from categories below
  • Select Category - Choose the category of section that is used with option above
  • Order Entries By – Allow to choose the criterion for order
    • Popularity ascending
    • Popularity descending
    • Creation date ascending
    • Creation date descending
    • Last update date ascending
    • Last update date descending
    • Expiration date ascending
    • Expiration date descending
    • Random
  • Entries Limit- Allow to set total of entries to be used by module
FIELD OPTIONS

  • Description Field- Alias of a SobiPro field that you want it to be entries’ description (fields of SobiPro section that you chose above)
  • Price Field- Alias of a SobiPro field that you want it to be entries’ price
  • Image Field- Alias of a SobiPro field that you want it to be entries’ main image
  • Syntax for image field above: field_alias/@attribute_name With:

  • field_alias: Alias of a SobiPro field that you want to set
  • attribute_name: One of 4 values: original, icon, thumnail, image
  • Ex: Default value of Image field is field_image/@original
ENTRY OPTIONS

  • Display Title - Show the title of entries OR not
  • Title Maxlength – Allow to set the length of entries title, set 0 for unlimited
  • Display Description – Show entries description OR not
  • Description Maxlength – Allow to set the length of entries’ description, set 0 for unlimited
  • Others

  • Entry Width (px)- Allow to set width of the entry details part
  • Entry Margin (px)- Allow to set space among entries of the entry details part
  • Display Read More - Show the Readmore link OR not
  • Read More text- Set text for Readmore link
  • Price Display- Show the price field OR not
  • Link Target – Set target for links clicked:
    • New window
    • Same window
    • Popup
IMAGE OPTIONS

  • From Image Field- Allow you to get images from image field configured above OR not
  • From External – Allow you to get images from external source OR not
  • External Path (or Url) – Set path to external image folder used by option above
  • Order to Get – Set order: field_image,external OR external,field_image
  • Resize Mode – Allow you to choose the mode of image resizing
    • None
    • Center
    • Fill
    • Fit
    • Strech
  • Output Format – Allow to set format for all output file:
    • Default – if you want to keep original format
    • GIF
    • JPEG
    • PNG
  • Keep Transparency – Allow to keep images transparent, for PNG and GIF format
  • Image Width – Allow you to set the width of the main image
  • Image Height – Allow you to set the height of the main image
  • Background – Allow to set the color of image background
  • Placeholder – Allow you to use a placeholder image when entries’ image is empty
  • Placeholder Path or Url – Allow to set path to placeholder image
ADVANCED OPTIONS

  • Alternative Layout – Allow you to choose custom alternative layout
  • Include jQuery – Allow to include jQuery lib OR not
  • Pre Text - The content to show at the top of module
  • Post Text – The content to show at the end of module
  • Caching
    • Use Global: Turn on caching
    • No Caching: Turn off caching
  • Cache Times – The time to cache