collab-presence — wer ist im Dokument, wo steht der Cursor?
collab-presence hängt sich an collab-core und liefert das Presence- und Awareness-Modell der Collab-Suite: Online-Status, Cursor-Position, Selection-Broadcast und User-Identität. Coming soon — Inhalte und API-Dokumentation folgen, sobald das Paket für die öffentliche Bereitstellung freigegeben ist.
What it does
collab-presence is the UI layer that surfaces presence data from collab-core inside the TYPO3 backend. Via the ModifyPageLayoutContentEvent event it injects the presence overlay (CSS and JS) into the backend page layout. The overlay uses server-sent events to fetch the active editors of a document and renders live avatars next to the editor position.
Active components
EventListener\InjectPresenceAssetsListener— asset injection into the page-layout footerResources/Public/Css/presence.css— avatar pills, colour indicatorsResources/Public/JavaScript/presence-overlay.js— SSE client and DOM mount
Per RTE field the overlay shows
- User initials
- Colour coding (deterministic allocation from
PresenceService::COLORS) - Mouse-over tooltip with the clear name
- Live updates via server-sent events on the collab-core route
/api/collab/presence
Requirements
- TYPO3 14.x, PHP 8.3+
moselwal/collab-coreas the backend API- Extension key
collab_presence, namespaceMoselwal\CollabPresence, GPL-2.0-or-later
Status note
At v0.1.x the installation is blocked by a version-constraint bug (the package requires moselwal/collab-core: ^1.0 while only v0.1.x is released). The fix is documented in the extension AUDIT.
Evaluate the presence layer early?
If you want to test collab-presence within a TYPO3 backend setup or validate the awareness API against your editor configuration early, get in touch via the contact form.
Or email us directly: kontakt@moselwal.de