Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net
Shopware ~6.7.0, PHP >=8.2 und eine gesetzte Umgebungsvariable APP_SECRET. Das Plugin bringt die ALTCHA-PHP-Bibliothek als Quellcode mit, ein vendor/-Verzeichnis für sie ist nicht nötig.
1. Privates Repository hinzufügen in der composer.json des Shops:
{
"repositories": [
{
"type": "composer",
"url": "https://packeton.markus-michalski.net"
}
]
}
Die Zugangsdaten zum Repository erhältst du nach dem Lizenzkauf. Das Repository wird über Packeton verwaltet.
2. Plugin installieren
composer require mmd/sw67-altcha-integration
Bei der Abfrage nach Zugangsdaten gibst du die mit der Lizenz bereitgestellten Daten ein.
3. Plugin aktivieren
bin/console plugin:refresh
bin/console plugin:install --activate MmdAltchaIntegration
bin/console cache:clear
core.basicInformation.activeCaptchasV2) und sichert deren Zustand. Beim Deaktivieren stellt es ihn wieder her.composer update mmd/sw67-altcha-integration
bin/console plugin:update MmdAltchaIntegration
bin/console cache:clear
Bei einer Installation über den Store aktualisierst du die Erweiterung unter Erweiterungen > Meine Erweiterungen.
Beim Update von einem älteren Release gilt Folgendes:
altchaMaxNumber), er wird nicht umgerechnet.<altcha-widget challenge="...">. Die Widget-Texte kommen aus dem mitgelieferten Sprachpaket, ein eigenes strings-Attribut wird nicht ausgewertet.{{ parent() }} aufrufen. Fehlt das Widget, lehnt der Shop die Absendung ab, solange ALTCHA aktiv ist. Details stehen unter Storefront-Integration.| Task | Intervall | Beschreibung |
|---|---|---|
mmd_altcha.rate_limit_cleanup |
alle 6 Stunden | Löscht Rate-Limit-Einträge, die älter als 24 Stunden sind, und abgelaufene benutzte Challenges |
mmd_altcha.disposable_domains_refresh |
wöchentlich | Aktualisiert die Wegwerf-Domain-Liste aus der öffentlichen Quelle. Läuft nur, wenn die Wegwerf-E-Mail-Prüfung global aktiv ist |
Beide Tasks laufen über die Shopware Message Queue:
bin/console messenger:consume scheduled_task
Manueller Lauf eines Tasks:
bin/console scheduled-task:run mmd_altcha.rate_limit_cleanup
Die Liste aktualisierst du auch von Hand, zum Beispiel wenn die Prüfung nur für einen Verkaufskanal aktiv ist:
bin/console mmd:altcha:update-disposable-domains
Beim Deinstallieren ohne die Option "Daten behalten" entfernt das Plugin:
mmd_altcha_used_challenge und mmd_altcha_rate_limit_logMmdAltchaIntegration.config.*)Mit der Option "Daten behalten" bleiben Konfiguration und Tabellen erhalten. Die aktualisierte Domain-Liste unter var/mmd_altcha/ entfernt das Plugin nicht.