schachbulle / contao-chessboardjs-bundle

2.0.0 2026-09-02 18:09 UTC

Requires

• php: ^7.4 || ^8.0
• contao/core-bundle: ^4.13 || ^5.7
• menatwork/contao-multicolumnwizard-bundle: ^3.6

Requires (Dev)

• contao/manager-plugin: ^2.0

Conflicts

• contao/core: *
• contao/manager-plugin: <2.0 || >=3.0

LGPL-3.0-or-later

• Frank Hoppe

• contao
• schach
• schachbrett
• chessboardjs

Published on Packagist.org on 2026-09-02 18:10 UTC

README

Bindet das JavaScript-Schachbrett Chessboard.js als Frontend-Modul in Contao ein. Damit lassen sich Stellungen anzeigen und Halbzüge zum Durchklicken hinterlegen.

Frank Hoppe

Voraussetzungen

• Contao 4.13 LTS oder Contao 5.7
• PHP 7.4 oder neuer (geprüft bis PHP 8.4)
• menatwork/contao-multicolumnwizard-bundle (wird mitinstalliert)
• jQuery muss im Seitenlayout aktiviert sein — der erzeugte Skriptcode verwendet $(…). Die Einstellung findet sich im Seitenlayout unter „jQuery-Einstellungen".

Installation

composer require schachbulle/contao-chessboardjs-bundle

Verwendung

Im Backend unter Layout → Frontend-Module ein Modul vom Typ Diagramm mit Chessboard.js anlegen und in den Seitenaufbau oder über das Inhaltselement Modul einfügen einbinden.

Einstellungen

Feld	Bedeutung
Koordinaten	Blendet die Feldbezeichnungen am Brettrand ein
Breite	Breite des Diagramms, etwa 400px oder 60%
Spielbutton	Zeigt unter dem Brett den Knopf „Weiter"
Alternative Stellung aufbauen	Statt der Grundstellung eine eigene Stellung zeigen
Stellung aufbauen	Figuren und Feldmarkierungen einzeln setzen
Stellung aufbauen (FEN)	Stellung als FEN-String; überschreibt die Figuren aus dem Feld darüber
Text zur Stellung	Wird unter dem Brett ausgegeben
Spielmodus	Legt fest, wie die Folgezüge erfasst werden

Spielmodi

• Halbzüge mit Markierungen — je Zeile ein Zug mit Ausgangs- und Zielfeld, Text und bis zu drei Gruppen farbig markierter Felder.
• Halbzüge als FEN-Strings — je Zeile eine vollständige Stellung als FEN-String, ebenfalls mit Text und Markierungen.
• Halbzüge in langer Notation — je Zeile ein Zug als Text. Das ist bei längeren Zugfolgen deutlich schneller einzugeben als zwei Auswahllisten.

Schreibweisen in der langen Notation

Ausgewertet werden die beiden ersten Feldbezeichnungen der Zeile. Damit funktionieren alle gebräuchlichen Schreibweisen:

Eingabe	Bedeutung
e2-e4, e2e4, e2 - e4, E2-E4	Bauer von e2 nach e4
Sg1-f3	Springer von g1 nach f3
Sf3xe5, Lc1xh6+	Schlagzug, Schach- und Mattzeichen stören nicht
e7-e8D, e7-e8=Q	Bauernumwandlung; D/Q, T/R, L/B und S/N werden erkannt

Rochade und En-passant-Schlag bewegen zwei Figuren und werden bewusst nicht selbsttätig erkannt — das Modul kennt die Schachregeln nicht. Beide lassen sich als zwei aufeinanderfolgende Zeilen eingeben, die kurze Rochade für Weiß also als e1-g1 und h1-f1.

Lizenz

LGPL-3.0-or-later, siehe LICENSE.