mailinapp
Documentation menu

Blocco Compito

Compiti a casa o materiale del corso con una data di scadenza: un titolo, istruzioni, un valore in punti facoltativo, un numero qualsiasi di link a risorse e un controllo di invio. È il blocco dello Studio per trasformare un'email in un vero e proprio compito invece che nel semplice annuncio di uno.

Come funziona

La data di scadenza viene renderizzata come un'immagine di conto alla rovescia dal vivo nell'email inviata, usando la stessa tecnica di GIF animata renderizzata lato server usata dal blocco Conto alla rovescia stesso. Quell'endpoint è realmente condiviso; il blocco Compito non esegue un proprio encoder di immagini. Accanto a essa si trova una semplice riga di testo "Scade tra Xg Yh Zm" oppure "Scaduto". Questo abbinamento è importante perché è ciò che mantiene la scadenza accurata indipendentemente dal fatto che un dato client renderizzi o meno l'immagine. La riga di testo viene calcolata al momento dell'invio a partire dall'apertura del destinatario stesso, così risulta corretta anche in un client che non mostra alcuna immagine, mentre la GIF continua a scorrere per i client che invece la mostrano.

L'invio ha tre forme, scelte dal campo Invio:

  • Contrassegna come fatto — un'azione a valore fisso, quindi riceve lo stesso trattamento link-first di un'opzione di sondaggio o di un chip di valutazione: un vero <form> nell'email che invia all'endpoint delle interazioni (livello cinetico) accanto a un link di fallback semplice verso la pagina di conferma ospitata (/v/[token]/act), entrambi racchiusi attorno allo stesso controllo "Contrassegna come fatto". Poiché il valore inviato non varia mai, il percorso di livello 2 basato solo su link funziona bene qui, a differenza delle due modalità sottostanti.
  • Risposta a testo breve / Risposta con link — queste portano un valore libero che nessun semplice link GET può pre-compilare, quindi — come il fallback a modulo intero del blocco Quiz — il percorso di livello 2 è un link verso la vista live ospitata stessa, dove un vero <input> (di tipo text oppure url rispettivamente, con un segnaposto appropriato) raccoglie la risposta e la invia. Per queste due modalità non esiste digitazione all'interno dell'email nei client che non possono renderizzare il modulo cinetico: si apre invece la vista live.

Qualunque sia la modalità configurata, un invio arriva come un normale evento di interazione ed è deduplicato per destinatario nello stesso modo di un voto di sondaggio — un clic ripetuto sul proprio link da parte del destinatario è un no-op, non un secondo invio. Se la data di scadenza del blocco è già trascorsa nel momento in cui arriva un invio, questo viene comunque registrato, solo contrassegnato come in ritardo più a valle (vedi il riepilogo Registro voti sotto). Il blocco Compito non blocca mai la registrazione di un invio in ritardo; si limita a contrassegnarlo.

Ovunque altrove (Outlook, o qualsiasi client che non rispetta né il livello cinetico né riesce a renderizzare in modo significativo l'immagine di conto alla rovescia), il fallback è semplicemente la riga di testo statica con la data di scadenza più l'elenco dei link alle risorse. Entrambi vengono sempre renderizzati indipendentemente dal livello, insieme a qualunque controllo di invio (chip o link alla vista live) si applichi.

Campi configurabili:

  • Titolo e Istruzioni, oltre ai propri colori e alle dimensioni del carattere.
  • Scade il — una data/ora; l'immagine di conto alla rovescia e il testo "Scade tra…"/"Scaduto" vengono renderizzati solo quando questo campo è impostato.
  • Punti — 0 significa non valutato (la stessa convenzione "0 = non impostato" usata dal campo Inventario del blocco Prodotto); un valore diverso da zero aggiunge "(N pt)" accanto al titolo.
  • Link alle risorse — un numero qualsiasi di coppie etichetta/URL, renderizzate come un semplice elenco di link sotto le istruzioni.
  • Invio — Contrassegna come fatto / Risposta a testo breve / Risposta con link, come sopra.
  • Colore di sfondo, padding, bordo, raggio del bordo, e una sostituzione del colore del pulsante condivisa dal controllo di invio.

Esempi

Subject

New assignment: Chapter 4 reading response

Un promemoria settimanale di compiti per un corso online si abbina naturalmente a Contrassegna come fatto — vedi Istruzione per lo schema più ampio di gestire compiti e promemoria via email. Un compito a risposta scritta ("riassumi il capitolo 3 in due frasi") usa Risposta a testo breve, così la risposta stessa arriva direttamente nel Registro voti invece di richiedere un portale di invio separato. Un compito basato su progetto ("invia il link al tuo documento condiviso") usa Risposta con link, con i Link alle risorse che puntano alla griglia di valutazione e a qualsiasi materiale di riferimento. Imposta una data di scadenza sulla scadenza effettiva, così il conto alla rovescia dà agli studenti una reale percezione di urgenza man mano che si avvicina.

Come appare il fallback statico

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

Questo mostra il fallback della modalità Risposta a testo breve: poiché la risposta non può essere pre-compilata in un semplice link, il fallback è un link verso la vista live ospitata invece di una pagina di conferma /act.

Vedi anche