Content Fragment Models

Content Fragment Models define the structure of content for your content fragments.

Enable Content Fragment Models

To enable content fragment models you need to:

• Enable the use of content fragment models in the Configuration Browser
• Apply the configuration to your Assets folder

Enable Content Fragment Models in Configuration Manager

To create a new Content Fragment Model you must first enable them using the Configuration Manager:

1. Navigate to Tools, General, then open the Configuration Browser.

2. Select the location appropriate to your website.

3. Use Create to open the dialog, where you:

   1. Specify a Title.
   2. Select Content Fragment Models to enable their use.

   

4. Select Create to save the definition.

Apply the Configuration to your Assets Folder

When the configuration global is enabled for content fragment models, then any models that users create can be used in any Assets folder.

To use other configurations (i.e. excluding global) with a comparable Assets folder, then you have to define the connection. This is done using Configuration in the Cloud Services tab of the Folder Properties of the appropriate folder.

Creating a Content Fragment Model

1. Navigate to Tools, Assets, then open Content Fragment Models.

2. Navigate to the folder appropriate to your configuration.

3. Use Create to open the wizard.

   CAUTION

   If the use of content fragment models have not been enabled, the Create option will not be available.

4. Specify the Model Title. You can also add a Description if required.

   

5. Use Create to save the empty model. A message will indicate the success of the action, you can select Open to immediately edit the model, or Done to return to the console.

Defining your Content Fragment Model

The content fragment model effectively defines the structure of the resulting content fragments. Using the model editor you can add, and configure, the required fields:

1. Navigate to Tools, Assets, then open Content Fragment Models.

2. Navigate to the folder holding your content fragment model.

3. Open the required model for Edit; use either the quick action, or select the model and then the action from the toolbar.

   Once open the model editor shows:

   • left: fields already defined
   • right: Data Types available for creating fields (and Properties for use once fields have been created)
   NOTE

   When a field as Required, the Label indicated in the left pane will be marked with an asterix (*).

   

4. To Add a Field

   • Drag a required data type to the required location for a field:

   

   • Once a field has been added to the model, the right panel will show the Properties that can be defined for that particular data type. Here you can define what is required for that field. For example:

   

   NOTE

   For the data type Multi line text it is possible to define the Default Type as either:

   • Rich Text

   • Markdown

   • Plain Text

   If not specified, the default value Rich Text is used for this field.

   Changing the Default Type in a content fragment model will only take effect on an existing, related, content fragment after that fragment is opened in the editor and saved.

5. To Remove a Field

   Select the required field, then click/tap the trash-can icon. You will be asked to confirm the action.

   

6. After adding all required fields, and defining the properties, use Save to persist the definition. For example:

   

Deleting a Content Fragment Model

To delete a content fragment model:

1. Navigate to Tools, Assets, then open Content Fragment Models.

2. Navigate to the folder holding your content fragment model.

3. Select your model, followed by Delete from the toolbar.

   NOTE

   If the model is referenced a warning will be given. Take action appropriately.

Publishing a Content Fragment Model

Content fragment models need to be published when/before any dependent content fragments are published.

To publish a content fragment model:

1. Navigate to Tools, Assets, then open Content Fragment Models.

2. Navigate to the folder holding your content fragment model.

3. Select your model, followed by Publish from the toolbar.

   NOTE

   If you publish a content fragment for which the model has not yet been published, a selection list will indicate this and the model will be published with the fragment.