TutorLab
Knowledge Base
Complete guide to the next-generation WordPress LMS plugin. Covers every module: from course hierarchy to the AI Suite with RAG, from the drag-and-drop Builder to the gamification engine with XP and badges.
Quick Start in 5 Steps
Get up and running with TutorLab. Follow these five steps to have your online course live and active.
- Activate the License
Go to Tutor Lab → Settings → License, enter the key received by email and click "Activate". The system verifies the license online and enables the modules included in your plan.
- Create the course structure
Go to Class Management, create a Course (the main container) and then one or more Classes (time-based editions). Assign exercises, lessons, and documents to the class.
- Add students
Go to System → Import Students for bulk CSV import, or approve registrations from the Approvals page. Assign each student to Course → Class → (optional Group).
- Build exercises with the Builder
Go to Content → Exercise Builder. Enter a title and icon, drag blocks from the palette to the canvas, configure each one, and click "Publish".
- Monitor progress
From the Teacher Dashboard and the Progress Matrix, view each student's status for every exercise in real time.
Requirements & License
WordPress Requirements
- WordPress 6.0+
- PHP 8.0+
- MySQL 5.7+ / MariaDB 10.3+
- ACF PRO 6.0+ (required)
- TCPDF (bundled in /lib/tcpdf/)
AI Suite Requirements
- Valid OpenAI API key
- AI addon active in your license
- PHP cURL enabled
- Active HTTPS connection
Available Addons
- Student AI Coach
- Advanced XP & badges
- Exercise PDF export
- Email templates
- Advanced analytics
- Multiple teams
- Single Sign-On
TutorLab AI Suite
A vertical, context-aware AI system that enhances learning without ever "inventing" information. Built on RAG (Retrieval-Augmented Generation), it only answers based on course content.
ai_coach addon is included in your license and the OpenAI API key is configured under AI → AI Configuration.RAG Engine — Zero Hallucinations
Unlike generic chatbots, TutorLab uses the RAG paradigm: it first retrieves relevant chunks from the Knowledge Base, then injects them into the prompt as context. If the answer is not in the uploaded documents, the AI says so explicitly and suggests contacting the human instructor.
Adaptive Coaching
The tone and complexity of responses adapt automatically to the student's profile (Novice → encouraging, Expert → challenging, Struggling → supportive).
Credits System
Every AI call consumes credits. The instructor assigns credits per user or class. Includes subscription plans and one-shot packages via PayPal and Stripe.
AI Analytics
Dashboard with: total API calls, tokens consumed, estimated costs, usage by student, by course, and by operation type. CSV export available.
AI Coach (Student Frontend)
Chat widget embedded in the frontend. Students can ask questions about the course; the AI responds based exclusively on the instructor's Knowledge Base.
Features
- Contextual answers: course topics only
- Chat history: persistent across sessions
- Instant feedback: Helpful / Not Helpful rating
- Smart fallback: if no answer found, redirects to instructor
- Rate limiting: configurable abuse prevention
How to turn it on
The instructor adds the chat to the course page and uploads the course documents to the Knowledge Base: the AI answers only from there. Students find it ready in their own area.
Adaptive Coaching by Profile
| Student Profile | AI Tone | Example response to "What is ROAS?" |
|---|---|---|
| Novice Few XP, early logins | Encouraging | "Great question! ROAS stands for Return On Ad Spend. If you spend €1 and earn €4, your ROAS is 4. Keep it up!" |
| Expert Master level | Challenging | "ROAS = Revenue / Ad Spend. Note: a high ROAS doesn't mean profit if margins are thin. Have you factored in CAC impact?" |
| Struggling Many recent errors | Supportive | "I understand the confusion. Let's take a step back with a concrete example. Don't worry, we'll get through this together." |
AI Feedback Generator (Instructor)
When grading an exercise, click "Generate AI Feedback". The system reads the student's response and generates a contextualized draft correction.
How it works
The AI receives the exercise context, the student's answer, the reference solution if there is one and the tone you prefer, and suggests a tailored correction.
The generated response is inserted as a draft in the "General Feedback" field — the instructor can edit it before publishing.
Exercise Builder
Visual drag & drop editor to create interactive exercises without writing code. Access from Content → Exercise Builder.
Drag & Drop
Drag blocks from the left palette to the central canvas. Reorder by dragging the handle.
Autosave
Automatic save every 30 seconds. Shortcut Ctrl+S / Cmd+S. Real-time status indicator (Saved / Unsaved changes / Saving).
Exercise Template
For each exercise choose the template: free builder or one of the advertising simulators (Ad Set, Creative, ROAS).
Ads Simulators
Specialized modules that replicate advertising platform interfaces (Meta Ads). Safe practice without a real budget. The simulator is chosen as the exercise template.
| Simulator | Main Fields |
|---|---|
| Ad Set Simulator | Objective, Budget (type+amount), Dates, Locations, Age, Gender, Placements, Interests, KPIs, Key message, Audience justification |
| Ad Creative Simulator | Hook, Body (3 brains), Headline, CTA button, Creative (image upload) |
| ROAS Calculator | Instructions text (WYSIWYG), ROAS calculation & analysis (free textarea) |
Dashboard & Student Hub
Central Hub
The student's command center, always up to date. Included widgets:
- Next Mission (exercise to complete)
- Current XP status and level
- Recently unlocked badges
- Instructor announcements
- Unread message counter
Operations Lab
Exercise list filterable by status (To Start / In Progress / Completed). Visual progress bars and feedback status.
Progress Hub
Detailed statistics: completion percentages, XP earned per exercise, performance over time.
Gamification & XP System
Complete gamification engine. XP is automatically awarded in the background for every valuable action. Badges unlock when configurable triggers are met.
Progression Levels
XP Points Table
| Action | XP Awarded |
|---|---|
| First exercise save | +10 XP |
| Exercise completion | +50 XP |
| Document view | +5 XP |
| Lesson view | +10 XP |
| Newsletter signup | +150 XP |
| Poll completion | +150 XP |
| Perfect test score | +50 XP bonus |
Badges
Badges unlock when students reach milestones set by the instructor, for example their first login or a number of completed exercises.
Rewards
Students redeem rewards with the XP they have earned: files, links or coupons defined by the instructor, each with its own XP cost.
Leaderboard
Class ranking by XP, badges and recent activity: name, avatar, total XP, badge count, level and position.
Frequently Asked Questions
Can the AI Coach make up incorrect information?
How do I add students to the platform?
Can I manage multiple courses simultaneously?
How does the Builder autosave work?
Ctrl+S / Cmd+S to save manually at any time.What happens if AI credits run out?
How do I modify an email template without PHP?
{{USER_NAME}}, {{EXERCISE_TITLE}}, etc.). You can preview and send test emails.