docs.modx.pro
  1. Extras
  2. PageBuilder
  3. Section catalog
  4. Pro
  5. Structured content

Structured content ​

Alternative to Rich text for long reads. Block editor: H2–H4, lists, quotes, inline images.

Structured content

Информация

Requires PageBuilder Pro.

Editor.js instead of richtext ​

  • Editor.js blocks: headings, lists, quotes without hand HTML
  • JSON in the section data, HTML from chunk on output
  • Better than richtext for long posts

Long-form content ​

  • Blog post inside page builder
  • Longread on a landing page
  • News with rich layout without hand-written HTML

Page examples ​

Editor.js field ​

editorjs stores block JSON. The chunk renders HTML inside .pb-richtext__content.

Similar sections ​

  • Rich text for short HTML snippets
  • Tabs to split topics, not linear longreads

Block parameters ​

ParameterValue
keystructured_content
LayerPro
Categorycontent (content)
Chunkpagebuilderpro_structured_content
Requirespro

Inspector fields ​

Fill these fields in the section inspector. Field types are documented in the field types reference.

Title (title) ​

Type text. Optional.

Content (body) ​

Type editorjs. Required. Block editor. Site output is HTML.

Site output ​

HTML from editorjs inside .pb-richtext__content.

Section data ​

Example payload after save. Media, video, and map values may be enriched on output:

json
{
  "title": "Section title",
  "body": {
    "json": {},
    "html": "<p>Structured Editor.js content</p>"
  }
}

Chunk template ​

Fenom chunk pagebuilderpro_structured_content:

fenom
{set $bodyHtml = ''}
{if $body is array}
  {set $bodyHtml = $body.html|default:''}
{else}
  {set $bodyHtml = $body}
{/if}
<section class="pb-section pb-section--structured-content pb-structured-content pb-richtext{if $cssClass} {$cssClass|escape}{/if}" data-pb-section="structured_content"{if $id} id="pb-{$id|escape}"{/if}>
  <div class="pb-section__inner pb-structured-content__inner pb-richtext__inner">
    {if $title}
      <h2 class="pb-heading pb-structured-content__title">{$title|escape}</h2>
    {/if}
    {if $bodyHtml}
      <div class="pb-richtext__content pb-structured-content__body">
        {$bodyHtml}
      </div>
    {/if}
  </div>
</section>

See also ​