flownative/neos-multisitehelper

Tooling for use in a multi-site Neos setup.

, _(*1)

Multisite Helper for Neos

The Neos Multisite Helper contains a tool to create asset collections for sites created by the Neos Multisite Kickstarter., _(*2)

Furthermore it provides an authentication provider that gracefully denies login if a user has no access to a site she tries to log in to., _(*3)

Installation

Usually this package is required by a site package and thus installed along with the depending site automatically., _(*4)

Only if you keep your site package in your Neos distribution (and not install it using composer), manual installation is needed:, _(*5)

composer require flownative/neos-multisitehelper, _(*6)

Command Usage

After kickstarting and importing a site, use the following command:, _(*7)

./flow multisite:setup --package-key Acme.AcmeCom, _(*8)

This creates an asset collection with a name as expected by the kickstarted site and assign it as default collection to the site., _(*9)

Authentication Provider

The package comes with an authentication provider that is configured for Neos user accounts through the settings of this package., _(*10)

It checks if access to the Site the user logged in is granted and rolls back authentication if needed. This avoids an error thrown by the security framework otherwise and thus provides a better user experience. For this to work, a domain must be assigned to the site – otherwise only users with the Neos.Neos:Administrator role are granted access., _(*11)

Credits

Development of this package has been sponsored by Schwabe AG, Muttenz, Switzerland., _(*12)

The authentication provider was adapted from code Aske Ertmann provided in a blog post at https://blog.ertmann.me/multi-site-access-restriction-with-neos-cms-9d5624126d5b., _(*13)