WatchParty - Social Video Watching Platform

🌐 Live Demo:

• Frontend: https://wp.w-co.in/
• Admin Panel: https://wp.w-co.in/admin
• Admin Email: admin@gmail.com
• Admin Password: 12345678

• Create public or private rooms with custom name, description & thumbnail
• Auto-generated unique room codes for easy sharing
• Configurable max user limit (2–50 users per room)
• Room statuses: Active (live), Ended (replay mode), Closed
• End room (keeps replay) or permanently close
• Reactivate ended rooms back to live
• Private rooms with join request system (approve/reject)
• Real-time live viewer count via heartbeat system
• Room search, browse, trending, newest, and popular filters
• Room invitations to other users

▶️ Synchronized Video Playback

• YouTube — Paste any YouTube URL, embedded via IFrame API
• Vimeo — Paste any Vimeo URL, embedded via Player API
• Direct Upload — Upload MP4, WebM, OGG videos (up to 500MB)
• Host-only playback control (play, pause, seek) — viewers cannot interfere
• Real-time state sync across all viewers via smart polling
• Configurable sync interval (default: 2 seconds)
• Video queue system for upcoming videos
• Custom video player with keyboard shortcuts
• Viewer lock system with visual indicators for non-host users

💬 Live Chat

• Real-time in-room chat via AJAX long polling
• User avatars and verification badges in messages
• Message deletion (owner + admin)
• Auto-scroll to latest messages
• Chat history persistence across sessions

🎉 Emoji Reactions

• 8 emoji reaction types: 👍 ❤️ 😂 😮 😢 🔥 👏 🎉
• Real-time floating animations visible to all viewers
• Reaction counts per type
• Polling-based synchronization

📝 Community Feed

• Create posts with text (2000 chars) + optional image upload
• Like / unlike posts
• Comment system with delete capability
• Live viewer count per post
• Feed sections: All, Following, User-specific
• Dedicated "My Posts" page with search, filter, and grid/list view

👤 User Profiles

• Custom avatar & cover/banner image upload
• Editable name, email, bio (150 chars)
• Verification badge system (request → admin approval with ID proof upload)
• User stats: rooms created, posts, likes received, followers count
• Public profile pages viewable by others
• Password change from settings

🤝 Social System

• Follow / unfollow users
• Follower / following counts on profiles
• Personalized feed based on follows
• Email notifications for new followers

🔔 Notification System

• 8 notification types: room join, invite, join request, approved/rejected, new follower, badge approved/rejected
• Unread count badge in header
• Mark individual or all notifications as read
• Notification history page

👑 Premium Plans & Ad Rewards

• Ad-reward based premium system — watch ads to earn premium days
• Customizable reward tiers (e.g., watch 5 ads = 1 premium day)
• Dedicated Plan Status and Plan Renew pages
• Plan badge auto-updater across all pages
• 12+ supported ad networks: Google AdSense, Google AdMob, Unity Ads, AppLovin, ironSource, Vungle, Facebook Audience Network, Chartboost, InMobi, Start.io, AdColony, Mintegral

📊 Full Admin Panel

• Dashboard — Real-time stats: users, rooms, posts, messages, follows, badges
• User Management — View, search, ban/unban, delete, change roles, verification badge approval with ID proof review
• Room Management — View all rooms, delete, view details
• Post Management — View all posts, delete posts and comments
• Moderation — Join requests management, follow activity monitoring
• Site Settings — 50+ configurable options from one panel
• Branding — Upload custom logo & favicon
• CMS Pages — About, Help, Press, Terms, Privacy + unlimited custom pages
• Email System — 8 customizable templates, SMTP configuration, email logs, test emails, variable substitution
• Ad Management — Analytics dashboard, platform breakdown, daily charts, reward tier configuration
• Live Activity Monitor — Real-time online users, active rooms, trending rooms, recent activity feed
• SEO Engine — Dynamic meta tags, Open Graph, Twitter Cards, JSON-LD structured data, sitemap.xml, robots.txt

🔐 Authentication

• Email + password login with bcrypt hashing
• User registration with email verification
• Forgot / reset password (token-based, 1-hour expiry)
• Google OAuth sign-in (optional, configurable)
• Role-based access control (Admin / User)
• Ban system with error messaging
• Signup enable/disable control from admin

🌐 Advanced SEO

• Dynamic meta tags per page
• Open Graph (og:title, ogescription, og:image, og:type)
• Twitter Cards (twitter:card, twitter:title, twitterescription)
• JSON-LD Schema: WebSite, Organization, VideoObject, Article, ProfilePage, BreadcrumbList
• Auto-generated sitemap.xml & robots.txt
• Canonical URLs
• Google Analytics integration

🔒 Security

• bcrypt password hashing
• PDO prepared statements — zero SQL injection
• XSS protection via htmlspecialchars sanitization
• Session-based authentication with 24h lifetime
• File upload validation (MIME + extension + size limits)
• PHP execution blocked in upload directories
• Security headers: X-Frame-Options, X-XSS-Protection, X-Content-Type-Options
• Directory & sensitive file protection
• Install lock prevents unauthorized reinstallation

📱 Responsive Design

• Fully responsive across desktop, tablet, and mobile
• Mobile navigation with hamburger menu
• Touch-friendly UI components
• 3-column layout on desktop, adaptive on smaller screens

🏗️ Architecture

• Pure PHP MVC — no heavy framework dependency
• 12 Controllers, 14 Models, 24 View templates
• 15 modular JavaScript files
• 23 database tables with proper indexing
• RESTful API with 80+ endpoints
• Composer autoloading with optimized classmap
• Tailwind CSS + Font Awesome 6 (fully offline, no CDN needed)

Features

• Real-time synchronized video playback (YouTube, Vimeo, direct upload)
• Public & private watch rooms with unique room codes
• Host-only video control with viewer lock system
• Video queue system for playlists
• Live in-room chat with avatars and badges
• 8 animated emoji reactions with floating animations
• Community feed with posts, likes, and comments
• User profiles with avatar, cover, bio, and stats
• Follow / unfollow social system
• Verification badge system with ID proof upload
• 8-type notification system with unread count
• Ad-reward premium plans with 12+ ad network support
• Full admin panel with dashboard, user/room/post management
• 50+ admin-configurable settings
• CMS pages (About, Terms, Privacy, Help + unlimited custom pages)
• Email system with 8 templates, SMTP, logs, and test emails
• Advanced SEO: Open Graph, Twitter Cards, JSON-LD, sitemap, robots.txt
• Google OAuth sign-in (optional)
• 6-step installation wizard — no coding required
• Supports Apache, LiteSpeed, Nginx, and IIS
• Fully responsive: desktop, tablet, and mobile
• Tailwind CSS + Font Awesome 6 — fully offline, no CDN
• bcrypt passwords, PDO prepared statements, XSS protection
• Live activity monitor: online users, active rooms, trending
• Branding control: custom logo and favicon upload
• Google Analytics integration
• Dedicated My Rooms & My Posts management pages
• Plan Status & Plan Renew pages with ad reward flow
• Room browse page with search, trending, newest, popular filters
• Replay mode for ended rooms

Requirements

Required

• PHP 7.4 or higher (PHP 8.x recommended)
• MySQL 5.7+ or MariaDB 10.3+
• PDO + PDO MySQL extension
• mbstring extension
• JSON extension
• Session support
• mod_rewrite (Apache/LiteSpeed) or equivalent

Recommended

• cURL extension — for external API calls
• OpenSSL extension — for encryption
• GD or Imagick extension — for image processing
• Fileinfo extension — for file validation
• upload_max_filesize: 64MB minimum (500MB for video uploads)
• post_max_size: 64MB minimum
• max_execution_time: 120 seconds minimum
• memory_limit: 256MB minimum

Supported Web Servers

• Apache 2.4+ — Fully Supported (.htaccess auto-generated)
• LiteSpeed — Fully Supported (.htaccess auto-generated)
• OpenLiteSpeed — Fully Supported (.htaccess auto-generated)
• Nginx — Supported (nginx.conf.sample auto-generated)
• IIS (Windows) — Supported (web.config auto-generated)

Supported Hosting

• Any shared hosting with PHP 7.4+ and MySQL (cPanel, DirectAdmin, Plesk)
• VPS and Dedicated Servers
• Cloud hosting: DigitalOcean, Vultr, Linode, AWS, Google Cloud
• XAMPP / WAMP / MAMP for local development

Instructions

Installation (6-Step Wizard)

1. Upload Files — Upload the entire watchparty folder to your web server document root (public_html or /var/www/html/)
2. Set Permissions — Run: chmod -R 755 config/ public/uploads/ install/

• Step 1: Welcome — auto-detects your server type   
• Step 2: System Check — verifies PHP version, extensions, and permissions   
• Step 3: Database — enter your MySQL credentials (auto-creates database if needed)   
• Step 4: Admin Setup — create your admin account and set site name   
• Step 5: Finalize — auto-generates all config files (.htaccess, database.php, .user.ini, nginx.conf.sample, web.config)   
• Step 6: Done — your WatchParty is ready!   

Quick Configuration

• All settings are managed from the Admin Panel → Settings section
• Configure SMTP for emails (Gmail, SendGrid, Mailgun, or any SMTP server)
• Set up Google OAuth for social login (optional)
• Configure ad networks for the premium plan system
• Upload your logo and favicon from Branding settings
• Create custom CMS pages (About, Terms, Privacy, etc.)
• Set room limits, upload sizes, and access controls

Admin Panel Access

Navigate to: https://yourdomain.com/?page=admin

Use the admin credentials you created during installation.