Skip to main content

​
Overview

Business settings control core platform functionality including general configuration, payment methods, shipping options, third-party integrations, and seller commission structures.

​
General Settings

​
Accessing General Settings

Route: /admin/general-setting
1

Navigate to Settings

Go to Settings > General Settings from the admin menuScreenshot Description: Settings menu with General Settings option highlighted
2

Review Current Settings

View all general configuration options
3

Update Settings

Modify settings and save changesRoute: POST /admin/business-settings/update

​
Key General Settings

  • Site Name: Platform display name (updates APP_NAME in environment)
  • Timezone: Platform timezone (updates APP_TIMEZONE)
  • Logo and Favicon: Branding assets
  • Contact Information: Business contact details
  • Meta Information: SEO settings
Changing the site name or timezone updates your .env file. Cache is automatically cleared after these changes.

​
Feature Activation

​
Managing Platform Features

Route: /admin/activation
1

Access Feature Activation

Navigate to Settings > Feature Activation
2

Toggle Features

Enable or disable platform features:
  • Email verification
  • Wallet system
  • Seller registration
  • Product approval workflow
  • Affiliate system
  • Club points
  • And more…
Route: POST /admin/business-settings/update/activation
3

Configure Feature Settings

Each feature may have additional configuration options

​
Special Activation Settings

​
Maintenance Mode

Temporarily disable public access to the platform.
  • Enable: Puts the site into maintenance mode
  • Disable: Returns site to normal operation
Use maintenance mode when:
  • Performing major updates
  • Migrating data
  • Fixing critical bugs
Administrators can still access the admin panel during maintenance.

​
HTTPS Enforcement

Force all connections to use HTTPS.
  • Enable: Sets FORCE_HTTPS=On and updates APP_URL to https://
  • Disable: Sets FORCE_HTTPS=Off and updates APP_URL to http://

​
Filesystem Driver

Configure where files are stored. Options: Local, S3, etc. Updates: FILESYSTEM_DRIVER environment variable

​
Payment Methods

​
Configuring Payment Gateways

Route: /admin/payment-method
1

Access Payment Methods

Navigate to Settings > Payment MethodsScreenshot Description: Payment methods page showing available gateways with configuration status
2

Select Payment Gateway

Choose a payment method to configure:
  • PayPal
  • Stripe
  • Razorpay
  • SSLCommerz
  • Paystack
  • And others…
3

Enter API Credentials

Input required credentials for the payment gateway
4

Configure Sandbox Mode

Toggle sandbox/test mode for testing purposes
5

Save Configuration

Update payment method settingsRoute: POST /admin/payment_method_update
After updating payment methods, the cache is automatically cleared and credentials are stored in the .env file.

​
Third-Party Integrations

​
Google Analytics

Route: /admin/google-analytics
1

Enable Google Analytics

Toggle the analytics activation switch
2

Enter Tracking ID

Input your Google Analytics tracking ID
3

Save Settings

Route: POST /admin/google_analytics

​
Google reCAPTCHA

Route: /admin/google-recaptcha Protect forms from spam and bots.
1

Get reCAPTCHA Keys

Obtain site key and secret key from Google
2

Configure reCAPTCHA

Enter keys in the configuration form
3

Enable reCAPTCHA

Toggle activation and saveRoute: POST /admin/google_recaptcha

​
Google Maps

Route: /admin/google-map Enable location-based features. Update Route: POST /admin/google-map

​
Google Firebase

Route: /admin/google-firebase Enable push notifications. Update Route: POST /admin/google-firebase

​
Facebook Integrations

​
Facebook Chat

Route: /admin/facebook-chat Integrate Facebook Messenger for customer support. Update Route: POST /admin/facebook_chat

​
Facebook Comment

Route: /admin/facebook-comment Enable Facebook comments on product pages. Update Route: POST /admin/facebook-comment

​
Facebook Pixel

Track conversions and build audiences. Update Route: POST /admin/facebook_pixel

​
Email Configuration

​
SMTP Settings

Route: /admin/smtp-settings
1

Access SMTP Settings

Navigate to Settings > SMTP Settings
2

Configure Mail Server

Enter SMTP details:
  • Host
  • Port
  • Username
  • Password
  • Encryption (TLS/SSL)
3

Test Email

Send a test email to verify configurationRoute: POST /admin/newsletter/test/smtp
4

Save Settings

Route: POST /admin/env_key_update
Common SMTP providers:
  • Gmail: smtp.gmail.com (port 587)
  • SendGrid: smtp.sendgrid.net (port 587)
  • Mailgun: smtp.mailgun.org (port 587)
  • Amazon SES: email-smtp.region.amazonaws.com (port 587)

​
Social Login

Route: /admin/social-login Enable login via social media platforms.
1

Select Social Platform

Choose platform (Facebook, Google, Twitter, etc.)
2

Enter App Credentials

Input App ID and App Secret from the social platform
3

Enable Social Login

Toggle activation for each platform

​
Seller Configuration

​
Seller Commission

Route: /admin/vendor_commission
1

Access Commission Settings

Navigate to Sellers > Commission ConfigurationScreenshot Description: Commission configuration form with percentage input fields
2

Set Commission Rate

Enter commission percentage for sellers
3

Configure Commission Type

Choose commission calculation method:
  • Percentage of sale price
  • Fixed amount per product
  • Category-wise commission
4

Save Commission Settings

Route: POST /admin/vendor_commission_update
Commission is automatically calculated when orders are marked as “Paid” and the commission_calculated flag is set.

​
Seller Verification Form

Route: /admin/verification/form Customize the seller verification form.
1

Access Form Builder

Navigate to Sellers > Verification Form
2

Add Form Fields

Create custom fields:
  • Text input
  • Select dropdown
  • Multi-select
  • Radio buttons
  • File upload
3

Configure Field Options

For select/radio fields, add available options
4

Save Form Configuration

Route: POST /admin/verification/form

​
Shipping Configuration

Route: /admin/shipping_configuration
1

Access Shipping Settings

Navigate to Settings > Shipping Configuration
2

Select Shipping Method

Choose from available shipping methods:
  • Flat rate
  • Carrier-based
  • Seller-wise
  • Product-based
3

Update Configuration

Route: POST /admin/shipping_configuration/update

​
Order Configuration

Route: /admin/order-configuration Configure order processing rules:
  • Minimum order amount
  • Guest checkout settings
  • Order number format
  • Invoice settings

​
File System Configuration

Route: /admin/file_system Configure where uploaded files are stored:
  • Local Storage: Store files on server
  • Amazon S3: Cloud storage
  • Other cloud providers: As configured

​
Cache Management

After updating any business settings, the system automatically:
  1. Clears the application cache
  2. Refreshes configuration values
  3. Updates environment variables (when applicable)
If changes don’t appear immediately:
  • Manually clear browser cache
  • Use the “Clear Cache” function in the dashboard
  • Wait a few minutes for CDN propagation (if using CDN)

​
Best Practices

  1. Test Payment Gateways: Always test in sandbox mode before going live
  2. Backup Before Changes: Backup your .env file before modifying settings
  3. Document Changes: Keep a record of configuration changes
  4. Secure Credentials: Never share API keys or credentials
  5. Regular Reviews: Audit settings quarterly

Build docs developers (and LLMs) love

Get started for freeTalk to us