Skip to content

Installable Features Configuration Guide

This guide will help you configure various third-party integrations and features available in LMSZAI. Each section provides step-by-step instructions to set up these features successfully.

Social Login (Google)

Overview: Google Social Login allows users to register and log in to your LMS platform using their Google accounts. This feature simplifies the registration process and improves user experience by eliminating the need for users to create separate accounts.

Benefits: - Faster user registration and login - Reduced password-related support issues - Improved user conversion rates - Enhanced security through Google's authentication

Prerequisites

  • A Google account
  • Access to Google Cloud Console
  • Admin access to your LMSZAI installation

Configuration Steps

Step 1: Access Admin Settings

  1. Log in to your LMSZAI admin panel
  2. Navigate to Application Settings → Global Settings → Social Login Settings
  3. Locate the Google Login configuration section

Image

Step 2: Create Google Cloud Project

  1. Visit Google Cloud Console
  2. Sign in with your Google account
  3. Click on the project dropdown at the top of the page

Image

Step 3: Enable Google+ API

  1. Click on the menu icon (☰) in the top-left corner
  2. Navigate to APIs & Services → Library

Image

  1. Search for "Google+ API" in the library

Image

  1. Click on Google+ API from the search results

Image

  1. Click the Enable button to activate the API

Image

Step 4: Create or Select Project

  1. Click on the project dropdown (shown as "My Project" or current project name)
  2. Click New Project to create a new project, or select an existing project

Image

  1. Enter a project name (e.g., "LMSZAI Social Login")
  2. Click Create

Image

  1. Navigate to APIs & Services → Credentials
  2. Click Create Credentials → OAuth client ID

Image

  1. If prompted, configure the OAuth consent screen by clicking the Configure Consent Screen button

Image

  1. Select External as the user type and click Create

Image

  1. Fill in the required app information:
  2. App name
  3. User support email
  4. Developer contact information

Image Image

  1. Click Save and Continue (you can skip the optional scopes in Step 2)

Image

  1. Add test users if your app is in testing mode, then click Save and Continue

Image

  1. Review the summary and click Back to Dashboard

Image

Step 6: Create OAuth Client ID

  1. Return to Credentials → Create Credentials → OAuth client ID

Image

  1. Select Web application as the application type
  2. Enter a name for your OAuth client
  3. Add the authorized redirect URI using this format: {your-website-url}/login/google/callback Example: https://lmszai.zainikthemes.com/login/google/callback Important: Replace {your-website-url} with your actual domain name

Image

  1. Click Create

Step 7: Copy Credentials

  1. Click the Edit button (pencil icon) next to your newly created OAuth client

Image

  1. Copy the following information:
  2. Client ID
  3. Client Secret
  4. Authorized redirect URI

Image

Step 8: Configure in LMSZAI Admin Panel

  1. Return to your LMSZAI admin panel
  2. Navigate to Application Settings → Global Settings → Social Login Settings
  3. Paste the Client ID and Client Secret into the respective fields
  4. Verify the Redirect URI matches the one you configured in Google Cloud Console
  5. Enable the Google Login status
  6. Click Update to save the settings

Image

Testing

  1. Log out from your admin panel
  2. Visit the login page
  3. Click the "Login with Google" button
  4. Complete the Google authentication process
  5. Verify that you are redirected back to your LMS platform

Social Login (Facebook)

Overview: Facebook Social Login enables users to register and sign in to your LMS using their Facebook accounts. This integration streamlines the authentication process for users who prefer using social media accounts.

Benefits: - Quick registration process - Access to user profile information (optional) - Reduced form abandonment - Trust factor through Facebook verification

Prerequisites

  • A Facebook account
  • Access to Facebook Developers Console
  • Admin access to your LMSZAI installation

Configuration Steps

Step 1: Access Facebook Developers Console

  1. Visit Facebook Developers
  2. Sign in with your Facebook account
  3. Click My Apps in the top-right corner

Image

Step 2: Create a New App

  1. Click the Create App button

Image

  1. Select the use case for your app (typically "Consumer" or "Business")
  2. Click Next

Image

  1. Fill in the app details:
  2. App Display Name
  3. App Contact Email
  4. Click Create App

Image

Step 3: Add Facebook Login Product

  1. In the app dashboard, click Add Product
  2. Find Facebook Login and click Set Up

Image

Step 4: Configure Settings

  1. Navigate to Settings → Basic in the left sidebar
  2. Add your App Domain (your website domain without http/https)
  3. Add Privacy Policy URL and Terms of Service URL (if available)
  4. Scroll down to Facebook Login settings
  5. Add the authorized redirect URI using this format: {your-website-url}/login/facebook/callback Example: https://lmszai.zainikthemes.com/login/facebook/callback
  6. Click Save Changes

Image

Step 5: Get App Credentials

  1. In the Basic settings page, you'll find:
  2. App ID - visible immediately
  3. App Secret - click Show to reveal it
  4. Copy both values securely

Image

Step 6: Configure in LMSZAI Admin Panel

  1. Log in to your LMSZAI admin panel
  2. Navigate to Application Settings → Global Settings → Social Login Settings
  3. Paste the App ID and App Secret into the Facebook Login section
  4. Enable Facebook Login status
  5. Click Update to save the settings

Testing

  1. Log out from your admin panel
  2. Visit the login page
  3. Click the "Login with Facebook" button
  4. Complete the Facebook authentication process
  5. Verify successful login and redirect

Agora Live Class

Overview: Agora Live Class integration allows instructors and organizations to conduct real-time video classes directly within the LMS platform. This feature provides high-quality video streaming, screen sharing, interactive whiteboards, and real-time communication capabilities.

Benefits: - Real-time video conferencing - Interactive learning experience - No need for external meeting links - High-quality audio and video streaming - Screen sharing and collaboration tools

Prerequisites

  • An Agora account (free tier available)
  • Admin access to your LMSZAI installation

Configuration Steps

Step 1: Create Agora Account

  1. Visit Agora Console
  2. Click Sign Up to create a new account

Image

  1. Fill in the registration form with valid information:
  2. Email address
  3. Password
  4. Company name (optional)

Image

  1. Check your email for a verification code
  2. Enter the verification code to complete registration

Image

  1. Complete any optional surveys or skip them
  2. You'll be redirected to the Agora Console dashboard

Step 2: Get Agora App ID

  1. In your Agora Console dashboard, you'll see your App ID displayed
  2. Copy this App ID - you'll need it for LMSZAI configuration

Image

Step 3: Generate App Certificate

  1. Navigate to Configure in your project settings
  2. Enable Primary Certificate
  3. An App Certificate will be generated automatically
  4. Copy the App Certificate - keep it secure as it won't be shown again

Image

Step 4: Configure in LMSZAI Admin Panel

  1. Log in to your LMSZAI admin panel
  2. Navigate to Application Settings → Global Settings → Agora Settings
  3. Enable Agora Status by toggling it ON
  4. Paste your Agora App ID in the designated field
  5. Paste your Agora App Certificate in the designated field
  6. Click Update to save the settings

Image

Creating a Live Class (Instructor/Organization)

  1. Log in to the Instructor/Organization panel
  2. Navigate to Live Class from the sidebar menu
  3. Click Create Live Class

Image

  1. Fill in the class details:
  2. Class title
  3. Description
  4. Date and time
  5. Duration
  6. Select Agora Live App as the meeting host
  7. Click Create or Save

Image

  1. The live class will appear in your live class list

Image

Note: Students who have enrolled in the associated course will be able to join the live class at the scheduled time.

Zoom Live Class

Overview: Zoom Live Class integration enables instructors and organizations to conduct live video classes using Zoom's robust video conferencing platform. This integration allows seamless scheduling and management of Zoom meetings directly from the LMS.

Benefits: - Professional video conferencing platform - Support for large participant numbers - Recording capabilities - Screen sharing and breakout rooms - Familiar interface for most users

Prerequisites

  • A Zoom account with API access
  • Zoom API Key and API Secret
  • Instructor/Organization account access

Important: Each instructor or organization must configure their own Zoom credentials separately.

Configuration Steps

Step 1: Create Zoom API Credentials

  1. Log in to your Zoom account
  2. Navigate to Zoom Marketplace
  3. Click Develop → Build App
  4. Choose OAuth or Server-to-Server OAuth app type
  5. Fill in the app details and create the app
  6. Copy your API Key and API Secret

Step 2: Configure in Instructor/Organization Panel

  1. Log in to your Instructor or Organization panel
  2. Navigate to Zoom Settings from the sidebar menu
  3. Enable Zoom Status by toggling it ON
  4. Enter your Zoom API Key
  5. Enter your Zoom API Secret
  6. Click Update to save the settings

Image

Creating a Zoom Live Class

  1. Navigate to Live Class in your instructor panel
  2. Click Create Live Class
  3. Fill in the class details
  4. Select Zoom as the meeting host type
  5. Configure meeting settings (if available)
  6. Save the live class

Note: Ensure your Zoom account has the necessary permissions and plan to support the number of participants you expect.

Google Meet Live Class (Admin Configuration)

Overview: Google Meet Live Class allows instructors and organizations to conduct live video classes using Google Meet. This feature requires initial admin configuration for OAuth credentials, after which instructors can set up their individual Google Calendar credentials.

Benefits: - Integrated with Google Calendar - No additional software installation needed - Automatic meeting creation and calendar invites - High-quality video and audio - Screen sharing capabilities

Prerequisites

  • Google Cloud Platform account
  • Google Calendar API enabled
  • Admin access to configure OAuth credentials

Admin Configuration Steps

Step 1: Enable Google Calendar API

  1. Visit Google Cloud Console
  2. Create a new project or select an existing one
  3. Navigate to APIs & Services → Library
  4. Search for "Google Calendar API"
  5. Click Enable

Step 2: Create OAuth 2.0 Credentials

  1. Navigate to APIs & Services → Credentials
  2. Click Create Credentials → OAuth client ID
  3. Configure the OAuth consent screen if prompted
  4. Select Web application as the application type
  5. Add authorized redirect URIs (check LMSZAI documentation for exact URI format)
  6. Copy the Client ID and Client Secret

Step 3: Configure in LMSZAI Admin Panel

  1. Log in to your LMSZAI admin panel
  2. Navigate to Application Settings → Global Settings → Google Meet Settings
  3. Enter the Google Calendar OAuth Client ID
  4. Enter the Google Calendar OAuth Client Secret
  5. Click Update to save the settings

Image

Google Meet Live Class (Instructor Configuration)

Overview: After admin configuration, each instructor or organization needs to configure their individual Google Calendar credentials to create and manage Google Meet live classes.

Important: Each instructor/organization must configure their own Google Calendar credentials.

Instructor/Organization Configuration Steps

Step 1: Authorize Google Calendar Access

  1. Log in to your Instructor or Organization panel
  2. Navigate to Application Settings → Global Settings → Google Meet Settings
  3. Click Authorize Google Calendar or similar button
  4. You'll be redirected to Google's authorization page
  5. Sign in with the Google account you want to use for Meet classes
  6. Grant the necessary permissions

Step 2: Configure Settings

  1. Enter your Calendar ID or Gmail ID (the email associated with your Google Calendar)
  2. Select your Timezone
  3. Click Update to save the settings

Image

Creating a Google Meet Live Class

  1. Navigate to Live Class in your instructor panel
  2. Click Create Live Class
  3. Fill in the class details
  4. Select Google Meet as the meeting host type
  5. The system will automatically create a Google Meet link and calendar event
  6. Save the live class

BigBlueButton Live Class

Overview: BigBlueButton (BBB) is an open-source web conferencing system designed for online learning. It provides real-time sharing of audio, video, slides, chat, and screen, making it ideal for virtual classrooms.

Benefits: - Open-source and self-hosted option - Designed specifically for education - Interactive whiteboard - Polling and breakout rooms - Recording capabilities

Prerequisites

  • A BigBlueButton server (self-hosted or cloud instance)
  • BBB Server Base URL
  • BBB Security Salt (API secret key)
  • Admin access to your LMSZAI installation

Configuration Steps

Step 1: Obtain BigBlueButton Credentials

  1. Install BigBlueButton server following the official documentation
  2. Access your BBB server admin panel
  3. Retrieve your Security Salt (BBB_SECRET) from the server configuration
  4. Note your BBB Server Base URL (e.g., https://bbb.yourserver.com/bigbluebutton/)

For detailed information about BBB API and security model, refer to the official BBB API documentation.

Step 2: Configure in LMSZAI Admin Panel

  1. Log in to your LMSZAI admin panel
  2. Navigate to Application Settings → Global Settings → BigBlueButton Meeting Settings
  3. Enable BBB Status by toggling it ON
  4. Enter your BBB Security Salt in the designated field
  5. Enter your BBB Server Base URL (ensure it includes the /bigbluebutton/ path)
  6. Click Update to save the settings

Image

Creating a BigBlueButton Live Class

  1. Instructors can navigate to Live Class in their panel
  2. Click Create Live Class
  3. Fill in the class details
  4. Select BigBlueButton as the meeting host type
  5. Save the live class

Note: Ensure your BBB server has sufficient resources to handle the expected number of concurrent users.

Jitsi Live Class

Overview: Jitsi is an open-source video conferencing solution that can be self-hosted or used via Jitsi Meet. It provides encrypted video, audio, and screen sharing capabilities without requiring user accounts.

Benefits: - Open-source and privacy-focused - No account required for participants - End-to-end encryption - Can be self-hosted - Easy to use

Prerequisites

  • A Jitsi server instance (self-hosted or Jitsi Meet cloud)
  • Jitsi Server Base URL
  • Admin access to your LMSZAI installation

Configuration Steps

Step 1: Set Up Jitsi Server

You have two options: - Option 1: Use Jitsi Meet cloud service (free, no setup required) - Option 2: Self-host Jitsi following the official installation guide

For cloud service, use: https://meet.jit.si

For self-hosted, use your server URL: https://your-jitsi-server.com

Step 2: Configure in LMSZAI Admin Panel

  1. Log in to your LMSZAI admin panel
  2. Navigate to Application Settings → Global Settings → Jitsi Meeting Settings
  3. Enable Jitsi Status by toggling it ON
  4. Enter your Jitsi Server Base URL (e.g., https://meet.jit.si or your custom server URL)
  5. Click Update to save the settings

Image

Creating a Jitsi Live Class

  1. Instructors can navigate to Live Class in their panel
  2. Click Create Live Class
  3. Fill in the class details
  4. Select Jitsi as the meeting host type
  5. Save the live class

Note: When using Jitsi Meet cloud, meetings are public by default. Consider self-hosting for enhanced privacy and security.

S3 Storage Settings (AWS, Wasabi, Vultr)

Overview: S3-compatible storage allows you to store video files and other course materials on cloud storage services instead of your local server. This reduces server load, improves scalability, and provides better performance for content delivery.

Supported Services: - AWS S3 - Amazon Web Services Simple Storage Service - Wasabi S3 - High-performance, cost-effective S3-compatible storage - Vultr S3 - Vultr's object storage service

Benefits: - Reduced server storage costs - Improved video delivery performance - Better scalability - Automatic backups - CDN integration capabilities

Prerequisites

  • An account with AWS, Wasabi, or Vultr
  • Access keys (Access Key ID and Secret Access Key)
  • A storage bucket created in your cloud provider
  • Admin access to your LMSZAI installation

Configuration Steps

Step 1: Create Storage Bucket

  1. Log in to your cloud storage provider's console:
  2. AWS: AWS Console
  3. Wasabi: Wasabi Console

  4. Vultr: Vultr Console

  5. Create a new S3 bucket:

  6. Choose a unique bucket name
  7. Select an appropriate region (closer to your users is better)
  8. Configure bucket permissions (public read access may be needed for videos)

Step 2: Create Access Keys

  1. Navigate to your account's security/credentials section
  2. Create a new access key pair:
  3. Access Key ID - acts as your username
  4. Secret Access Key - acts as your password (save this securely)

Security Note: Store your access keys securely and never share them publicly.

Step 3: Configure in LMSZAI Admin Panel

  1. Log in to your LMSZAI admin panel
  2. Navigate to Application Settings → Global Settings → S3 Storage Settings
  3. Select your storage provider (AWS S3, Wasabi S3, or Vultr S3)
  4. Enable the storage service by toggling the status ON
  5. Enter the following credentials:
  6. Access Key ID
  7. Secret Access Key
  8. Bucket Name
  9. Region (e.g., us-east-1, eu-west-1)
  10. Endpoint URL (if required by your provider)

Image

  1. Set Video Storage Driver to your S3 provider (not "public")
  2. Click Update to save the settings

Important Notes

  • If you deactivate S3 storage, ensure you change Video Storage Driver back to public
  • Existing videos stored locally won't automatically migrate to S3
  • New video uploads will be stored in your configured S3 bucket
  • Test upload a small video file to verify the configuration works correctly

Vimeo Integration

Overview: Vimeo integration allows you to host course videos on Vimeo's platform instead of your server. This offloads video hosting and streaming to Vimeo's infrastructure, providing better performance and reducing server bandwidth usage.

Benefits: - Professional video hosting and streaming - Reduced server bandwidth costs - Better video playback performance - Advanced privacy controls - No video storage limitations on your server

Prerequisites

  • A Vimeo account (Pro or higher recommended for better features)
  • Vimeo API credentials (Client ID, Client Secret, Access Token)
  • Admin access to your LMSZAI installation

Configuration Steps

Step 1: Create Vimeo API Application

  1. Visit Vimeo Developer Portal
  2. Log in with your Vimeo account
  3. Click Create an app or New app
  4. Fill in the application details:
  5. App name
  6. App description
  7. App URL (your website URL)
  8. Redirect URL (if needed)
  9. Submit the application

Step 2: Get API Credentials

  1. After creating the app, you'll be redirected to the app settings
  2. Copy the following credentials:
  3. Client ID
  4. Client Secret
  5. Generate an Access Token:
  6. Click Generate token or Authenticate
  7. Select the scopes/permissions needed (typically: upload, edit, delete, private)
  8. Copy the generated access token

Step 3: Configure in LMSZAI Admin Panel

  1. Log in to your LMSZAI admin panel
  2. Navigate to Application Settings → Global Settings → Vimeo Settings
  3. Enable Vimeo Status by toggling it ON
  4. Enter the following credentials:
  5. Vimeo Client ID
  6. Vimeo Client Secret
  7. Vimeo Access Token
  8. Click Update to save the settings

Image

Important Notes

  • Videos uploaded to Vimeo will be stored on Vimeo's servers
  • Vimeo account limits (storage, bandwidth) apply based on your Vimeo plan
  • If you deactivate Vimeo, set Vimeo Status to Deactivated
  • Ensure your Vimeo access token has the necessary permissions for video upload and management

Payment Gateway Configuration

Overview: Payment gateway integration enables your LMS to accept payments for courses and other purchases. LMSZAI supports multiple payment gateways, allowing you to offer various payment options to your students based on their location and preferences.

Supported Payment Gateways: - PayPal - Global payment processing - Stripe - Credit/debit card processing - Razorpay - Popular in India - SSLCOMMERZ - Popular in Bangladesh - Mollie - Popular in Europe - Instamojo - Popular in India - Paystack - Popular in Africa

Benefits: - Multiple payment options for users - Secure payment processing - Automatic transaction handling - Support for various currencies and regions

Prerequisites

  • Business account with your chosen payment gateway(s)
  • API credentials from your payment gateway provider
  • Admin access to your LMSZAI installation

Configuration Steps

Step 1: Obtain Payment Gateway Credentials

  1. Log in to your payment gateway account
  2. Navigate to the API/Developer section
  3. Create API keys or credentials:
  4. Test/Sandbox credentials (for testing)
  5. Live/Production credentials (for real transactions)

Important: Use test credentials initially to verify the integration works correctly before switching to live mode.

Step 2: Configure in LMSZAI Admin Panel

  1. Log in to your LMSZAI admin panel
  2. Navigate to Application Settings → Payment Options → Payment Method
  3. For each payment gateway you want to enable:
  4. Toggle the status ON
  5. Enter the required API credentials (API Key, Secret Key, Merchant ID, etc.)
  6. Select the appropriate mode (Test/Sandbox or Live)
  7. Configure any additional settings
  8. Click Update to save the settings

Image

Testing Payment Gateways

  1. Always test with test/sandbox credentials first
  2. Make a test purchase with a small amount
  3. Verify the payment processes correctly
  4. Check that course enrollment occurs after successful payment
  5. Only switch to live credentials after successful testing

Geo-location (MapBox Integration)

Overview: Geo-location feature allows you to add location information to user profiles and filter instructors or content based on geographic location. This is particularly useful for platforms that want to connect local instructors with students.

Benefits: - Location-based instructor filtering - Enhanced user profiles - Local course discovery - Geographic analytics

Prerequisites

  • A MapBox account (free tier available)
  • MapBox API key
  • Admin access to your LMSZAI installation

Configuration Steps

Step 1: Create MapBox Account

  1. Visit MapBox
  2. Sign up for a free account
  3. Verify your email address

Step 2: Get MapBox API Key

  1. Log in to your MapBox account
  2. Navigate to your Account page
  3. Copy your Default Public Token or create a new access token
  4. Ensure the token has the necessary scopes (typically styles:read, fonts:read, datasets:read)

Step 3: Configure in LMSZAI Admin Panel

  1. Log in to your LMSZAI admin panel
  2. Navigate to Application Settings → Global Settings → Geo Location API Key
  3. Paste your MapBox API Key in the designated field
  4. Click Update to save the settings

Image

Usage

After configuration, users (especially instructors) can add their location information to their profiles. This location data can then be used to filter and display instructors based on geographic proximity.

Bank Payment Gateway

Overview: Bank payment gateway allows you to accept direct bank transfers as a payment method. Admins can add multiple bank account details, and students can choose to pay via bank transfer during checkout. This is particularly useful in regions where online payment gateways are not widely used.

Benefits: - Additional payment option for users - No transaction fees (typically) - Suitable for high-value transactions - Local payment preference support

Prerequisites

  • One or more bank accounts
  • Bank account details (account number, bank name, routing number, etc.)
  • Admin access to your LMSZAI installation

Configuration Steps

Step 1: Prepare Bank Information

Gather the following information for each bank account you want to add: - Bank name - Account holder name - Account number - Branch name - Routing/SWIFT code (if applicable) - IBAN (International Bank Account Number, if applicable) - Bank address (optional) - Any additional instructions for students

Step 2: Configure in LMSZAI Admin Panel

  1. Log in to your LMSZAI admin panel
  2. Navigate to Application Settings → Payment Options → Bank
  3. Enable Bank Payment status by toggling it ON
  4. Click Add Bank or similar button
  5. Fill in the bank account details:
  6. Bank name
  7. Account holder name
  8. Account number
  9. Branch name
  10. Other relevant details
  11. Add any special instructions for students (e.g., "Include order ID in transfer description")
  12. Save the bank information
  13. Repeat for additional bank accounts if needed

Image

Payment Process

  1. During checkout, students can select "Bank Transfer" as the payment method
  2. Students will see the bank account details you've configured
  3. Students make the bank transfer with the order/transaction reference
  4. Admin manually verifies and confirms the payment in the admin panel
  5. Course access is granted after payment confirmation

Note: Bank payments typically require manual verification, so ensure you have a process to check bank statements and confirm payments promptly.

Mail Configuration (Gmail SMTP)

Overview: Mail configuration allows your LMS to send transactional emails (registration confirmations, course enrollment notifications, password resets, etc.) using SMTP. This guide covers Gmail SMTP configuration, which is one of the most commonly used email services.

Benefits: - Reliable email delivery - Professional email communications - Transactional email automation - Email notifications for important events

Prerequisites

  • A Gmail account (Google Workspace account recommended for business use)
  • Two-factor authentication enabled (recommended)
  • Admin access to your LMSZAI installation

Important Notes

Two-Step Verification: If you have two-step verification enabled on your Google account, you'll need to generate an "App Password" instead of using your regular Gmail password. App passwords are special passwords designed for applications that don't support two-step verification.

Why App Passwords? Some applications may be blocked from accessing your Gmail account due to two-step verification. An app-specific password allows these applications to access your mail account securely.

Configuration Steps

Step 1: Enable Two-Step Verification (If Not Already Enabled)

  1. Go to your Google Account
  2. Navigate to Security in the left panel
  3. Under Signing in to Google, find 2-Step Verification
  4. Follow the prompts to enable two-step verification if it's not already enabled

Step 2: Generate App Password

If you don't have two-step verification enabled, you can skip this section and use your regular Gmail password. However, using an app password is recommended for better security.

  1. Go to your Google Account
  2. Navigate to Security in the left panel

Image

  1. Under Signing in to Google, click on App Passwords

Image

If you don't see the App Passwords option, it might mean: - Two-step verification is not set up for your Google account - Two-step verification is set up for security keys only - Your account is managed through work, school, or another organization - Advanced Protection is enabled for your account

  1. Click Select app and choose Mail (or Other if Mail is not listed, then type "LMSZAI" or "SMTP")

Image

  1. Click Select device and choose the device you're using (or Other and type a name)

Image

  1. Click Generate

Image

  1. A 16-character password will be generated. Copy this password immediately - you won't be able to see it again. The password will appear in a yellow bar with spaces (e.g., xxxx xxxx xxxx xxxx)

Image

  1. Click Done

Note: You won't need to remember this App Password since you'll only use it once to configure your application. Store it securely until you've completed the configuration.

Step 3: Configure SMTP in LMSZAI Admin Panel

  1. Log in to your LMSZAI admin panel
  2. Navigate to Application Settings → Global Settings → Mail Configuration (or similar)
  3. Configure the following SMTP settings:

Gmail SMTP Settings: - Mail Driver: SMTP - SMTP Host: smtp.gmail.com - SMTP Port: 587 (TLS) or 465 (SSL) - Encryption: TLS (for port 587) or SSL (for port 465) - SMTP Username: Your Gmail address (e.g., [email protected]) - SMTP Password: - If using App Password: Paste the 16-character app password (remove spaces) - If not using 2FA: Use your Gmail password - From Email Address: Your Gmail address - From Name: Your organization/LMS name

  1. Click Update or Save to save the settings

Image

Step 4: Test Email Configuration

  1. Send a test email through your LMS system
  2. Check your inbox (and spam folder) to verify the email was received
  3. Verify the "From" address displays correctly
  4. If emails are not sending, check:
  5. SMTP credentials are correct
  6. App password was copied correctly (no extra spaces)
  7. Firewall is not blocking SMTP ports
  8. Gmail account doesn't have login restrictions

Alternative Email Providers

While this guide covers Gmail, you can configure other SMTP providers using similar steps: - Outlook/Hotmail: smtp-mail.outlook.com, Port 587 - Yahoo: smtp.mail.yahoo.com, Port 587 - SendGrid: smtp.sendgrid.net, Port 587 - Mailgun: smtp.mailgun.org, Port 587 - Amazon SES: email-smtp.[region].amazonaws.com, Port 587

Each provider will have specific requirements for authentication and configuration.

Troubleshooting Common Issues

Social Login Not Working

  • Issue: Users cannot log in with Google/Facebook
  • Solutions:
  • Verify redirect URIs match exactly (including http/https and trailing slashes)
  • Check that credentials are copied correctly
  • Ensure APIs are enabled in Google Cloud Console
  • Verify app is not in testing mode with restricted users (Google)

Live Class Issues

  • Issue: Live classes not starting or students cannot join
  • Solutions:
  • Verify API credentials are correct
  • Check server status of the live class provider
  • Ensure proper permissions are granted
  • Verify network/firewall settings allow connections

Payment Gateway Errors

  • Issue: Payments failing or not processing
  • Solutions:
  • Verify API keys are correct (check for extra spaces)
  • Ensure you're using test credentials for testing
  • Check payment gateway account status
  • Verify webhook URLs are configured (if applicable)

Email Not Sending

  • Issue: Transactional emails not being delivered
  • Solutions:
  • Verify SMTP credentials
  • Check spam folder
  • Ensure App Password is correct (for Gmail with 2FA)
  • Verify SMTP ports are not blocked
  • Check email sending limits

S3 Storage Issues

  • Issue: Videos not uploading to S3
  • Solutions:
  • Verify access keys are correct
  • Check bucket permissions
  • Ensure bucket name and region are correct
  • Verify endpoint URL (for some providers)
  • Check bucket exists and is accessible

Additional Resources

Last Updated: Please refer to your LMSZAI version documentation for the most current information.