[XR] XFRM Sliders

---

Overview

Transform your XenForo Resource Manager index into a modern, engaging showcase with beautiful card-based sliders. Display your recent and top resources in an eye-catching carousel format that encourages exploration and improves user engagement.

---

Key Features

Fully Responsive Design

• Desktop: 3-5 cards per row (admin configurable)
• Tablet: Auto-adjusts to 2 cards
• Mobile: Optimized single-card view with peek effect
• Touch-friendly swipe navigation

Modern Visual Design

• Smooth scroll animations
• Elegant card hover effects
• Category badges with blur backdrop
• "New" and "Top" resource indicators
• Beautiful gradient hero sections
• Resource thumbnails with fallback icons

Admin Control

• Set resource limit per widget (1-20)
• Choose cards per row: 3, 4, or 5 columns
• Independent configuration for Recent and Top sliders
• Widget system integration - place anywhere

Peek Effect

• Partial next/previous card visible at edges
• Edge fade indicators show scroll state
• Creates "there's more" visual cue
• Encourages user interaction

Resource Information Display

• Resource title and category
• Author avatar and username
• Upload/update date
• Version number
• Download count
• Star ratings
• Direct "View resource" button

---

Two Widget Types

Recent Resources Slider
Shows the latest uploaded and updated resources sorted by date. Perfect for highlighting fresh content and keeping your community informed about new additions.

Top Resources Slider
Displays the most popular resources ranked by rating and download activity. Ideal for showcasing community favorites and quality content.

---

Technical Highlights

• XenForo 2.3 compatible (FA SVG icons, no jQuery)
• Vanilla JavaScript - no external dependencies
• LESS integration with XF style properties
• Proper permission checking (canViewResources)
• Ignored users filtering
• Accessible (ARIA labels, keyboard navigation)
• SEO-friendly semantic HTML
• No template modifications required
• Performance optimized (lazy loading images)

---

Installation

1. Upload & Install

1. Download the ZIP file
2. Admin CP → Add-ons → Install/upgrade from archive
3. Upload the ZIP and click "Install"

2. Add Widgets

1. Admin CP → Appearance → Widgets
2. Click "Add widget" → Select "[XR] Recent Resources Slider" or "[XR] Top Resources Slider"
3. Choose position (typically "xfrm_overview_sidebar" or "xfrm_overview_above_list")
4. Configure options:
   • Limit: Number of resources to display (1-20)
   • Cards per row: 3, 4, or 5 columns (desktop only)
5. Save widget

3. Done!
Visit your Resource Manager index to see the sliders in action.

---

Configuration Examples

Minimal Setup (Sidebar)
Position: xfrm_overview_sidebar
Limit: 5 resources
Cards per row: 3

Featured Showcase (Above List)
Position: xfrm_overview_above_list
Limit: 10 resources
Cards per row: 5

Dual Widgets (Recent + Top)
Widget 1: Recent Resources - 8 resources, 4 cards
Widget 2: Top Resources - 8 resources, 4 cards
Both in xfrm_overview_above_list

---

Upgrade from 1.1.0 → 1.2.0

New in v1.2.0:

• Admin-configurable columns (3/4/5 cards per row)
• Enhanced peek effect for better UX
• Edge fade indicators
• Automatic widget cache rebuild on upgrade

Simply upload the new ZIP via Admin CP → Add-ons. Your existing widgets will auto-upgrade with default 3-column layout.

---

Browser Support

• Chrome 90+
• Firefox 88+
• Safari 14+
• Edge 90+
• Mobile browsers (iOS Safari, Chrome Android)

---

Support

Need help? Post your questions in this thread or visit Bxen.net.

Before asking for support:

• Check you're running XenForo 2.3.0+ and XFRM 2.3.10+
• Verify widgets are added to a valid position
• Clear XF cache (Admin CP → Tools → Caches → Rebuild)
• Check browser console for JavaScript errors

---

License

This add-on is released under standard XenForo add-on license terms. One license per XenForo installation.

---