wusong8899/flarum-tag-tiles

Convert tag tiles to advanced splide-based layout with social media integration and comprehensive autoplay controls

Maintainers

Details

github.com/wusong8899/flarum-tag-tiles

Source

Issues

Installs: 22

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

Open Issues: 0

Language:TypeScript

Type:flarum-extension

dev-main 2025-08-17 15:44 UTC

Requires

MIT 429199ef53dedddcac691a9ebf2d491771fd1f2f

  • wusong8899

tagscarouseltilessocial-mediaflarumautoplaysplide

This package is auto-updated.

Last update: 2025-08-17 15:44:47 UTC

README

A Flarum extension that converts the default tag tiles layout into a modern splide-based carousel with social media integration.

Features

  • Tag Tiles Conversion: Transforms standard tag tiles into an interactive splide carousel
  • Advanced Splide Configuration: Full control over autoplay, loop mode, transition speed, and more
  • Background Image Support: Integrates with flarum-tag-background extension for custom tag backgrounds
  • Social Media Integration: Displays configurable social media buttons (Kick, Facebook, Twitter, YouTube, Instagram)
  • Mobile Responsive: Optimized layout for mobile devices
  • Independent Operation: Works standalone without dependencies on other custom extensions

Advanced Splide Features

  • Autoplay Control: Enable/disable automatic slide progression with customizable delay
  • Loop Mode: Infinite loop for continuous sliding experience
  • Free Mode: Allow free sliding without snapping to slides
  • Grab Cursor: Visual feedback with grab cursor on hover
  • Pause on Hover: Automatically pause autoplay when mouse hovers over slides
  • Customizable Transitions: Adjustable transition speed and spacing between slides

Installation

composer require wusong8899/flarum-tag-tiles

Configuration

  1. Enable the extension in your Flarum admin panel
  2. Configure social media links and icons in the extension settings
  3. Adjust advanced splide settings:
    • Autoplay Settings: Enable autoplay and set delay between slides
    • Loop Mode: Enable infinite loop for continuous sliding
    • Transition Effects: Customize transition speed and spacing
    • Interactive Features: Enable grab cursor, free mode, and hover pause
  4. The extension will automatically convert tag tiles on the tags page

Advanced Configuration Options

  • Minimum Slides for Loop: Set minimum number of slides required for loop mode
  • Autoplay Delay: Control time between automatic slide transitions (in milliseconds)
  • Transition Speed: Adjust animation duration for slide transitions
  • Space Between Slides: Customize spacing between individual slides
  • Pause on Mouse Enter: Pause autoplay when hovering over the carousel
  • Grab Cursor: Show grab cursor to indicate draggable content
  • Free Mode: Allow free sliding without automatic slide snapping

Requirements

  • Flarum ^1.0
  • flarum/tags extension

License

MIT License