Skip to main content

Settings

The Settings page allows administrators to configure global application behavior, company information, and system preferences. This guide covers all configurable areas.

Accessing Settings​

Navigate to /settings in your browser. The settings page is accessible to users with the Admin role.

Admin Access Required

Settings require Admin or Super Admin role to view and modify.

Company Settings​

Company Information​

Configure your organization's identity:

SettingDescription
Company NameYour organization's legal name
Company LogoLogo displayed throughout the application
Company AddressStreet address
Company PhoneMain phone number
Company EmailPrimary contact email
Company WebsiteYour corporate website URL
Company CountryCountry
Company StateState or province
Company CityCity name
Company ZipcodeZIP or postal code

Registration Details​

SettingDescription
Company Tax IDTax identification number
Company Reg NoBusiness registration/incorporation number

General Settings​

Application Settings​

SettingDescription
App NameApplication display name (shown in browser title and emails)
CountryDefault country for the application
Phone Country CodeDefault phone country code
CurrencyPrimary currency (e.g., USD, EUR, INR)
Currency SymbolSymbol displayed with amounts (e.g., $, EUR, Rs)
Distance UnitUnit for distance measurements
Helper TextEnable/disable in-app helper text

Employee Settings​

SettingDescription
Default PasswordDefault password assigned to new employee accounts

When creating new employees, if "Use Default Password" is selected, this password is used for the employee's initial login.

Branding Settings​

Logo & Favicon​

SettingDescription
App LogoApplication logo (PNG, JPG, JPEG, max 2MB)
App FaviconBrowser tab icon (PNG, JPG, JPEG, ICO, max 512KB)

Map Settings​

For location-based features (geofencing, client visits, live tracking):

SettingDescription
Map ProviderGoogle Maps or other supported providers
Map API KeyYour map provider API key
Map Zoom LevelDefault zoom level for map views (1-20)
Center LatitudeDefault center latitude for maps
Center LongitudeDefault center longitude for maps

Mail Settings​

SMTP Configuration​

Configure email delivery for notifications and system emails:

SettingDescription
Mail DriverMail transport driver (e.g., smtp)
Mail HostSMTP server address
Mail PortSMTP port (usually 587 or 465)
Mail UsernameSMTP account username
Mail PasswordSMTP account password
Mail EncryptionEncryption method (TLS, SSL, or None)
From AddressDefault sender email address
From NameDefault sender display name

Testing Email​

After configuring SMTP settings:

  1. Click Send Test Email
  2. Enter a test recipient email address
  3. Check the inbox for the test message
  4. Verify email was received successfully

Saving Settings​

Save and Apply​

  1. Make your changes in the relevant settings section
  2. Click Save for that section
  3. Settings are organized into separate save actions per section (Company, General, Employee, Map, Mail, Branding)

Cache Clear​

After changing certain settings, clear the application cache:

php artisan config:clear
php artisan config:cache

Best Practices​

Initial Setup​

  1. Configure company information first
  2. Set currency and country preferences
  3. Configure email for notifications
  4. Set up map provider for location features
  5. Upload branding (logo and favicon)

Regular Maintenance​

  • Review settings periodically
  • Test email delivery after server changes
  • Keep API keys current

Security​

  • Use strong default passwords for employee accounts
  • Keep SMTP credentials secure
  • Restrict settings access to administrators only

This completes the User Guide section. For module-specific configuration, see the Modules documentation.

Last updated on