mailinapp
Documentation menu

Aufgaben-Block

Hausaufgaben oder Kursarbeit mit einem Fälligkeitsdatum: ein Titel, Anweisungen, ein optionaler Punktwert, beliebig viele Ressourcen-Links und ein Einreichungselement. Es ist der Block des Studios, der aus einer E-Mail eine echte Aufgabe macht statt nur deren Ankündigung.

Wie es funktioniert

Das Fälligkeitsdatum wird in der versendeten E-Mail als live tickendes Countdown-Bild gerendert, mit derselben serverseitig gerenderten animierten-GIF-Technik, die auch der Countdown-Block selbst verwendet. Dieser Endpunkt wird tatsächlich gemeinsam genutzt; der Aufgaben-Block betreibt keinen eigenen Bildencoder. Daneben steht eine reine Textzeile „Fällig in Xd Yh Zm“ oder „Überfällig“. Dieses Zusammenspiel ist wichtig, denn es sorgt dafür, dass die Frist korrekt bleibt, unabhängig davon, ob ein bestimmter Client das Bild überhaupt rendert. Die Textzeile wird zum Zeitpunkt des Versands aus dem eigenen Öffnen des Empfängers berechnet, sodass sie auch in einem Client korrekt angezeigt wird, der kein Bild zeigt, während das GIF für Clients weiterläuft, die es tun.

Die Einreichung hat drei Formen, gewählt über das Feld Einreichung:

  • Als erledigt markieren — eine Aktion mit festem Wert, die daher dieselbe link-first-Behandlung erhält wie eine Abstimmungsoption oder ein Bewertungs-Chip: ein echtes E-Mail-internes <form>, das an den Interaktions-Endpunkt postet (kinetische Stufe), zusammen mit einem einfachen Fallback-Link zur gehosteten Bestätigungsseite (/v/[token]/act), beide um dasselbe Steuerelement „Als erledigt markieren“ herum aufgebaut. Da der übermittelte Wert nie variiert, funktioniert der reine Link-Pfad der Stufe 2 hier problemlos, anders als bei den beiden folgenden Modi.
  • Kurze Textantwort / Link-Antwort — diese tragen einen Freitextwert, den kein einfacher GET-Link vorausfüllen kann, daher ist — wie beim Ganzformular-Fallback des Quiz-Blocks — der Stufe-2-Pfad ein Link direkt zur gehosteten Live-Ansicht, wo ein echtes <input> (Typ text bzw. type url, mit passendem Platzhalter) die Antwort erfasst und absendet. In diesen beiden Modi gibt es kein E-Mail-internes Eintippen in Clients, die das kinetische Formular nicht rendern können — sie öffnen stattdessen die Live-Ansicht.

Unabhängig vom konfigurierten Modus landet eine Einreichung als normales Interaktionsereignis und wird pro Empfänger dedupliziert, genau wie eine Abstimmungsstimme — ein wiederholter Klick auf den eigenen Link des Empfängers ist ein No-op, keine zweite Einreichung. Ist das Fälligkeitsdatum des Blocks bereits verstrichen, wenn eine Einreichung eintrifft, wird sie trotzdem erfasst, nur nachgelagert als verspätet gekennzeichnet (siehe die Notenbuch-Zusammenfassung unten). Der Aufgaben-Block verhindert nie, dass eine verspätete Einreichung erfasst wird; er markiert sie nur.

Überall sonst (Outlook oder jeder Client, der weder die kinetische Stufe unterstützt noch das Countdown-Bild sinnvoll rendern kann) besteht der Fallback einfach aus der statischen Fälligkeitsdatum-Textzeile plus der Liste der Ressourcen-Links. Beide werden immer gerendert, unabhängig von der Stufe, zusammen mit dem jeweils zutreffenden Einreichungselement (Chip oder Live-Ansicht-Link).

Konfigurierbare Felder:

  • Titel und Anweisungen, jeweils mit eigenen Farben und Schriftgrößen.
  • Fällig am — Datum/Uhrzeit; das Countdown-Bild und der Text „Fällig in…“/„Überfällig“ werden nur gerendert, wenn dies gesetzt ist.
  • Punkte — 0 bedeutet unbewertet (dieselbe Konvention „0 = nicht gesetzt“ wie beim Lagerbestand-Feld des Produkt-Blocks); ein Wert ungleich null hängt „(N Pkt.)“ an den Titel an.
  • Ressourcen-Links — beliebig viele Beschriftung/URL-Paare, dargestellt als einfache Linkliste unter den Anweisungen.
  • Einreichung — Als erledigt markieren / Kurze Textantwort / Link-Antwort, wie oben.
  • Hintergrundfarbe, Innenabstand, Rahmen, Eckenradius und eine gemeinsame Farbüberschreibung für die Schaltfläche des Einreichungselements.

Beispiele

Subject

New assignment: Chapter 4 reading response

Eine wöchentliche Hausaufgabenerinnerung für einen Online-Kurs passt natürlich zu Als erledigt markieren — das breitere Muster, Kursarbeit und Erinnerungen per E-Mail abzuwickeln, finden Sie unter Bildung. Eine schriftliche Antwortaufgabe („fassen Sie Kapitel 3 in zwei Sätzen zusammen“) verwendet Kurze Textantwort, sodass die Antwort selbst im Notenbuch landet, statt ein separates Einreichungsportal zu erfordern. Eine projektbasierte Aufgabe („reichen Sie den Link Ihres geteilten Dokuments ein“) verwendet Link-Antwort, wobei Ressourcen-Links auf die Bewertungsrichtlinie und weiteres Referenzmaterial verweisen. Setzen Sie ein Fälligkeitsdatum auf die tatsächliche Frist, damit der Countdown Studierenden ein echtes Gefühl der Dringlichkeit vermittelt, je näher er rückt.

So sieht der statische Fallback aus

<div style="margin:12px 0;background-color:transparent">
  <p style="margin:0 0 4px;font-weight:700;font-size:18px;color:#111827">
    Chapter 3 reading response (10 pts)
  </p>
  <p style="margin:0 0 6px;font-size:13px;font-weight:600;color:#111827">
    Due in 2d 4h 30m
  </p>
  <img src="https://mailinapp.com/api/countdown?t=1737936000000&c=111827&s=..."
       width="220" height="40" alt="Due in 2d 4h 30m"
       style="display:block;max-width:100%;height:auto;margin-bottom:8px" />
  <div style="text-align:center;margin-top:8px">
    <a href="https://mailinapp.com/v/eyJhbGci..."
       style="display:inline-block;padding:10px 20px;background-color:#4f46e5;
              color:#ffffff;border-radius:6px;text-decoration:none;
              font-size:14px;font-weight:600">
      Submit answer
    </a>
  </div>
</div>

Dies zeigt den Fallback des Modus Kurze Textantwort: Da die Antwort nicht in einen einfachen Link vorausgefüllt werden kann, ist der Fallback ein Link zur gehosteten Live-Ansicht statt zu einer /act-Bestätigungsseite.

Siehe auch