🪷 Lotus International School
School Suite
🖥️
Gatepass
Gate passes, pickup tracking & bus management
— passes today
Open →
📒
Reference Register
Document requests, TC tracking & reference numbers
— entries this FY
Open →
📲
Fee QR
UPI fee cards with QR code for each student
— studentsOpen →
💸
Due List
Pending fee balance, class-wise tracker
— students due
Open →
🖥️
Gatepass
0 today
🚌 Today's Passes by Bus
0
Bus Passes
🔒
Settings Protected
Enter admin password to continue.
⚙️ Settings
Force refresh on tab focus
Resets localMod on tab focus, forcing a fresh fetch from Firebase. Turning OFF saves ~45 MB/month bandwidth. Synced via Firebase — change from any device.
Sync students with Reference Register. Use the same URL & Sync Code as Reference Register → Settings → Student DB.
Students sync every 30s. Changes push instantly. Force Fetch ignores today's cache.
Add / Edit Student
📥 Bulk CSV Upload
Columns:
name, admissionNumber, class, fatherName, motherName, phone, busNumberBulk Add (one per line)
Variables:
{name}{class}{pickedby}{relation}{time}{date}{reason}{bus}
🐦 Send Mode
Gate Pass Issued — Message Template
Include country code, no + or spaces. Leave empty to disable admin alerts.
📲 Send Options
⏱ Admin Message Delay
Delay (seconds)
sec
Parent WA fires instantly. Admin WA opens after this delay via a tap button.
Meta WhatsApp Cloud API
From Meta Developer Console → WhatsApp → API Setup
Use a Permanent Token for production
Leave empty to send plain text (only works within 24hr window)
Sent to parent when student exits gate. Parameters: {{1}} name | {{2}} class | {{3}} gate out time | {{4}} date
Template Parameters:
{{1}} name | {{2}} class | {{3}} picked by
{{4}} relation | {{5}} date & time | {{6}} reason
{{4}} relation | {{5}} date & time | {{6}} reason
Students are flagged as frequent when they are picked up X or more times out of the last Y active school days (days that had any gate passes).
Students picked up 4+ times in the last 6 active school days will appear in Quick Pass.
📸 Picker photo requirement
Choose when a picker photo must be captured/uploaded before a gate pass can be issued
Auto-prints slip on every pass issue. Batch-print from Records tab.
Where on the paper the slip prints (useful for pre-cut paper or label sheets)
✍️ Principal Signature
Upload once — appears automatically on every printed slip.
Height (mm)
Max Width (mm)
on slip
🔥 Force Push to Firebase
Clears Firebase completely and pushes your current local data. Use when another device deleted records but they still show here.
🧹 Reset Passes on All Devices
Clears only the local pass cache on every connected device (this one included) and makes each one re-fetch fresh from Firebase. Settings/config on each device are untouched, and Firebase's own data is untouched too.
📦 JSON Backup
📋 CSV Student Upload → Column Mapping → Auto Sync
Upload CSV/Excel, column mapping popup will appear, then pushes to Firebase.
Select dates to preview…
✈️ Every gate pass is logged to your school's private Telegram channel — with photo if taken, text-only if not. When a pass is deleted, the message is deleted too.
Get from @BotFather — see setup guide below
Channel / group / personal chat ID — use @userinfobot to find yours
📋 Bot Setup — Step by Step
Step 1 — Create a bot
1. Open @BotFather on Telegram
2. Send
3. Give it a name — e.g. Lotus Gate Pass
4. Give it a username — e.g. LotusGatePassBot (must end in "bot")
5. BotFather will send you a Token — paste it in the field above
2. Send
/newbot3. Give it a name — e.g. Lotus Gate Pass
4. Give it a username — e.g. LotusGatePassBot (must end in "bot")
5. BotFather will send you a Token — paste it in the field above
Step 2 — Create a private channel
1. Create a new private Channel on Telegram
2. Add your bot as an Administrator with Post Messages permission
3. Send any message in the channel, then open this URL:
2. Add your bot as an Administrator with Post Messages permission
3. Send any message in the channel, then open this URL:
https://api.telegram.org/botYOUR_TOKEN/getUpdates
4. Copy the "id" value from the chat object (starts with -100...)
💠 Use your school's Office 365 account. One-time setup by IT admin: enable Tenant ID and ROPC — then email + password login works directly.
Get this from Azure Portal — see steps below
Empty = saves to a "GatePasses" folder in root
📋 IT Admin Setup — Step by Step
Step 1 — Find your Tenant ID
1. Open portal.azure.com with any school Office 365 account
2. Click your name in the top-right corner
3. Click Switch directory
4. Your Tenant ID (Directory ID) will be shown — copy it
2. Click your name in the top-right corner
3. Click Switch directory
4. Your Tenant ID (Directory ID) will be shown — copy it
Step 2 — Enable ROPC (done by IT Admin)
1. portal.azure.com pe jao → Azure Active Directory
2. App Registrations → All Applications
3. Search for:
4. Go to Authentication tab
5. Set "Allow public client flows" → Yes
6. Save ✅
2. App Registrations → All Applications
3. Search for:
Microsoft Office (App ID: d3590ed6...)4. Go to Authentication tab
5. Set "Allow public client flows" → Yes
6. Save ✅
Step 3 — Disable MFA (for this account only)
1. Azure AD → Users → select the account that will be used for upload
2. Multi-Factor Authentication → set to Disabled
3. Or ask IT admin to create a dedicated service account with MFA disabled
2. Multi-Factor Authentication → set to Disabled
3. Or ask IT admin to create a dedicated service account with MFA disabled
⚠️ Use a dedicated account — do not use your main admin account. Create a separate account specifically for gate pass uploads.
Month
Scope
Export all settings — Firebase URLs, Telegram tokens & chat IDs, Print config, Signature, WhatsApp templates — as one JSON. Import on any device to restore instantly.
⚠️ Only this device's local data will be cleared — Firebase data stays safe. Page will reload.
App-wise Clear
Full Reset
⚡ Quick Pass 0
Frequent pick-ups (4+ of last 6 active days)
Loading…
👨👩👧👦
Sibling detected — same number
These students share the same parent phone number and father's name — cut their pass too?
📱
Send WhatsApp
—
Opening WhatsApp…
⏱ Opening in 3s…
⚡
—
—
—
📒
Reference Register
0 Total
0
0
FY
⏱️ Live Tracker
Pending requests with elapsed time
✅
All clear — no pending requests.📦 Ready to Deliver
Documents ready for collection
🎉
No documents ready to deliver yet.📊 Breakdown
Select document type…
▼
📂
Drop file or click to browse
🔒
Settings Protected
Enter password to access settings.
tap 5×
🏷️ General▼
🔢 Reference Number Format▼
If a file isn't attached yet and you set the status to this value, a popup will ask you to attach the document first.
Preview:
LIS/2025-26/0001🔢 Override Next Number
Use this to skip numbers or reset the sequence for a financial year. The next ref number generated will be this value.
🔄 Status Types▼
First status = default for new requests. The Prepared status generates Ref No.
📄 Document Type Presets▼
These chips appear in the Add Entry form — click to select a document type. Add or remove as needed.
🔐 Entry Permissions▼
Set Allowed, Password, or Blocked for Edit, Delete, and Status Change — per status.
🗂️ Dashboard Status Mapping▼
Tracker list shows Card 2 status. Ready to Deliver shows Card 3. Delivered pill shows Card 4.
📱 WhatsApp▼
🐦 Send Mode
Variables:
{refno} {name} {doctype} {status} {date} {timestamp}
⏱ Admin Message Delay
sec
Parent WA fires instantly. Admin gets a tap button after this delay.
Meta WhatsApp Cloud API
From Meta Developer Console → WhatsApp → API Setup
Use a Permanent Token for production
Per-Status Template Names
Template Parameters:
{{1}} name | {{2}} refno | {{3}} doctype
{{4}} status | {{5}} date & time
{{4}} status | {{5}} date & time
☁️ Cloud Upload — File Storage▼
When status is set to Prepared and a file is attached, it uploads automatically. You can enable one or more platforms.
Firebase Console → Storage → gs://your-project.appspot.com
Firebase Console → Project Settings → Web API Key
📋 Wix Page Code (Firebase)
Storage → Rules: set
allow read: if true;. Then paste this code in your Wix page.
💡 Use a Microsoft personal or school account. Files are automatically renamed to the Reference Number before upload.
Path relative to OneDrive root. Leave empty for root folder.
⚠️ Note: OneDrive ROPC auth may be blocked on some organisational accounts. Personal Microsoft accounts (outlook.com, hotmail.com) work best. School/Office 365 accounts require IT admin approval.
🌐 Student name, Reference Number and PDF file are pushed to your "Transfer Certificates" collection.
⚠️ Required: Wix's API blocks direct calls from a browser (CORS). A small free Cloudflare Worker is needed as a relay. Deploy
wix-proxy.js (provided separately) to Cloudflare Workers, then paste its URL below.
The Cloudflare Worker URL you get after deploying wix-proxy.js. Leave empty to attempt a direct call (will fail with CORS error in most browsers).
Wix Dashboard → Settings → General Info → copy the Site ID
Wix Dashboard → Settings (account level) → some API keys are account-scoped and the Media Manager upload step needs this in addition to the Site ID.
Wix Dashboard → Settings → API Keys → New Key → give CMS permission
Exact name of your collection as shown in Wix
🔑 Wix Field IDs — how to find them
1. Wix Dashboard → CMS → open "Transfer Certificates" collection
2. Click the Settings (⚙️) icon at the top
3. In the Fields tab, each field shows its Field Key in grey
4. Note the Field Key for the name column, the reference number column, and the file/PDF column
2. Click the Settings (⚙️) icon at the top
3. In the Fields tab, each field shows its Field Key in grey
4. Note the Field Key for the name column, the reference number column, and the file/PDF column
Field Key of the student name column
Field Key of the reference number column (Text type — not Number, since ref numbers contain "/")
Field Key of the PDF file column
OFF (default): a popup offers to attach a file before issuing, but a "Skip" button lets you continue without one.
ON: the popup still appears, but the Skip button is hidden — a file must be attached before the status can be set to Issued/Delivered.
ON: the popup still appears, but the Skip button is hidden — a file must be attached before the status can be set to Issued/Delivered.
Document Types to Sync
Only the document types selected (✓) below will be pushed to Wix CMS. Others will be saved locally as usual but skipped from Wix sync.
💡 How it works: When you attach a file to an entry and set the status to Prepared, the PDF is automatically uploaded to Wix Media and saved in the "Transfer Certificates" collection with the student name and file link — but only if that entry's document type is checked above.
✈️ A notification is sent to your Telegram channel whenever a Reference Register entry is added, updated, or deleted.
Can be same as Gate Pass bot or a separate one
Your private channel or group Chat ID
👥 Student Database▼
Upload Excel/CSV:
Name AdmNo Class Phone FatherName MotherName📂
Drop Excel/CSV or click
➕ Add Manually
| Name | Adm No | Class | Father | Mother | Phone | Bus | Address | Del |
|---|
Page 1
📤 Export Register▼
🔗 Firebase Sync▼
Register DB
Student DB
🌐 Wix Public Board
When Firebase is connected, prepared TCs are auto-published to
/public_board in your Firebase DB. Paste your Firebase URL below in the Wix widget to display them on your school website.
🔒 Settings Password▼
Leave blank to disable password protection.
📅 Financial Year Management▼
FY can only be deleted when it has no entries. A PDF export will be generated automatically before deletion.
💾 Backup & Force Sync▼
🔥 Force Push to Firebase
Clears Firebase completely and pushes current local data. Use when another device deleted entries but they still show here.
📦 JSON Backup
⚠️ Danger Zone▼
🎉
Reference Number Generated!
Tap to copy
—
📎 Attach Document File
(optional — TC / certificate PDF)
📂
Drop file or click to browse
🔄 Change Status
Ref:
📱 Send WhatsApp
Sending to:
Opening WhatsApp…
⏱ Opening in 3s…
📱
Fee QR
0 selected
📱
No Students Yet
Upload an Excel file or add students manually
in the Students tab
in the Students tab
🔥
Firebase Connected
Tap to sync students from database
📤
Excel Upload
No file📊
Drag & drop or click to upload Excel
Supports .xlsx, .xls, .csv
Required: Name + Class · Optional: ID, Section, Phone, Amount
🗂️
Map Columns
📋
Student Database
0 students
💾 Data restored from last session. No need to re-upload Excel.
🔥
Firebase Student Database
Not connectedAuto-fetch students from Gatepass Student DB. Use the same URL and Path set in Gatepass → Settings → Student DB.
💳
UPI Payment Config
Encoded in QRPreview URL:
🏫
School Info (on Fee Card)
💬
WhatsApp Message Template
{name} {class} {id} {amount}💡 {name} {class} {id} {amount} — auto-replaced per student
🔒
Security & Controls
💬 WhatsApp Notifications
Show/hide the WhatsApp send button
🔑 Settings Password
Set a password to protect Fee QR settings. Leave blank to remove protection.
🎴
Fee QR Cards Preview
➕
Add Student
💸
Due List
₹0
Outstanding
⚠️
Pinned file — tap anywhere to reload
🔍
🔍
💸
No Fee Data
Go to Settings → Upload Excel to load data
0 selected
📲
Sending WhatsApp Messages…
Preparing…
💳
No Transactions Yet
Payments will appear here automatically after QR scan
⚙️
Due List Settings
Data sync, WhatsApp & Payments
🔒
Settings Protected
Enter password to access Due List settings
📄
file.xlsx
Last loaded: —
🟢 Active
Column Mapping
Admission No
Student Name
Class
Mobile No
Total Due
Received
Balance
Sheet Name
🏷️ Class Filter Mode
Upload Excel from any device → data syncs to all devices via Firebase.
QR generates automatically when you send WhatsApp. Payments tracked in Transactions tab.
Meta API Credentials
📅 Double Month
Extra Month:
Message Templates
Display Mode
Sort Order
Auto-Delete
Settings Password
Leave blank to disable password protection on this settings modal.
Danger Zone
Firebase data will remain intact. Only local settings, column mapping, and cached data will be cleared. Page will reload.