Documentation
- 1 Getting started
- 2 Integrated fundamentals
- 2.1 Integrated Content Structure
- 2.2 Content types and document types
- 2.3 Integrated Relations
- 2.4 Channels and connectors
- 2.5 Technical architecture
- 2.6 Data and storage
- 2.7 Issue tracking
- 3 Content store
- 4 Blocks
- 5 Multi channel publishing
- 6 Storage
- 7 Themes and templating
- 8 Solr
- 9 Contributing
- 9 Social media
- 9 Users
2.3 Integrated Relations
Integrated allows (admin) users to add relations. A relation can be used to define the relationship between content items, e.g. adding keywords to an article.
Some examples of the use of relations are:
- Link images and videos to an article
- Link keywords, categories and tags to an article, image, or company
This allows Integrated to:
- Reuse images for different articles and use them in article pages and as cover image
- Link keywords, categories and tags to an article, image, or company
- Generate content blocks based on flexible filters
- Show related content
Defining a relation
To define a relation start with the Manage - Relations menu item. A relation can be defined with:
Name | Name to be used when editing content. |
Type | Type of the relation (see next paragraph) |
Sources | Content types which are allowed to use the relation. This are the content types which will have a new field for the relation, to choose the linked items. |
Targets | Content types that are allowed to be linked. |
Multiple | Tells if multiple linked items are allowed for this relation. This is a validation when editing content only, relations are stored in the same way in both situations. |
Required | Tells if it is required to have a minimum of one link on this relation, when editing an item from the source content types |
When adding a relation allowing to add keywords to an article, the Article content type will be the source and the Keyword content type will be the target. This means the Article content type will have a new field for choosing keywords.
Relation types
A relation always has a "type". The type tells about the kind of relation. Integrated offers some build in types:
embedded | Used to link items that should be embedded in the content item. Useful for images, media, etc. |
taxonomy |
Used to link items that tell about the taxonomy of the content, for example Keywords. Taxonomy relations are added as a filter in the content navigator, to allow to create search selections and use it in a content block. Taxonomy items will be included in the meta data of an article, such as the HTML keywords tag. |
commercial |
Used to link commercial information to the content item, such as "Payed listing". Commercial relations are added as a filter in the content navigator. |
cover | Used to link a media item that will be used as a cover image, for content overview pages. |
Other types can be added by any bundle.
Using relations in code
When using relations in code, it is best practice to find linked items by relation type instead of queries on the specific relation. By using the type, the (admin) user keeps the possibility to change relations, without the need to change the code. For further reference see the Use relations in code documentation.