mailinapp
Documentation menu

Bloc Devoir

Un devoir ou un travail scolaire avec une date d'échéance : un titre, des instructions, une valeur en points facultative, un nombre quelconque de liens de ressources, et un contrôle de soumission. C'est le bloc du studio pour transformer un email en un véritable devoir plutôt qu'une simple annonce de devoir.

Comment ça fonctionne

La date d'échéance se rend comme une image de compte à rebours en direct dans l'email envoyé, en utilisant la même technique de GIF animé rendu côté serveur que le bloc compte à rebours utilise lui-même. Cet endpoint est véritablement partagé ; le bloc devoir n'exécute pas son propre encodeur d'image. À côté figure une simple ligne de texte « Échéance dans Xj Yh Zm » ou « En retard ». Cet appariement compte car c'est ce qui garde l'échéance exacte que le client rende l'image ou non. La ligne de texte est calculée au moment de l'envoi à partir de l'ouverture propre du destinataire, elle reste donc correcte même dans un client qui n'affiche aucune image, tandis que le GIF continue de défiler pour les clients qui le peuvent.

La soumission a trois formes, choisies par le champ Soumission :

  • Marquer comme fait — une action à valeur fixe, elle reçoit donc le même traitement lien-en-premier qu'une option de sondage ou une puce de notation : un vrai <form> dans l'email qui poste vers l'endpoint des interactions (niveau cinétique) à côté d'un lien de repli simple vers la page de confirmation hébergée (/v/[token]/act), tous deux enveloppant le même contrôle « Marquer comme fait ». Comme la valeur soumise ne varie jamais, le chemin lien seul de niveau 2 fonctionne bien ici, contrairement aux deux modes ci-dessous.
  • Réponse en texte court / Réponse par lien — ces modes portent une valeur libre qu'aucun lien GET simple ne peut pré-remplir, donc — comme le repli en formulaire entier du bloc quiz — le chemin de niveau 2 est un lien vers la vue en direct hébergée elle-même, où un vrai <input> (type text ou type url respectivement, avec un espace réservé approprié) collecte la réponse et la poste. Il n'y a pas de saisie dans l'email pour ces deux modes dans les clients qui ne rendent pas le formulaire cinétique ; ils ouvrent la vue en direct à la place.

Quel que soit le mode configuré, une soumission atterrit comme un événement d'interaction normal et est dédupliquée par destinataire de la même façon qu'un vote de sondage — un clic répété sur le propre lien du destinataire est sans effet, pas une seconde soumission. Si la date d'échéance du bloc est passée au moment où une soumission arrive, elle est tout de même enregistrée, simplement signalée comme tardive en aval (voir la synthèse du Carnet de notes ci-dessous). Le bloc devoir ne bloque jamais une soumission tardive ; il ne fait que la marquer.

Partout ailleurs (Outlook, ou tout client n'honorant ni le niveau cinétique ni capable de rendre l'image de compte à rebours de façon significative), le repli est simplement la ligne de texte statique de date d'échéance plus la liste des liens de ressources. Les deux se rendent toujours, quel que soit le niveau, à côté de quel que soit le contrôle de soumission (puce ou lien vers la vue en direct) applicable.

Champs configurables :

  • Titre et Instructions, plus leurs propres couleurs et tailles de police.
  • Échéance — une date/heure ; l'image de compte à rebours et le texte « Échéance dans… »/« En retard » ne se rendent du tout que lorsque ce champ est défini.
  • Points — 0 signifie non noté (la même convention « 0 = non défini » que le champ Stock du bloc produit) ; une valeur non nulle ajoute « (N pts) » à côté du titre.
  • Liens de ressources — un nombre quelconque de paires libellé/URL, rendues comme une simple liste de liens sous les instructions.
  • Soumission — Marquer comme fait / Réponse en texte court / Réponse par lien, comme ci-dessus.
  • Couleur d'arrière-plan, marge intérieure, bordure, rayon de bordure, et une surcharge de couleur de bouton partagée pour le contrôle de soumission.

Exemples

Subject

New assignment: Chapter 4 reading response

Un rappel de devoir hebdomadaire pour un cours en ligne s'associe naturellement à Marquer comme fait — voir Éducation pour le motif plus large de gérer les travaux et rappels par email. Un devoir à réponse rédigée (« résumez le chapitre 3 en deux phrases ») utilise Réponse en texte court afin que la réponse elle-même atterrisse dans le Carnet de notes plutôt que d'exiger un portail de soumission séparé. Un devoir par projet (« soumettez le lien de votre document partagé ») utilise Réponse par lien, avec Liens de ressources pointant vers le barème et tout matériel de référence. Réglez une date d'échéance sur la véritable date limite afin que le compte à rebours donne aux élèves un vrai sentiment d'urgence à mesure qu'elle approche.

À quoi ressemble l'alternative statique

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

Ceci montre le repli du mode Réponse en texte court : comme la réponse ne peut pas être pré-remplie dans un lien simple, le repli est un lien vers la vue en direct hébergée plutôt qu'une page de confirmation /act.

Voir aussi