Best Practice Guide - gitea_code:jtl-shop-altcha-spamschutz
https://guide.falk.plus/
2026-09-22T09:36:09+00:00Best Practice Guide
https://guide.falk.plus/
https://guide.falk.plus/lib/exe/fetch.php?media=wiki:logo.pngtext/html2026-09-21T16:16:38+00:00jf (jf@undisclosed.example.com) - Fix: ExsID entfernt (loeste Lizenzpruefung aus)
https://guide.falk.plus/doku.php?id=gitea_code:jtl-shop-altcha-spamschutz:info_xml&rev=1790007398&do=diff
<?xml version="1.0" encoding="UTF-8"?>
<jtlshopplugin>
<Name>ALTCHA Spamschutz</Name>
<Description>Selbst gehosteter, quelloffener Spamschutz auf Basis des ALTCHA Proof-of-Work-Verfahrens (MIT-Lizenz). Schuetzt Registrierung und Newsletter-Anmeldung ohne Datenweitergabe an Dritte -- bewusst ohne Google reCAPTCHA und ohne Umleitung ueber Cloudflare oder aehnliche Dienste. Fuer beliebige JTL-Shop-5-Installationen geeignet.</Description>
<Author>falk.plus</Author>
<URL>https://falk.…text/html2026-09-21T14:16:11+00:00jf (jf@undisclosed.example.com) - Anonymisierung: Plugin-Name entfernt
https://guide.falk.plus/doku.php?id=gitea_code:jtl-shop-altcha-spamschutz:templatehandler_php&rev=1790000171&do=diff
<?php
declare(strict_types=1);
namespace Plugin\fp_altcha_spamschutz\src\Handler;
use JTL\phpQuery\phpQueryObject;
use JTL\Plugin\PluginInterface;
use JTL\Smarty\JTLSmarty;
use Plugin\fp_altcha_spamschutz\src\Service\AltchaService;
/**
* Fuegt das ALTCHA-Widget (Container + Skript) in Registrierungs- und Newsletter-Formular ein.
* Wird ueber HOOK_SMARTY_OUTPUTFILTER aufgerufen, also nach dem Rendern der Seite, auf dem
* fertigen HTML-Dokument (phpQuery, jQuery-aehnliche PHP-DOM-API).
*/
…text/html2026-09-21T14:12:26+00:00jf (jf@undisclosed.example.com) - Anonymisierung + reCAPTCHA/Cloudflare-Hinweis
https://guide.falk.plus/doku.php?id=gitea_code:jtl-shop-altcha-spamschutz:bootstrap_php&rev=1789999946&do=diff
<?php
declare(strict_types=1);
namespace Plugin\fp_altcha_spamschutz;
use JTL\Events\Dispatcher;
use JTL\Plugin\Bootstrapper;
use JTL\Plugin\PluginInterface;
use JTL\Shop;
use Plugin\fp_altcha_spamschutz\src\Handler\TemplateHandler;
use Plugin\fp_altcha_spamschutz\src\Handler\ValidationHandler;
use Plugin\fp_altcha_spamschutz\src\Service\AltchaService;
require_once __DIR__ . '/src/Vendor/AltchaOrg/Altcha/V1/Hasher/HasherInterface.php';
require_once __DIR__ . '/src/Vendor/AltchaOrg/Altcha/V1/…text/html2026-09-21T13:40:30+00:00jf (jf@undisclosed.example.com) - fp-altcha.js Mirror aus Gitea anlegen
https://guide.falk.plus/doku.php?id=gitea_code:jtl-shop-altcha-spamschutz:fp-altcha_js&rev=1789998030&do=diff
/*!
* fp-altcha.js -- kleiner, eigenstaendiger Loeser fuer das klassische ALTCHA V1
* Proof-of-Work-Verfahren (SHA-256 Hashcash-Stil).
*
* Sucht fuer eine vom Server vorgegebene Aufgabe {algorithm, challenge, salt, maxnumber, signature}
* eine Zahl n mit 0 <= n <= maxnumber, fuer die SHA-256(salt + n) == challenge gilt, und traegt das
* Ergebnis base64-kodiert in ein verstecktes Formularfeld "altcha" ein. Die Verifikation auf dem
* Server erfolgt mit der offiziellen ALTCHA-PHP-Bibliothek …text/html2026-09-21T13:39:33+00:00jf (jf@undisclosed.example.com) - ValidationHandler.php Mirror aus Gitea anlegen
https://guide.falk.plus/doku.php?id=gitea_code:jtl-shop-altcha-spamschutz:validationhandler_php&rev=1789997973&do=diff
<?php
declare(strict_types=1);
namespace Plugin\fp_altcha_spamschutz\src\Handler;
use Plugin\fp_altcha_spamschutz\src\Service\AltchaService;
/**
* Prueft die ALTCHA-Loesung bei Registrierung und Newsletter-Anmeldung.
*
* Registrierung: nutzt den dokumentierten Hook HOOK_REGISTRIEREN_PAGE_REGISTRIEREN_PLAUSI (41),
* der genau fuer diesen Zweck (Plausibilitaetspruefung nach Formularabsendung) vorgesehen ist.
* Bei fehlender/ungueltiger Pruefung wird ein Eintrag zu "fehlendeAngaben" hinzug…text/html2026-09-21T13:37:40+00:00jf (jf@undisclosed.example.com) - AltchaService.php Mirror aus Gitea anlegen
https://guide.falk.plus/doku.php?id=gitea_code:jtl-shop-altcha-spamschutz:altchaservice_php&rev=1789997860&do=diff
<?php
declare(strict_types=1);
namespace Plugin\fp_altcha_spamschutz\src\Service;
use AltchaOrg\Altcha\V1\Altcha;
use AltchaOrg\Altcha\V1\ChallengeOptions;
use AltchaOrg\Altcha\V1\Hasher\Algorithm;
use JTL\Plugin\PluginInterface;
/**
* Kapselt die ALTCHA V1 Proof-of-Work Bibliothek (MIT-Lizenz, https://github.com/altcha-org/altcha-lib-php).
*
* Warum V1 statt der aktuellen ALTCHA-Widget-Version (v3)?
* Das offizielle JS-Widget v3 nutzt ein neueres, komplexeres Protokoll (PBKDF2/Argon2id/…