System Configuration Guide

This guide details the core system settings and infrastructure requirements to ensure your Preads Platform installation is secure, performant, and correctly branded.

🛠️ Admin Panel Settings

Most system configurations are managed directly through the Admin → Settings dashboard.

1. General Settings

Located at Admin → Settings → General, these settings define your platform's core identity and regional behavior.

Group Key Setting Impact
Branding Site Name Displayed in Page Titles, Headers, and Emails.
SEO Meta Keywords/Description Controls how your platform appears in search engines.
Regional Timezone Sets the default timezone for all transactions and stats.
System Contact Email The official support address for system-generated alerts.

2. Security & Verification

Protect your platform and verify your users at Admin → Settings → Publisher Settings.

  • Registration: Toggle user signups on or off.
  • Email Verification: Force users to verify their email before accessing the offerwall.
  • Manual Approval: When enabled, admins must manually approve every new publisher account.
  • Two-Factor Authentication (2FA): Enabling this enforces Google Authenticator or Email TOTP for admin accounts.

3. Authentication & CAPTCHA

Located at Admin → Settings → Social Auth and Captcha Settings.

  • Social Sign-In: Supports Google, Facebook, and Twitter. Requires Client IDs and Secrets.
  • CAPTCHA: Supports reCAPTCHA and hCaptcha. Essential for preventing bot registrations and brute-force attacks.

🏗️ Infrastructure & Environment

Advanced configurations are handled via the .env file and system-level services.

1. Environment Variables

Your .env file should be optimized for a production environment.

APP_ENV=production
APP_DEBUG=false
APP_URL=https://your-domain.com

# Database Connection
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_DATABASE=preads_platform
DB_USERNAME=your_user
DB_PASSWORD="your_password"

Security Alert

Always keep APP_DEBUG=false in production. Enabling debug mode exposes sensitive database credentials and environment secrets on error pages.

2. Caching & Performance

For high-traffic platforms, we recommend using Redis for sessions and caching.

SESSION_DRIVER=database  # Options: file, database, redis
CACHE_STORE=database    # Options: file, database, redis

3. Automated Tasks (CRON)

Preads Platform requires a single CRON entry to manage scheduled tasks such as conversion cleanup, automated payouts, and statistic updates.

# Add this to your server's crontab (crontab -e)
* * * * * cd /path/to/platform && php artisan schedule:run >> /dev/null 2>&1

📧 Email Configuration

The platform uses a robust mailing system for notifications and verification codes.

SMTP Setup

Configure your mail server at Admin → Settings → Email.

  • Mail Driver: Recommended to use smtp.
  • Encryption: Use TLS (Port 587) or SSL (Port 465).
  • Master Template: Customize the global header and footer branding for all system emails.

🔒 Production Hardening

  1. SSL Certificate: Always use HTTPS. Ensure your APP_URL in .env starts with https://.
  2. File Permissions: Ensure .env is not web-accessible (standard Laravel security).
  3. Optimize Autoloader: Run composer install --optimize-autoloader --no-dev for production deployments.

Proceed to Post-Installation Setup →