BSN-Chatsystem/plg_system_bsn_wertungsbox/README.md

BSN Wertungsbox v2 — Joomla System Plugin

Artikel-Typen

Typ	Infobox	Wertungsbox
News	❌	❌
Review	✅ {bsn_infobox}	✅ automatisch
Vorschau	✅ {bsn_infobox}	❌

Review-Artikel-Aufbau

[Einleitung — Daniel schreibt]
{bsn_infobox}            ← Shortcode setzen!
[Haupttext]
                           ← Wertungsbox erscheint HIER automatisch

---

Installation

1. ZIP hochladen: Administrator → System → Erweiterungen → Installieren
2. Plugin aktivieren: System → Plugins → "System - BSN Wertungsbox" → Aktivieren
3. Kategorien wählen: Plugin-Einstellungen → "Kategorien für Wertungsbox" → Nur die Review-Kategorie(n) anhaken
4. Speichern

→ 19 Custom Fields sind automatisch angelegt in der Gruppe "BSN Wertungsbox".

---

Verwendung

1. Custom Fields ausfüllen (Tab "Felder" im Artikel-Editor)

Infobox-Felder:

Feld	Beispiel
BGG-Spiel-ID	349463
Verlag	alea
Designer	Richard Garfield
Autor	— (falls abweichend)
Illustrator	—
Spieleranzahl	1–4
Alter	ab 12 Jahren
Spieldauer	45–60 Minuten
BGG-Rating	7,0/10
BGG-Schwierigkeit	1,89/5

Wertungsbox-Felder:

Feld	Beispiel
Wertung – Titel	Chrono Fall
Wertung – Untertitel	At the End of Space and Time
Wertung – Komplexität	Kennerspiel
Wertung – Sprache	Deutsch
Wertung – Mechanismen	Cooperative Game (eine pro Zeile)*
Wertung – Pro	hohe strategische Tiefe (eine pro Zeile)*
Wertung – Kontra	anspruchsvolle Einstiegshürde (eine pro Zeile)*
Wertung – Rezensent	Michael Berndt
Wertung – Punkte	84

2. Shortcode im Artikel platzieren

An die Stelle, wo die Infobox erscheinen soll:

{bsn_infobox}

---

Rückgängig machen

• Plugin deaktivieren → Boxen verschwinden sofort. Custom Fields + Werte bleiben erhalten.
• Plugin deinstallieren → Custom Fields + Werte werden gelöscht.
• Artikel-Inhalte werden NIE verändert. Der Shortcode {bsn_infobox} bleibt als Text im Artikel, falls das Plugin deaktiviert wird (einfach löschen).

---

Sicherheit

• Läuft nur im Frontend (nicht im Admin)
• Nur bei text/html-Output
• Alle Operationen in try/catch → macht die Seite nie kaputt
• Keine Datenbank-Schreibzugriffe beim Rendern (nur lesend)