The Reference component is used to have a single source for a piece of content and reference it within multiple pages. The single source allows for the content to be updated in one place and then changes display everywhere that content is referenced. The component can reference another component or set of components to display their content.
The Title and Options configuration dialog contains the following options:
- Component Title - text input field that does not display for this component but useful for giving the component a title for keeping track of what it is used for on the page
- CSS Class - text input field for custom CSS and/or utility classes
- Reference - text input and path selector for a /content/... path for content item
- Display Title - select pulldown used to choose None, Title, and Title with Link options for displaying the referenced component title
Once in place, you cannot edit the text within a referenced component. To make changes, go to the page where the original content appears and make updates. Those changes will appear wherever the reference component has been placed. However, you will need to republish any page on each site that uses the reference for that site to update referenced content.
The reference component is used to feature content from one page to another within your site. It can be used multiple times to display the same content on numerous pages. It supports a principle called Don't Repeat Yourself (DRY) which means that if the same content is created more than once, it is likely the mutliple copies will get out of sync.
- Saves the author from copy/pasting content across multiple pages
- The user can browse Ensemble for the desired content
- Optional title for the source content with link
Title and Options
Component Title- Title of Component
CSS Class- CSS class to be applied to the component
Reference- Browse for the page or page contents to reference
Display Title- Choose whether to display the title, optionally with a link to the original page
Title With Link