=== Business Toolbox ===
Tags: business tools, office tools, quiz, games, puzzles, brain teasers, calculators, generators, compliance, security, word cloud, chat
License: Commercial License (includes third-party Open Source components; see license.txt)
Text Domain: Business Toolboxz
Domain Path: /lang/
Version: 9.3.0.550
Stable tag: 9.3.0.550
Requires at least: 6.9
Tested up to: 7.1.4
Requires PHP: 8.2

Die Business Toolbox vereint produktive Werkzeuge und unterhaltsame Pausenfüller in einem WordPress-Plugin.
Sie bietet praktische Business- und Office-Tools, Generatoren und Rechner, Werkzeuge rund um Compliance und IT-Sicherheit
 sowie Quizze und persönliche Prüfungen mit CSV-Import. Ergänzt wird die Toolbox durch interaktive Wordclouds
und Chat-Funktionen sowie Office-Denksport, Rätsel und Spiele für die kleine Pause zwischendurch.


== Quick Start – Business Toolbox (Compliance-Paket) ==

Willkommen bei der Business Toolbox! Diese Anleitung zeigt Ihnen, wie Sie die Toolbox aktualisieren oder neu installieren und anschließend in WordPress einrichten.

WICHTIG: Wählen Sie entweder „Update“ für eine bestehende Installation oder eine der drei Installationsvarianten. Die abschließenden Einrichtungsschritte gelten für alle Neuinstallationen.

== A. Bestehende Business Toolbox aktualisieren ==

Bei gültigem Abonnement können Sie die Business Toolbox jederzeit aktualisieren.

1. Laden Sie das aktuelle Paket „compliance-paket.zip“ unter tech-nachrichten.de im Bereich „Schulungen / Downloads“ herunter:
   https://tech-nachrichten.de/?ddownload=128611
2. Entpacken Sie die ZIP-Datei auf Ihrem lokalen Computer.
3. Kopieren Sie den entpackten Ordner „wordpress“ einschließlich aller Unterordner in die Zwischenablage.
4. Verbinden Sie sich per Remotedesktop (RDP) mit dem Intranet-Server (häufig dem SDOK-Server) und fügen Sie den Ordner zunächst auf dessen Desktop ein.
5. Kopieren Sie dort den Ordner „wordpress“ erneut und fügen Sie ihn im Windows-Explorer unter folgendem Pfad ein:
   C:\Program Files (x86)\xampplite\htdocs\
6. Bestätigen Sie das Zusammenführen der Ordner und das Überschreiben vorhandener Dateien.

Hinweis: Erstellen Sie vor dem Update eine Sicherung der bestehenden WordPress-Dateien und der Datenbank. Löschen Sie bei einem Update nicht die vorhandene Installation.

== B. Business Toolbox neu installieren ==

Wählen Sie die Variante, die zu Ihrer Umgebung passt.

= Variante 1 – OpenAudit Classic neu installieren =

1. Laden Sie OpenAudit Classic herunter:
   https://tech-nachrichten.de/?ddownload=3071
2. Falls bereits OpenAudit Classic installiert ist: Sichern Sie zuvor benötigte Daten, deinstallieren Sie die vorhandene Version und entfernen Sie anschließend den Ordner
   C:\Program Files (x86)\xampplite\
   einschließlich aller Unterordner.
   ACHTUNG: Beim Löschen dieses Ordners können bestehende WordPress-Dateien und andere lokale Daten verloren gehen.
3. Starten Sie das OpenAudit-Setup und aktivieren Sie die Option „WordPress“.
4. Öffnen Sie nach Abschluss der Installation die Desktopverknüpfung „OpenAudit CL Oberfläche“ oder diese Adresse:
   https://{NameDeinesIntranetservers}:4443/wordpress
5. Folgen Sie dem WordPress-Einrichtungsdialog.

= Variante 2 – Vorhandenes OpenAudit Classic verwenden =

Voraussetzung: OpenAudit Classic ist bereits installiert. Für die aktuelle Business Toolbox wird PHP 8.2 oder neuer benötigt.

1. Laden Sie die Business Toolbox über Ihren bereitgestellten Lizenz-Download-Link auf tech-nachrichten.de herunter.
2. Entpacken Sie das ZIP-Archiv in das Verzeichnis
   C:\Program Files (x86)\xampplite\htdocs\
   und achten Sie darauf, dass die enthaltene Ordnerstruktur erhalten bleibt.
3. Öffnen Sie die Desktopverknüpfung „OpenAudit CL Oberfläche“ oder diese Adresse:
   https://{NameDeinesIntranetservers}:4443/wordpress
4. Folgen Sie gegebenenfalls dem WordPress-Einrichtungsdialog.

= Variante 3 – Vorhandene WordPress-Umgebung verwenden =

1. Laden Sie die Business Toolbox über Ihren bereitgestellten Lizenz-Download-Link auf tech-nachrichten.de herunter.
2. Entpacken Sie das ZIP-Archiv.
3. Kopieren Sie die enthaltenen Dateien und Unterordner aus „wp-content“ in das Verzeichnis „wp-content“ Ihrer bestehenden WordPress-Installation (Dateisystem, nicht URL). Führen Sie gleichnamige Ordner zusammen und übernehmen Sie die benötigten Dateien.

Hinweis: Sichern Sie vorhandene Dateien und die WordPress-Datenbank, bevor Sie Dateien ersetzen.

== C. WordPress einrichten – nach jeder Neuinstallation ==

1. Melden Sie sich in der WordPress-Administrationsoberfläche an.
2. Öffnen Sie „Design → Themes“ und aktivieren Sie das Theme „Penguin“, sofern es noch nicht aktiv ist.
3. Öffnen Sie „Plugins“ und aktivieren Sie die zur Business Toolbox gehörenden Plugins. Über „Mehrfachaktionen → Aktivieren“ können Sie mehrere Plugins gleichzeitig aktivieren.
4. Öffnen Sie „Einstellungen → Permalinks“, wählen Sie „Beitragsname“ und speichern Sie die Änderungen.
5. Führen Sie unter „Tools → Neu Sync“ die Synchronisation aus.
6. Optional: Legen Sie einen Menüeintrag für „Tool 98“ an. Alternativ können Sie die Business Toolbox direkt aufrufen:
   https://{NameDeinesIntranetservers}:4443/wordpress/tools/business-toolbox

Ersetzen Sie {NameDeinesIntranetservers} durch den tatsächlichen Namen Ihres Intranet-Servers. Bei einer anderen WordPress-Installation passen Sie die Adresse entsprechend an.

Viel Erfolg mit der Business Toolbox!

== Beschreibung ==

Business Toolbox ist ein Mehrzweck-Plugin für interaktive Inhalte in WordPress. Es erweitert WordPress um eigene Inhaltstypen, Shortcodes und Administrationsfunktionen für:

* Quizfragen mit Antwortoptionen, Bildern, Kategorien und CSV-Import/-Export
* persönliche Quiz-Prüfungen mit Ergebnis-/Zertifikatsausgabe
* SEO-freundliche Tool- und Games-Landingpages unter /tools/
* interaktive Wordcloud-/Voting-Räume mit Live-Chat und CSV-Auswertung
* optionale Compliance-, Security-, Awareness- und Generator-Tools im /games-Verzeichnis

Das Plugin arbeitet weitgehend eigenständig und bindet CSS/JavaScript für Ausgaben inline ein. Für Zusatzfunktionen können andere Plugins oder Theme-Funktionen genutzt werden, z.B. Diagramme, Kalender-/ICS-Ausgabe, Kategorie-Bilder, QR-Codes oder das Penguin-Mod-Theme.


= CSV Uploader / automatische CSV-Synchronisation =

Business Toolbox enthält die aus FolderGallery übernommene CSV-Upload- und Synchronisationsfunktion. Sie dient dazu, externe CSV-Dateien zentral abzurufen und unter WordPress für weitere Tools und Shortcodes bereitzustellen.

Backend:

* Aufruf unter Tools → CSV Uploader.
* Pro Import können Quell-URL, lokaler Dateiname und Aktiv-Status gepflegt werden.
* Aktive Importe erhalten einen eigenen täglichen WP-Cron-Termin.
* Einzelne Importe oder alle Importe können zusätzlich manuell synchronisiert werden.
* Erfolgs-/Fehlerstatus, letzter Lauf und übertragene Datenmenge werden gespeichert.
* Die heruntergeladenen Dateien liegen unter /wp-content/uploads/csv/.

Die CSV-Synchronisation kann insbesondere zusammen mit [csvtorss] und [csvtohtml_create] verwendet werden. Manuelle und automatische Läufe verwenden dieselbe Synchronisierungsfunktion.

= CSV/RSS-Shortcodes aus FolderGallery =

Die drei bisherigen FolderGallery-Shortcodes sind Bestandteil von Business Toolbox. Die Shortcode-Namen bleiben kompatibel; der eigentliche PHP-Code wird erst beim Aufruf des jeweiligen Shortcodes aus /games/ geladen.

== [csvtorss] – CSV-Datei als RSS-Feed bereitstellen ==

[csvtorss] erzeugt auf der Seite einen Link zu einem RSS-Feed aus einer semikolongetrennten CSV-Datei in /wp-content/uploads/csv/. Der Feed ist über den zusätzlichen Seiten-Endpunkt /csvrss/ erreichbar.

Beispiel:

[csvtorss file="softwareverzeichnis.csv" pubdate="Datum" title="Produkt;Version" description="Bemerkungen;beschreibung" link="Herstellerwebsite" guid="id" limit="30"]

Parameter:

* file: CSV-Dateiname unter /wp-content/uploads/csv/; erforderlich.
* pubdate: Spaltenname für das Veröffentlichungsdatum.
* title: Eine oder mehrere Spalten für den Feed-Titel; Trennung mit Semikolon oder Komma.
* description: Eine oder mehrere Spalten für die Beschreibung.
* link: Spaltenname mit einer HTTP-/HTTPS-Zieladresse.
* guid: Spaltenname für einen stabilen Datensatzbezug.
* limit: Maximale Anzahl Feed-Einträge, Standard 30, zulässig 1 bis 500.

Nach Änderungen an Permalink-Regeln einmal Einstellungen → Permalinks öffnen und speichern, falls der /csvrss/-Endpunkt in einer bestehenden Installation noch nicht aufgelöst wird.

== [csvtohtml_create] – CSV-Dateien als HTML-Tabelle anzeigen ==

[csvtohtml_create] liest eine oder mehrere CSV-Dateien und zeigt sie als durchsuchbare, sortierbare und paginierte HTML-Tabelle an. Lokale Pfade beziehen sich auf /wp-content/uploads/; alternativ sind HTTP-/HTTPS-Quellen möglich. Mehrere Quellen werden mit Semikolon getrennt, lokale Wildcards werden unterstützt.

Beispiele:

[csvtohtml_create source_files="csv/softwareverzeichnis.csv" csv_delimiter=";" rows_per_page="30"]
[csvtohtml_create source_files="csv/*.csv" csv_delimiter=";" exclude_cols="7-9" sort_cols="1" sort_cols_order="asc"]

Wichtige Parameter:

* source_files: Lokale Datei(en), Wildcard oder Remote-URL(s); mehrere Quellen mit Semikolon trennen.
* csv_delimiter: CSV-Trennzeichen, Standard Komma.
* rows_per_page: Datensätze je Seite, Bereich 10 bis 250, Standard 30.
* include_cols: Nur bestimmte Spalten anzeigen, z.B. 1,3,5-7.
* exclude_cols: Bestimmte Spalten ausblenden; unterstützt auch last.
* cols_with_stats: Statistik für ausgewählte Spalten anzeigen.
* sort_cols: Spaltennummer(n) für die Sortierung.
* sort_cols_order: Sortierrichtung(en), z.B. asc oder desc.
* float_divider: Dezimaltrennzeichen für die Anzeige.

Die Ausgabe unterstützt außerdem die vorhandenen Business-Toolbox-/Theme-Erweiterungen für Datumsboxen, ISO-Flaggen, Firmen-/Automarkenlogos und Kfz-Kennzeichen, sofern die jeweiligen Shortcodes/Funktionen verfügbar sind.

== [rssdisplay] – einen oder mehrere RSS-Feeds anzeigen ==

[rssdisplay] zeigt RSS-/Atom-Feeds als Kartenansicht an. Mehrere Feed-URLs können kommasepariert übergeben und gemeinsam nach Aktualität dargestellt werden.

Beispiele:

[rssdisplay url="https://example.org/feed/" limit="30"]
[rssdisplay url="https://example.org/feed/,https://example.net/feed/" excerpt="1" image="1" wordcount="25" paged="1" limit="60"]

Parameter:

* url: Feed-URL oder kommaseparierte Liste mehrerer Feed-URLs.
* excerpt: 1 für Textauszug, 0 für den Feed-Inhalt.
* image: 1 versucht beim Auszug das erste Bild als lazy-loaded Thumbnail anzuzeigen, 0 deaktiviert es.
* wordcount: Maximale Wortmenge für gekürzte Inhalte, Standard 25.
* paged: 1 aktiviert die Seitennavigation, 0 zeigt die geladenen Beiträge auf einer Seite.
* limit: Maximale Zahl geladener Feed-Beiträge, Standard 30.

Für Administratoren unterstützt der Shortcode weiterhin den bisherigen URL-/Key-Aufruf zur temporären Feed-Auswahl. Bestehende Inhalte mit [rssdisplay], [csvtorss] oder [csvtohtml_create] müssen nach der Migration nicht geändert werden.

== Enthaltene Hauptfunktionen ==

= 6. Quizzz / Custom Post Type "question" =

Das Plugin legt den Custom Post Type "question" sowie die Taxonomie "quizcategory" an. Quizfragen können wie normale WordPress-Beiträge gepflegt und kategorisiert werden.

Funktionen:

* Quizfragen mit Titel, Inhalt, Beitragsbild und Metafeldern.
* Antworten A-D bzw. Einzelantworten über eigene Metabox "Answers & more".
* Herkunftsland und ISO-Code pro Frage.
* Bilddatei pro Frage aus /wp-content/uploads/quizbilder/.
* Quiz-Kategorien über Taxonomie "quizcategory".
* Import und Export von Fragen per CSV.
* Einzelanzeige über question-template.php bzw. games/wpdquizmain.php.
* Optionales Zertifikat bzw. Ergebnisanzeige.
* Optionale Speicherung von Prüfungsergebnissen im Penguin-Mod-Theme.

Kurzablauf Quizfrage manuell anlegen:

1. Im Backend unter "Questions" auf "Add New Question" klicken.
2. Fragetext in den Editor schreiben.
3. In der Metabox "Answers & more" die richtige Antwort und optionale falsche Antworten eintragen.
4. Herkunftsland, ISO-Code, Zusatzinfo und optional Bilddateiname pflegen.
5. Quiz-Kategorie zuweisen.
6. Frage veröffentlichen.

= 7. Quizfragen per CSV importieren/exportieren =

Das Plugin kann Fragen aus CSV-Dateien im Upload-Verzeichnis importieren und vorhandene Fragen exportieren.

CSV-Dateien:

* public_hist_quizfrage.csv: Vollimport. Vorhandene Fragen werden gelöscht und durch die CSV ersetzt.
* public_hist_quizfrage_update.csv: Ergänzungsimport. Fragen aus der Datei werden hinzugefügt.

Erwartete Struktur:

id;datum;charakter;land;titel;seitjahr;antwort;antwortb;antwortc;antwortd;zusatzinfo;kategorie;iso;bild

Kurzablauf Import:

1. CSV-Datei nach /wp-content/uploads/ hochladen.
2. Im Backend die Fragenliste öffnen.
3. Den CSV-Import auslösen.
4. Danach Fragen, Kategorien, Antworten und Bildverweise prüfen.

Bilddateien für Fragen gehören nach:

/wp-content/uploads/quizbilder/

= 8. Zufallsfrage auf der Startseite: [random-question] =

Der Shortcode zeigt auf der Startseite eine zufällige Quizfrage an. Gedacht ist er vor allem für Widgets oder Startseitenbereiche.

Beispiel:

[random-question]

Hinweise:

* Ausgabe erfolgt nur auf Startseite oder Frontpage.
* Angezeigt werden u.a. Kategorie, Bild, Herkunftsland, Frage und Link zur Beantwortung.
* Je nach Einstellung kann die Tool-/Games-Leiste angezeigt werden.

= 9. Persönliches Quiz / Prüfung: [personal_quiz] =

Der Shortcode lädt bei Bedarf die Datei games/xquizexam.php und startet daraus eine persönliche Prüfung aus vorhandenen Fragen.

Beispiele:

[personal_quiz items="20"]
[personal_quiz items="20" cats="sport"]
[personal_quiz items="20" suche="Kartfahren"]
[personal_quiz fragen="30433,20344,44444,12345"]
[personal_quiz cats="sport" items="20" suche="Kartfahren"]

Parameter:

* items: Anzahl der Fragen, Standard 20.
* cats: Kategorie-Slug oder kommaseparierte Kategorie-Slugs.
* suche: Suchbegriff, filtert Fragen nach Inhalt.
* fragen: Kommaseparierte Liste konkreter question-Post-IDs.

Nach Abschluss kann ein Zertifikat bzw. Ergebnis ausgegeben werden.

= 10. Tools und Games unter /tools/ =

Das Plugin kann aus der Datei /games/0_games_config.php automatisch SEO-freundliche Tool-Landingpages erzeugen. Dazu wird der Custom Post Type "tools" sowie die Taxonomie "tools_tag" registriert.

Funktionen:

* Eigener CPT "Tools" mit Archiv /tools/.
* SEO-Landingpages je Tool.
* Kanonischer Tool-Aufruf über /tools/<slug>/.
* Tools ohne CPT-Eintrag koennen direkt ueber /tools/<ID>/ gestartet werden.
* Kategorien und Tool-Tags aus der Games-Konfiguration.
* Resync-Schaltfläche im Backend zur Neu-Erzeugung der Tool-Beiträge.
* Automatische Empfehlung weiterer Tools auf Toolseiten.
* Tools (IDs 1–199) und Spiele (ab ID 200) bleiben über die Modulauswahl und Kategorien filterbar. Es gibt keine 7-Tage-Spieltoken oder tokenabhängigen Aufruf-URLs mehr.

Kurzablauf Tool-Sync:

1. Tool in /games/0_games_config.php eintragen.
2. Im Backend den CPT "Tools" öffnen.
3. Schaltfläche "Neu sync" verwenden.
4. Danach die erzeugten Toolseiten prüfen.
5. Bei geänderten Slugs oder Rewrite-Regeln unter Einstellungen > Permalinks einmal "Änderungen speichern" klicken.

URL-Beispiele:

/tools/passwort-generator/

Direktaufruf nach Config-ID (auch ohne CPT):
/tools/79/

Neue Links verwenden /tools/<slug>/ oder /tools/<ID>/.

Query-Parameter bleiben beim Direktstart erhalten.

= 11. Gamesbar-Einstellung =

Unter "Questions > Settings" wird die Sichtbarkeit der Gamesbar gesteuert.

Optionen:

* off: Gamesbar deaktiviert.
* admin: Gamesbar nur für Administratoren bzw. Admin-Kontext sichtbar.
* on: Gamesbar für alle sichtbar.

= 12. Business Toolbox Handbuch =

Das Plugin verweist auf eine HTML-Dokumentation im Plugin-Ordner:

business_tools_manual.htm

Enthalten sind Kapitel zu OpenAuditClassic, Rollenmodell, AVV-/Kontaktlisten, Organisationsanweisungen, Compliance-Schildern, Checklisten, Awareness, KI-Act, Arbeitsschutz, VVT, Hinweisgeber-Portal, Arbeitszeiterfassung, Raumbuchung, Ticketsystem, Administratorhandbuch, DSGVO/EU AI Act, Lizenzmodell, FAQ und Glossar.

= 13. MM Wordclouds / Live-Feedback / Chat: [menti_cloud] =

Das Plugin integriert eine Wordcloud- und Live-Feedback-Funktion. Die Kernlogik wird aus dem Unterordner /mm_wordclouds/ geladen. Räume werden über Codes geöffnet und können Beiträge, Upvotes, Tabellenansichten und Chatansichten bereitstellen.

Beispiele:

[menti_cloud]
[menti_cloud code="ABCDE12345"]

URL-Beispiele:

?code=ABCDE12345
?code=ABCDE12345&view=chat
?code=ABCDE12345&view=table

Funktionen für Teilnehmende:

* Raum per Code betreten.
* Beiträge bis 255 Zeichen erstellen.
* Optionales Autor-Kürzel mit drei Zeichen.
* Beiträge upvoten.
* Live-Aktualisierung per AJAX.
* Darstellung als Wordcloud/Karten, Chat oder Tabelle.

Funktionen für Administratoren:

* Räume anlegen und löschen.
* Räume zurücksetzen.
* Einzelne Beiträge löschen.
* CSV-Export je Raum.
* Moderation im Frontend.
* Nonce- und Rechteprüfung für Admin-Aktionen.

Optional kann ein QR-Code angezeigt werden, wenn eine passende QR-Code-Shortcode-Funktion in der WordPress-Installation vorhanden ist.

== Weitere Module von Business Toolbox ==

Die folgenden Module ergänzen die bereits beschriebenen Kernfunktionen. Sie dienen der Unterstützung organisatorischer, dokumentationsbezogener und administrativer Prozesse. Vorlagen, Prüfungen und automatisch erzeugte Ergebnisse sind vor produktiver Nutzung fachlich, technisch und rechtlich zu prüfen.

= Datenschutz in der Praxis =

Interaktive Datenschutz-Compliance-Prüfung mit praxisnahen Fragen zu Datenschutz-Grundlagen, sensiblen Informationen, Betroffenenrechten, Datensicherheit und Meldepflichten bei Datenschutzvorfällen. Sie unterstützt dabei, Datenschutzwissen im Arbeitsalltag zu überprüfen und typische Fehlhandlungen frühzeitig zu erkennen.

= Phishing Awareness =

Realistische Phishing- und Social-Engineering-Simulationen sensibilisieren Mitarbeitende für manipulierte Nachrichten, Links, Anhänge und Anmeldeaufforderungen. Auswertungen machen typische Schwachstellen sichtbar und liefern eine Grundlage für gezielte Nachschulungen.

= Awareness Tracker =

Zentrale Verwaltung der Schulungs- und Prüfungsstände aller Mitarbeitenden. Mitarbeiterlisten können importiert und mit absolvierten Awareness-Prüfungen abgeglichen werden; Erinnerungen unterstützen die fristgerechte Durchführung und eine nachvollziehbare Compliance-Dokumentation.

= Digitales Vertriebs- und Außendiensttagebuch =

Strukturierte Dokumentation von Kundenbesuchen, Vertriebsterminen und Außendiensteinsätzen. Neben Texten können Fotos und Audio-Sprachnotizen hinterlegt werden, sodass Besuchsberichte unmittelbar vor Ort erfasst und berechtigten Teams zentral bereitgestellt werden können.

= Lieferketten-Dokumentation =

Vorlagen und strukturierte Abfragen unterstützen die Dokumentation von Lieferketten, Sorgfaltspflichten, Risiken, Maßnahmen und Verantwortlichkeiten. Die erzeugten Nachweise können für interne Kontrollen, Kundenanfragen sowie interne und externe Prüfungen genutzt werden.

= Nachhaltigkeitsbericht =

Erstellung strukturierter Nachhaltigkeitsberichte auf Basis von Unternehmensangaben, Website-Informationen und Vorlagen. Das Modul unterstützt die nachvollziehbare Kommunikation von Umwelt-, Sozial- und Governance-Maßnahmen gegenüber Management, Kunden und Partnern.

= Mitgliedskarten- und Zertifikatsgenerator =

Erstellung personalisierter Mitglieds-, Mitarbeiter-, Besucher- und Berechtigungskarten sowie von Zertifikaten und Urkunden. Fotos, Logos, Hintergründe und QR-Codes können integriert werden; eine Gültigkeitsprüfung unterstützt die Kontrolle ausgegebener Nachweise.

= Besucher-Ausweise =

Digitale Erstellung, Ausgabe und Rücknahme von Besucherausweisen. Das Modul unterstützt Zutritts- und Sicherheitskonzepte und ermöglicht eine nachvollziehbare Dokumentation von Besuchern und ausgegebenen Ausweisen.

= Visitenkarten =

Erstellung einheitlicher Visitenkarten mit Logo, Foto, QR-Code und individuellen Unternehmensdesigns. Die Daten können zusätzlich für digitale Kontaktdaten oder E-Mail-Signaturen genutzt werden und fördern ein konsistentes Erscheinungsbild.

= Zertifikat Druckerei =

Erstellung hochwertiger Urkunden und Teilnahmezertifikate für Schulungen, Prüfungen, Auszeichnungen oder besondere Leistungen. Designs und Personalisierungen lassen sich an den jeweiligen Anlass und das Corporate Design anpassen.

= Website Scanner =

Prüft Unternehmenswebsites auf typische Schwachstellen und fehlende Pflichtinformationen in den Bereichen Datenschutz, Impressum, Cookie-Hinweise und Compliance. Die Analyse liefert konkrete Hinweise auf mögliche Ergänzungen, ersetzt jedoch keine rechtliche Prüfung.

= 5 Minuten IT-Check =

Kurzer Selbstcheck zur Ersteinschätzung des IT- und Compliance-Status. Ein kompakter Fragenkatalog betrachtet typische Anforderungen aus Cyberversicherung, Datenschutz, Informationssicherheit und organisatorischen Maßnahmen und zeigt mögliche Handlungsfelder auf.


= Arbeitszeugnisse =

Das Modul unterstützt Personalabteilungen und Führungskräfte bei der Erstellung von Arbeitszeugnissen, Zwischenzeugnissen und Ausbildungszeugnissen. Geführte Eingabemasken, Vorlagen und Formulierungshilfen unterstützen Tätigkeitsbeschreibungen sowie Leistungs-, Sozial- und Führungsbeurteilungen.

Funktionen:

* Auswahl zwischen Arbeitszeugnis, Zwischenzeugnis und Ausbildungszeugnis.
* Erfassung von Personendaten, Beschäftigungszeitraum, Position und Tätigkeiten.
* Strukturierte Leistungs-, Sozial- und Führungsbeurteilungen.
* Formulierungshilfen und Textbausteine für unterschiedliche Bewertungsstufen.
* Individuelle Ergänzungen, Schlussformeln und druckoptimierte Ausgabe.
* Speichern und erneutes Laden von Entwürfen.

Hinweis: Die erzeugten Texte sind Entwürfe und ersetzen keine individuelle fachliche oder arbeitsrechtliche Prüfung. Jedes Zeugnis ist vor Unterzeichnung und Ausgabe durch die zuständige Stelle zu kontrollieren und an den konkreten Einzelfall anzupassen.

Die vollständige fachliche Einordnung, typische Einsatzfälle, Rollen, Datenschutz- und Audit-Hinweise sind im HTML-Handbuch `business_tools_manual.htm` dokumentiert.

== Custom Menüs – eigene Kachel-Sammlungen ==

Mit Custom Menüs können Administratoren eine Auswahl vorhandener Business-Toolbox-Kacheln als Sammlung speichern. Die Auswahl nutzt die bestehenden Tools und Kategorien; es werden keine neuen Tools angelegt.

Sammlung erstellen:
1. Die Business Toolbox im Frontend öffnen und „+ Menüs“ wählen.
2. „+ Neue Sammlung“ öffnen, einen Namen eingeben und die gewünschten Kacheln markieren.
3. Über „Kategorie“ die Auswahl eingrenzen. „Sichtbare auswählen“ bzw. „Sichtbare abwählen“ wirkt auf die aktuell sichtbaren Kacheln.
4. „Speichern“ wählen. Die Sammlung erscheint anschließend in der Übersichtstabelle.

Sammlungen verwalten:
- In der Übersicht sind Name, Anzahl ausgewählter Kacheln, Shortcode und Aktionen sichtbar.
- Über das Bearbeiten-Symbol lässt sich eine Sammlung ändern; über das Kopier-Symbol lässt sich der Shortcode übernehmen. Das Lösch-Symbol entfernt die Sammlung.
- Gespeicherte Custom Menüs erscheinen als eigene Auswahl-Badges am Anfang der Cats-Liste, direkt nach „Alle“. Beim Auswählen werden nur die Kacheln dieser Sammlung angezeigt.

Shortcode und Lazy Loading:
- Jede Sammlung besitzt einen Shortcode nach dem Muster [wpd_menu id="SAMMLUNGS_ID"]. Die tatsächliche ID steht in der Übersicht und sollte von dort kopiert werden.
- Der Shortcode kann in WordPress-Beiträgen oder -Seiten verwendet werden. Die Kacheln werden beim Annähern an den sichtbaren Bereich nachgeladen (Lazy Loading über AJAX).
- Änderungen an der gespeicherten Auswahl wirken sich auch auf die Shortcode-Ausgabe aus.

Als Sticky Post veröffentlichen:
- In der Sammlungsübersicht das Stern-Symbol für „Als Sticky Post veröffentlichen“ verwenden.
- Es wird ein WordPress-Beitrag mit dem Sammlungsnamen als Titel und dem Shortcode als Inhalt veröffentlicht. Der Beitrag erhält das Post-Format „chat“, die Kategorie „Tools“ und den Sticky-Status.
- Ist bereits ein Beitrag mit der Sammlung verknüpft, wird dieser aktualisiert statt erneut angelegt. In der Tabelle erscheint dann „Veröffentlicht“; das Stern-Symbol dient zur Aktualisierung.
- Die WordPress-Kategorie „Tools“ muss bereits vorhanden sein. Fehlt sie, wird die Veröffentlichung mit einer Fehlermeldung abgebrochen.
- Die tatsächliche Anzeige vollständiger Beitragsinhalte in der Startseitenliste hängt vom eingesetzten WordPress-Theme ab.

Hinweis: Die Verwaltung erfolgt im Frontend der Business Toolbox und ist Administratoren vorbehalten. Die Zugriffsrechte der verlinkten Tools gelten weiterhin.

== Shortcode-Übersicht ==

= [random-question] =

Zufällige Quizfrage auf Startseite/Frontpage anzeigen.

Beispiel:

[random-question]

= [personal_quiz] =

Persönliche Quiz-Prüfung starten.

Beispiel:

[personal_quiz items="20" cats="edv"]

= [menti_cloud] =

Wordcloud-/Feedback-/Chat-Raum anzeigen.

Beispiel:

[menti_cloud code="ABCDE12345"]



== Shortcode [pbadventskalender] - Adventskalender (Tool-ID 79) ==

Der PBAdventskalender (cadventskalender.php) ist der zentrale Adventskalender der Business Toolbox.
Er ersetzt den frueheren Business-Adventskalender. Der alte Shortcode [businessadvent]
wird nicht mehr registriert. Der Kalender kann als Tool oder per Shortcode in
WordPress-Seiten und -Beitraegen eingebunden werden.

Die 24 Tuerchen verlinken auf zufaellig ausgewaehlte Beitraege/Seiten, optional
Spiele sowie Adventsimpulse. Impulse werden als eigene zufaellige Tuer-Aktion
angezeigt: mit Frage oder Aufgabe, Schaltflaeche zum Aufdecken der Antwort und
optionalem Vorlesen per deutscher Browser-Sprachausgabe. Die Verfuegbarkeit der
Sprachausgabe haengt vom Browser und den installierten Stimmen ab.
Der Kalender ist responsiv und verwendet saisonale Hintergrundbilder.
Tuerchen sind regulär ab ihrem jeweiligen Dezembertag zu oeffnen.

## Usage ##

Standard: [pbadventskalender]
Mit Spielen und Impulsen: [pbadventskalender games="1" impuls="1"]
Ohne Impulse: [pbadventskalender impuls="0"]
Mit ausgewaehlten Inhalten: [pbadventskalender cats="33,102" pages="adventsgeschichte,sonderangebot,23" games="1" impuls="1"]

Parameter:
- impuls="1" (Standard): Adventsimpulse in die zufaellige Tuer-Aktionsauswahl aufnehmen.
- impuls="0": Adventsimpulse abschalten; es bleiben Beitraege/Seiten und ggf. Spiele.
- games="1": zufaellig Spiele einbeziehen (Shortcode-Standard: 0).
- games="0": keine Spiele einbeziehen.
- cats="33,102": Beitrags-/Quiz-Kategorie-IDs, kommasepariert.
- pages="slug,23": explizite Beitraege/Seiten nach Slug oder ID, kommasepariert.
- debug="1": Kalender auch ausserhalb des Dezembers anzeigen (Standard: 0).

Bei der Tool-Darstellung koennen Spiele standardmaessig aktiv sein. Bei einem
Shortcode muessen sie explizit mit games="1" aktiviert werden.
Die Impulse sind standardmaessig aktiv, auch wenn impuls nicht angegeben wird.

Sticky-Automatik: WP-Cron setzt veroeffentlichte Beitraege mit [pbadventskalender]
am 28.11. um 00:00 Uhr (WordPress-Zeitzone) auf sticky und entfernt den
Sticky-Status am 03.01. des Folgejahres um 00:00 Uhr. Die beiden Termine
werden jaehrlich erneut geplant. Ein Aufruf der Adventskalender-Seite ist
nicht erforderlich. Standard-WP-Cron benoetigt allerdings Website-Traffic;
bei garantiert puenktlicher, besucherunabhaengiger Ausfuehrung muss ein
serverseitiger Cronjob wp-cron.php regelmaessig aufrufen.
Vorhandene individuell gespeicherte Impulse bleiben ueber die bisherige
Optionsspeicherung businessadvent_impulses lesbar.
Spiele aus dem Adventskalender verbrauchen keine 7-Tage-Spieltoken; die zentrale
Lizenz- und Demopruefung der Business Toolbox bleibt bestehen.

* pages können mindestens 2 bis zu 24 komma-getrennte Werte sein:
	Ist der Wert eine Zahl (integer), so wird der Beitrag mit der ID dieser Zahl aufgerufen (Shortlink: ?p= wird automatisch ergänzt)
	Alternativ kann der Wert der relative Permalink (slug) zur Seite/Beitrag/Produkt oder custom post type sein (z. B. staubsauger-w600)
	Werden weniger als 24 Werte übergeben, erfolgt die Zuordnung zu den Seiten nach Zufallsprinzip
* cats können mindestens 2 bis zu 24 komma-getrennte Werte sein, die aus post Kategorien (categories) oder question quizkategorie terms sein
	Beispiel: quizcateory "weihnachten" hat ID: 254, post category ID: 16
	cats=254,16 sucht in post Kategorien und Psot type "question" quicategory und zeigt Zufallsbeiträge aus beiden Kategorien an.
* debug=1 added to show calendar in other months than dec, default=0 it omitted
* games=1 zeigt spiele hinter sich öffnenden Türen nach Zufall an, mit anderen Params kombinierbar.

## Background images (advanced users) ##

Enthaltene Bilder sind von mir erstellt und CC0-lizensiert, frei verwendbar. Im Ordner /images unter dem Plugin zu finden.
Für eigene Motive bitte in einen Ordner hochladen und folder= Pfad angeben

== Shortcode [grusskarte] - Grußkarten mit Bild, Musik und Kalender ==
=

Zu vielen Gelegenheiten eine Grußkarte anzeigen (mit zufälligem Bild, teilweise mit Ton). Anrede kann auch als URL-Parameter ?an= 
und Absender als Parameter &von= mitgegeben werden. Mit dem Parameter calendar=0 kann der Monatskalender ausgeschaltet werden.

	[grusskarte calendar=1 showimage=1 widget=0 anlass='' von='']
			'calendar' => 1,	// zeigt Monatskalender mit Terminen des Stichtagen an
			'showimage' => 1,	 // zeigt CC0-Motiv-Bild aus der Plugin-Galerie an px-anlassx.jpg
			'btm' => '', 		// Bild 0...b, Text 0...t und Musik 0...m festlegen - 1,2,11 Grußkarte mit Bild#2 Text#3 Musik#12 - ,,1 Bild+Text random, Musik2 festgelegt
			'widget' => 0, 		// andere Darstellung im Widget: todayinhist/5, wenn Feiertag: Feiertagsbild/Text
			'disablegui' => 0, 	// wenn =1, Auswahlen für Grusskarten nur für Admins, nicht für User, ansonsten sind Grußkarten public
			'jukebox' => 0, 	 // nur Jukebox mit allen Songs anzeigen
			'anlass' => '', 	 // Anlass vorgeben auch als Commandline
			'von' => '' 		  // Absender vorgeben auch als Commandline
	
	Verfügbare Anlässe und Stichtage:

	Das Plugin enthält eine umfangreiche Auswahl an Grußkarten-Anlässen und automatisch berechneten Feiertagen/Stichtagen.
	Beispiele für Anlässe:
	Abschied, Achtsamkeit, Beileid, Danke, Geburtstag, Genesung, Glückwunsch, Hochzeit, HomeOffice, Jubiläum, Kommunion,
	Mutmacher, Nachwuchs, Rente/Ruhestand, Sauna, Schulung, Spieleabend, Umzug, Urlaub, Weihnachten, Wochenende und weitere.

	Beispiele für Feiertage und Stichtage:
	Neujahr, Valentinstag, Karneval, Ostern, Muttertag, Vatertag, Pfingsten, Fronleichnam, Sommeranfang, Warntag,
	Tag der deutschen Einheit, Halloween, St. Martin, Advent, Nikolaus, Weihnachten und Silvester.

	Der gewünschte Anlass kann über `anlass=""` vorgegeben oder über die Oberfläche ausgewählt werden.
	Anrede und Absender können auch per URL-Parameter übergeben werden:
	?an=Name&von=Absender


== Installation ==

1. Plugin als ZIP-Datei über Plugins > Installieren > Plugin hochladen installieren oder per FTP in den Plugin-Ordner kopieren.
2. Plugin aktivieren.
3. Unter Einstellungen > Permalinks einmal "Änderungen speichern" klicken, damit Rewrite-Regeln aktualisiert werden.
4. Prüfen, ob die Menüpunkte "Business Toolbox", "Questions", optional "Tools" und "MM Wordclouds" erscheinen.
5. Für Quizbilder bei Bedarf Dateien in /wp-content/uploads/quizbilder/ ablegen.
6. Für Tool-/Games-Funktionen die Dateien im /games/-Ordner und die Konfiguration 0_games_config.php prüfen.


== Kurzanleitung: Quiz importieren ==

1. CSV-Datei nach /wp-content/uploads/ hochladen.
2. Für Vollimport public_hist_quizfrage.csv verwenden.
3. Für Ergänzungsimport public_hist_quizfrage_update.csv verwenden.
4. Questions-Liste im Backend öffnen und Import starten.
5. Stichprobenartig Fragen, Antworten, Kategorien und Bilder prüfen.

== Kurzanleitung: Toolseite erzeugen ==

1. Tool in /games/0_games_config.php konfigurieren.
2. Backend > Tools öffnen.
3. "Neu sync" klicken.
4. Toolseite unter /tools/<slug>/ prüfen.
5. Aufruf unter /tools/<slug>/ und bei Bedarf /tools/<ID>/ testen.

== Kurzanleitung: Wordcloud-Raum nutzen ==

1. Im Backend einen Raum unter "MM Wordclouds" anlegen.
2. Code kopieren.
3. Seite mit [menti_cloud] oder [menti_cloud code="DEINCODE"] erstellen.
4. Link mit ?code=DEINCODE teilen.
5. Für Chatansicht &view=chat ergänzen.
6. Für Tabellen-/Statistikansicht &view=table ergänzen.

== Datenschutz / DSGVO-Hinweise ==

* Für Terminabstimmungen reicht ein Kürzel oder Spitzname; echte Namen sind nicht zwingend erforderlich.
* Business Toolboxz speichert Abstimmungen serverseitig und kann IP-Adresse sowie Zeitstempel speichern.
* Cookies können verwendet werden, um eigene Stimmen wiederzuerkennen und Bearbeitung zu ermöglichen.
* Bei Einsatz des Penguin-Mod-Cookiebanners werden Business Toolboxz-Cookies nur gesetzt, wenn Komfort-Cookies erlaubt sind.
* Wordcloud-Beiträge arbeiten mit Autor-Kürzeln und Cookies für Upvotes; echte Namen sind nicht erforderlich.
* Betreiber sollten die Nutzung in ihrer Datenschutzerklärung beschreiben und bei produktivem Einsatz eigene rechtliche Prüfung durchführen.

== Abhängigkeiten und optionale Integrationen ==

Das Plugin funktioniert grundsätzlich eigenständig. Einige Funktionen erscheinen nur, wenn passende externe Funktionen, Themes oder Plugins vorhanden sind:

* WPGDCharts: Diagramm-/Kreisdiagramm-Ausgabe.
* ipflag: Länder-/Flaggenanzeige zu IP-Adressen für eingeloggte Nutzer.
* export_ics bzw. icalfeed: ICS-/Kalenderdownload bei Terminen.
* timeline_calendar: Monatskalender mit markierten Terminoptionen.
* ZCategoriesImages: Kategorie-Bilder für Quizkategorien.
* QR-Code-Shortcode: QR-Code-Anzeige für Wordcloud-Räume.
* Penguin-Mod-Theme: Cookiefreigabe, Zertifikats-/Prüfungsintegration und weitere Theme-Funktionen.

== Häufige Fragen ==


= Warum funktionieren /tools/-URLs nicht? =

Gehe zu Einstellungen > Permalinks und klicke "Änderungen speichern", ohne etwas zu ändern. Dadurch werden Rewrite-Regeln aktualisiert.

= Kann ich Doodlez in eine normale Seite einbauen? =

Ja, mit [Business Toolboxz_sc id="POST_ID"]. Pro Seite sollte dieser Shortcode nur einmal verwendet werden.

= Können Umfragen anonym genutzt werden? =

Umfragen verwenden automatisch erzeugte Werte für den Namen. Betreiber sollten trotzdem prüfen, welche Daten im konkreten Setup gespeichert werden.

= Können mehrere Wordcloud-Räume parallel laufen? =

Ja. Jeder Raum hat einen eigenen Code und kann unabhängig genutzt werden.

= Ist das Plugin für produktive Compliance-Prozesse geeignet? =

Die enthaltenen Tools und Generatoren sollten vor produktivem Einsatz fachlich, rechtlich und technisch geprüft werden. Sie ersetzen keine Rechts-, Datenschutz-, Compliance- oder Sicherheitsberatung.

== Sicherheit und Haftung ==

Die Nutzung erfolgt auf eigene Verantwortung. Vor produktivem Einsatz sollten Code, Datenflüsse, Berechtigungen, Datenschutztexte und Serverumgebung geprüft werden. Der Betreiber der Website ist für rechtmäßige Nutzung, Datenschutzhinweise, Cookie-Einwilligungen, Backup, Updates und Zugriffsschutz verantwortlich.

== Entwicklerhinweise ==

Wichtige Dateien und Bereiche:

* Hauptplugin: Business Toolboxz.php
* Question-Template: question-template.php
* Quiz-/Games-Code: /games/
* Games-Konfiguration: /games/0_games_config.php
* Persönliches Quiz: /games/xquizexam.php
* Quiz-Hauptlogik: /games/wpdquizmain.php
* Wordcloud-Core: /mm_wordclouds/
* Quizbilder: /wp-content/uploads/quizbilder/

Wichtige Inhaltstypen und Taxonomien:

* question: Quizfragen.
* quizcategory: Quiz-Kategorien.
* tools: SEO-Toolseiten.
* tools_tag: Tool-Tags.


= Lizenzierung und 7-Tage-Demoversion =

Nach der ersten Initialisierung beginnt ohne eingetragenen Lizenzschlüssel eine sieben Tage lange Demoversion. Der Demo-Beginn wird in WordPress gespeichert; ein leerer Lizenzschlüssel startet keine neue Demo. Nach Ablauf der Demo oder bei ungültigem bzw. abgelaufenem Lizenzschlüssel sperrt die Business Toolbox die zentralen Modulaufrufe und zeigt einen Hinweis an.

Administratoren verwalten die Lizenz im WordPress-Backend unter Tools (Custom Post Type) > Lizenz, NICHT unter Werkzeuge. Dort kann ein Lizenzschlüssel in ein einzeiliges Feld eingefügt und gespeichert werden. Die Übersicht zeigt je nach Status Demo-Beginn und Demo-Ende bzw. Lizenznehmer/Firma, Lizenz-ID, Vertragsbeginn, Intervalldauer, Ablaufdatum und gegebenenfalls Kündigungsdatum. Datumsangaben enthalten relative Zeitangaben.

Im Konfigurations-Details wird unten ein kompakter Lizenzstatus einschließlich Lizenznehmer, Lizenztyp und Restlaufzeit angezeigt. Während der Demo erscheint im Titelbereich des Menüs und der Module neben dem Hamburger-Menü ein rotes Badge „Demoversion“; der Tooltip enthält das Ablaufdatum. Die einzelnen Modulkarten erhalten keinen separaten Demo-Badge.

Lizenzschlüssel sind für Business Toolbox bestimmt und werden lokal auf Signatur und Gültigkeit geprüft. Der aktuelle HMAC-Prüfmechanismus benötigt WPD_LK_SIGNING_SECRET in wp-config.php (identisch mit dem Geheimnis des Licenz Keygen); ohne diesen Wert können ausgegebene Schlüssel nicht erfolgreich geprüft werden. HMAC mit einem an Kunden ausgelieferten Geheimnis ist für eine sichere Offline-Lizenzprüfung nicht geeignet.

Die früheren 7-Tage-Spieltoken sind entfernt und dürfen nicht mit der sieben Tage gültigen Plugin-Demoversion verwechselt werden.


== Glossar (Business Toolbox) ==
Das Glossar ist als reguläres Business-Tool mit Tool-ID 81 im Toolbox-Menü eingebunden (games/cglossar.php).
Es wird keine Seite automatisch angelegt, keine feste URL /glossar/ vorausgesetzt und kein Theme-Template registriert.
Eine beliebige bestehende oder neue WordPress-Seite kann den Shortcode enthalten.
Suche, Seitengroesse, Schlagwort-Beschreibungen und Navigation bleiben erhalten.
