Documentation

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.