TutorLab
Knowledge Base

Quick Start in 5 Steps

Get up and running with TutorLab. Follow these five steps to have your online course live and active.

1. 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.

2. 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.

3. 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).

4. 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".

5. Monitor progress

   From the Teacher Dashboard and the Progress Matrix, view each student's status for every exercise in real time.

Requirements & License

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 (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.

Adaptive Coaching by Profile

RAG Engine & Knowledge Base

The semantic search engine that powers AI Coach responses. Managed from AI → Knowledge Base in the backend.

Knowledge Base AJAX Actions

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.

{
  "role": "teacher",
  "student_level": "beginner",
  "exercise_context": "SWOT Analysis",
  "student_answer": "...",
  "ideal_solution": "...",
  "tone": "formal"
}

AI Credits System

AI Payments

Backend Menu

The plugin menu is organized into 6 logical sections with visual headings. The AI section only appears if the addon is active.

Teaching Hierarchy

A 4-level structure for managing complex organizations with multiple parallel courses, classes, and working groups.

Class Management

Class Management AJAX Actions

Staff Roles & Permissions

Team & Staff

Manage collaborators from the Management → Team & Staff page. Each member has a specific role with scope limited to their area of responsibility.

Exercise Builder

Visual drag & drop editor to create interactive exercises without writing code. Access from Content → Exercise Builder.

Exercise Data Structure (JSON)

{
  "title": "SWOT Analysis",
  "slug": "swot-analysis",
  "fase": "analisi",          // analisi | creazione | acquisizione | gestione | misurazione
  "icon": "🎯",
  "level": "apprendista",     // apprendista | praticante | specialista | maestro
  "visible": true,
  "description": "...",
  "sections": [
    {
      "id": "uuid-v4",
      "type": "textarea",     // see block list below
      "title": "Strengths",
      "icon": "💪",
      "objective": "Describe the strengths",
      "layout": "1-col",      // 1-col | 2-col | 3-col | 2-1 | 1-2
      "placeholder": "Enter here..."
    }
  ]
}

Builder Blocks (19 types)

Text & Input

Media

Interactive

Callout

Layout

Ads Simulators

Specialized modules that replicate advertising platform interfaces (Meta Ads). Safe practice without a real budget. Template selected via ACF field exercise_template.

Instructor Feedback System

Professional workflow for grading exercises. Supports per-section corrections, general feedback, draft mode, and publishing with automatic notification.

Feedback Meta Keys

PDF Export

Generate professional PDFs of student responses. TCPDF library (DejaVuSans, full UTF-8). File: /includes/pdf-exporter.php. Requires the pdf_export addon.

Email System

Templates configurable from the backend without modifying PHP. Settings under System → Settings → Email. File: /includes/email-handler.php.

Internal Messaging

Private messaging system between students and instructors/admins. CPT: messaggio_privato. Enabled per class: _tutor_lab_messaging_enabled.

Announcements

CPT annuncio associated with the classe taxonomy. Publishing an announcement with the notification field active automatically schedules an email to all students in the class (via WP-Cron with a 10-second delay). Announcements appear in the student hub.

Dashboard & Student Hub

Gamification & XP System

Complete gamification engine. XP is automatically awarded in the background for every valuable action. Badges unlock when configurable triggers are met.

XP Points Table

Badges

CPT badge. Configurable triggers: first_login, exercises_completed_count. Meta: badge_trigger_type, badge_trigger_value_number. Unlocked badges are saved in _tutor_lab_unlocked_badges (array of post IDs).

Rewards

CPT premio. ACF fields: punti_xp_richiesti (XP cost), tipo_premio (file/link/coupon), specific content. AJAX: tutor_lab_redeem_reward.

Leaderboard

Shows ranking with: student name, avatar, total XP, badge count, level, leaderboard position. Data from _tutor_lab_xp_points and _tutor_lab_unlocked_badges, filtered by the classe taxonomy.

Lock & Unlock System

Exercises are sequential: completing N unlocks N+1. Students can request early unlock with a justification.

Polls & Tests

CPT sondaggio with template single-sondaggio.php. Supports single choice, multiple choice, and open-ended answers. Integrated with the XP system (+150 XP for completion, +50 XP bonus for a perfect score).

Shortcodes Reference

Custom Post Types & Taxonomy

Taxonomy

Complete AJAX Reference

Over 80 registered AJAX actions. Key ones for developers:

Exercises & Students

Gamification

Registration & Auth

Administration

WordPress Hooks

Key Actions

Key Filters

License System

File: /includes/core/license-manager.php. License server: https://promologica.it/wp-json/tl-license/v1

Frequently Asked Questions

Best Practices