📖 What is Premium Playlist?

The Premium Playlist System (Tier 2) lets you create automated video playlists with ad insertion for your broadcast channel. Viewers can watch a continuous stream of your videos with ads automatically injected between them — like a TV channel for your content.

• ✅ Create playlists with unlimited videos from YouTube, Vimeo, Dailymotion & more
• ✅ Auto-advance to next video with configurable delay
• ✅ Insert ads automatically every N videos or after X minutes
• ✅ Skip button for ads (configurable countdown)
• ✅ Drag & drop reordering of playlist items
• ✅ Shuffle, loop, and autoplay controls
• ✅ Detailed analytics: plays, completions, skips, geography
• ✅ Premium subscription gating (lifetime or expiry-based)

🚀 Quick Start Guide

1. Open Playlist Manager:
   Click "Manage Playlist" in the sidebar or go to:
   /af/includes/admin-playlist-manager.php?tokenkey=YOUR_TOKEN
2. Enter your tokenkey and click Set. A playlist is auto-created if it doesn't exist.
3. Configure Settings: Name your playlist, set autoplay delay (5s recommended), enable loop.
4. Add Videos: Paste YouTube URLs and click "Add to Playlist". Repeat for all videos.
5. Reorder: Drag the ⋮⋮ handle to arrange videos in your preferred order.
6. Add Ad Rules (Optional): Configure ad insertion (e.g., every 3 videos) and paste your ad video URL.
7. Share the Player URL:
   /af/includes/its-playlist-player.php?tokenkey=YOUR_TOKEN

▶️ Player Features

🎮 Controls

• ⏮️ Previous/Next: Navigate between videos
• ▶️ Play/Pause: Toggle playback
• 🔀 Shuffle: Randomize playback order
• 🔁 Loop: Restart playlist after last video
• ⏩ Autoplay: Auto-advance to next video

⌨️ Keyboard Shortcuts

• ⌨️ Space — Play / Pause
• ⌨️ → — Next video
• ⌨️ ← — Previous video
• ⌨️ S — Skip current ad
• ⌨️ F — Toggle sidebar

📺 Sidebar

• 📋 Shows all videos in the playlist with thumbnails
• 👆 Click any video to jump directly to it
• ✅ Played videos are marked with reduced opacity
• 🔵 Current video is highlighted with a blue border

📢 Ad Insertion System

Ads are automatically injected into the playlist based on rules you configure.

Ad Rule Types:

• 🔁 Interval: Insert ad after every N videos
  Example: Every 3 videos → Video, Video, Video, AD, Video, Video, Video, AD...
• ▶️ After Video: Insert after specific videos (coming soon)

Ad Settings:

• ⏱️ Skip After X Seconds: Show skip button after countdown (0 = unskippable)
• 🔢 Max Plays Per Session: Limit how many times an ad shows per viewer (0 = unlimited)
• 🎯 Multiple Rules: Combine interval + time-based rules for sophisticated ad scheduling

📊 Analytics Dashboard

Track performance at /af/includes/live_playlist_analytics.php?tokenkey=YOUR_TOKEN

• 📈 Total Plays & Completions: See how many times your playlist is watched
• 🌍 Viewer Geography: Which countries your viewers are from
• 🏆 Top Videos: Most popular videos ranked by play count
• 📢 Ad Performance: Views vs skips, skip rate percentage
• 🕐 Peak Hours: When your playlist gets the most views
• 📅 Date Range: Filter by 24h, 7d, 30d, 90d, 1y, or all time

⭐ Premium Tiers

💡 Tip: Set premium_expires to a future date for subscription-based access, or leave it empty for lifetime premium access.

🔗 Quick Links

💬 Need help? Contact support or visit the admin dashboard for more tools.