Initial Configuration

Chapter 3: Initial Configuration

This chapter covers all the essential configuration settings needed to get your School Management System up and running properly.

---

3.1 Accessing Settings

Navigating to Settings

  • Log in as Administrator
  • Click on Settings in the sidebar menu
  • You'll see various configuration options
  • Settings Overview

    The Settings page is divided into several sections:
    • General Settings
    • Academic Settings
    • Fee Settings
    • Attendance Settings
  • Examination Settings
  • ---

    3.2 General Settings

    School Information

    #### Step 1: Access General Settings Navigate to: Settings → General Settings

    #### Step 2: Configure Basic Information

    FieldDescriptionExample
    -----------------------------
    School NameOfficial school nameSunshine International School
    School TaglineShort mottoExcellence in Education
    EmailOfficial emailadmin@school.edu
    PhoneContact number+1 234 567 890
    FaxFax number (optional)+1 234 567 891
    AddressFull postal address123 Education Lane, City

    #### Step 3: Upload School Logo

    • Click "Choose File" or drag and drop
    • Select your school logo (recommended: 200x200px, PNG/JPG)
  • Click "Upload"
  • Tip: Use a transparent PNG logo for best results on all backgrounds.

    #### Step 4: Configure Regional Settings

    SettingOptionsDescription
    --------------------------------
    CurrencyUSD, EUR, KHR, etc.Default currency for fees
    Currency Symbol$, €, ៛Symbol to display
    Currency PositionLeft/RightWhere symbol appears
    Date FormatDD/MM/YYYY, MM/DD/YYYYDate display format
    Time Format12-hour, 24-hourTime display format
    TimezoneVariousServer timezone

    #### Step 5: Save Settings Click Save Changes button at the bottom of the page.

    ---

    3.3 Academic Settings

    Configuring Academic Year

    #### Step 1: Access Academic Years Navigate to: Academics → Academic Years

    #### Step 2: Create New Academic Year

  • Click Add Academic Year button
  • Fill in the details:
  • FieldDescriptionExample
    -----------------------------
    YearAcademic year label2025-2026
    Start DateWhen year beginsJanuary 1, 2025
    End DateWhen year endsDecember 31, 2025
    Is CurrentActive yearYes (check)

  • Click Save
  • #### Step 3: Set Current Year To set a year as current:

    • Find the academic year in the list
  • Click Set as Current button
  • Confirm the action
  • ---

    3.4 Fee Settings

    Configuring Fee Parameters

    #### Step 1: Access Fee Settings Navigate to: Fees → Settings

    #### Step 2: Configure Late Payment Rules

    SettingDescriptionExample
    -------------------------------
    Enable Late FeeTurn on/off late feesEnabled
    Late Fee TypeFixed or PercentageFixed Amount
    Late Fee AmountLate fee value$5.00
    Grace Period (Days)Days before late fee10 days
    Late Fee FrequencyOnce, MonthlyOnce

    #### Step 3: Configure Payment Methods

    Available payment methods:

  • Cash: Physical cash payments
  • Cheque: Cheque payments
  • Bank Transfer: Direct bank transfers
  • Card: Credit/debit card payments
  • Online: Payment gateway
  • Other: Miscellaneous
  • To enable a payment method:

    • Toggle the switch to enable
    • Add any required details (account numbers, etc.)
  • Save settings
  • #### Step 4: Configure Other Fee Options

    OptionDescription
    ---------------------
    Invoice PrefixPrefix for invoice numbers (e.g., INV-)
    Minimum DueMinimum amount due for partial payments
    Allow Partial PaymentEnable/disable partial payments
    Auto InvoiceGenerate invoices automatically

    ---

    3.5 Attendance Settings

    Configuring Attendance Rules

    #### Step 1: Access Attendance Settings Navigate to: Attendance → Settings

    #### Step 2: Configure Rules

    SettingDescriptionExample
    -------------------------------
    Enable Late ArrivalTrack late arrivalsEnabled
    Late Threshold (minutes)Minutes before considered late30 min
    Attendance CodeShort code for reportsA, P, L
    Weekend AttendanceAllow weekend markingDisabled

    #### Step 3: Configure Session Times

    Define your school periods:

    PeriodStart TimeEnd Time
    ------------------------------
    Period 107:3008:15
    Period 208:1509:00
    Break09:0009:15
    Period 309:1510:00

    ---

    3.6 Examination Settings

    Configuring Exam Parameters

    #### Step 1: Access Exam Settings Navigate to: Exams → Settings

    #### Step 2: Configure Grade System

    FieldDescription
    --------------------
    Grade NameLetter grade (A, B, C)
    Grade PointPoint value (4.0, 3.0)
    Minimum MarksStarting marks for grade
    Maximum MarksEnding marks for grade
    DescriptionGrade description (Excellent, Good)

    #### Step 3: Set Pass Marks

    • Set minimum pass percentage (usually 35-40%)
  • Configure grade point calculations
  • ---

    3.7 User Roles & Permissions

    Configuring Roles

    #### Step 1: Access Roles Navigate to: Settings → Roles

    #### Step 2: Default Roles

    RoleDescriptionDefault Permissions
    ----------------------------------------
    AdminFull accessAll
    TeacherTeaching staffLimited
    AccountantFinance staffFees, Payroll
    LibrarianLibrary staffLibrary
    DriverTransport staffTransport
    ParentStudent parentsView only
    StudentStudentsView own

    #### Step 3: Customizing Permissions

    • Click on a role to edit
    • Toggle permissions on/off
  • Save changes
  • ---

    3.8 Email & Notification Settings

    Configuring Email

    #### Step 1: Email Configuration Navigate to: Settings → Email Settings

    #### Step 2: Configure SMTP

    SettingDescriptionExample
    -------------------------------
    Mail DriverSMTP, Sendmail, etc.SMTP
    Mail HostSMTP serversmtp.gmail.com
    Mail PortServer port587
    Mail UsernameYour emailschool@gmail.com
    Mail PasswordApp password**
    Mail EncryptionTLS/SSLTLS
    From AddressSender emailnoreply@school.edu
    From NameSender nameSchool Management

    #### Step 3: Test Email

    • Enter a test email address
    • Click "Send Test Email"
  • Verify receipt
  • ---

    3.9 Telegram Integration

    Setting Up Telegram Bot

    #### Step 1: Create Telegram Bot

    • Open Telegram and search for @BotFather
    • Start a chat and send /newbot
    • Follow instructions to create bot
  • Copy the bot token
  • #### Step 2: Configure in System Navigate to: Settings → Telegram Settings

    SettingDescription
    ----------------------
    Bot TokenYour Telegram bot token
    Bot UsernameUsername of your bot
    Enable NotificationsTurn on/off alerts

    #### Step 3: Get Chat ID

    • Start a chat with your bot
    • Send /start command
    • Use @userinfobot to get your chat ID
  • Enter chat ID in settings
  • ---

    3.10 Theme & Branding

    Customizing Appearance

    #### Step 1: Access Theme Settings Navigate to: Settings → Theme

    #### Step 2: Color Scheme

    ColorPurposeRecommended
    -----------------------------
    Primary ColorMain brand color#2563EB (Blue)
    Secondary ColorAccent color#7C3AED (Purple)
    Sidebar ColorMenu background#1F2937 (Dark)
    Header ColorTop bar color#FFFFFF (White)

    #### Step 3: Customize Colors

    • Enter hex color codes
    • Preview changes in real-time
  • Save when satisfied
  • ---

    3.11 Data Management

    Backup Settings

    #### Step 1: Configure Backup Navigate to: Settings → Backup

    #### Step 2: Set Backup Schedule

    OptionDescription
    ---------------------
    Auto BackupEnable automatic backups
    FrequencyDaily, Weekly, Monthly
    RetentionHow many backups to keep
    Storage LocationWhere to store backups

    #### Step 3: Manual Backup Click Backup Now to create an immediate backup.

    ---

    3.12 Testing Your Configuration

    Verification Checklist

    After configuration, verify:

    • [ ] School information displays correctly
    • [ ] Currency and date formats work
    • [ ] Academic year is set as current
    • [ ] Fee late rules calculate correctly
    • [ ] Attendance rules apply properly
    • [ ] Grade system calculates grades
    • [ ] Email notifications send successfully
    • [ ] Telegram integration works
  • [ ] Theme colors apply correctly
  • ---

    3.13 Configuration Complete

    Next Steps

    Your system is now configured! Continue to:

  • Chapter 4: User Roles & Permissions
  • Chapter 6: Academic Years
  • Chapter 7: Classes & Sections
  • Tips

  • Test thoroughly: Test each setting before going live
  • Document changes: Keep a log of configuration changes
  • Regular reviews: Periodically review and update settings
  • Backup before changes: Always backup before major config changes
  • ---

    Quick Reference

    Settings Locations

    SettingMenu Path
    --------------------
    GeneralSettings → General
    AcademicSettings → Academic Years
    FeesFees → Settings
    AttendanceAttendance → Settings
    ExamsExams → Settings
    EmailSettings → Email
    TelegramSettings → Telegram
    ThemeSettings → Theme
    RolesSettings → Roles
    BackupSettings → Backup

    ---

    © 2026 School Management System. All rights reserved.