=== MM Wordclouds ===

Contributors: Sven Bolte
Author: ChatGPT and PBMod
Author URI: https://github.com/svenbolte/
License: Closed Source (Freeware)
License URI: license.txt im Plugin-Ordner
Tags: wordcloud, voting, interactive, presentation, brainstorming, workshop, ajax
Version: 1.3.8
Stable tag: 1.3.8
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 8.2


Interaktive Wordcloud- und Voting-App für Präsentationen, Workshops und Live-Feedback – direkt in WordPress.

== Beschreibung ==

MM_Wordcloud ist eine interaktive Präsentations-App auf WordPress-Basis. Über eine eindeutige Schlüssel-URL betreten Teilnehmende einen gemeinsamen Raum, in dem sie Texte posten oder bestehende Beiträge per Klick upvoten können. Eine Registrierung oder Anmeldung ist nicht erforderlich.

Das Plugin eignet sich ideal für Workshops, Schulungen, Retrospektiven, Brainstormings, Feedback-Runden und interaktive Meetings, bei denen spontane Beteiligung und Live-Auswertung gefragt sind.

Administratoren können beliebig viele eigenständige Räume („Clouds“) anlegen. Jeder Raum erhält automatisch einen eindeutigen 10-stelligen Hex-Code und ist öffentlich über einen URL-Parameter erreichbar, zum Beispiel:

https://example.com/deine-seite/?code=abcdef1234

== Funktionen für Teilnehmende ==

Teilnehmende können direkt im Browser interagieren.

Sie können eigene Beiträge mit bis zu 255 Zeichen erstellen. Optional kann ein Autor-Kürzel mit genau drei Zeichen (A–Z, 0–9) angegeben werden. Wird kein gültiges Kürzel eingegeben, vergibt das System automatisch eine neutrale Kennung.

Bestehende Beiträge können per Klick upgevotet werden. Jede Stimme erhöht den Zähler des Beitrags und wirkt sich unmittelbar auf dessen visuelle Gewichtung aus. Pro Browser und Beitrag ist nur eine Stimme möglich. Dies wird über ein Cookie umgesetzt.

Die Wordcloud aktualisiert sich live per AJAX, ohne Seitenneuladung. Beiträge können nach Aktualität oder Anzahl der Stimmen sortiert werden.

== Autor-Kürzel und Emoji-Zuordnung ==

Jedem Autor-Kürzel wird automatisch ein Emoji zugeordnet. Diese Zuordnung bleibt innerhalb eines Raums konsistent und ermöglicht Wiedererkennung, ohne personenbezogene Daten zu speichern. Auch automatisch vergebene Kürzel erhalten ein fest definiertes Emoji.

== Darstellung der Wordcloud ==

Beiträge werden als interaktive Karten dargestellt und enthalten:

- Emoji und Autor-Kürzel
- Zeitstempel
- Anzahl der Stimmen
- Dynamische Schriftgröße abhängig von der Anzahl der Upvotes

Beiträge mit vielen Stimmen werden visuell stärker hervorgehoben und prägen die Wordcloud entsprechend.

== Auswertung und Statistik ==

Zusätzlich zur grafischen Darstellung erzeugt MM_Wordcloud eine tabellarische Live-Auswertung mit folgenden Spalten:

- Datum und Uhrzeit
- Autor (Emoji + Kürzel)
- Beitragstext
- Anzahl der Stimmen
- Prozentualer Anteil
- Grafische Balkendarstellung

Ergänzend werden statistische Kennzahlen wie Gesamtanzahl der Beiträge, Gesamtvotes sowie Minimal-, Maximal- und Durchschnittswerte berechnet.

Die Tabelle kann als CSV-Datei exportiert und extern weiterverarbeitet werden. Der Export ist UTF-16-BOM-kompatibel und für Tabellenkalkulationsprogramme geeignet.

== Funktionen für Administratoren ==

Administratoren können im WordPress-Backend:

- neue Räume anlegen
- bestehende Räume löschen
- Räume zurücksetzen (alle Beiträge löschen, Raum bleibt bestehen)
- einzelne Beiträge inklusive Upvotes löschen
- CSV-Exporte pro Raum durchführen
- den Shortcode [menti_cloud] auf beliebigen Seiten oder Beiträgen platzieren

Im Frontend stehen Administratoren zusätzliche Moderationsfunktionen zur Verfügung. Alle Aktionen sind durch WordPress-Rechteprüfungen und Nonce-Checks abgesichert.

== QR-Code-Unterstützung ==

Ist in der WordPress-Installation ein QR-Code-Shortcode vorhanden, kann automatisch ein QR-Code zur aktuellen Raum-URL angezeigt werden. Dies erleichtert die Teilnahme bei Präsentationen, Workshops oder Veranstaltungen erheblich.

== Installation ==

1. Plugin als ZIP hochladen oder in das Verzeichnis /wp-content/plugins/ kopieren
2. Plugin im WordPress-Backend aktivieren
3. Der Menüpunkt „MM Wordclouds“ erscheint im Administrationsbereich
4. Einen neuen Raum anlegen und den generierten Code kopieren
5. Eine Seite oder einen Beitrag erstellen und folgenden Shortcode einfügen:

[menti_cloud]

6. Die Seite mit dem gewünschten Raum-Code aufrufen, z.B.:

https://deinedomain.de/meine-cloud/?code=abcdef1234

== Verwendung ==

Der Shortcode [menti_cloud] rendert das Frontend.
Der URL-Parameter ?code=DEINCODE bestimmt, welcher Raum geladen wird.
Teilnehmende können sofort Beiträge posten oder abstimmen.
Administratoren können Inhalte moderieren, zurücksetzen oder exportieren.

== Frequently Asked Questions ==

= Ist das Plugin Open Source? =
Nein. MM_Wordcloud ist Closed Source Software und wird kostenfrei bereitgestellt.

= Können Beiträge mehrfach gevotet werden? =
Nein. Pro Browser und Beitrag wird ein Cookie gesetzt, sodass jeder Beitrag nur einmal unterstützt werden kann.

= Können ganze Sätze eingegeben werden? =
Ja. Beiträge können bis zu 255 Zeichen lang sein.

= Werden personenbezogene Daten gespeichert? =
Nein. Es werden keine Namen, IP-Adressen oder sonstige personenbezogenen Daten gespeichert.

= Können mehrere Räume parallel genutzt werden? =
Ja. Es können beliebig viele Räume unabhängig voneinander betrieben werden.

== Haftungsausschluss ==

Die Nutzung von MM_Wordcloud erfolgt auf eigene Gefahr.

Das Plugin wird ohne Gewährleistung bereitgestellt. Der Entwickler übernimmt keinerlei Haftung für direkte oder indirekte Schäden, Datenverluste, Sicherheitsvorfälle, Inkompatibilitäten mit WordPress, Themes oder Plugins, Performanceprobleme oder wirtschaftliche Folgeschäden.

Der Einsatz in produktiven oder unternehmenskritischen Umgebungen erfolgt ausschließlich in eigener Verantwortung des Betreibers.

Support, Einrichtung, Anpassungen oder Beratungsleistungen sind nicht Bestandteil der kostenlosen Bereitstellung und erfolgen ausschließlich kostenpflichtig nach gesonderter Vereinbarung.

== Changelog ==

= 1.3.8 =
AJAX-Aktualisierung, Sortier- und Filterfunktionen für Cloud- und Tabellenansicht in Echtzeit

= 1.1.2 =
Statistiktabelle mit Progressbars und Akzentfarben

= 1.1.1 =
Stabilitäts- und Sicherheitsverbesserungen, Optimierung der AJAX-Aufrufe

= 1.1.0 =
CSV-Export und Reset-Funktion pro Raum, Unterstützung für längere Texte

= 1.0.0 =
Grundfunktionalität mit Raum-Konzept, Voting, Shortcode und öffentlichem Zugriff per Code
