Get Started

jQuery News Ticker is a Joomla site module that displays scrolling news headlines from Joomla articles, custom items, or RSS feeds. Version 2.7 uses a modern vanilla JavaScript engine with no jQuery dependency.

Choose from reveal, fade, continuous scroll, or vertical animation modes. Style the bar with layout presets, color pickers, Google Fonts, and custom CSS. Compatible with Joomla 4, 5, and 6.

Downloading the Extension

After purchase, download the extension from the email link or from the Downloads section in the JoomlaX store.

Installing the Module

Log in to your Joomla administrator and go to System > Install > Extensions. Upload mod_ticker_2.7.zip and wait for the success message.

Publishing the Module

Go to Content > Site Modules, create or open a jQuery News Ticker instance, configure the settings below, assign a module position, and set status to Published.

Content Source

• Content Source (source_mode): Articles, Custom Items, RSS Feed, or Mixed.
• Custom Items (custom_items): Repeatable subform. Shown when source is Custom or Mixed.
• RSS Feed URL (rss_url): Valid RSS or Atom feed URL. Shown for RSS or Mixed.
• RSS Item Count (rss_count): Maximum RSS items to load (1–50).
• RSS Cache (seconds) (rss_cache_ttl): How long to cache RSS results (60–86400). Default 300.
• Mixed Source Order (mixed_priority): Articles first, Custom first, RSS first, or Round-robin interleave.
• Pinned Article IDs (pinned_article_ids): Comma-separated article IDs shown first.
• Categories (catid): Filter articles by category (multi-select).
• Tags (tag): Filter articles by tag (multi-select).
• Item Count (count): Maximum total items to display (1–100).
• Order Results (ordering): Published date, created, modified, ordering, hits, or random.
• Order Direction (direction): Ascending or descending.
• Featured Articles (show_featured): Show all, featured only, or hide featured.
• Exclude Current Article (exclude_current): Hide the article currently being viewed.
• Author (author_id): Show articles by a specific author only.
• Date Range (days) (date_range_days): Only articles published within this many days. 0 = no limit.

Content Display

• Content to Display (content_mode): Title, Intro Text, or Both.
• Character Limit (numChar): Truncate text (10–1000 characters).
• Read More Text (readMore): Optional suffix such as … read more.
• Read More as Link (readmore_as_link): Render read more as a separate link.
• Link Title to Article (link): Make the headline clickable.
• Open in New Tab (link_target): Global default for article links.
• Add nofollow to Links (link_nofollow): Add rel="nofollow" to links.
• Show Date (show_date): Display article date before headline.
• Date Field (date_field): Use published, created, or modified date.
• Date Format (date_format): PHP date format or language string such as DATE_FORMAT_LC3.
• Show Category (show_category): Display article category name.
• Show Badge (show_badge): Display a badge before headlines.
• Badge Text (badge_text): Default badge label such as BREAKING.
• Show Label (show_label): Show or hide the label pill.
• Trigger Content Plugins (triggerevents): Run content plugins on article intro text.
• View All Link URL (view_all_url): Optional link inside the ticker bar.
• View All Text (view_all_text): Label for the view-all link. Default: View all.
• Empty State Message (empty_text): Shown when no items are available.

Custom Item Subform Fields

Available when Content Source is Custom or Mixed:

• Ticker Text (item_text): Headline text (required).
• Link URL (item_link): Optional click-through URL.
• Badge Text (item_badge): Per-item badge override.
• Show From (item_start): Optional start date/time.
• Show Until (item_end): Optional end date/time.
• Pin Item (item_pinned): Keep item at the top.
• Open in New Tab (open_in_new_tab): Per-item link target override.

Animation

• Animation Mode (display_type): Reveal (curtain), Fade, Continuous Scroll, or Vertical.
• Scroll Speed (px/s) (speed): Movement speed. Default 100. Range 20–400.
• Pause on Items (ms) (pauseOnItems): How long each headline stays visible. Default 2500.
• Gap Between Headlines (ms) (item_gap): Pause before the next headline. Default 400.
• Fade In Speed (ms) (fadeInSpeed): Fade/vertical enter duration. Default 400.
• Fade Out Speed (ms) (fadeOutSpeed): Fade/vertical exit duration. Default 280.
• Label Spacing (px) (label_gap): Space between label pill and headline. Default 8.
• Direction (dir): Left to Right or Right to Left (RTL).
• Show Controls (controls): Play, pause, previous, and next buttons.
• Controls Position (controls_position): Start or end of the bar.
• Pause Between Scroll Loops (ms) (scroll_loop_pause): Pause at end of each scroll loop. 0 = none.
• Reveal Pointer (reveal_pointer): Show moving cursor during reveal. Reveal mode only.
• Pointer Color (pointer_color): Color of the reveal cursor.
• Pointer Width (px) (pointer_width): Width of the reveal cursor (1–4).
• Pause on Hover (pause_on_hover): Pause animation when the user hovers the bar.
• Item Separator (separator): Text between items in scroll mode. Default | .

Styling

• Layout Preset (layout_preset): Default, Breaking News, Minimal, Lower Third, or Compact.
• Bar Position (position): Static, Fixed Top, or Fixed Bottom.
• Width (width): Bar width. Default 100%.
• Height (px) (height): Bar height. Range 28–120. Default 40.
• Border Radius (px) (bar_radius): Corner roundness. Default 6.
• Horizontal Padding (px) (bar_padding_x): Left/right inner padding. Default 10.
• Vertical Padding (px) (bar_padding_y): Top/bottom inner padding. Default 6.
• Label Text (titleText): Text in the label pill. Default Latest News.
• Label Color (titlecolor): Text color of the label pill.
• Label Background (label_bg_color): Background color of the label pill.
• Background Color (color): Main bar background.
• Border Color (border_color): Bar border color.
• Content Color (contentcolor): Headline text color.
• Link Hover Color (link_hover_color): Color when hovering links.
• Badge Color (badge_color): Background color of badges.
• Control Icon Color (control_color): Color of play/pause/prev/next icons.
• Control Button Size (px) (control_size): Size of control buttons. Range 18–36.
• Font Family (tfont): Google Font preset or User Defined.
• Custom Font Family (user_defined): CSS font stack when Font Family is User Defined.
• Load Google Fonts (load_google_fonts): Load selected Google Font from CDN.
• Font Weight (fontweight): Bold or Normal.
• Font Size (px) (fontSize): Base text size. Range 10–32.
• Custom CSS (custom_css): Additional CSS rules for this module instance.

Advanced

• Auto Refresh (auto_refresh): Reload ticker items via AJAX without refreshing the page.
• Refresh Interval (ms) (refresh_interval): How often to refresh. Range 10000–3600000. Default 60000.
• Enable Analytics Events (enable_analytics): Push headline click events to dataLayer.
• Analytics Event Name (analytics_event): Event name sent to GTM. Default ticker_click.

Standard Joomla Module Options

These are configured on the module edit screen outside the plugin params:

• Module Class Suffix (moduleclass_sfx): Extra CSS class on the root element.
• Menu Assignment: Which pages the module appears on.
• Module Position: Template position for placement.
• Access / Language: Standard Joomla visibility controls.

• Does this module require jQuery?

  • No. Version 2.7 uses vanilla JavaScript. The name is kept for Joomla Extension Directory compatibility.

• How do I show only article titles without the label?

  • Set Show Label to No.

• Can I pin a breaking story?

  • Use Pinned Article IDs for articles, or Pin Item on custom items.

• What is the difference between hover pause and manual pause?

  • Hover pause freezes reveal at the current position. Manual pause (play button) shows the full headline.

• Can I use RTL languages?

  • Yes. Set Direction to Right to Left.

• How does Mixed mode ordering work?

  • Use Mixed Source Order to stack sources or interleave them round-robin before applying Item Count.

• No items showing: Check published articles, category selection, menu assignment, and Empty State Message. For custom items, verify schedule dates.
• RSS not loading: Confirm feed URL, increase RSS Cache, and ensure PHP can make outbound HTTP requests.
• Text cut off on mobile: Long headlines auto-scroll in reveal/fade modes. Check Width and template CSS on .jnt-root.
• Controls stacked vertically: Clear cache and confirm ticker-style.css v2.7 is loading.
• Strange separator characters: Set Item Separator to plain ASCII such as | .
• Install error: Unable to detect manifest: Use the Joomla-compatible mod_ticker_2.7.zip built with forward-slash paths.
• Styles not applying: Use Custom CSS or Module Class Suffix. Check layout preset and color fields.