Travel In

PHP Requirements

• PHP Version: 8.1 or higher (8.2+ recommended)
• Extensions Required:
  • BCMath PHP Extension
  • Ctype PHP Extension
  • Fileinfo PHP Extension
  • JSON PHP Extension
  • Mbstring PHP Extension
  • OpenSSL PHP Extension
  • PDO PHP Extension
  • Tokenizer PHP Extension
  • XML PHP Extension
  • GD Library / Imagick (for image processing)
  • cURL Extension
  • Zip Extension

Database Requirements

• MySQL: Version 5.7 or higher
• MariaDB: Version 10.2 or higher
• Collation: utf8mb4_unicode_ci (recommended)
• Permissions: CREATE, ALTER, DROP, INSERT, UPDATE, DELETE, SELECT

Web Server

• Apache 2.4+ with mod_rewrite enabled
• Nginx 1.10+ (alternative to Apache)
• Document Root: Must point to /public directory

Server Configuration

• Memory Limit: 256M or higher (512M recommended)
• Max Execution Time: 300 seconds or higher
• Max Upload Size: 20M or higher (for image uploads)
• Max Post Size: 25M or higher

• PHP Version: 8.1 or higher
• Laravel: 10.10 or higher
• Database: MySQL 5.7+ or MariaDB 10.2+
• Web Server: Apache or Nginx
• Extensions: OpenSSL, PDO, Mbstring, Tokenizer, XML, Ctype, JSON, BCMath

For Local Development (XAMPP/WAMP):

1. Navigate to your XAMPP htdocs folder (or WAMP www folder)
2. Create a new folder (e.g., travelnew)
3. Extract all files from the package ZIP into this folder
4. Your path should be: C:\xampp\htdocs\travelnew\

For Production Server:

1. Upload all files to your domain's public_html directory
2. Ensure proper file permissions are set

You have two options for database setup:

Option A: Using SQL File (Quick Setup)

1. Create a new database in phpMyAdmin
2. Import the travelin25.sql file located in the root directory
3. Wait for the import to complete

Option B: Using Laravel Migrations (Recommended)

1. Create a new database in phpMyAdmin
2. Configure your .env file with database credentials
3. Run the following command:

   php artisan migrate

Migrations provide better version control and are recommended for production deployments.

Open the .env file in the root directory and update the following:

APP_NAME=TravelIn
APP_ENV=local
APP_DEBUG=true
APP_URL=http://localhost/travelnew

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_username
DB_PASSWORD=your_password

Run the following commands in your terminal:

php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear

Create Storage Link: Visit http://yourdomain.com/storage-link to create the symbolic link for profile photos and other uploads.

Login to the admin panel using:

URL: http://yourdomain.com/login

Email: admin@demo.com
Password: demo2626

1. Site Settings

Navigate to Admin Panel → Settings → Site Settings and configure:

• Site Logo & Favicon
• Company Name & Contact Information
• SMTP Email Configuration
• Duffel API Credentials (for flight search)
• Payment Gateway Settings (PayPal, Stripe, Paystack)

2. Add Languages

Navigate to Admin Panel → Languages → Add New:

1. Enter Language Name (e.g., "Arabic")
2. Enter Language Code (e.g., "ar")
3. Upload Flag Image
4. Check "RTL" if applicable
5. Save

3. Add Location Data

Start adding your location data:

1. Countries: Admin → Locations → Countries
2. States: Admin → Locations → States
3. Cities: Admin → Locations → Cities
4. Airports: Admin → Locations → Airports

The admin dashboard displays key statistics and quick access to important features:

• Statistics Cards: Total bookings, revenue, active users
• Recent Bookings: Latest tour, hotel, and flight bookings
• Revenue Charts: Monthly revenue visualization
• Quick Actions: Access to frequently used features
• System Notifications: Important alerts and updates

Features

• View All Users: Complete list with search and filters
• Add New User: Create user accounts manually
• Edit User: Update profile information, email, password
• Delete User: Remove user accounts
• User Status: Activate/deactivate accounts
• View Bookings: See all bookings by specific user
• Team Management: Manage team members and permissions

Tour Operations

• Create Tours: Add new tour packages with complete details
• Edit Tours: Update tour information, pricing, availability
• Delete Tours: Remove old or discontinued tours
• Tour Gallery: Upload multiple images per tour
• Pricing Management: Set prices, discounts, seasonal rates
• Itinerary Builder: Day-by-day tour schedule
• Inclusions/Exclusions: What's included in the package

Tour Bookings

• View All Bookings: Filter by status, date, customer
• Booking Details: Complete customer and payment info
• Status Management: Pending, Confirmed, Completed, Cancelled
• Email Notifications: Send confirmations and updates
• Payment Tracking: View payment status and amounts

Hotel Operations

• Add Hotels: Create hotel listings with complete details
• Edit Hotels: Update hotel information and amenities
• Delete Hotels: Remove hotel listings
• Hotel Gallery: Upload hotel photos and images
• Room Management: Different room types with pricing
• Amenities: WiFi, pool, gym, parking, etc.
• Location Details: Map integration and address

Hotel Bookings

• View Bookings: All hotel reservations
• Check-in/Check-out: Manage arrival and departure dates
• Guest Details: Complete guest information
• Special Requests: Customer requirements and notes
• Status Updates: Booking confirmation and management

Flight System

• Duffel API Integration: Real-time flight data
• Flight Search: One-way, round-trip, multi-city
• Airlines Management: Manage airline information
• Airports Database: IATA/ICAO codes management
• Pricing Controls: Service fees and markups

Flight Bookings (Version 4.1)

• View All Bookings: Complete flight reservation list
• Passenger Details: All passenger information
• Passport Information: Complete passport data for all passengers
• Age Validation: Automatic age verification
• PDF Downloads: Booking tickets with all details
• Payment Status: Track payment completion
• Booking Reference: Unique booking IDs

Language Management

• Add Languages: Create new language entries
• Edit Languages: Update language details
• Delete Languages: Remove unused languages
• Flag Upload: Custom flag images for each language
• RTL Support: Enable Right-to-Left for Arabic, Hebrew, etc.
• Default Language: Set primary site language
• Status Control: Enable/disable languages

Translation Management

• Menu Translations: Translate navigation menus
• Content Translations: Translate tours, hotels, blogs
• Widget Translations: Homepage widgets and sections
• Static Text: Frontend labels and buttons
• Bulk Translation: Translate multiple items at once

Navigation Menus

• Create Menus: Multiple menu locations
• Menu Items: Add/edit/delete menu items
• Nested Menus: Multi-level dropdown support
• Menu Types: Header, Footer, Sidebar menus
• External Links: Link to external websites
• Menu Translations: Translate menu items
• Sort Order: Drag-and-drop menu ordering
• Custom URLs: Add any URL to menu

General Settings

• Site Logo: Upload main and footer logos
• Favicon: Site icon
• Company Info: Name, address, contact details
• Social Media: Facebook, Twitter, Instagram, etc.
• Copyright Text: Footer copyright message
• Currency: Default currency for bookings

Email Configuration

• SMTP Settings: Host, port, username, password
• From Email: Sender email address
• From Name: Sender name
• Test Email: Send test emails
• Email Templates: Booking confirmations, notifications

Payment Gateway Settings

• PayPal: Client ID, Secret, Mode (Sandbox/Live)
• Stripe: Publishable Key, Secret Key
• Paystack: Public Key, Secret Key
• Service Fees: Add percentage or fixed fees
• Currency Settings: Payment currency configuration

Duffel API Settings

• API Token: Duffel access token
• API Mode: Test or Live environment
• Service Fees: Flight booking fees
• Currency: Default flight currency

Message Management

• View Messages: All contact form submissions
• Message Details: Name, email, subject, message
• Reply: Respond directly from admin panel
• Delete Messages: Remove old messages
• Mark as Read: Organize messages
• Export: Download messages as CSV

Review System

• View All Reviews: Tours, hotels, flights reviews
• Approve/Reject: Moderate customer reviews
• Edit Reviews: Update review content if needed
• Delete Reviews: Remove inappropriate reviews
• Rating System: 1-5 star ratings
• Featured Reviews: Highlight best reviews
• Email Notifications: Alert admins of new reviews

Available Reports

• Booking Reports: Daily, weekly, monthly booking stats
• Revenue Reports: Total revenue by period
• Payment Reports: Payment gateway wise reports
• User Reports: Registration and activity stats
• Popular Destinations: Most booked locations
• Export Data: Download reports as PDF/Excel

Security Features

• Admin Roles: Different permission levels
• Team Management: Multiple admin accounts
• Activity Log: Track admin actions
• Password Protection: Secure password hashing
• Two-Factor Auth: Enhanced security (optional)
• Session Management: Control active sessions

Customize Homepage

• Hero Section: Banner image and text
• Search Widget: Homepage search form
• Featured Tours: Highlight top tours
• Featured Hotels: Showcase hotels
• Popular Destinations: Display top cities
• Testimonials Section: Customer reviews
• Blog Posts: Latest blog entries
• Call-to-Action: Custom CTA sections

Features

• Online Booking: Users can book tours directly from the frontend
• Pricing Management: Dynamic pricing with per-person or per-group options
• Date Selection: Availability calendar for tour dates
• Email Notifications: Automatic confirmation emails to customers and admin
• Booking Management: Admin panel to view and manage all bookings
• Status Tracking: Pending, Confirmed, Completed, Cancelled statuses

Features

• Room Selection: Multiple room types with different pricing
• Check-in/Check-out: Date range selection with automatic rate calculation
• Guest Details: Collect guest information during booking
• Special Requests: Allow customers to add special requirements
• Payment Integration: Multiple payment gateway support
• Booking Confirmation: Instant confirmation with booking reference

Features

• Duffel API Integration: Real-time flight search and booking
• Multi-Passenger Support: Adults, children, and infants
• Passport Information: Complete passport details collection (Version 4.1)
• Age Validation: Smart age-based DOB validation (Version 4.1)
• Optional Add-ons: Extra services like meals, baggage, seats
• Price Breakdown: Transparent pricing with taxes and fees
• PDF Tickets: Downloadable booking confirmation PDFs
• Admin Management: Full booking management in admin panel

1. Visit https://developer.paypal.com
2. Click "Log In" or "Sign Up" if you don't have an account
3. Use your existing PayPal account or create a new one
4. Accept the developer agreement

1. Go to Dashboard > My Apps & Credentials
2. Select "Sandbox" for testing or "Live" for production
3. Click "Create App" button
4. Enter your App Name (e.g., "TravelIn")
5. Select app type: "Merchant"
6. Click "Create App"

After creating the app, you'll see:

• Client ID: Copy this value
• Secret: Click "Show" and copy this value

1. Login to Admin Panel
2. Navigate to Settings → PayPal Settings
3. Enable PayPal: Yes
4. PayPal Mode: sandbox (for testing) or live (for production)
5. Paste your Client ID
6. Paste your Secret
7. Click "Save Settings"

1. Visit https://stripe.com
2. Click "Sign Up" or "Start Now"
3. Enter your email and create a password
4. Complete business information
5. Verify your email address

1. Login to Stripe Dashboard
2. Click "Developers" in the left sidebar
3. Click "API keys"
4. You'll see two sets of keys:
   • Test keys (for development)
   • Live keys (for production - visible after activation)
5. For each set, copy:
   • Publishable key: Starts with pk_test_ or pk_live_
   • Secret key: Starts with sk_test_ or sk_live_ (click "Reveal" first)

1. Login to Admin Panel
2. Navigate to Settings → Stripe Settings
3. Enable Stripe: Yes
4. Paste your Publishable Key
5. Paste your Secret Key
6. Click "Save Settings"

General Testing Steps

1. Use sandbox/test mode credentials for all gateways
2. Test card numbers (each gateway provides their own):
   • Stripe: 4242 4242 4242 4242
   • PayPal: Use PayPal sandbox accounts
   • Paystack: 4084 0840 8408 4081
3. Make a test booking (tour, hotel, or flight)
4. Verify transaction appears in:
   • Gateway dashboard
   • Travel In admin panel
   • Customer email confirmation
5. Test both successful and failed transactions
6. Once satisfied, switch to live mode credentials

Create backups before starting any update:

• Database Backup:

  # Using phpMyAdmin:
  - Select your database
  - Click "Export" tab
  - Choose "Quick" or "Custom" method
  - Click "Go" to download SQL file
  
  # Using Command Line:
  mysqldump -u username -p database_name > backup_$(date +%Y%m%d).sql

• Files Backup:

  # Backup entire project folder
  # Or use your hosting control panel backup feature

Download the update package from CodeCanyon. The update package contains:

• Updated files in the Update folder
• Database SQL files in the database folder
• Update instructions (README.txt)

Copy files from Update folder to your project:

1. Extract the update package
2. Open the Update folder
3. Copy all files and folders maintaining the exact directory structure
4. Overwrite existing files in your project root
5. Ensure folder permissions remain correct (755 for folders, 644 for files)

Execute SQL queries if provided:

1. Open phpMyAdmin (or your database management tool)
2. Select your database
3. Go to the "SQL" tab
4. Open the SQL file from the database folder
5. Copy and paste the SQL queries into the SQL tab
6. Click "Go" to execute
7. Verify the queries executed successfully

Example SQL file location:

• database/payment_gateway_settings.sql - For Payment Gateway Settings update

Clear Laravel caches to ensure changes take effect:

php artisan config:clear
php artisan cache:clear
php artisan view:clear
php artisan route:clear
php artisan optimize:clear

Or use the combined command:

php artisan optimize:clear

Configure any new features in admin panel:

• Login to admin panel
• Check for new settings or configuration pages
• Configure new features as needed
• Test all updated functionality

For Payment Gateway Settings Update:

1. Go to: Settings → Payment Gateways
2. Configure each payment gateway (PayPal, Stripe, Paystack)
3. Enter your API keys and secrets
4. Select mode (Test/Sandbox or Live)
5. Enable/disable payment gateways as needed
6. Click "Save Settings"

Thoroughly test all updated features:

• Test payment processing for all gateways
• Verify payment methods show/hide correctly based on admin settings
• Test booking flows (flights, hotels, tours)
• Check admin panel functionality
• Verify email notifications still work
• Test on different browsers and devices

What This Update Includes

• ✅ Payment Gateway Management System in Admin Panel
• ✅ Complete Paystack Integration (Flights, Hotels, Tours)
• ✅ Conditional Payment Method Display (based on admin settings)
• ✅ Settings stored in database (no .env configuration needed)

Files Updated

The following files have been updated (located in Update folder):

• app/Http/Controllers/Admin/SettingsController.php
• app/Http/Controllers/FlightsController.php
• app/Http/Controllers/HotelsController.php
• app/Http/Controllers/ToursController.php
• app/Http/Controllers/Api/PaymentController.php
• app/Providers/AppServiceProvider.php
• routes/admin.php
• resources/views/admin/settings/payment-gateways.blade.php (NEW)
• resources/views/livewire/admin/common/sidebar.blade.php
• resources/views/flights/payment.blade.php
• resources/views/hotel-payment.blade.php
• resources/views/tours/payment-selection.blade.php

Database Changes

Run this SQL file: database/payment_gateway_settings.sql

This will add the following settings to your settings table:

• PayPal: paypal_account, paypal_client_id, paypal_secret, paypal_mode, paypal_active
• Stripe: stripe_key, stripe_secret, stripe_mode, stripe_active
• Paystack: paystack_public_key, paystack_secret_key, paystack_merchant_email, paystack_mode, paystack_active

❌ White Screen After Update

Solution:

php artisan config:clear
php artisan cache:clear
php artisan view:clear
php artisan route:clear

Then check storage/logs/laravel.log for specific errors.

❌ Payment Gateway Not Showing

Solutions:

• Ensure you ran the database SQL file
• Go to Admin → Settings → Payment Gateways
• Configure and enable the payment gateway
• Clear cache: php artisan config:clear

❌ Database Error After SQL Import

Solutions:

• Check if settings already exist (use INSERT IGNORE version if needed)
• Verify database connection
• Check if settings table exists
• Ensure you're running SQL on the correct database

❌ Routes Not Working

Solution:

php artisan route:clear
php artisan route:cache

❌ 500 Internal Server Error

Causes & Solutions:

• Permission Issues:

  chmod -R 775 storage bootstrap/cache

• Cache Issues:

  php artisan config:clear
  php artisan cache:clear
  php artisan view:clear
  php artisan route:clear

• Check Error Logs: storage/logs/laravel.log
• Missing APP_KEY: Run php artisan key:generate

❌ Database Connection Error

Solutions:

• Verify database credentials in .env file
• Ensure database exists and user has proper privileges
• Check if MySQL service is running
• Try DB_HOST=localhost instead of 127.0.0.1 or vice versa
• Ensure database port (3306) is correct

❌ Blank Page / White Screen

Solutions:

• Check PHP error logs
• Ensure .env file exists and is properly configured
• Run: php artisan key:generate
• Clear all caches (see above)
• Check file permissions for storage/ and bootstrap/cache/

❌ Images Not Uploading

Solutions:

• Check public/ directory permissions (755 or 775)
• Increase upload_max_filesize in php.ini (e.g., 20M)
• Increase post_max_size in php.ini (e.g., 25M)
• Ensure storage/ is writable
• Create storage link: Visit http://yourdomain.com/storage-link

❌ Emails Not Sending

Solutions:

• Verify MAIL settings in .env file
• Test SMTP credentials using a tool like Mailtrap
• Check storage/logs/laravel.log for email errors
• Ensure port 587 or 465 is not blocked by firewall
• For Gmail: Use "App Password" not regular password (enable 2FA first)
• Verify your email provider allows SMTP access

❌ Payment Gateway Not Working

Solutions:

• Verify API credentials are correct in admin settings
• Ensure gateway is enabled in admin panel
• Check if in test/sandbox mode for testing
• Review gateway error logs in Laravel logs
• Verify webhook URLs are configured (if required)
• Ensure SSL certificate is installed (required for live payments)

❌ Flight Search Not Working (Duffel API)

Solutions:

• Verify Duffel API token in admin settings
• Check if API token is active and not expired
• Ensure airports are properly configured in database
• Check Laravel logs for API error messages
• Verify your Duffel account has sufficient credits/access

Test Case 1: Adult Passenger with Passport

1. Search for a flight with 1 adult
2. Fill in passenger details
3. Try to select date of birth - should be limited to 18-100 years old
4. Fill in all 5 passport fields
5. Submit booking
6. Expected: Booking successful with passport data saved

Test Case 2: Child Passenger

1. Search for a flight with 1 child
2. Try to select date of birth
3. Expected: Can select any date up to today (including today)
4. Expected: Cannot select dates older than 18 years ago
5. Complete passport fields and submit

Test Case 3: Verify Passport Display

1. Complete a flight booking
2. Go to booking details page
3. Download user PDF
4. Check admin panel for booking
5. Download admin PDF
6. Expected: All pages show complete passport information