Download the PHP package flownative/neos-customdocumenturirouting without Composer
On this page you can find all versions of the php package flownative/neos-customdocumenturirouting. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download flownative/neos-customdocumenturirouting
More information about flownative/neos-customdocumenturirouting
Files in flownative/neos-customdocumenturirouting
Package neos-customdocumenturirouting
Short Description This allows to have custom document URI paths for document nodes
License MIT
Informations about the package neos-customdocumenturirouting
Custom Document URI paths for Neos
This allows to have custom document URI paths for document nodes. This means, independent from the URI path that is usually built from the uriPathSegments of each node, a document can be given a full, unique, custom URI path.
Installation
composer require flownative/neos-customdocumenturirouting
Configuration
After installing the package, by default it looks for a property called uriPath
in document nodes.
The uriPath
property can be added to your document nodes by using the provided
Flownative.Neos.CustomDocumentUriRouting:UriPathMixin
.
The used mixin node type name and property name can be changed in the settings, if you like to use a different name:
Flownative:
Neos:
CustomDocumentUriRouting:
mixinNodeTypeName: 'Acme.Product:UriPathMixin'
uriPathPropertyName: 'myCustomUriPathProperty'
Make sure that, if you configure a custom mixin node type name, that node type actually provides a property with the
name you defined in uriPathPropertyName
.
Excluding paths from matching
In order to exclude specific request paths (e.g. public resources), the matchExcludePatterns
setting exists. All given array values will skip the matching process for request paths that start
with the value. The default shipped with the package is:
Neos:
CustomDocumentUriRouting:
matchExcludePatterns:
- '_Resources'
Any URI starting with _Resources
will be ignored by the package and passed through.
A note about performance
This package provides a custom node route part handler which will check if the current HTTP request matches a given uri path. The route part handler uses a Flow Query to do that. If the Flow Query finds too many nodes, because the criteria is too broad, frontend and backend performance can suffer, especially if your content repository contains thousands of nodes.
Therefore try to limit possible matches to a minimum: only use the configured mixin in those node types
which actually need them. For example, if you have a custom "Landing Page" node type, you may want to
define the CustomDocumentUriRoutingMixin
as a super type. But what you won't do is assign that mixin
to the Neos.Neos:Document
node type - because that would match all possible document nodes in the system.
Credits
Development of this package has been sponsored by web&co OG, Vienna, Austria.