Zum Hauptinhalt springen

Für Entwickler

Eigene Prüfungen

Eine eigene Prüfung ist eine Klasse, die Pdir\AntiSpamBundle\AntiSpam\Check\SpamCheckInterface implementiert. Liegt sie in einem Bundle mit Autoconfiguration, wird sie automatisch registriert (Tag pdir_anti_spam.check) und fließt in den Score ein.

Prüfungen liefern keine fertigen Texte, sondern einen Schlüssel unter $GLOBALS['TL_LANG']['MSC']['pdir_anti_spam']['reason'][…] plus Parameter. Übersetzt wird erst bei der Ausgabe.

Sprachen

Alle Texte (Backend-Einstellungen, Hinweistext, Honeypot-Label, Log-Einträge, Fehlermeldungen) liegen in contao/languages/<sprache>/. Mitgeliefert sind Deutsch und Englisch, für andere Sprachen nutzt Contao Englisch als Fallback. Einzelne Texte kannst du wie gewohnt in contao/languages/<sprache>/default.php deiner Installation überschreiben.

Neue Sprache: Ordner contao/languages/<sprache>/ mit default.php und tl_settings.php anlegen. composer test prüft Schlüssel und Platzhalter gegen die deutschen Texte.

Tests

composer install
composer test          # Tests gegen die lokal installierte Contao-Version
composer test-matrix   # Tests gegen Contao 4.13, 5.3, 5.7 und 6.0
composer cs-check      # prüft den Datei-Header in allen PHP-Dateien
composer phpstan       # statische Analyse (PHPStan Level 8)

Die Tests enthalten anonymisierte, reale Spam-Beispiele sowie legitime Anfragen, die nie blockiert werden dürfen. Neue Spam-Muster zuerst als Fixture in tests/Fixtures/Submissions.php ergänzen.