moodle-section-optimizer

name: moodle-section-optimizer description: Optimiert Moodle-Kursabschnitte basierend auf 4K-Analyse. Erstellt Labels mit Bildern, generiert H5P-Inhalte, fügt Struktur-Elemente hinzu. Nutze nach moodle-section-analyzer oder wenn konkrete Verbesserungen umgesetzt werden sollen. license: MIT

Moodle Section Optimizer

Setzt konkrete Optimierungen für Moodle-Abschnitte um: Labels, H5P, Struktur, Multimedia.

Wann nutzen

• Nach Analyse mit moodle-section-analyzer
• Konkrete 4K-Lücken schließen
• Abschnitt visuell aufwerten
• Interaktive Elemente hinzufügen

Voraussetzungen

• MCP Server: moodle-mcp (v2.4.0+) mit H5P-Tools
• Skills: h5p-generator (für H5P-Erstellung)
• Analyse: Idealerweise vorher moodle-section-analyzer ausführen
• Optional: wordpress-mcp (nur falls WordPress H5P benötigt wird)

Optimierungs-Bausteine

1. Phasen-Labels (Struktur)

Visuelle Trenner für Abschnittsphasen:

<!-- Phase-Start Label -->
<div style="background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); 
            color: white; padding: 15px; border-radius: 8px; margin: 10px 0;">
  <h3 style="margin: 0;">🎯 Phase 1: Orientierung</h3>
  <p style="margin: 5px 0 0 0; opacity: 0.9;">ca. 15 Minuten</p>
</div>

Farb-Schema nach Phase:

2. Einführungs-Labels (Multimedia)

<!-- Mit Bild (Base64 oder URL) -->
<div style="display: flex; align-items: center; gap: 20px; padding: 15px; 
            background: #f8f9fa; border-radius: 8px; border-left: 4px solid #667eea;">
  <img src="[BILD_URL]" style="width: 120px; border-radius: 8px;" alt="Thema">
  <div>
    <h3 style="margin: 0 0 8px 0;">🛒 Der Checkout-Prozess</h3>
    <p style="margin: 0; color: #666;">In dieser Einheit analysieren Sie...</p>
  </div>
</div>

Bildquellen:

• undraw.co (kostenlos, SVG)
• Flaticon (Icons)
• Eigene Screenshots

3. Lernziel-Labels

<div style="background: #e8f5e9; padding: 15px; border-radius: 8px; 
            border-left: 4px solid #4caf50;">
  <h4 style="margin: 0 0 10px 0;">🎯 Lernziele</h4>
  <ul style="margin: 0; padding-left: 20px;">
    <li>Den Checkout-Prozess beschreiben können</li>
    <li>Abbruchgründe analysieren und bewerten</li>
    <li>Optimierungsvorschläge entwickeln</li>
  </ul>
</div>

4. Abschluss-Labels

<div style="background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); 
            color: white; padding: 20px; border-radius: 8px; text-align: center;">
  <h3 style="margin: 0;">🎉 Geschafft!</h3>
  <p style="margin: 10px 0 0 0;">Sie haben Phase 1 abgeschlossen.<br>
     Weiter geht's mit: Zahlungsarten</p>
</div>

5. H5P-Elemente (via h5p-generator)

✅ EMPFOHLEN: Native Moodle H5P (Content Bank)

Seit dem local_h5p_api Plugin können H5P-Inhalte direkt in Moodle gespeichert werden:

Workflow für native Moodle H5P:

# 1. H5P generieren mit h5p-generator
from h5p_generator import create_multi_choice
questions = [...]
create_multi_choice("Checkout-Quiz", questions, "checkout-quiz")
# → Datei: checkout-quiz.h5p

# 2. H5P zu Moodle hochladen (via MCP)
moodle_upload_h5p({
    "base64data": "[BASE64_ENCODED_H5P]",
    "filename": "checkout-quiz.h5p",
    "title": "Checkout-Quiz",
    "courseid": 6
})
# → Response: { contentid: 42, embedurl: "...", iframecode: "..." }

# 3. In Section einbetten (via moodle_update_section oder moodle_create_label)

Moodle H5P Embed-Format:

https://moodle.example.com/h5p/embed.php?url=https%3A%2F%2Fmoodle.example.com%2Fpluginfile.php%2F[contextid]%2Fcontentbank%2Fpublic%2F[contentid]%2F[filename]

Zwei Einbettungs-Optionen:

Beispiel: H5P in Section Summary:

<h4>Wissenstest</h4>
<iframe src="https://moodle.example.com/h5p/embed.php?url=..."
        width="100%" height="600" frameborder="0" allowfullscreen></iframe>

Alternative: WordPress H5P (Legacy)

Falls WordPress H5P noch benötigt wird:

https://[DOMAIN]/wp-admin/admin-ajax.php?action=h5p_embed&id=[H5P_ID]

Erstellung:

# Via h5p-generator Skill
from h5p_generator import create_multi_choice, create_fill_blanks

# Quiz für Kritisches Denken
questions = [
    {
        "question": "Was ist der wichtigste Faktor für Kaufabbrüche?",
        "answers": [
            {"text": "Zu hohe Versandkosten", "correct": True},
            {"text": "Schlechtes Design", "correct": False},
            {"text": "Lange Ladezeiten", "correct": False}
        ]
    }
]
create_multi_choice("Checkout-Quiz", questions, "checkout-quiz")

Workflow

Schritt 1: Analyse-Ergebnis prüfen

input:
  kurs_id: 6
  abschnitt_num: 2
  diagnose:
    4k_defizite: [Kreativität, Kritisches Denken]
    fehlend: [Bilder, Quiz, Struktur-Labels]

Schritt 2: Optimierungsplan erstellen

plan:
  - aktion: "Phase-Label erstellen"
    typ: label
    position: "Anfang"
    inhalt: "🎯 Phase 1: Orientierung"
    
  - aktion: "Einführungs-Label mit Bild"
    typ: label
    position: "Nach Phase-Label"
    bild: "checkout-illustration.svg"
    
  - aktion: "H5P Quiz erstellen"
    typ: h5p
    h5p_typ: "multi_choice"
    fragen: 5
    
  - aktion: "Abschluss-Label"
    typ: label
    position: "Ende"
    inhalt: "🎉 Geschafft!"

Schritt 3: Module erstellen

// 1. Phase-Label
moodle:moodle_create_label({
  courseId: "6",
  sectionNum: "2",
  labelText: `<div style="background: linear-gradient(...)">
    <h3>🎯 Phase 1: Orientierung</h3>
  </div>`
})

// 2. H5P erstellen (via h5p-generator)
// → Datei: checkout-quiz.h5p

// 3. H5P zu Moodle Content Bank hochladen (empfohlen)
moodle:moodle_upload_h5p({
  base64data: "[BASE64]",
  filename: "checkout-quiz.h5p",
  title: "Checkout-Quiz",
  courseid: "6"
})
// → { contentid: 42, embedurl: "...", iframecode: "..." }

// 4. H5P in Abschnitt einbetten
moodle:moodle_update_section({
  courseId: "6",
  sectionNum: "2",
  summary: `<h4>🎮 Quiz: Checkout-Basics</h4>
            <iframe src="[embedurl from response]"
            width="100%" height="600" frameborder="0" allowfullscreen></iframe>`
})

Optimierungs-Rezepte

Rezept 1: "Quick Win" – Visuelle Aufwertung (15 Min)

schritte:
  1. Phase-Label am Anfang (Gradient + Emoji)
  2. Lernziel-Label nach Einführung
  3. Abschluss-Label am Ende
  
aufwand: ⭐
4k_impact: Gering (Orientierung verbessert)

Rezept 2: "Interaktivität" – H5P hinzufügen (30 Min)

schritte:
  1. Quiz mit 5 Fragen erstellen (h5p-generator)
  2. Fill-in-Blanks für Definitionen
  3. In Moodle als Page einbetten
  
aufwand: ⭐⭐
4k_impact: Kritisches Denken ↑↑

Rezept 3: "Vollständig" – Alle 4K abdecken (60 Min)

schritte:
  1. Struktur-Labels (Phasen)
  2. Einführungs-Label mit Bild
  3. H5P Quiz (Kritisches Denken)
  4. H5P Drag&Drop (Kreativität)
  5. Forum-Aufgabe umformulieren (Kollaboration)
  6. Peer-Review-Anweisung (Kommunikation)
  7. Abschluss-Label mit Badge-Hinweis
  
aufwand: ⭐⭐⭐
4k_impact: Alle 4K verbessert

HTML-Templates

Template: Info-Box

<div style="background: #e3f2fd; padding: 15px; border-radius: 8px; 
            border-left: 4px solid #2196f3; margin: 10px 0;">
  <strong>💡 Info:</strong> [TEXT]
</div>

Template: Warnung

<div style="background: #fff3e0; padding: 15px; border-radius: 8px; 
            border-left: 4px solid #ff9800; margin: 10px 0;">
  <strong>⚠️ Wichtig:</strong> [TEXT]
</div>

Template: Aufgaben-Box

<div style="background: #f3e5f5; padding: 15px; border-radius: 8px; 
            border-left: 4px solid #9c27b0; margin: 10px 0;">
  <strong>📋 Arbeitsauftrag:</strong>
  <ol style="margin: 10px 0 0 0;">
    <li>[SCHRITT 1]</li>
    <li>[SCHRITT 2]</li>
  </ol>
</div>

Template: Zeitangabe

<div style="display: inline-block; background: #e8eaf6; padding: 5px 12px; 
            border-radius: 15px; font-size: 0.9em; color: #3f51b5;">
  ⏱️ ca. 15 Minuten
</div>

Best Practices

1. Konsistente Farben: Ein Farbschema pro Kurs durchhalten
2. Emoji-Sprache: Einheitliche Emojis für gleiche Konzepte
3. Nicht überladen: Max. 2-3 neue Elemente pro Iteration
4. Testen: Nach jeder Änderung im Browser prüfen
5. Mobile-First: Inline-Styles responsive halten

Reihenfolge der Module

Nach Optimierung sollte ein Abschnitt folgende Struktur haben:

📁 Abschnitt X: [Thema]
├── 🏷️ Phase-Label (Einführung)
├── 🏷️ Lernziele
├── 🏷️ Einführungs-Label mit Bild
├── 🔗 LOOP/Theorie-Link
├── 🎮 H5P Selbsttest (Verständnissicherung)
├── 📋 Arbeitsauftrag / Assignment
├── 💬 Forum zur Aufgabe
├── 🎮 H5P Quiz (Abschlusstest)
└── 🏷️ Abschluss-Label

Limitations

Bekannte Einschränkungen

Empfohlener Workflow

1. Erst analysieren (moodle-section-analyzer)
2. H5P generieren (h5p-generator)
3. H5P zu Moodle hochladen (moodle_upload_h5p)
4. Labels + Pages erstellen (dieser Skill)
5. In Moodle einloggen → Module per Drag&Drop sortieren
6. Foren manuell anlegen (falls benötigt)

⚠️ Kritische Warnung: Berechtigungen

Nach CLI-Befehlen im Moodle-Container können Berechtigungsprobleme auftreten!

Symptom: "Invalid permissions detected when trying to create a directory"

Lösung:

docker exec moodle chown -R daemon:daemon /bitnami/moodledata/

Siehe: [[Moodle-Learnings#KRITISCH moodledata Berechtigungsproblem]]

Referenzen

• [[Moodle]] - MCP Server Dokumentation v2.4.0+
• [[Moodle-Learnings]] - Troubleshooting & Best Practices
• [[local_h5p_api Plugin]] - H5P Upload/Embed API

Logging

Bei Ausführung dieses Skills wird automatisch geloggt:

Beispiel-Log:

{
  "agent": "education",
  "action": "moodle:optimize_section",
  "context": "{\"course_id\": 6, \"section_num\": 2, \"labels_added\": 3, \"h5p_added\": 2, \"recipe\": \"vollstaendig\"}",
  "result": "success"
}

Skill Version: 1.1 Abhängigkeiten: moodle-mcp (v2.4.0+), h5p-generator Letzte Aktualisierung: 2026-01-15