Eigenentwicklungen / Schach-Plugin / Handbuch
Handbuch · Version 3.1
So funktioniert Chess Master.
Alle Funktionen im WordPress-Backend und auf der Website, Schritt für Schritt erklärt: vom ersten Import über Taktikaufgaben bis zum Einbinden auf Ihren Seiten.
01 · Überblick
Was das Plugin kann
Schachfieber Chess Master macht aus Schachnotation (PGN) und Stellungen (FEN) interaktive Bretter. Besucher spielen Partien nach, lesen Varianten und Kommentare, lösen Taktikaufgaben und lassen Stellungen von einer Engine bewerten. Sie pflegen alle Inhalte bequem im WordPress-Backend.
Drei Inhaltsarten:
- Schach-Partien: vollständige Partien oder Studien mit Kommentaren und Varianten.
- Taktikaufgaben: Rätsel, bei denen Besucher den richtigen Zug selbst finden.
- Partiefragmente: Ausschnitte, Endspiele und Lehrbeispiele ab einer bestimmten Stellung.
Die wichtigsten Funktionen: Bretter auf Basis von Chessground (Lichess), Zugliste mit Varianten, Kommentaren und Bewertungszeichen, Taktik-Modus mit Tipp, Lösung und Neustart, Stockfish-Engine im Browser, Brett-Editor im Backend, Kategorien, Shortcodes und automatische Einzelseiten. Alle Bibliotheken liegen auf Ihrem Server.
02 · Installation
Installation und erste Schritte
- In WordPress Plugins → Installieren → Plugin hochladen öffnen.
- Die ZIP-Datei auswählen (nicht entpacken) und Jetzt installieren klicken.
- Plugin aktivieren. Im Menü erscheint der Punkt „Chessmaster“.
- Unter Chessmaster → Schach-Kategorien Kategorien anlegen, z. B. „Eröffnungen“ oder „Endspiele“.
- Im Brett-Editor die erste Partie erfassen.
Voraussetzungen: WordPress 5.8 oder neuer, PHP 7.4 oder neuer. Funktioniert mit jedem Theme, mit Divi, dem Block-Editor und dem klassischen Editor.
03 · Backend
Das Menü „Chessmaster“
- Brett-Editor: das Herzstück mit sechs Bereichen zum Erfassen neuer Inhalte.
- Schachpartien, Partiefragmente, Taktikaufgaben: die Listen aller gespeicherten Inhalte, jeweils mit fertigem Einbinde-Code in einer eigenen Spalte.
- Schach-Kategorien: gemeinsame, auch verschachtelte Kategorien für alle drei Inhaltsarten.
Der Ablauf: Im Brett-Editor erfassen, als Partie, Aufgabe oder Fragment speichern (Spieler, Turnier, Ort und Datum werden übernommen, der Titel entsteht automatisch), in der Liste Kategorien zuweisen und per Shortcode oder über die automatische Einzelseite veröffentlichen.
04 · Brett-Editor
Die sechs Bereiche des Brett-Editors
Tab 1: Partie eintragen (live)
Für Partien vom Notizzettel oder aus dem Turnier.
- Optional Weiß, Schwarz, Turnier und Datum eintragen.
- Figuren per Maus oder Fingertipp ziehen. Nur regelgerechte Züge sind möglich, Bauern werden automatisch zur Dame.
- Varianten: in der Zugliste zu einem früheren Zug springen und einen anderen Zug spielen.
- Die Live-Notation zeigt die fertige PGN mit Kopfdaten. Unter „Flüchtige Codes“ stehen sofort nutzbare Shortcodes, auch ohne Speichern.
- Partie speichern in Beitragsliste legt eine Schach-Partie an und zeigt den Einbinde-Code.
Tab 2: Importieren (PGN, FEN, Datei)
Für Partien aus ChessBase, Lichess oder Datenbanken.
- PGN-Text oder FEN einfügen oder eine .pgn-Datei hochladen.
- Die Vorschau zeigt sofort Brett, Züge, Kommentare und Varianten.
- Spieler, Turnier, Ort und Datum werden automatisch erkannt und können angepasst werden; Änderungen fließen live in die PGN zurück.
- Für reine Stellungen einen eigenen Titel vergeben.
- Partie speichern in Beitragsliste. Fehlerhafte FENs werden erkannt und nicht gespeichert.
Tab 3: Stellung aufbauen
- Figuren setzen: Figur in der Leiste über oder unter dem Brett wählen, dann auf das Zielfeld klicken. Figuren auf dem Brett lassen sich frei verschieben.
- Löschen mit dem Papierkorb, außerdem Brett leeren, Startposition und Brett drehen.
- Zugrecht und Rochaderechte festlegen oder eine vorhandene FEN laden.
- Die Stellung wird laufend geprüft (z. B. genau ein König je Seite, höchstens acht Bauern, keine Bauern auf der Grundreihe).
- Als Taktikaufgabe oder als Partiefragment übernehmen wechselt mit dieser Stellung direkt in Tab 4 bzw. Tab 5.
Tab 4: Taktikaufgabe erstellen
- Start-FEN einfügen oder aus Tab 3 übernehmen. Wer am Zug ist, erkennt das Plugin selbst.
- Die Lösung auf dem Brett nachspielen, einschließlich der Gegenzüge, oder als PGN einfügen.
- Mit { } Kommentar an der Cursorposition einen Kommentar setzen.
- Lösungen aus Büchern als Fließtext einfügen und mit Buchtext jetzt scannen umwandeln (deutsche Kürzel S, L, T, D, K werden erkannt).
- Taktikaufgabe dauerhaft speichern, oder den Schnell-Shortcode ohne Speichern verwenden.
Für Besucher ist das Brett aus Sicht der Seite am Zug gedreht. Jeder Zug wird geprüft, der Gegenzug erfolgt automatisch, falsche Züge werden zurückgenommen.
Tab 5: Partiefragment eingeben
- PGN-Fragment mit [FEN "…"]-Angabe einfügen, eine Datei hochladen oder eine reine FEN verwenden.
- Optional Spieler, Turnier, Ort und Jahr ergänzen. Wer am Zug ist, wird automatisch eingetragen.
- Fragment speichern in Beitragsliste.
Tab 6: Text-Scanner (experimentell)
Wandelt unstrukturierten Text aus Büchern, PDFs oder Foren in saubere Notation um.
- Rohtext einfügen, Sprache wählen (Deutsch S, L, T, D, K oder Englisch N, B, R, Q, K), optional eine Ausgangs-FEN angeben.
- Analysieren & Umwandeln: Gültige Züge werden erkannt, Fließtext wird zu Kommentaren, Abweichungen zu Varianten. Rochaden als 0-0 und 0-0-0 werden verstanden.
- Die erkannte PGN ist bearbeitbar. Danach Titel vergeben und als Partie, Aufgabe oder Fragment speichern.
Bitte das Ergebnis vor dem Speichern prüfen.
05 · Inhalte pflegen
Inhalte bearbeiten und ordnen
Auf der Bearbeitungsseite jedes Inhalts finden Sie die Box „Schachdaten & Vorschau“:
- Shortcodes für den ganzen Inhalt und für das aktuelle Brettbild, mit einem Klick markiert.
- Partie-Daten (Weiß, Schwarz, Event, Ort, Datum), die sofort in die PGN übernommen werden.
- PGN-Feld mit der kompletten Notation, frei bearbeitbar.
- Vorschau-Brett, auf dem Sie weitere Züge und Varianten spielen können.
Rechts weisen Sie Schach-Kategorien zu. In den Listen zeigt die Spalte „Einbinde-Code“ den passenden Shortcode. Jeder Inhalt hat außerdem eine eigene Einzelseite, auf der das Brett automatisch erscheint.
06 · Einbinden
Die Shortcodes
Shortcodes funktionieren im Block-Editor (Block „Shortcode“), in Divi (Text-Modul) und im klassischen Editor.
[chess_analytics id="123"]: gespeicherte Partie oder gespeichertes Fragment mit Zugliste, Varianten, Kommentaren und Engine.[chess_tactic id="123"]: gespeicherte Taktikaufgabe.[chess_fen fen="…"]: statisches Stellungsbild für Diagramme.[chess_pgn] … [/chess_pgn]: Partie direkt aus PGN-Text, ohne Speichern.[chess_tactic fen="…" pgn="…"]: Schnell-Aufgabe aus Tab 4.
Entwürfe, private und passwortgeschützte Inhalte werden über Shortcodes nicht angezeigt. In schmalen Spalten und auf dem Smartphone rutscht die Zugliste automatisch unter das Brett.
07 · Für Besucher
Bedienung auf der Website
Partien und Fragmente
- « ‹ › »: zum Anfang, zurück, vor, zum Ende. ⇅ dreht das Brett.
- Ein Klick auf einen Zug in der Zugliste springt direkt zur Stellung, auch in Varianten.
- Pfeiltasten, solange die Maus über dem Brett ist: ← → für Züge, ↑ ↓ für Anfang und Ende.
- Kommentare und Varianten lassen sich ein- und ausblenden.
- Engine ON: Stockfish bewertet die Stellung (z. B. +1.74 = Vorteil Weiß, M3 = Matt in 3).
- Eigene Züge sind erlaubt und erscheinen als neue Variante.
Taktikaufgaben
- Zug auf dem Brett ausführen: richtige Züge werden beantwortet, falsche zurückgenommen.
- Tipp bekommen markiert die richtige Figur, Lösung zeigen spielt die Lösung vor, Neustart setzt zurück.
08 · Datenschutz und Technik
Datenschutz, Technik und Rechte
- Chessground, chess.js und Stockfish werden mit dem Plugin ausgeliefert und von Ihrem Server geladen. Keine externen Dienste, keine Cookies, kein Tracking.
- Die Engine rechnet im Browser des Besuchers.
- Den Brett-Editor nutzen alle Rollen ab „Mitarbeiter“. Wer nicht veröffentlichen darf, speichert neue Inhalte als „Ausstehend“ zur Prüfung.
- Alle Eingaben werden geprüft und bereinigt.
Technik: Chessground 8.3.1, chess.js 0.10.3, Stockfish.js 10.0.2. Lizenz GPL-3.0 oder später. WordPress 5.8+ und PHP 7.4+.
09 · Tipps
Tipps und häufige Fragen
Meine importierte Partie zeigt nicht alle Züge.
Das Brett bricht beim ersten ungültigen Zug ab. Prüfen Sie die Notation an dieser Stelle. Häufig fehlt eine [FEN]-Angabe bei Partien, die nicht mit der Grundstellung beginnen.
Wie schreibe ich Kommentare und Varianten?
Kommentare stehen in geschweiften Klammern, Varianten in runden, z. B. 1. e4 {Königsbauer} e5 (1... c5 {Sizilianisch}). Bewertungszeichen wie $1 (!) oder $2 (?) werden als Symbole dargestellt.
Kann ich deutsche Figurenkürzel verwenden?
Im Text-Scanner (Tab 6) und beim Scannen von Buchtexten in Tab 4: ja. Für den PGN-Import bitte die internationale Schreibweise (N, B, R, Q, K) verwenden, wie sie Datenbanken exportieren.
Wie zeige ich nur ein Diagramm ohne Züge?
Mit dem Shortcode für das Stellungsbild (chess_fen). Den fertigen Code erhalten Sie in Tab 3 oder auf der Bearbeitungsseite unter „Nur aktuelles Brettbild“.
Die Einzelseiten zeigen „Seite nicht gefunden“.
Speichern Sie einmal unter Einstellungen → Permalinks ohne Änderung. Das Plugin erledigt dies bei der Aktivierung normalerweise selbst.
Lassen Sie uns über Ihr Projekt sprechen.
Unverbindlich und persönlich, für Handwerk, Mittelstand, Vereine und Institutionen in ganz Deutschland.