Handling "Content Body"

What is the content body?
The content body is actually the filling of the Article/Video/Gallery it contains the text, widgets, embeds all of the nitty gritty things that will help with the creation of amazing engaging content.

To further understand how to create a proper body structure you need to follow these steps

How the content body is structured
The different types of content blocks

How the content body is structured

The body of the Article/Video/Gallery consists of an array “blocks“, there are different types of blocks representing different type of data like: paragraphs, lists, tables, widgets, content (articles/videos/galleries/etc.).

A block of data will look like the following:

{
  "data": {
    "content":<some content>
  },
  "id": string,
  "type": string
}

What the developers should be interested in is the “content“ field. The “content“ field contains the information needed to render the block in whatever way they see fit. All the other information stored in the block is mainly meta-data that is used to optimize the CMS.

Use of the meta-data when developing the client product must be avoided, as it could be changed in the future.

The blocks are not validated, so whatever data is uploaded as a block it will be stored on the server, be careful when uploading data, because if the block is not valid, it will not be visualized by the CMS front-end or it will be displayed as erroneous.

The different types of content blocks

As of this moment the CMS supports 39 different blocks.

They are divided in three categories: Text, Widget and Content

Text blocks

Paragraph

{
    "id": "qrMdhd",
    "data": {
        "type": "paragraph",
        "content": "<p>Sample</p>",
        "placeholderName": "qrMdhd"
    },
    "type": "editor_block"
}

Heading

{
    "id": "SACxpc",
    "data": {
        "type": "heading",
        "content": "<h2>Sample</h2>",
        "placeholderName": "SACxpc"
    },
    "type": "editor_block"
}

Quote

List

Table

Widget blocks

Odds

Team profile

Team Players

Player profile

Match

Top Scorers

Standings

Player H2H

Team comparison

Match list

Team form

Most decorated players

Player career

Squad statistics

Content blocks

!IMPORTANT

Unlike other content blocks, the main data for the Content blocks are all of the fields except the changeId and preview.

As you may notice they hold and id field which is going to be used to request the article when rendering the content. The reason the id to be the only one provided in the block is that objects like: Article, Video, Gallery, Image, Banner and Poll are complex objects and could contain a lot of data, which will cause huge information to be transferred.

Article

Gallery

The main information that is required for the render on the front-end side is the: id and main_image_id.

The main_image_id is the cover image which was selected for the gallery.

Image

The main information that is required for the render on the front-end side is the id, description.

Video

Embed

The main information that is required for the render on the front-end side is in the content field.

To be able to differentiate between different types of embeds: Video/Social the embed_type is used.

Highlight

The main fields that are required to render Highlight are: title and description

Link

The main fields that are required to render the Link are: link, text, linkType, open_type

Banner

Poll