Downloading the Extension

Email: After purchasing from our store, you will receive an email with the download link.

Store: You can also download it from the Downloads section. Create an account with the same email used at purchase if you are new.

Package: VerticalLogoScroller_UNZIP.zip

Unzip the Package

• Unzip VerticalLogoScroller_UNZIP.zip.
• Inside you will find:
  • mod_logo_scroller_1.8.zip — install this for Joomla 4, 5 & 6
  • ReadMe.txt — notes for the current version

After unzipping, install mod_logo_scroller_1.8.zip.

1. Go to System → Install → Extensions.
2. Upload the package and install.
3. Open Content → Site Modules, find Vertical Logo Scroller, publish it, assign a template position, and set menu assignment.

Requirements: Joomla 4.x, 5.x, or 6.x · PHP 8.1+ recommended.

Download ID (DLID): Use Joomla’s built-in Download ID under extension updates — there is no custom license key field in the module.

Note: The front-end script is vanilla JavaScript (no jQuery required).

All options under the Behavior fieldset.

• Scroll Mode (mode, default: Step)
  • Step (one at a time) — advances one logo card per transition; supports Prev/Next buttons.
  • Continuous ticker — seamless infinite vertical scroll with no buttons.
• Direction (direction, default: Up)
  • Up — logos move upward.
  • Down — logos move downward.
• Visible Logos (visibleItems, default: 3, range 1–12) — how many logo cards are visible in the viewport at once. Viewport height = card height × this value.
• Autoplay (autoplay, default: Yes) — starts scrolling automatically on page load.
• Autoplay Interval (ms) (autoplayDelay, default: 2800, range 800–30000) — pause between step advances. Shown only when Autoplay is Yes and Scroll Mode is Step.
• Transition Speed (ms) (speed, default: 450, range 0–20000)
  • Step mode: duration of the move animation (ms). 0 = instant jump.
  • Ticker mode: milliseconds to scroll the height of one logo card. Higher = slower. Typical calm ticker: 4000–6000.
• Pause on Hover (pauseOnHover, default: Yes) — stops autoplay/ticker while the mouse or keyboard focus is on the scroller; resumes when leaving.
• Show Prev / Next (showControls, default: Yes) — circular arrow buttons above/below the viewport. Shown only when Scroll Mode is Step (hidden for ticker).

All options under the Look & Feel fieldset.

• Theme (theme, default: Modern 2026)
  • Modern 2026 — soft panel, gradient fade edges, card shadows, accent tint.
  • Minimal — no panel chrome; logos only.
  • Outline — white panel with stronger card borders.
  • Dark — dark cards and viewport for dark sites.
• Horizontal Alignment (align, default: Center) — places the scroller Left, Center, or Right inside the module position.
• Accent Color (themeColor, default: #1819ed) — brand colour for panel tint, button hover, and focus states.
• Logo Card Width (px) (itemWidth, default: 160, range 60–480) — width of the viewport and card column.
• Logo Card Height (px) (itemHeight, default: 120, range 40–400) — height of each logo card (also used for ticker distance).
• Gap Between Logos (px) (itemGap, default: 12, range 0–48) — vertical space between cards.
• Card Border Size (borderSize, default: 1, range 0–8) — border thickness in pixels; 0 removes the border.
• Card Border Color (borderColor, default: #e6e9ef) — CSS colour for the card border.
• Card Background (cardBg, default: #ffffff) — background of each logo card.
• Card Corner Radius (borderRadius, default: 12px) — CSS radius (e.g. 12px, 50%, 0).
• Idle Logo Opacity (logoOpacity, default: 0.75) — image opacity before hover (e.g. 0.6–1). On hover/focus the logo becomes full opacity.
• Greyscale until Hover (greyscale, default: No) — logos render in greyscale and switch to full colour on hover/focus.

All options under the Content fieldset.

• Logo Source (source, default: Individual logos)
  • Individual logos — manage each logo in the Logos subform.
  • From folder — auto-load every image file from a folder on the server.

Individual logos (subform)

Shown when Logo Source is Individual logos. Use Add to create rows; drag to reorder.

• Logo image (imgname, required) — media picker under /images. Joomla may append a #joomlaImage://… suffix; the module strips it automatically.
• Link URL (imglink) — optional URL when the logo is clicked. Leave empty or use # for no link.
• Alt text (imgalt) — accessible alternative text. If empty, a label is generated from the filename.
• Published (imgstatus, default: Show) — Show or Hide this row without deleting it.

From folder

Shown when Logo Source is From folder.

• Image Folder (folder, default: images/sponsors) — path relative to the site root (no leading slash). Supported extensions: jpg, jpeg, png, gif, webp, svg.
• Folder Sort Order (sort, default: A → Z)
  • A → Z — natural ascending filename sort.
  • Z → A — natural descending sort.
  • Random — shuffled on each page load.

Link options (individual logos only)

• Enable Logo Links (linkEnable, default: Yes) — when No, logos are not wrapped in anchors even if a URL is set.
• Open Links In (linkTarget, default: New tab) — New tab (_blank (with rel="noopener noreferrer") or Same window _self. Shown only when Enable Logo Links is Yes.

All options under the Advanced fieldset, plus update downloads.

• Module Class Suffix (moduleclass_sfx) — extra CSS class(es) added to the scroller wrapper (e.g. my-sponsors).
• Additional CSS (extraCSS) — raw CSS injected with the module. Scope with #jx-vls-{moduleId} or .jx-vls / .jx-vls-shell.
• Layout (layout) — alternate module layout override if your template provides one (standard Joomla module layout field).
• Download ID (DLID) — not a module parameter. Enter your Download Key in Joomla’s extension update settings so paid updates download correctly. Prefix used: download_key=.

Useful CSS classes: .jx-vls-shell, .jx-vls, .jx-vls-viewport, .jx-vls-card, .jx-vls-btn, .jx-vls-theme-modern-2026, .jx-vls-mode-ticker, .jx-vls-greyscale, .jx-vls-align-center.

• Confirm the module is published, assigned to a real template position, and assigned to the correct menu items.
• After changing parameters, clear Joomla cache if enabled, then hard-refresh (Ctrl+F5).
• If no logos show for Individual logos, check that at least one row is Published = Show and has an image selected.
• If no logos show for From folder, confirm the folder path is relative to the site root (e.g. images/sponsors) and contains supported image files.
• Ticker too fast? Raise Transition Speed (e.g. 4800). In ticker mode higher ms = slower scroll.
• Scroller stuck on the left? Set Horizontal Alignment to Center.
• Media fields may include a #joomlaImage://… suffix — that is normal; the module removes it when rendering.
• Prev/Next buttons only appear in Step mode.
• No jQuery is required. Docs mentioning jCarousel apply only to versions before 1.8.
• To embed in an article, see: Joomla docs — module inside an article.

Support: support.joomlax.com