Rebirth your orphaned nodes
This package can help you to move orphaned node in the Neos Content Repository., (*1)
Warning: Working with broken / orphaned nodes can be hard, please backup your data before using this package., (*2)
Currently this package supports only document nodes restoration. That means you can only restore documents
including their content (and further children), but not only content that has been orphaned., (*3)
How to use ?
- Optional: For each site where you want to restore orphaned nodes, you can create a "Trash" node. This can be
used as the automatically detected target for document node restoration.
- Go to the CLI and run the restore command.
CLI commands
List the current orphaned document nodes
flow rebirth:list
List the current orphaned nodes for a specific type
flow rebirth:list --type Neos.Neos:Document
Restore everything under the "Trash" node of the current site
flow rebirth:restore
Note: if you have no Trash node, this will fail with the message Missing restoration target for the current
node. Either create a Trash node or specify the target node using --target
., (*4)
Restore everything under the "Trash" node of the current site, only for the given type
flow rebirth:restore --type Neos.Neos:Document
Restore everything under the given target node
flow rebirth:restore --target f34f834b-c36b-43eb-a580-f0e2f168b241
Prune all orphaned document nodes
flow rebirth:prune
Prune all orphaned document nodes for a specific type
flow rebirth:prune --type Neos.Neos:Document
Troubleshooting
If you get the message Missing restoration target for the current node even though a Trash node has been
created, make sure you have a Trash node matching the context of the nodes to be restored. Specifically check
the content dimensions. You must have a Trash node that can be found in the same dimension value combination
as the node to be restored., (*5)
Acknowledgments
Development sponsored by ttree ltd - neos solution provider., (*6)
We try our best to craft this package with a lots of love, we are open to
sponsoring, support request, ... just contact us., (*7)
License
Licensed under MIT, see LICENSE, (*8)