ScholaBook – School Management Integration

ScholaBook integrates your school’s WordPress website with the ScholaBook school management platform. It provides parents and visitors with real-time access to essential school information — all powered by secure API connectivity.

This plugin communicates with the ScholaBook SaaS platform via its REST API. An active ScholaBook account is required. By using this plugin you agree to ScholaBook’s Terms and Conditions and Privacy Policy.

Features

• School Information Widget & Shortcode — Display your school’s name, logo, tagline, board affiliation, and contact details.
• Fee Dues Lookup — Parents can check pending fees using their ward’s admission number and registered mobile number. No login required.
• Fee Summary & Receipts — Authenticated parents see a detailed breakdown of fees by category, payment history, and can reference receipt details.
• Attendance Summary — Parents can view their child’s attendance percentage and summary.
• Holiday Calendar — Display the academic year’s holidays publicly on your website.
• Notice Board — Publish school announcements from ScholaBook directly on your WordPress site.
• Parent Portal with OTP Login — Parents log in securely using a mobile OTP, then access a mini-dashboard with fees and attendance at a glance.
• Unified Parent Portal — A single, modern portal page (auto-created on activation) powered by a Preact SPA. Parents log in via OTP and navigate between dashboard, fees, receipts, and attendance — all within one page using hash-based routing.
• Module Toggle — Enable or disable individual features from the admin panel.
• Connection Diagnostics — Built-in connectivity test to verify your ScholaBook API connection.

Security

• OAuth2 Client Credentials authentication (industry-standard server-to-server auth)
• All credentials encrypted at rest using Sodium / OpenSSL
• AJAX forms protected by WordPress nonces
• Rate limiting on OTP requests and fee lookups
• Guardian sessions use HttpOnly, Secure, SameSite=Strict cookies
• All output properly escaped; all input sanitized

Requirements

• WordPress 6.2 or later
• PHP 7.4 or later with Sodium or OpenSSL extension
• An active ScholaBook account with API credentials

Shortcodes

• [scholabook_school_info] — School information display
• [scholabook_fee_lookup] — Public fee dues check form
• [scholabook_fee_summary] — Fee breakdown (requires parent login)
• [scholabook_fee_receipts] — Payment history (requires parent login)
• [scholabook_attendance] — Attendance summary (requires parent login)
• [scholabook_holidays] — Academic holiday calendar
• [scholabook_notices] — School announcements
• [scholabook_guardian_login] — Parent OTP login form
• [scholabook_guardian_dashboard] — Parent mini-dashboard
• [scholabook_portal] — Unified Parent Portal (recommended) — single page that combines login, dashboard, fees, receipts, and attendance into one seamless experience. A “Parent Portal” page with this shortcode is auto-created on plugin activation.

Development

The minified file public/js/scholabook-portal.js is built from the human-readable source in src/portal/ using esbuild.

To rebuild from source:

1. npm install
2. npm run build