=== SwagFlow Anmeldung ===
Contributors: fetzwerbeagentur
Tags: swagflow, messe, formular, embed, iframe
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.0
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Bindet das SwagFlow-Besucher-Anmeldeformular per iframe in eine WordPress-Seite ein – als Shortcode oder Gutenberg-Block.

== Description ==

SwagFlow ist eine Messe-Plattform für Werbeartikelmessen. Dieses Plugin bindet das Besucher-Registrierungsformular eines SwagFlow-Händlers auf dessen eigener WordPress-Website ein.

Wichtig: Das Formular wird **immer** von SwagFlow selbst gerendert und per iframe eingebunden. Das Plugin rendert kein eigenes Formular und verarbeitet, speichert oder überträgt keine Besucherdaten – es kapselt lediglich das offizielle Einbett-Snippet.

**Funktionen**

* Shortcode `[swagflow_anmeldung fair="auto" lang="de"]` – funktioniert im klassischen Editor, in Elementor, Divi und überall sonst, wo Shortcodes ausgewertet werden.
* Gutenberg-Block „SwagFlow Anmeldeformular“ mit echter Live-Vorschau im Editor und Seitenleisten-Feldern für Messe und Sprache.
* Einstellungsseite für Public Key, Standard-Messe, Sprache und Basis-URL (für Tests gegen eine andere SwagFlow-Instanz).
* Eingebaute Verbindungsprüfung: zeigt direkt in den Einstellungen, ob der Public Key gültig ist und wie viele Domains freigegeben sind.
* Mehrfache Verwendung auf einer Seite funktioniert.
* Ohne hinterlegten Public Key sehen nur eingeloggte Redakteure einen Hinweis – Besucher sehen nichts, es gibt niemals einen PHP-Fehler.
* Zweisprachig: Deutsch und Englisch (Übersetzung via .po/.mo, auch für den Block-Editor).
* Keine Abhängigkeiten außer WordPress-Bordmitteln.

== Installation ==

1. Plugin-Ordner nach `wp-content/plugins/swagflow` hochladen (oder als ZIP über „Plugins → Installieren“ hochladen).
2. Plugin unter „Plugins“ aktivieren.
3. Unter „Einstellungen → SwagFlow“ den Public Key deines SwagFlow-Händlerkontos eintragen und mit „Verbindung prüfen“ testen.
4. Auf einer beliebigen Seite den Shortcode `[swagflow_anmeldung]` einfügen oder den Block „SwagFlow Anmeldeformular“ verwenden.

== Frequently Asked Questions ==

= Wo bekomme ich meinen Public Key her? =

Du bekommst ihn direkt von SwagFlow zusammen mit den freigegebenen Domains – es gibt keine Selbstverwaltung im Konto. Er ist kein Geheimnis – er landet ohnehin sichtbar im Quelltext deiner Seite.

= Werden Besucherdaten von diesem Plugin verarbeitet? =

Nein. Das Anmeldeformular wird komplett von SwagFlow gerendert und verarbeitet – dieses Plugin bindet nur das Einbett-Snippet ein.

= Was sehen Besucher, wenn kein Public Key hinterlegt ist? =

Nichts. Nur eingeloggte Redakteure (Rolle mit `edit_posts`-Recht) sehen einen Hinweis mit Link zu den Einstellungen.

= Kann ich mehrere Formulare auf einer Seite einbinden? =

Ja, Shortcode und Block können beliebig oft auf einer Seite verwendet werden, auch mit unterschiedlichen Messen/Sprachen.

= Funktioniert das Plugin mit Elementor oder Divi? =

Ja, über den Shortcode `[swagflow_anmeldung]` in einem Text-/HTML-Widget.

= Wofür ist das Feld „Basis-URL“ in den Einstellungen? =

Nur relevant, um während der Entwicklung gegen eine andere (z. B. lokale) SwagFlow-Instanz zu testen. Im Normalbetrieb unverändert lassen.

== Screenshots ==

1. Einstellungsseite mit Verbindungsprüfung.
2. Gutenberg-Block mit Live-Vorschau.

== Changelog ==

= 1.2.0 =
* Besucherkategorie vorauswählen: neues Attribut „category“ (Shortcode und Block). Unbekannte Kategorie wird ignoriert, das Formular funktioniert trotzdem.
* Aktion nach erfolgreicher Anmeldung: neues Attribut „on_success“ / „After successful registration“ – „redirect:/danke“ (nur eigene Website) oder „scroll“.
* Meldet dem SwagFlow-Server bei jedem Update-Check die eigene Plugin-Version (für die Versionsübersicht im SwagFlow-Backoffice, keine personenbezogenen Daten).

= 1.1.0 =
* Einstellungsseite eingedampft: Public Key ist das einzig sichtbare Pflichtfeld, Standard-Messe/Sprache/Basis-URL sind unter „Advanced“ zusammengeklappt.
* Verbindungsprüfung erkennt jetzt, wenn diese Website nicht zu den freigegebenen Domains gehört, und meldet das klar statt eines leeren Formulars.
* Nach erfolgreicher Verbindungsprüfung erscheint ein Hinweis, wie es weitergeht (Block oder Shortcode).

= 1.0.0 =
* Erstveröffentlichung: Shortcode, Gutenberg-Block, Einstellungsseite mit Verbindungsprüfung, Deutsch/Englisch.

== Upgrade Notice ==

= 1.2.0 =
Neue Attribute „category“ und „on_success“ für Shortcode/Block; meldet dem Server die eigene Version.

= 1.1.0 =
Einstellungsseite vereinfacht, Verbindungsprüfung erkennt nicht freigegebene Domains.

= 1.0.0 =
Erstveröffentlichung.
