#ACKNOWLEDGEMENTS
This is a Drupal 8 rewrite of CER, which was in turn the next generation of Corresponding Node References.
Credit goes to everyone who's worked on CER and CNR in the past!
#DESCRIPTION
CER keeps reference fields in sync. If entity Alice references entity Bob, CER will make Bob back-reference Alice automatically, and it will continue to keep the two in sync if either one is changed or deleted. CER does this by way of “presets”, which are relationships you set up between reference-type fields.
By “reference-type fields”, I mean any kind of field that references an entity.
Out of the box, CER integrates with any core Entity Reference field. (More field integrations are planned).
#DEPENDENCIES
- Entity Reference (In core)
#CREATING PRESETS
CER won’t do anything until you create at least one preset. To create a preset, visit admin/config/content/cer and click “Add corresponding reference”.
- Name your preset so you remember what it's for
- Select the fields and entity bundles you would like to correspond to one another.
- Save the Corresponding Reference, and you're all set!
#THINGS YOU SHOULD KNOW
- There is no upgrade path from previous versions of CER or CNR, but you shouldn't really need one! CER for Drupal 8 doesn't store any additional information about each referenced entity, so simply configure CER after you upgrade your site to D8, and it should continue working.
- Everything CER does, it does in a normal security context. This can lead to unexpected behavior if you’re not aware of it. In other words, if you don’t have the permission to view a specific node, don’t expect CER to be able to reference it when logged in as you. Be mindful of your entity/field permissions!
#ROAD MAP
CER for D8 is still under heavy development. Some of the things you can help contribute to:
- A better configuration UI.
- Synchronization functionality for existing references.
- A plugin system for supporting more field types.
- Bug fixes!
#MAINTAINER
Questions, comments, etc. should be directed to bmcclure ([email protected]).