# 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)
