Einbau per TypoScript oder Fluid – was passt wann?
Für ein globales Setup ist TypoScript der saubere Weg: `page.headerData.1900 = TEXT` mit `value = <script …></script>` im Setup deines Site-Packages, versioniert im Git-Repository und damit reproduzierbar auf allen Instanzen. Wenn du nur einzelne Seitenbäume abnehmen lassen willst, ist eine Bedingung sinnvoll (`[page["uid"] in tree.rootLineIds]`). Alternativ setzt du das Snippet direkt ins Fluid-Layout (`Layouts/Page/Default.html`) – praktisch, wenn TypoScript im Projekt kaum genutzt wird, aber weniger flexibel, weil jedes weitere Layout den Code ebenfalls braucht.
Cache-Ebenen: die häufigste Ursache, wenn nichts erscheint
TYPO3 cached auf mehreren Ebenen: `pages`, `pagesection`, `hash`, dazu oft ein Reverse-Proxy wie Varnish oder Nginx-FastCGI und ein CDN. Nach dem Einbau leerst du im Backend über „Flush frontend caches“ und – bei Änderungen am Site-Package – über „Flush all caches“; anschliessend Varnish oder CDN. Erscheint das Snippet nur auf einzelnen Seiten, sind meist noch alte `pagesection`-Einträge aktiv oder das TypoScript wurde nicht auf der richtigen Root-Page eingebunden.
Nur in Staging ausliefern, nicht in Produktion
Weil TYPO3-Projekte fast immer eine Deployment-Kette mit mehreren Kontexten haben, koppelst du das Snippet an den Application Context: `[applicationContext == "Development/Staging"]` in der TypoScript-Bedingung oder eine Umgebungsvariable, die im Fluid-Template ausgewertet wird. So durchläuft derselbe Code alle Instanzen, ohne dass ein Feedback-Snippet ungewollt live geht – ein Punkt, an dem generische Anleitungen für Baukasten-Systeme nicht weiterhelfen.
Mehrsprachigkeit und Site-Konfiguration
In TYPO3-Setups mit mehreren Sprachen oder mehreren Sites pro Instanz hat jede Sprachvariante ihre eigene URL – die Notiz hängt genau daran. Für die Abnahme heisst das: Prüfe die Sprachen als getrennte Durchgänge und hinterlege alle Domains und Subdomains aus der Site-Konfiguration im nootiz-Projekt, sonst wird das Snippet auf einer Sprachdomain nicht akzeptiert.
Abnahme ohne Backend-Schulung
Der teuerste Teil einer TYPO3-Abnahme sind Kunden, die sich im Backend nicht zurechtfinden: Sie melden Fehler, die eigentlich Redaktionsinhalte sind, oder gar nichts, weil sie am Login scheitern. Mit Frontend-Notizen brauchen sie nur den Link – Rückmeldungen kommen präzise am Element statt als Sammel-E-Mail, und du erkennst sofort, ob es um Template, Inhalt oder Extension-Ausgabe geht.
Redaktions-Workflow und Extension-Ausgabe
Notizen ersetzen keine Backend-Workspaces und keine Freigabe-Workflows. Sie ergänzen sie: Feedback zu Ausgaben von Extensions – News-Listen, Powermail-Formularen, EXT:form-Feldern oder Slider-Elementen – landet am gerenderten Element mit CSS-Selektor. Damit weiss die Entwicklung, ob eine Fluid-Partial-Anpassung, ein TypoScript-Setting oder ein Inhaltselement die Ursache ist.
Grenzen im TYPO3-Kontext
nootiz kennt keine TYPO3-Benutzergruppen: Wer den Projektlink hat, kann Notizen setzen. Für vertrauliche Vorab-Inhalte kombinierst du das Snippet daher mit Basic Auth oder einer IP-Sperre auf der Staging-Domain. Ebenso gilt: Notizen sind kein Ersatz für ein Ticket-System – sie werden dorthin übergeben (Trello, Asana, Jira, GitHub).
