Handyman Service - Documentation

Configuration

Estimated reading: 2 minutes

Steps to follow for getting started with the Laravel:

⚙️ Configuration – Mail Setup

Why is Mail Configuration Required?

When you’re running a Laravel application that includes features like password reset, booking confirmations, or contact forms, the app needs to send emails.
To enable this, you must configure the mail settings properly.

Laravel uses a special configuration file called .env to manage all sensitive settings — including email.

Steps to Configure Mail in Laravel

Step 1: Open and Edit the .env File

The .env file is located in the root directory of your Laravel project.

Open this file and add the following mail configuration values:

MAIL_DRIVER="Your mail driver"           → (e.g., smtp)
MAIL_HOST="Your mail host"               → (e.g., smtp.gmail.com)
MAIL_PORT="Your mail port"               → (e.g., 587)
MAIL_USERNAME="Your email ID"            → (e.g., yourname@gmail.com)
MAIL_PASSWORD="Your email password"      → (e.g., your email account password)
MAIL_ENCRYPTION="Your encryption type"   → (e.g., tls or ssl)
Step 2: Fill in the Mail Credentials

Here’s what each value means:

  • MAIL_DRIVER: Usually set as smtp
  • MAIL_HOST: For Gmail it is smtp.gmail.com, for others it could be smtp.sendgrid.net, etc.
  • MAIL_PORT: Common values are 587465, or 2525, depending on your email provider
  • MAIL_USERNAME: The email ID used to send emails from your app
  • MAIL_PASSWORD: The actual password or app-specific password of your email
  • MAIL_ENCRYPTION: Usually tls or ssl (used to secure the connection)
📝 Example for Gmail Setup:
MAIL_DRIVER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=yourname@gmail.com
MAIL_PASSWORD=yourpassword
MAIL_ENCRYPTION=tls

After saving these settings, your Laravel application will be able to send emails automatically.

🧿 Configuration – General Settings

From Setting Panel You can configure the common settings

This panel is used to for common configurations.

  • General Settings – Configure the details like App Name, Description, Email, Phone, Website, ZipCode, Address.
  • Theme Settings – You can configure logo, Footer Logo,favicon etc.
  • Service Configurations – Enable Disable available Service Type from here.
  • App Configurations – The App Configurations section allows the admin to manage key app features. From here, the admin can enable or disable login options like Google, Facebook, Apple, and OTP. Features such as Demo Login, Online Payment, Blog, and ChatGPT can also be controlled as needed.
  • Payment-related features like User Wallet and In-app Purchases can be configured here. Options like Firebase Notification and Auto Assign improve user experience.
  • Additionally, the admin can enable or disable communication options like Chat, WhatsApp, and SMS Notifications. Finally, a preferred layout for the Customer App can be selected and all changes can be saved using the Save button.

  • Notification Configurations – From here you can choose for which you want to send push notification
  • Social Media Configurations – Add your social media links here. It will be displayed in App and Web.
  • COOKIE SETUP – Configure cookie consent messages to inform users about data usage for better browsing, personalized content, and analytics.
  • ROLE & PERMISSION SETUP – Manage different user roles (like user, provider, handyman) and control their access rights within the system.
  • Language Configurations – You can choose Language for your Web from here.
  • Payment Configurations – You can enable and configure Payment Methods from here.
  • Mail Configurations – You can used this mail configuration for sending mail to user
    when for forget password etc.
  • Earning Configurations – Choose Earning Type for provider from here.
  • Provider Promotional Banner – This setting allows the admin to decide whether to enable paid promotional banners for service providers. If this option is turned ON, providers will need to pay a fee to display their promotional banners in the app.
  • To configure the Provider Promotional Banner, go to Admin Panel > Settings > Provider Promotional Banner. Enable the toggle to allow providers to promote their services through banners. Set the banner price in the Price ($) fieldx. Finally, click Save to apply the changes.

Front-End Configuration

  • Configure Landing Page from Landing Page Setting.

  • Configure Header of Landing Page from Header Menu Setting.

  • Configure Footer of Landing Page from Footer Setting.

Watch Laravel Admin Configurations