README

Team and people management for Neos CMS 9. People are document nodes and are maintained in one place. Overviews and contact blocks read from there, so no data is entered twice. Departments run on Sitegeist.Taxonomy, lists on Flowpack.Listable.

The package ships structure, not design. Markup carries Tailwind class names, there is no CSS file and no build step of its own.

When to use it, and when not

Use it when the same people appear in several places — an overview page, a contact block in a sidebar, a department listing — and you want them maintained once. Detail pages are optional per person, so a team of forty can have three profiles and thirty-seven plain cards.

Do not use it when:

Your project has no Tailwind build. The markup carries nothing but Tailwind class names and arrives unstyled without it.
People need accounts. These are content nodes, not Neos users. There is no connection to authentication, roles or a member area.
You need vCard export, org charts or reporting lines. The package stores flat records with a department taxonomy. Hierarchy is not modelled.
Contact data must stay out of the public HTML. Phone and mail addresses are rendered as plain links, with no obfuscation.

Requirements

Component	Version	Note
Neos CMS	9.0 – 9.1	Tested against 9.1.8
PHP	>= 8.2	Inherited from `neos/neos`; tested on 8.3
Flowpack.Listable	^4.0	Listing
Sitegeist.Taxonomy	^2.0	Departments
Tailwind CSS	3.x	In the site package, not here

Neos 9.2 is not tested. It changes the content graph schema, so treat compatibility as open until someone has run it.

Your site package must bring its own content node types. The Neos base distribution ships no text or image element. Without one, a person detail page renders its header and an empty content area.

Installation

composer require waterproof/neos-team
./flow neos.flow:package:rescan
./flow flow:cache:flush --force
./flow resource:publish

The three commands after the require are mandatory under DDEV. The Composer plugin writes the package cache to Data/Temporary/, while Flow reads it from /tmp/Flow/. Without package:rescan the package stays invisible.

Set up Tailwind, or everything stays unstyled

The Fusion files live outside your site package, and Tailwind only finds class names in files from its content glob. Add this to your tailwind.config.js:

content: [
    './Resources/Private/**/*.{fusion,html,js}',
    './NodeTypes/**/*.{yaml,fusion}',
    '../../Packages/Application/Waterproof.Team/Resources/Private/**/*.fusion',
],

Without that entry the package works, but arrives without any layout.

Node types

Node type	Backend label	Purpose
`Waterproof.Team:Document.Person`	Person	One person with role, portrait, contact details, optional detail page
`Waterproof.Team:Document.TeamIndex`	Teamübersicht	Parent page, lists the people below it
`Waterproof.Team:Content.TeamGrid`	Team-Übersicht (Team)	Grid, optionally limited to departments
`Waterproof.Team:Content.TeamHighlight`	Ansprechpartner (Team)	A single person on any page

Detail pages

Every person carries the hasDetailPage property, switched off by default:

off: cards do not link, a direct call answers with 404 in the frontend. The page stays editable in the backend so it can be prepared.
on: the person gets a regular page with its own content area.

Column choice

Document.TeamIndex and Content.TeamGrid carry a columns property with the values cols1 to cols4, default cols3. The class names are written out in Component/PersonCard.fusion, because composed class names would be invisible to the Tailwind scanner.

Apply your own design

Prototype	Responsible for
`Waterproof.Team:Document.Person.Short`	Card in listings
`Waterproof.Team:Content.TeamIndexBody`	List body of the index
`Waterproof.Team:Content.PersonBody`	Detail page
`Waterproof.Team:Content.PersonNotFound`	Output when the detail page is switched off
`Waterproof.Team:Component.PersonCollection`	Grid around the cards
`Waterproof.Team:Component.GridClass`	Mapping of column value to classes

Languages

Backend labels ship as XLIFF in Resources/Private/Translations/ for German and English.

Changelog

Release history and upgrade notes are in CHANGELOG.md.

License

MIT.

Built and maintained by waterproof.agency.

waterproof / neos-team

Package info

Security

Statistics