PHPackages                             hyperlink/cloudflare-turnstile - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication &amp; Authorization](/categories/authentication)
4. /
5. hyperlink/cloudflare-turnstile

ActiveShopware-platform-plugin[Authentication &amp; Authorization](/categories/authentication)

hyperlink/cloudflare-turnstile
==============================

Cloudflare Turnstile CAPTCHA integration for Shopware 6.

1.0.0(1mo ago)12proprietaryPHPPHP ^8.1

Since Apr 30Pushed 1mo agoCompare

[ Source](https://github.com/hyperlinkgroup/shopware-cloudflare-turnstile)[ Packagist](https://packagist.org/packages/hyperlink/cloudflare-turnstile)[ RSS](/packages/hyperlink-cloudflare-turnstile/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

SsqCloudflareTurnstile – Cloudflare Turnstile für Shopware 6
============================================================

[](#ssqcloudflareturnstile--cloudflare-turnstile-für-shopware-6)

[![Latest Version on Packagist](https://camo.githubusercontent.com/b1d9d29b9f81ee4ec9fc5ef890644c3849ed43b1bc14dcdb4bffb38cfcd88126/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f68797065726c696e6b2f636c6f7564666c6172652d7475726e7374696c652e737667)](https://packagist.org/packages/hyperlink/cloudflare-turnstile)[![Shopware 6.5](https://camo.githubusercontent.com/7021e484bf9f44e76bb517ef5c2dd7a691228e1f2b789e0a7eb3570646bd5909/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53686f70776172652d362e352e782d3138394546462e737667)](https://www.shopware.com)[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](LICENSE)

Integriert [Cloudflare Turnstile](https://www.cloudflare.com/products/turnstile/) als datenschutzfreundliche CAPTCHA-Lösung in Shopware 6.

---

Funktionsumfang
---------------

[](#funktionsumfang)

- **Cloudflare Turnstile** als CAPTCHA-Option unter *Einstellungen → Shop → Stammdaten → CAPTCHA*
- Konfigurierbarer **Widget-Modus**: Managed, Nicht-interaktiv oder Unsichtbar
- Konfigurierbares **Theme**: Automatisch, Hell oder Dunkel
- **Credentials-Test** direkt im Admin-Panel
- **Fail-open**: Bei Cloudflare-API-Ausfall werden Anfragen standardmäßig durchgelassen (konfigurierbar)
- Lokalisierte Fehlermeldungen (Deutsch &amp; Englisch)
- Funktioniert auf allen Shopware-Formularen (Checkout, Kontakt, Registrierung, Newsletter etc.)

---

Voraussetzungen
---------------

[](#voraussetzungen)

- Shopware 6.5.x
- PHP 8.1+
- Ein [Cloudflare Turnstile](https://dash.cloudflare.com/?to=/:account/turnstile)-Konto mit Site Key und Secret Key

---

Installation
------------

[](#installation)

### Variante 1: Installation via Composer (empfohlen)

[](#variante-1-installation-via-composer-empfohlen)

```
composer require hyperlink/cloudflare-turnstile
bin/console plugin:refresh
bin/console plugin:install --activate SsqCloudflareTurnstile
bin/console cache:clear
```

### Variante 2: Manuell in den Plugin-Ordner kopieren

[](#variante-2-manuell-in-den-plugin-ordner-kopieren)

1. **Repository klonen oder herunterladen:**

    ```
    git clone git@github.com:hyperlink/cloudflare-turnstile.git custom/plugins/SsqCloudflareTurnstile
    ```
2. **Plugin erkennen, installieren und aktivieren:**

    ```
    bin/console plugin:refresh
    bin/console plugin:install --activate SsqCloudflareTurnstile
    bin/console cache:clear
    ```
3. **Administration-Assets veröffentlichen** (optional – das Plugin enthält bereits eine vorgebaute JS-Datei):

    ```
    bin/console assets:install
    ```

### Variante 3: Installation via ZIP-Upload im Admin-Panel

[](#variante-3-installation-via-zip-upload-im-admin-panel)

1. **ZIP-Datei erstellen** (falls noch nicht vorhanden):

    ```
    cd custom/plugins
    zip -r SsqCloudflareTurnstile.zip SsqCloudflareTurnstile/ \
      -x "SsqCloudflareTurnstile/.git/*" \
      -x "SsqCloudflareTurnstile/vendor/*"
    ```

    Alternativ: Den neuesten Release als ZIP von der [Releases-Seite](https://github.com/hyperlink/cloudflare-turnstile/releases) herunterladen.
2. **Im Admin-Panel hochladen:**

    - Navigiere zu **Erweiterungen → Meine Erweiterungen**
    - Klicke oben rechts auf **„Erweiterung hochladen"**
    - Wähle die `SsqCloudflareTurnstile.zip` aus
    - Klicke auf **„Installieren"** und anschließend auf **„Aktivieren"**

---

Konfiguration im Admin-Panel
----------------------------

[](#konfiguration-im-admin-panel)

1. Navigiere zu **Einstellungen → Shop → Stammdaten**
2. Scrolle nach unten zum Abschnitt **„CAPTCHA"**
3. Wähle im Multi-Select **„Cloudflare Turnstile"** aus
4. Es erscheinen folgende Konfigurationsfelder:

FeldBeschreibung**Site Key**Der öffentliche Schlüssel aus deinem [Cloudflare Dashboard](https://dash.cloudflare.com/?to=/:account/turnstile)**Secret Key**Der geheime Schlüssel aus deinem Cloudflare Dashboard**API-Zugangsdaten überprüfen**Button zum Testen, ob die eingegebenen Keys gültig sind**Widget-Modus**`Managed` (empfohlen) – Cloudflare entscheidet automatisch · `Nicht-interaktiv` – Widget ohne Nutzerinteraktion · `Unsichtbar` – kein sichtbares Widget**Darstellung**`Automatisch` · `Hell` · `Dunkel`**Bei API-Ausfall Anfragen durchlassen**Wenn aktiviert (Standard), werden Anfragen bei einem Cloudflare-API-Ausfall durchgelassen, damit der Shop weiter funktioniert. Wenn deaktiviert, werden Anfragen blockiert, bis die API wieder erreichbar ist.5. Klicke auf **„Speichern"**

---

Cloudflare Turnstile Keys erstellen
-----------------------------------

[](#cloudflare-turnstile-keys-erstellen)

1. Melde dich im [Cloudflare Dashboard](https://dash.cloudflare.com/) an
2. Navigiere zu **Turnstile** in der linken Sidebar
3. Klicke auf **„Widget hinzufügen"**
4. Gib einen Namen und die Domain deines Shops ein
5. Wähle den gewünschten Widget-Typ
6. Nach der Erstellung erhältst du **Site Key** und **Secret Key**

---

Deinstallation
--------------

[](#deinstallation)

```
bin/console plugin:deactivate SsqCloudflareTurnstile
bin/console plugin:uninstall SsqCloudflareTurnstile
bin/console cache:clear
```

Bei der Deinstallation werden alle gespeicherten Konfigurationsdaten (inkl. Secret Keys) aus der Datenbank entfernt, sofern nicht „Benutzerdaten behalten" gewählt wird.

---

Technische Details
------------------

[](#technische-details)

- Das Plugin registriert sich über den Tag `shopware.storefront.captcha` im Shopware Captcha-Framework
- Die Captcha-Validierung erfolgt serverseitig über die [Cloudflare Siteverify API](https://developers.cloudflare.com/turnstile/get-started/server-side-validation/)
- Bei API-Ausfällen greift ein konfigurierbarer **Fail-open/Fail-closed**-Mechanismus: Standardmäßig werden Anfragen durchgelassen (Fail-open), damit der Shop weiter funktioniert. Kann im Admin unter der Checkbox „Bei API-Ausfall Anfragen durchlassen" deaktiviert werden, um stattdessen Anfragen zu blockieren (Fail-closed).
- Die Konfiguration wird in `core.basicInformation.activeCaptchasV2.cloudflareTurnstile` in der `system_config`-Tabelle gespeichert

---

Mitwirken
---------

[](#mitwirken)

Beiträge sind willkommen! Alle Details findest du in der [CONTRIBUTING.md](CONTRIBUTING.md).

---

Lizenz
------

[](#lizenz)

Dieses Projekt ist lizenziert unter der [MIT-Lizenz](LICENSE).

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance92

Actively maintained with recent releases

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

40d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/133309?v=4)[Xiaoxin Lu](/maintainers/hyperlink)[@hyperlink](https://github.com/hyperlink)

---

Top Contributors

[![kaiserkiwi](https://avatars.githubusercontent.com/u/8428551?v=4)](https://github.com/kaiserkiwi "kaiserkiwi (5 commits)")

### Embed Badge

![Health badge](/badges/hyperlink-cloudflare-turnstile/health.svg)

```
[![Health](https://phpackages.com/badges/hyperlink-cloudflare-turnstile/health.svg)](https://phpackages.com/packages/hyperlink-cloudflare-turnstile)
```

###  Alternatives

[shopware/production

177202.8k](/packages/shopware-production)[adyen/adyen-shopware6

Official Shopware 6 Plugin to connect to Payment Service Provider Adyen

24115.8k](/packages/adyen-adyen-shopware6)[shopware/storefront

Storefront for Shopware

684.4M207](/packages/shopware-storefront)[unzerdev/shopware6

Unzer payment integration for Shopware 6

1230.4k](/packages/unzerdev-shopware6)[kiener/mollie-payments-plugin

Mollie Payments

6562.4k](/packages/kiener-mollie-payments-plugin)[frosh/tools

Provides some basic things for managing the Shopware Installation

83783.3k2](/packages/frosh-tools)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
