Topic List Previews (TLP)

merefield · August 29, 2026, 9:04pm

There’s now a vastly improved Featured Images presentation option - “Carousel”.

See https://www.starzen.space/ for a demo

github.com/merefield/discourse-tc-topic-list-previews

FEATURE: Add carousel options for featured images (#70)

master ← feature/featured-images-carousel

merged 08:53PM - 29 Aug 26 UTC

merefield

+1121 -90

Previously, featured images used a continuously scrolling tag-based strip with f…ixed placement and no responsive carousel option. This change adds flexible view, placement, and source options while preserving the existing camera-roll behavior by default. Major changes: - Adds a `Camera roll` or `Carousel` featured-images view setting. - Adds a desktop carousel maximum of 1–4 images, defaulting to 3 and automatically showing fewer when the available width becomes too narrow. - Displays complete carousel images with equal spacing and previous/next controls at the extreme edges. - Adds a single-image mobile carousel with physics-based pointer dragging and no navigation buttons. - Adds three-state position dots representing the beginning, middle, and end of the featured-topic population. - Supports keyboard navigation, accessible position announcements, RTL layouts, accidental-click suppression after dragging, and reduced-motion preferences. - `Left Arrow` and `Right Arrow` move one image backward or forward, respecting RTL direction. - `Home` jumps to the beginning. - `End` jumps to the final set of images. - Keyboard handling is active only while focus is on the carousel viewport or one of its descendants; it does not capture keys globally. - Adds a tag/category source selector and allows the existing source field to accept pipe-delimited tags or a category slug. - Makes the optional featured source footer generic, linking to the configured tags or category. - Migrates overridden values from `topic_list_featured_images_tag_show` to `topic_list_featured_images_source_show`. - Adds placement options for `discovery-list-container-top` (above the topic list) and `discovery-list-controls-above` (above navigation controls). - Uses the featured-image height settings as desktop/mobile maximum heights in carousel mode while preserving natural image proportions. - Limits the “larger featured tiles” presentation to desktop widths; mobile tiles retain the normal layout. - Adds integration and unit coverage for carousel navigation, mobile dragging, responsive sizing, placement selection, and tag/category requests.

Topic		Replies	Views
Topic List Thumbnails Theme component official , topic-list-thumbnails	160	36221	August 13, 2026
MD Topic List Mobile component Theme component	67	7646	July 21, 2026
Homepage Feature Theme component official , homepage-feature	136	25588	July 9, 2026
FKB Pro - Social theme Theme	496	38739	September 2, 2026
MD Topic List component Theme component	73	10576	September 7, 2025

Topic List Previews (TLP)

Related topics