Wie baue ich das eigentlich alles? Ein Blick unter die Haube

PHP, JSON, CSS und eine Datei, die niemand sehen darf: So ist Lehrzeug aufgebaut, so kommen neue Werkzeuge auf den Server, und darum bleiben eure Daten bei euch.

Michael3 Min. Lesezeit

Hallo zusammen,

nach dem ersten Beitrag kam oft die Frage: „Und wie baust du das eigentlich alles?“ Hier kommt die Antwort, so verständlich wie möglich und gern auch zum Nachmachen im Informatikunterricht.

Kurz zu mir: Ich bin eigentlich Mathematiker, habe Informatik bis Klasse 10 unterrichtet und bin in Baden-Württemberg Lehrer für Informatik und für IMP (Informatik, Mathematik, Physik). Schon im Studium habe ich mich auf Webdesign spezialisiert. Das hat mir immer Spaß gemacht, und genau dieser Spaß steckt in Lehrzeug.

Ein Werkzeugkasten mit gemeinsamem Kern

Lehrzeug ist aufgebaut wie ein echter Werkzeugkasten. Es gibt einen gemeinsamen Kern, den alle Werkzeuge benutzen:

  • PHP setzt auf dem Server jede Seite zusammen: Kopf, Fuß, Menü, Sicherheitsregeln.
  • CSS sorgt für das Aussehen, in Hell und Dunkel, am Handy wie am Beamer.
  • JavaScript macht die Werkzeuge lebendig: Drucken mit sauberen Seitenumbrüchen, QR-Codes, Timer, Speichern.

Jedes Werkzeug hat dann seinen eigenen Ordner mit einer kleinen index.php, einer HTML-Vorlage, einer JavaScript- und einer CSS-Datei. Ein zentrales Verzeichnis beschreibt alle Werkzeuge: Name, Kurzbeschreibung, Fächer, Klassenstufen, Unterrichtsphase. Daraus entstehen Startseite, Menü und Filter automatisch. Ein neues Werkzeug ist also ein neuer Ordner und ein neuer Eintrag.

Warum JSON?

Eure Eingaben, Klassenlisten oder Vorlagen speichert Lehrzeug im Browser, und zwar als JSON. Das ist ein einfaches Textformat, das Menschen und Programme gleichermaßen lesen können:

{"klasse": "7b", "thema": "Brüche", "kriterien": 4}

Der große Vorteil: Ihr könnt alles als kleine Datei sichern, auf einem anderen Gerät wieder laden oder an Kolleginnen und Kollegen weitergeben, ganz ohne Konto und ohne Server. Auf dem Server selbst liegen nur anonyme Zählwerte (wie oft ein Werkzeug genutzt wird) und die Live-Runden von Wortwolke und Co., die nach 24 Stunden automatisch gelöscht werden.

Die Datei, die niemand sehen darf

Jede Webseite hat Geheimnisse, zum Beispiel das Kennwort für die Verwaltung. Bei Lehrzeug stehen sie in einer config.php, und die liegt nicht im öffentlichen Webordner, sondern eine Ebene darüber. Über eine Internetadresse ist sie gar nicht erreichbar, und eine zusätzliche Sperrdatei verriegelt den Ordner doppelt.

Dazu kommen weitere Schutzschichten:

  • Alles läuft verschlüsselt über HTTPS, und der Browser merkt sich, dass es nur so geht.
  • Eine strenge Sicherheitsrichtlinie (Content Security Policy) erlaubt nur Code von Lehrzeug selbst: keine fremden Skripte, keine Werbenetzwerke, keine Google Fonts.
  • Besucher bekommen keine Cookies. Darum gibt es auch keinen Cookie-Banner.
  • Die Verwaltung ist mit einem langen Kennwort geschützt. Nach wenigen Fehlversuchen ist erst einmal Pause.
  • Ein Dateiwächter kennt von jeder Datei eine Prüfsumme und meldet sofort, wenn sich auf dem Server etwas verändert hat, das ich nicht hochgeladen habe.

Oben auf jeder Seite unter „Mehr“ → „Sicher und privat“ könnt ihr die wichtigsten Punkte sogar live selbst prüfen.

Wie neue Versionen auf den Server kommen

Ich programmiere auf meinem Rechner in einem Quellordner. Ein kleines Python-Skript baut daraus das fertige Paket, prüft alle Dateien und erzeugt die Prüfsummen für den Dateiwächter. Danach laufen automatische Tests im Browser: Passt jede Seite aufs Handy? Lässt sich alles sauber als PDF drucken? Gibt es Fehler?

Erst dann geht es hoch, und zwar per SFTP, also verschlüsselt, mit einem starken Kennwort. Bei Updates lade ich nur die Dateien hoch, die sich wirklich geändert haben. Die config.php wird dabei nie überschrieben.

Und die Ideen?

Die kommen aus dem Unterricht, aus dem Kollegium und von euch. Beim Programmieren nutze ich inzwischen auch KI als Sparringspartner, ähnlich wie im Unterricht: Die Ideen, das Ausprobieren im Klassenzimmer und die Verantwortung bleiben bei mir.

Wenn ihr Fragen zur Technik habt oder das Ganze mit eurem Informatikkurs nachbauen wollt: Schreibt mir, ich helfe gern.

Euer Michael

Geschrieben von

Michael

Lehrer und Macher von Lehrzeug

Ich unterrichte Mathematik, Informatik und Psychologie und baue Lehrzeug in meiner freien Zeit: kostenlos, ohne Werbung und ohne Anmeldung. Ideen und Rückmeldungen sind immer willkommen.

Das könnte dich auch interessieren

So geht’s mit Lehrzeug

Kostenlose Werkzeuge für Lehrkräfte, die in deinem Browser arbeiten. Das Wichtigste in Kürze:

  • In einer Minute fertigWerkzeug öffnen, ausfüllen, drucken oder an den Beamer. Ohne Anmeldung, ohne Einarbeitung.
  • FavoritenMit „Merken“ steht dein Werkzeug oben im Kopf und zuerst auf der Startseite.
  • Vorlagen speichernÜber „Speichern“ legst du je Werkzeug eigene Vorlagen an, zum Beispiel je Klasse oder Fach.
  • Sichern als DateiEine Seite oder alles auf einmal als JSON-Datei: für ein neues Gerät, als Sicherung oder fürs Kollegium.
  • Drucken und PDFA4 oder zweimal A5 auf einem Blatt, mit Kopfzeile, Logo und sauberen Seitenumbrüchen.
  • Für den BeamerVollbild, große Schrift, Steuerung mit dem Klicker. Live-Runden per QR-Code.
  • KostenlosAuch das, was anderswo Geld kostet: Transkription, Live-Umfragen, Tests mit Lösung.
  • Alles an einem OrtEine Werkzeugkiste statt vieler Abos, Konten und Passwörter.
  • Von Lehrkräften für LehrkräfteJedes Werkzeug kommt aus einer echten Situation im Schulalltag.
  • Beta-PhaseLehrzeug wird gerade von vielen Lehrkräften erprobt. Deine Rückmeldung fließt direkt ein.
  • Login geplantWeil so viele mitmachen, kommt ein freiwilliges Konto: Vorlagen auf allen Geräten. Ohne Konto bleibt alles wie jetzt.

Sicher und privat

Lehrzeug-Werkzeuge verarbeiten deine Eingaben im Browser. Nichts wird an den Server übertragen (Ausnahme: Kurzlink).

Live geprüft, gerade eben in deinem Browser

Was dieser Browser für Lehrzeug speichert

Alle Schutzmaßnahmen im Überblick
  • Verschlüsselte Verbindung (HTTPS mit HSTS)Alles läuft verschlüsselt. Dein Browser merkt sich ein Jahr lang, dass Lehrzeug nur verschlüsselt aufgerufen werden darf.
  • Strenge Content-Security-PolicyDer Browser führt nur Programmcode von lehrzeug.online aus. Fremde Skripte, eingeschleuster Code und Inline-Skripte werden blockiert.
  • Keine FremddiensteKeine Google-Schriften, keine CDNs, keine Analyse- oder Werbedienste. Schriften, Bilder und Programmteile kommen alle vom eigenen Server in Deutschland.
  • Keine Cookies, kein TrackingEs gibt kein Profil über dich und keinen Cookie-Banner, weil es nichts zum Einwilligen gibt. Gezählt wird nur anonym, wie oft ein Werkzeug genutzt wird: ohne IP-Adresse, ohne Kennung, ohne Cookie. „Do Not Track“ wird beachtet.
  • Deine Daten bleiben im BrowserKlassenlisten, Noten, Texte und Dateien werden direkt auf deinem Gerät verarbeitet. Sie werden nicht hochgeladen und der Betreiber kann sie nicht sehen.
  • Schutz vor Clickjacking und DatenlecksLehrzeug lässt sich nicht in fremde Seiten einbetten (frame-ancestors, X-Frame-Options), Dateitypen werden nicht erraten (nosniff) und fremde Seiten erfahren nicht, welche Lehrzeug-Seite du besucht hast (Referrer-Policy).
  • Kein Zugriff auf Kamera, Mikrofon oder StandortDie Permissions-Policy verbietet diese Zugriffe für alle Seiten. Auch Werbe-Schnittstellen wie „Topics“ sind abgeschaltet.
  • Private Einstellungen unter VerschlussZugangsdaten und Einstellungen liegen in einem Ordner, den der Server für Besucher komplett sperrt. Vorlagen und Programmteile sind ebenfalls nicht direkt abrufbar.
  • Kurzlink mit MissbrauchsschutzErstellen nur mit Zugangscode, fälschungssichere Formular-Token (HMAC), Begrenzung der Anfragen, Köderfeld gegen Bots, gesperrte Domains, Meldefunktion mit automatischer Sperre. IP-Adressen werden nie gespeichert, nur ein nicht umkehrbarer Prüfwert für höchstens 24 Stunden.
  • Gesicherte VerwaltungAdmin-Bereich und Kurzlink-Verwaltung sind passwortgeschützt, für Suchmaschinen unsichtbar, sperren nach wiederholten Fehlversuchen und ist gegen Anfragen von fremden Seiten (CSRF) abgesichert.
  • SicherheitskontaktWer eine Schwachstelle findet, erreicht den Betreiber über die standardisierte Datei /.well-known/security.txt.

Und Cookies?

Lehrzeug setzt keine Cookies, weder für Statistik noch für Werbung. Deshalb gibt es auch keinen Cookie-Banner zum Wegklicken. Was du speicherst, liegt im lokalen Speicher deines Browsers und ist für die Funktion unbedingt nötig (§ 25 Abs. 2 Nr. 2 TDDDG). Einzige Ausnahme: Admin-Bereich und Kurzlink-Verwaltung, die nur der Betreiber nutzt, setzen nach der Anmeldung ein technisch notwendiges Sitzungs-Cookie. Gezählt wird nur anonym, wie oft ein Werkzeug genutzt wird, ohne IP-Adresse, ohne Kennung und ohne Cookie.

Speichern und laden

Sichere alles, was du in Lehrzeug angelegt hast, in einer einzigen Datei: Vorlagen, Pläne, Listen, Favoriten und Einstellungen aller Werkzeuge. Ideal für den Umzug auf ein neues Gerät oder als Sicherung vor den Ferien.

Beim Laden ersetzt Lehrzeug nur die Werkzeuge, die in der Datei stehen. Alles andere bleibt, wie es ist. Die Datei ist ein lesbares JSON-Textdokument ohne Programmcode.

Alles liegt nur in diesem Browser. Vor dem Laden einer Vorlage sichert Lehrzeug den Stand der Seite automatisch als „Automatische Sicherung“. Mit dem geplanten Lehrzeug-Konto sind Vorlagen später auf all deinen Geräten verfügbar.

Diese Seite teilen

Zeig den Code am Beamer oder häng ihn ins Lehrerzimmer. Wer ihn scannt, landet direkt hier.

Bild für den WhatsApp-Status

  1. Bild speichern oder direkt teilen.
  2. In Instagram oder WhatsApp als Story oder Status posten.
  3. Den Link als Sticker oder in die Bildunterschrift einfügen (ist schon kopiert, wenn du auf „Text kopieren“ tippst).

Das Bild entsteht in deinem Browser. Es wird nichts hochgeladen.