<< Einsatz im Unterricht | Hot Potatoes | Linkliste >>


Seiteninhalt (verbergen)

  1. 1. Was ist HotPotCGI?
  2. 2. Features
  3. 3. Einstellungen in Hot Potatoes
  4. 4. Skript für educanet2.ch-Benutzer/innen
  5. 5. Skripteinstellungen
  6. 6. Download

1. Was ist HotPotCGI?

HotPotCGI ist ein PHP-Skript das zur Weiterleitung der Ergebnisse von Hot Potatoes-Übungen dient. Dabei werden die Angaben, wie Übungsname, Name des Schülers/Studenten, Ergebnis, Zeitpunkt und benötigte Zeit per Mail verschickt. HotPotCGI nutzt die CGI-Schnittstelle von Hot Potatoes und ist sehr einfach im Einsatz.

Falls Sie weitergehende Möglichkeiten zur Ergebnisverwaltung brauchen, schauen Sie sich bitte die Linkliste an.


2. Features

HotPotCGI Merkmal folgende Merkmale:

  • Nutzung der CGI-Schnittstelle von Hot Potatoes
  • Minimum-Score-Angabe
    Wird der Minimum-Score nicht erreicht, wird auch kein Mail verschickt.
  • Zeitangabe vom Server
    Angabe zum Zeitpunkt der Übungsbearbeitung vom Server und nicht vom Client-Computer.
  • Angabe der Übungsdauer
    Berechnung der Übungsdauer durch HotPotCGI.
  • Versenden der Ergebnisse wahlweise an:
    • eine oder mehrere vordefinierte Adressen
      unabhängig von den Angaben in Hot Potatoes
    • eine oder mehrere BCC-Adressen (Blindkopien)
    • eine oder mehrere Adressen, die in Hot Potatoes definiert wurden.
  • Validitätsprüfung der eMail-Adressen
    Mails werden nur an korrekte Adressen verschickt.
  • Positiv-Liste
    Liste mit Adressen, an die Mails verschickt werden sollen.
  • Negativ-Liste
    Liste mit Adressen, an die keine Mails verschickt werden dürfen.
  • Schutz vor SPAM-Bots
    Codierte @-Zeichen, damit die Adresse nicht von Adresssammlern erkannt und ev. missbraucht wird.
  • Server-Kontrolle
    Nur von Übungen auf erlaubten Servern werden Mails verschickt.

Rückmeldungsfenster nach bestandener Übung


3. Einstellungen in Hot Potatoes

Um die CGI-Schnittstelle von Hot Potatoes nutzen zu können, klicken Sie den Knopf «Konfiguration für Websitenausgabe» bzw. «Show Configuration Window». Im aufspringenden Fenster kann unter dem Reiter «CGI» die Box zum Aktivieren der CGI-Funktionalität geklickt werden.

  1. Pfadeingabe zu HotPotCGI
    Beispiel: http://www.server.ch/hotpot/hotpotcgi.php (absoluter oder relativer Pfad)
  2. eMail-Adresse/n eingeben
    Beispiele: mein_name@server.ch (mehrere Adressen durch Komma trennen)
  3. Aufforderungstext eingeben
    Beispiel: Bitte Namen eingeben:

Am Schluss die Eingaben mit «OK» besätigen.


Hot Potatoes CGI-Einstellungen


4. Skript für educanet2.ch-Benutzer/innen

Für alle Benutzer/innen von educanet2.ch steht ein voll funktionsfähiges Skript zur Verfügung. Voraussetzung für die Benutzung ist, dass die Übung bei educanet2.ch abgelegt sein muss. Eine Anleitung dafür finden sie auf der Seite HotPot-Educanet2.

Falls Sie das Skript benutzen möchten, tragen Sie im CGI-Bereich von Hot Potatoes folgende Adresse ein: http://php.educanet2.ch/schulict/hotpot/hotpotcgi.php


5. Skripteinstellungen

Im Skript können einige Einstellungen vorgenommen werden. Dazu kann das Skript in einem Texteditor geöffnet und bearbeitet werden.

$min_score = 70;
Wert:Zahl
Minimaler Score, der erreicht werden muss, um eine Übung zu bestehen und damit ein Mail verschickt wird. Wird der minmale Score unterschritten, wird eine Meldung angezeigt, dass keine Mails verschickt wurden.
$send_mail = true;
Wert: true oder false
Soll dieses Script grundsätzlich Mails verschicken? Ja (true) oder nein (false).
$master_recipients = "";
Wert: eMail-Adresse(n)
Wird hier mind. eine korrekte Adresse angegeben, dann werden alle Ergebnisse an diese aufgeführten Adressen weitergeleitet. Alle in Hot Potatoes eingetragenen Adressen werden nicht beachtet. So lässt sich das Script ausschliesslich persönlich nutzen. Mehrere Adressen durch Komma trennen.
$bcc_recipients = "";
Wert: eMail-Adresse(n)
Wird hier mind. eine korrekte Adresse angegeben, dann wird von jedem Mail, das durch das Skript versandt wird, eine Blindkopie an die aufgeführten Adressen geschickt. Das kann Administratoren dazu dienen, zu überprüfen, wer dieses Skript wie oft benutzt. Mehrere Adressen durch Komma trennen.
$allowed_hotpot_addresses = "";
Wert: eMail-Adresse(n) oder Serverangabe
Es werden nur Mails verschickt an Adressen, die hier eingetragen sind. So kann das Skript einem ausgewählten Nutzerkreis zugänglich gemacht werden, z.B. einzelnen Personen (sein_name@schule.ch) oder allen Personen einer Schule (*@schule.ch). Mehrere Adressen durch Komma trennen.
$banned_hotpot_addresses = "";
Wert: eMail-Adresse(n) oder Serverangabe
An eingetragene Adressen werden keine Mails verschickt. So können einzelne Personen (sein_name@schule.ch) oder alle Personen einer Schule (*@schule.ch) von der Nutzung des Skriptes gezielt ausgeschlossen werden. Mehrere Adressen durch Komma trennen.
$at_code = "-at-,_at_";
Wert: eindeutige Zeichenfolgen
Anstelle des @-Zeichens werden im Hot Potatoes CGI-Bereich die eMailadressen mit diesem Ersatzcode versehen (mein_name_at_schule.ch). Die richtige Adresse erscheint somit nicht im Quellcode der Übungsdatei und kann nicht von SPAM-Robotern eingesammelt werden. SPAM-Schutz also. Mehrere Ersatzcodes durch Komma trennen.
$check_referer = true;
Wert: true oder false
Soll dieses Script prüfen auf welchem Server die Übung liegt? Ja (true) oder nein (false). Somit kann kontrolliert werden, wer das Skript brauchen darf.
$allowed_referers = "";
Wert: Domains
Damit das Skript ausgeführt wird, muss die Übungsdatei auf dem gleichen Server liegen wie das Skript selbst (inkl. alle Subdomains). Sollen auch Übungen von anderen Servern erlaubt sein, können diese hier eingtragen werden (andereschule.ch). Mehrere Domains durch Komma trennen.
$block_empty_referers = false;
Wert: true oder false
Die Absenderkennung (Referer) wird bei einigen Netzwerken durch die Firewall oder durch den Benutzer selber unterdrückt. Es kann bestimmt werden, ob diese Personen ausgeschlossen werden (true) oder nicht ausgeschlossen werden (false).


6. Download

Hier können Sie das aktuelle HotPotCGI-Script als ZIP-File herunterladen