Registering content types

Content types are registered from content type schemas that are either created using the schema editor and stored internally, or externally on a web based services such as AWS. Registering a content type and associating it with one or more content repositories makes it available for a user to use to create content.

The Dynamic Content app provides a user interface to make it easier to register and configure content types, including providing support for out of the box icons and content library cards.

On this page we'll walk through the process of registering a content type and how to set up an icon, card and one or more visualizations for that content type.

Slot types are registered in the same way as content types and associated with one or more slot repositories.

The Register content type window

To register a content type, select "content types" from the development tab at the top of the Dynamic Content window. A list of content types registered to this hub will be displayed, with their label and their URL. To register a new content type click the "Register content type button".

Note that you can also register a content type directly from the schema editor window. See the schema editor page for more details.

The content types list
The content types list

The register content type window is displayed. In this example we're adding the tutorial banner content type.

To register a content type you need to provide the URL of a content type schema. Schemas can be created with the schema editor and stored with your Dynamic Content hub, or hosted externally on a service such as AWS or GitHub.

In this example the content type schema was created with the schema editor so we will select "internal" and choose the tutorial banner schema from the list. If the schema is stored externally, choose "external" and enter the URL.

Maximum length of URI

The maximum length of the content type URI is 950 characters.

See the schema editor section for more examples of creating and registering schemas.

Choosing an internal schema for the tutorial banner
Choosing an internal schema for the tutorial banner

You will also need to provide a label- this is used in the content type window in the production view to help identify the type of content to be created. We will give it the label "Tutorial banner".

Registering a content type from the schema editor

You can also register a content type directly from the schema editor.

With your schema open in the schema editor, choose "Save and register as content type" from the schema editor Save menu. If you've already saved your schema, then the menu item will be "Register as a content type".

You can choose to register a content type from the schema editor Save menu
You can choose to register a content type from the schema editor Save menu

The content type registration window will then open, with your schema already selected.

The register content types window opens with the schema selected
The register content types window opens with the schema selected

Enter the content type label and then configure the rest of the fields as explained below.

Choosing an icon

Click "Choose content type icon" to choose an icon for the content type. The content type icon is used to help to visually identify a content type in the create new content window in the production view.

You can add an icon to a content type by providing the URL to a 256x256 pixel image or choosing one of the standard icons. In this case we'll choose the hero banner icon.

Choosing an icon
Choosing an icon

Once you choose an icon, click "Save" to return to the register content type window. For more information about setting content type icons see the icons page.

Configuring a card

A card provides a graphical representation of a piece of content in the Content Library. This makes it easier for users to quickly identify a piece of content when viewing items of this content type in the Content Library.

To configure a card to use with this content type, click the "+" icon in the content type card section.

Adding a card
Adding a card

You can provide the URL to your own custom card or choose from one of our out of the box cards, each providing a different way of representing your content. For this example we'll use the summary photo card. This will display an image with some text underneath.

Each card includes a number of configurable fields that determine how the card content should be displayed. You will map the chosen properties in your content type to the fields displayed on the content card.

For example, the banner type includes properties named "headline" and "background". We want the value of the headline property to be displayed on the card, so we enter "/headline" in the headline field and "/background" for the image.

When content of this type is shown in the content library, the background image will be displayed with the headline text underneath.

Adding the mapping for the card
Adding the mapping for the card

When your chosen card is configured, click the "Save" button to return to the main screen.

For more information about content cards, creating your own cards and mapping fields from linked content see the Cards page.

Enabling the content type on a repository

Before a content type can be used to create content, it must be enabled on at least one content repository. Choose the repositories on which you want to enable the content type from the list of available repositories in the "Associated repositories" section.

In this example there are just two repositories, one for content and one for slots, but each repository within the hub will be displayed. Once a content type has been enabled for a repository, it will be available to use to create content.

Icon and card added
Icon and card added

Registering slot types

If you are registering a slot type, then choose one or more slot repositories on which to register it. See the tutorial banner slot sample for more details of creating and working with slot types.

Setting up visualizations

If you want to provide a visualization for the content type, click the "Add a visualization button" and enter the templated visualization URI in the field provided. Note that you must provide the complete URI, including all the templated variables. Give the visualization a label.

If you want to add an additional visualization, click the "Add a visualization" button again.

Adding a visualization
Adding a visualization

For more information about developing visualizations see the Visualizations page.

Completing the content type registration

Click Save to register the content type with the hub. If the content type is valid, then a message appears indicating that the content type has been registered. Note that an error message will also be displayed if the content type URL is the same as another content type already registered on this hub.

Once registered with the hub, the content type appears in the list. In the image below, the newly added tutorial banner is highlighted.

The tutorial banner type is now registered
The tutorial banner type is now registered

In the production view, the tutorial banner is now available from the content types window and can be used to create content.

The tutorial banner type is now available to use to create content
The tutorial banner type is now available to use to create content

Tutorial banner

Creating content

results matching ""

    No results matching ""