PHP Class Neos\ContentRepository\Domain\Model\NodeType

Although methods contained in this class belong to the public API, you should not need to deal with creating or managing node types manually. New node types should be defined in a NodeTypes.yaml file.
Show file Open project: neos/neos-development-collection Class Usage Examples

Protected Properties

Property Type Description
$abstract boolean Is this node type marked abstract
$declaredSuperTypes array<\Neos\ContentRepository\Domain\Model\NodeType> node types this node type directly inherits from
$final boolean Is this node type marked final
$fullConfiguration array Full configuration for this node type, can be an arbitrarily nested array. Includes any inherited configuration.
$initialized boolean Whether or not this node type has been initialized (e.g. if it has been postprocessed)
$localConfiguration array Configuration for this node type, can be an arbitrarily nested array. Does not include inherited configuration.
$name string Name of this node type. Example: "ContentRepository:Folder"
$nodeLabelGenerator Neos\ContentRepository\Domain\Model\NodeDataLabelGeneratorInterface | Neos\ContentRepository\Domain\Model\NodeLabelGeneratorInterface
$nodeTypeManager Neos\ContentRepository\Domain\Service\NodeTypeManager
$objectManager Neos\Flow\ObjectManagement\ObjectManagerInterface

Public Methods

Method Description
__call ( string $methodName, array $arguments ) : mixed Magic get* and has* method for all properties inside $configuration.
__construct ( string $name, array $declaredSuperTypes, array $configuration, array $fullConfiguration = null ) Constructs this node type
__toString ( ) : string Alias for getName().
allowsChildNodeType ( NodeType $nodeType ) : boolean Checks if the given NodeType is acceptable as sub-node with the configured constraints, not taking constraints of auto-created nodes into account. Thus, this method only returns the correct result if called on NON-AUTO-CREATED nodes!
allowsGrandchildNodeType ( string $childNodeName, NodeType $nodeType ) : boolean Checks if the given $nodeType is allowed as a childNode of the given $childNodeName (which must be auto-created in $this NodeType).
getAutoCreatedChildNodes ( ) : array Return an array with child nodes which should be automatically created
getConfiguration ( string $configurationPath ) : mixed Returns the configuration option with the specified $configurationPath or NULL if it does not exist
getDeclaredSuperTypes ( ) : array Returns the direct, explicitly declared super types of this node type.
getDefaultValuesForProperties ( ) : array Return an array with the defined default values for each property, if any.
getFullConfiguration ( ) : array Get the full configuration of the node type. Should only be used internally.
getLabel ( ) : string Get the human-readable label of this node type
getLocalConfiguration ( ) : array Get the local configuration of the node type. Should only be used internally.
getName ( ) : string Returns the name of this node type
getNodeLabelGenerator ( ) : Neos\ContentRepository\Domain\Model\NodeLabelGeneratorInterface Return the node label generator class for the given node
getOptions ( ) : array Get additional options (if specified)
getProperties ( ) : array Return the array with the defined properties. The key is the property name, the value the property configuration. There are no guarantees on how the property configuration looks like.
getPropertyType ( string $propertyName ) : string Returns the configured type of the specified property
hasConfiguration ( string $configurationPath ) : boolean Checks if the configuration of this node type contains a setting for the given $configurationPath
isAbstract ( ) : boolean Return boolean TRUE if marked abstract
isAggregate ( ) : boolean Returns whether this node type (or any parent type) is an *aggregate*.
isFinal ( ) : boolean Return boolean TRUE if marked final
isOfType ( string $nodeType ) : boolean If this node type or any of the direct or indirect super types has the given name.

Protected Methods

Method Description
addInheritedSuperTypes ( array &$superTypes, NodeType $superType ) : void Recursively add super types
applyPostprocessing ( ) : void Iterates through configured postprocessors and invokes them
buildFullConfiguration ( ) : void Builds the full configuration by merging configuration from the supertypes into the local configuration.
buildInheritanceChain ( ) : array Returns a flat list of super types to inherit from.
initialize ( ) : void Initializes this node type
isNodeTypeAllowedByConstraints ( NodeType $nodeType, array $constraints ) : boolean Internal method to check whether the passed-in $nodeType is allowed by the $constraints array.
isNodeTypeAllowedByDirectConstraints ( NodeType $nodeType, array $constraints ) : boolean
isNodeTypeAllowedByInheritanceConstraints ( NodeType $nodeType, array $constraints ) : boolean | null This method loops over the constraints and finds node types that the given node type inherits from. For all matched super types, their super types are traversed to find the closest super node with a constraint which is used to evaluated if the node type is allowed. It finds the closest results for true and false, and uses the distance to choose which one wins (lowest). If no result is found the node type is allowed.
traverseSuperTypes ( NodeType $currentNodeType, string $constraintNodeTypeName, integer $distance ) : integer This method traverses the given node type to find the first super type that matches the constraint node type.

Method Details

__call() public method

Magic get* and has* method for all properties inside $configuration.
Deprecation: Use hasConfiguration() or getConfiguration() instead
public __call ( string $methodName, array $arguments ) : mixed
$methodName string
$arguments array
return mixed

__construct() public method

Constructs this node type
public __construct ( string $name, array $declaredSuperTypes, array $configuration, array $fullConfiguration = null )
$name string Name of the node type
$declaredSuperTypes array Parent types of this node type
$configuration array the configuration for this node type which is defined in the schema
$fullConfiguration array

__toString() public method

Alias for getName().
public __toString ( ) : string
return string

addInheritedSuperTypes() protected method

Recursively add super types
protected addInheritedSuperTypes ( array &$superTypes, NodeType $superType ) : void
$superTypes array
$superType NodeType
return void

allowsChildNodeType() public method

Otherwise, allowsGrandchildNodeType() needs to be called on the *parent node type*.
public allowsChildNodeType ( NodeType $nodeType ) : boolean
$nodeType NodeType
return boolean TRUE if the $nodeType is allowed as child node, FALSE otherwise.

allowsGrandchildNodeType() public method

Only allowed to be called if $childNodeName is auto-created.
public allowsGrandchildNodeType ( string $childNodeName, NodeType $nodeType ) : boolean
$childNodeName string The name of a configured childNode of this NodeType
$nodeType NodeType The NodeType to check constraints for.
return boolean TRUE if the $nodeType is allowed as grandchild node, FALSE otherwise.

applyPostprocessing() protected method

Iterates through configured postprocessors and invokes them
protected applyPostprocessing ( ) : void
return void

buildFullConfiguration() protected method

Builds the full configuration by merging configuration from the supertypes into the local configuration.
protected buildFullConfiguration ( ) : void
return void

buildInheritanceChain() protected method

Returns a flat list of super types to inherit from.
protected buildInheritanceChain ( ) : array
return array

getAutoCreatedChildNodes() public method

Return an array with child nodes which should be automatically created
public getAutoCreatedChildNodes ( ) : array
return array the key of this array is the name of the child, and the value its NodeType.

getConfiguration() public method

Returns the configuration option with the specified $configurationPath or NULL if it does not exist
public getConfiguration ( string $configurationPath ) : mixed
$configurationPath string The name of the configuration option to retrieve
return mixed

getDeclaredSuperTypes() public method

Note: NULL values are skipped since they are used only internally.
public getDeclaredSuperTypes ( ) : array
return array

getDefaultValuesForProperties() public method

The default value is configured for each property under the "default" key.

getFullConfiguration() public method

Instead, use the hasConfiguration()/getConfiguration() methods to check/retrieve single configuration values.
public getFullConfiguration ( ) : array
return array

getLabel() public method

Get the human-readable label of this node type
public getLabel ( ) : string
return string

getLocalConfiguration() public method

Note: post processing is not applied to this.
public getLocalConfiguration ( ) : array
return array

getName() public method

Returns the name of this node type
public getName ( ) : string
return string

getNodeLabelGenerator() public method

Return the node label generator class for the given node
public getNodeLabelGenerator ( ) : Neos\ContentRepository\Domain\Model\NodeLabelGeneratorInterface
return Neos\ContentRepository\Domain\Model\NodeLabelGeneratorInterface

getOptions() public method

Get additional options (if specified)
public getOptions ( ) : array
return array

getProperties() public method

Return the array with the defined properties. The key is the property name, the value the property configuration. There are no guarantees on how the property configuration looks like.
public getProperties ( ) : array
return array

getPropertyType() public method

Returns the configured type of the specified property
public getPropertyType ( string $propertyName ) : string
$propertyName string Name of the property
return string

hasConfiguration() public method

Checks if the configuration of this node type contains a setting for the given $configurationPath
public hasConfiguration ( string $configurationPath ) : boolean
$configurationPath string The name of the configuration option to verify
return boolean

initialize() protected method

Initializes this node type
protected initialize ( ) : void
return void

isAbstract() public method

Return boolean TRUE if marked abstract
public isAbstract ( ) : boolean
return boolean

isAggregate() public method

The most prominent *aggregate* is a Document and everything which inherits from it, like a Page. If a node type is marked as aggregate, it means that: - the node type can "live on its own", i.e. can be part of an external URL - when moving this node, all node variants are also moved (across all dimensions) - Recursive copying only happens *inside* this aggregate, and stops at nested aggregates.
public isAggregate ( ) : boolean
return boolean TRUE if the node type is an aggregate

isFinal() public method

Return boolean TRUE if marked final
public isFinal ( ) : boolean
return boolean

isNodeTypeAllowedByConstraints() protected method

$constraints is an associative array where the key is the Node Type Name. If the value is "TRUE", the node type is explicitly allowed. If the value is "FALSE", the node type is explicitly denied. If nothing is specified, the fallback "*" is used. If that one is also not specified, we DENY by default. Super types of the given node types are also checked, so if a super type is constrained it will also take affect on the inherited node types. The closest constrained super type match is used.
protected isNodeTypeAllowedByConstraints ( NodeType $nodeType, array $constraints ) : boolean
$nodeType NodeType
$constraints array
return boolean

isNodeTypeAllowedByDirectConstraints() protected method

protected isNodeTypeAllowedByDirectConstraints ( NodeType $nodeType, array $constraints ) : boolean
$nodeType NodeType
$constraints array
return boolean TRUE if the passed $nodeType is allowed by the $constraints

isNodeTypeAllowedByInheritanceConstraints() protected method

This method loops over the constraints and finds node types that the given node type inherits from. For all matched super types, their super types are traversed to find the closest super node with a constraint which is used to evaluated if the node type is allowed. It finds the closest results for true and false, and uses the distance to choose which one wins (lowest). If no result is found the node type is allowed.
protected isNodeTypeAllowedByInheritanceConstraints ( NodeType $nodeType, array $constraints ) : boolean | null
$nodeType NodeType
$constraints array
return boolean | null if no constraint matched

isOfType() public method

If this node type or any of the direct or indirect super types has the given name.
public isOfType ( string $nodeType ) : boolean
$nodeType string
return boolean TRUE if this node type is of the given kind, otherwise FALSE

traverseSuperTypes() protected method

In case the hierarchy has more than one way of finding a path to the node type it's not taken into account, since the first matched is returned. This is accepted on purpose for performance reasons and due to the fact that such hierarchies should be avoided.
protected traverseSuperTypes ( NodeType $currentNodeType, string $constraintNodeTypeName, integer $distance ) : integer
$currentNodeType NodeType
$constraintNodeTypeName string
$distance integer
return integer or NULL if no NodeType matched

Property Details

$abstract protected property

Is this node type marked abstract
protected bool $abstract
return boolean

$declaredSuperTypes protected property

node types this node type directly inherits from
protected array<\Neos\ContentRepository\Domain\Model\NodeType> $declaredSuperTypes
return array<\Neos\ContentRepository\Domain\Model\NodeType>

$final protected property

Is this node type marked final
protected bool $final
return boolean

$fullConfiguration protected property

Full configuration for this node type, can be an arbitrarily nested array. Includes any inherited configuration.
protected array $fullConfiguration
return array

$initialized protected property

Whether or not this node type has been initialized (e.g. if it has been postprocessed)
protected bool $initialized
return boolean

$localConfiguration protected property

Configuration for this node type, can be an arbitrarily nested array. Does not include inherited configuration.
protected array $localConfiguration
return array

$name protected property

Name of this node type. Example: "ContentRepository:Folder"
protected string $name
return string

$nodeLabelGenerator protected property

protected NodeDataLabelGeneratorInterface,Neos\ContentRepository\Domain\Model|NodeLabelGeneratorInterface,Neos\ContentRepository\Domain\Model $nodeLabelGenerator
return Neos\ContentRepository\Domain\Model\NodeDataLabelGeneratorInterface | Neos\ContentRepository\Domain\Model\NodeLabelGeneratorInterface

$nodeTypeManager protected property

protected NodeTypeManager,Neos\ContentRepository\Domain\Service $nodeTypeManager
return Neos\ContentRepository\Domain\Service\NodeTypeManager

$objectManager protected property

protected ObjectManagerInterface,Neos\Flow\ObjectManagement $objectManager
return Neos\Flow\ObjectManagement\ObjectManagerInterface