FAQ & Troubleshooting
General Questions
Q: Is this a hosted solution or do I need my own server?
A: This is a self-hosted solution. You need your own web server with PHP, MySQL, and SSH access. It's not a SaaS platform.
Q: Can I customize the design and branding?
A: Yes, completely! You have full access to the source code. Customize colors, logos, themes, and layouts using Laravel Blade templates and Tailwind CSS.
Q: Can I use this on shared hosting?
A: Yes, if your hosting supports PHP 8.4+, MySQL 8.0+, and provides SSH access. You may need to contact your host to enable Composer or increase resource limits.
Q: Do I need Node.js to run this?
A: No. Assets are pre-compiled. Node.js is only needed if you want to modify frontend CSS/JavaScript.
Q: What about free trials or demo?
A: Check CodeCanyon's preview/demo features. Install locally first to test before deploying to production.
Installation & Setup
Q: Is installation difficult?
A: MoodFlix includes an automated installer wizard that guides you through setup step-by-step. No command-line knowledge required for basic installation.
Q: Can you install it for me?
A: Contact support at rokbyte@gmail.com for paid installation and setup services.
Q: What's needed before installation?
A: Web hosting, domain name, SSL certificate, and API keys for TMDB and payment gateways. The installer checks everything for you.
Content Management
Q: How do I add movies?
A: Two methods: (1) Manual entry via Admin → Movies → Create, or (2) Bulk import from TMDB via Admin → TMDB Import.
Q: Can I import from TMDB automatically?
A: Yes! Built-in TMDB importer lets you search and import movies, TV shows, cast, episodes, and images automatically. Requires free TMDB API key.
Q: How long does TMDB import take?
A: Single movie imports take seconds. Large bulk imports (1000+ items) run in background via queue system.
Q: Can I edit movies after importing?
A: Yes. All imported data is fully editable. You can modify titles, descriptions, images, cast, pricing, and anything else.
Q: How do I manage TV series?
A: Admin → TV Shows. Create show → Add Seasons → Add Episodes. Full episode-level metadata support (title, air date, guest stars, etc.).
Payments & E-Commerce
Q: What payment methods are supported?
A: 8+ gateways: Stripe, PayPal, Razorpay, Chapa, Paystack, Flutterwave, Mollie, and Cash on Delivery (COD).
Q: How do I set up payments?
A: Get API keys from payment provider → Admin → Payment Methods → Enable and configure → Test mode available for testing.
Q: Can I accept multiple currencies?
A: Yes. Stripe, Razorpay, Flutterwave, and Mollie support multiple currencies. Configure in payment settings.
Q: Can I process refunds?
A: Yes. Refund directly from Admin → Orders. Refunds are processed through your payment gateway.
Q: Can customers save payment methods?
A: Yes. Payment gateways like Stripe support saved cards for faster checkout on future purchases.
Cinema Booking
Q: How do I set up cinema screenings?
A: Admin → Screenings. Create screening with movie, date, time, theater, seat layout, and ticket prices.
Q: Can I have different seat prices (VIP, Regular, etc.)?
A: Yes. Define seat categories (Premium, Regular, Economy) with different prices in theater configuration.
Q: Do customers get booking confirmation?
A: Yes. Automatic email with QR code or booking reference. Customers can cancel and get refunds based on your policy.
Multi-Language Support
Q: Is the platform multi-language?
A: Yes! Admin → Languages. Add any language you want. Users can switch languages in the frontend. Supports RTL languages (Arabic, Urdu, etc.).
Q: How do I translate content?
A: Movies, products, pages, and UI text can all be translated. Edit in each language separately in the admin panel.
Admin & Reporting
Q: What's the default admin login?
A: Set during installation. Change password immediately in production for security.
Q: Can I create multiple admin users?
A: Yes. Admin → Users. Create as many admins as needed with full or limited permissions.
Q: What analytics are available?
A: Sales dashboard, revenue, orders, users, popular content, booking stats. Export reports in CSV format.
Q: Can I backup my data?
A: Yes. Backup database via phpMyAdmin or command line. Keep regular backups for safety.
Security
Q: Is the application secure?
A: Yes. Built on Laravel with CSRF protection, SQL injection prevention, XSS protection, and secure password hashing.
Q: Are payments secure?
A: Yes. PCI-DSS compliant. Payment gateways handle sensitive data; your server never sees full credit card numbers.
Q: Should I use SSL/HTTPS?
A: Absolutely yes. Use HTTPS on your domain for payment pages and admin panel. Most hosts offer free SSL (Let's Encrypt).
Q: Are API keys stored securely?
A: Yes. All sensitive settings are encrypted and stored securely in the database. Never exposed in source code.
Technical & Development
Q: Can I extend the functionality?
A: Yes. Full Laravel source code available. You can add custom features, packages, and integrations.
Q: Is there an API for custom development?
A: Yes. RESTful API built-in. Extensive code documentation for developers. Webhook support for real-time updates.
Q: What's the codebase size?
A: Approximately 50+ Laravel files with comprehensive code organization. Well-documented and follows Laravel best practices.
Q: Is it production-ready?
A: Yes, fully production-ready with proper error handling, logging, and performance optimization.
Troubleshooting
Storage Link Error
php artisan storage:link
Database Connection Error
# Verify credentials in .env
# Ensure MySQL is running
php artisan migrate
Permission Denied on Storage
chmod -R 775 storage/
chmod -R 775 bootstrap/cache
Clear Cache
php artisan cache:clear
php artisan view:clear
php artisan route:clear
TMDB Import Issues
- Check TMDB API key is correct
- Verify API rate limits aren't exceeded
- Check logs:
storage/logs/laravel.log
- Large imports may timeout — use background queue
Email Not Sending
- Configure SMTP in Admin → Settings
- Verify credentials with email provider
- Check mail logs for errors
- Ensure your server allows outgoing SMTP connections
Need More Help?
Email: rokbyte@gmail.com
Documentation: This guide covers all features and configuration
Laravel Community: Extensive Laravel resources available online
