ALTCHA Spam-Schutz: Installation

Installation des ALTCHA Spam-Schutz Moduls für OXID eShop 7 per Composer oder manuell, Aktivierung, Update und Deinstallation inklusive der beiden Datenbank-Tabellen.

English Version

Zurück zur Übersicht

ALTCHA Spam-Schutz: Installation

Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net

Voraussetzungen

Anforderung	Version
OXID eShop	`oxid-esales/oxideshop-ce` ^7.0
PHP	8.2 oder höher
Datenbank	MySQL oder MariaDB (die Prüfung benutzt `ON DUPLICATE KEY` und `DATE_SUB`)

Installation

Via Composer (Empfohlen)

Private Repositories werden über Packeton verwaltet. Zugangsdaten erhältst du nach dem Lizenzkauf.

1. Privates Repository hinzufügen:

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://packeton.markus-michalski.net"
        }
    ]
}

2. Modul installieren:

composer require mmd/oxid7-altcha-integration

Bei der Authentifizierungsabfrage gibst du die Zugangsdaten ein, die du mit deiner Lizenz erhalten hast. Das Composer-Paket legt das Modul im Verzeichnis mmd/altcha-integration unter source/modules ab.

3. Modul registrieren und aktivieren:

vendor/bin/oe-console oe:module:install-configuration source/modules/mmd/altcha-integration
vendor/bin/oe-console oe:module:activate mmd_altcha
vendor/bin/oe-console oe:cache:clear

Manuell

Kopiere das Modul nach source/modules/mmd/altcha-integration:

cd <shop-root>
git clone <repository-url> source/modules/mmd/altcha-integration

Das Modul bringt eine PSR-4-Autoload-Definition mit (Mmd\AltchaIntegration\ auf src/). Damit der Composer-Autoloader sie kennt, binde das Verzeichnis als Path-Repository ein:

composer config repositories.mmd-altcha path source/modules/mmd/altcha-integration
composer require mmd/oxid7-altcha-integration:*

Danach registrierst und aktivierst du das Modul wie bei Composer:

vendor/bin/oe-console oe:module:install-configuration source/modules/mmd/altcha-integration
vendor/bin/oe-console oe:module:activate mmd_altcha
vendor/bin/oe-console oe:cache:clear

Was bei der Aktivierung passiert

Die Aktivierung legt zwei Tabellen an, falls sie noch nicht existieren: mmd_altcha_rate_limit_log und mmd_altcha_used_challenges (Aufbau auf der Seite Technik). Der HMAC-Geheimschlüssel wird nicht bei der Aktivierung erzeugt, sondern beim ersten Zugriff darauf und dann in den Moduleinstellungen gespeichert.

Die Einstellungen des Moduls "ALTCHA Spam-Schutz" findest du in den Moduleinstellungen im OXID Admin (siehe Konfiguration).

Update

composer update mmd/oxid7-altcha-integration
vendor/bin/oe-console oe:cache:clear

Deinstallation

vendor/bin/oe-console oe:module:deactivate mmd_altcha
composer remove mmd/oxid7-altcha-integration
vendor/bin/oe-console oe:cache:clear

Das Deaktivieren und Entfernen löscht die beiden Tabellen nicht. Wenn du sie nicht mehr brauchst, löschst du sie manuell mit DROP TABLE mmd_altcha_rate_limit_log, mmd_altcha_used_challenges;.