Configuration

Post-install configuration. Most settings live in admin panel (no code edits). The .env file holds only infrastructure config (DB, mail, caching).

.env reference

Located at kode/.env. Edit via FTP/SSH only — never via admin panel.

App identity

APP_NAME="CartUser"
APP_URL=https://yourdomain.com
APP_ENV=production
APP_DEBUG=false
APP_KEY=base64:...   # auto-generated by installer
APP_TIMEZONE=UTC

Database

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=cartuser
DB_USERNAME=cartuser
DB_PASSWORD=...

Mail (for order notifications)

MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
[email protected]
MAIL_PASSWORD=...
MAIL_ENCRYPTION=tls
[email protected]
MAIL_FROM_NAME="${APP_NAME}"

Cache + sessions (recommended)

CACHE_DRIVER=file
SESSION_DRIVER=file
QUEUE_CONNECTION=database

For high-traffic stores, switch to Redis:

CACHE_DRIVER=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis
REDIS_HOST=127.0.0.1
REDIS_PORT=6379

File storage

FILESYSTEM_DRIVER=public   # local storage
# OR for S3:
FILESYSTEM_DRIVER=s3
AWS_ACCESS_KEY_ID=...
AWS_SECRET_ACCESS_KEY=...
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=your-bucket

Admin → Settings → General

SettingPurpose
Site NameStorefront title, emails, page titles
Site Logo / Admin LogoHeader branding
FaviconBrowser tab icon
Default CurrencyDisplay currency for prices
Currency PositionBefore or after amount ($10 vs 10$)
Decimal Digits2 for USD, 0 for IDR, etc.
CountryDefault country for new addresses
TimezoneFor order timestamps
Date Formate.g. d M Y, Y-m-d, M d Y
Multi-Vendor ModeToggle marketplace vs single-store
Default CommissionPlatform cut on seller orders
Cash on DeliveryToggle COD payment method
Customer WalletToggle wallet feature
Club Point SystemToggle reward points
Minimum Order AmountEnforce minimum cart value
Email VerificationRequire email verify before login
SMS OTPOTP verification for phone-based login
Pagination NumberItems per page in admin lists

Branding

  1. Admin → Settings → General → Logo settings
  2. Upload: Site Logo (header), Admin Logo (admin panel), Favicon (browser tab)
  3. Recommended sizes:
    • Site Logo: 200×50 px PNG (transparent background)
    • Admin Logo: 200×50 px
    • Favicon: 32×32 px ICO or PNG
  4. Save

Tax setup

  1. Admin → Catalog → Tax → Create
  2. Name (e.g. "VAT 20%"), Status = Active
  3. Attach to products: Admin → Products → Edit → Tax tab
  4. For per-product variable rates: set rate when attaching

Multi-language

  1. Admin → Settings → Language → Add Language
  2. Choose code (e.g. "es" for Spanish), name
  3. Toggle RTL if applicable (Arabic, Hebrew)
  4. Save
  5. Click Translate next to the language
  6. Translate strings one-by-one (or auto-translate via AI Assistant)
  7. Save
  8. Frontend language switcher auto-includes the new language

Multi-currency

  1. Admin → Settings → Currency → Add Currency
  2. Set: name, code (USD/EUR/INR), symbol ($/€/₹), rate (relative to default)
  3. Set as Default if needed
  4. Frontend shows currency switcher
  5. Prices auto-convert based on rate

SMS gateway setup

  1. Admin → Settings → SMS Gateway → choose provider
  2. Supported: Twilio, Vonage (Nexmo), MessageBird, TextMagic, Infobip, SendGrid SMS, Custom
  3. Enter API credentials
  4. Set Status = Active
  5. Test SMS from same page

Email templates

  1. Admin → Settings → Email Template
  2. Edit templates: Welcome, Order Placed, Order Shipped, Order Delivered, Password Reset, etc.
  3. Use merge tags: {{name}}, {{order_number}}, {{amount}}
  4. Save

Social login

  1. Admin → Settings → Social Login
  2. Google: Get Client ID + Secret from console.cloud.google.com
  3. Facebook: Get App ID + Secret from developers.facebook.com
  4. Copy the callback URL shown on edit page → paste into Google/Facebook OAuth config
  5. Toggle status to Active
  6. Save