punktde / nodereplicator
Replicate Neos node structure and content to other content dimensions
Installs: 3 603
Dependents: 0
Suggesters: 0
Security: 0
Stars: 7
Watchers: 9
Forks: 6
Open Issues: 6
Type:neos-package
Requires
- neos/neos: ^5.0 || ^7.0 || ^8.0
README
This package provides an additional option for the NodeType configuration to automatically update this node in other dimensions.
The problem, this package solves
Scenario: On a multi language page, without configured fallbacks, you want to show addresses. The addresses are content nodes. An address entry should reference a country and a category. Country and categories should be content nodes too. While the title of a category and country needs to be translated for every language, the address itself stays the same for every language.
The problem: As soon, as you translate the page which contains the content nodes from language A to language B, you are no longer able to add nodes in both languages which have the same identifier. Without fallback you would need to add an address on every language separately with the references to the corresponding nodes.
The solution: This package adds a configuration option to the node type configuration called replication
. Which allows you to specify if a node should be automatically replicated to all dimensions where the parent node already exists and also if the content in the alternative dimensions should be updated on change.
Configuration
Options:
'Vendor.Package:Address': superTypes: 'Neos.Neos:Content': true ... options: replication: structure: // Replicate the node itself into the other dimension if the parent exists and the node is missing, default: false create: true // Create the node as hidden, default: false createHidden: true // Also delete the node in other dimensions, default: false remove: true // Defaults for all properties of this nodeType properties: // defaults false update: true // default false, takes precedence of update updateEmptyOnly: true properties: myProperty: options: replication: // default inherited from node level config update: false // default inherited from node level config updateEmptyOnly: false
Example Configuration:
'Vendor.Package:Address': superTypes: 'Neos.Neos:Content': true ... options: replication: structure: create: true properties: update: true 'Vendor.Package:AddressCategory': superTypes: 'Neos.Neos:Content': true ... options: replication: structure: create: true 'Vendor.Package:AnotherAddressCategory': superTypes: 'Neos.Neos:Content': true ... options: replication: structure: create: true properties: updateEmptyOnly: true 'Vendor.Package:TranslateableCategory': superTypes: 'Neos.Neos:Content': true ... options: replication: structure: createHidden: true properties: updateEmptyOnly: true # Disable a single property 'Vendor.Package:YetAnotherAddressCategory': superTypes: 'Neos.Neos:Content': true ... options: replication: structure: create: true properties: update: true properties: metaDescription: options: replication: update: false