PHPackages                             itplusx/headless-container - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [PSR &amp; Standards](/categories/psr-standards)
4. /
5. itplusx/headless-container

ActiveTypo3-cms-extension[PSR &amp; Standards](/categories/psr-standards)

itplusx/headless-container
==========================

Container Content Elements (EXT:container) json output for EXT:headless

v3.0.0(10mo ago)014.7k↓22.5%7[1 PRs](https://github.com/itplusx/headless-container/pulls)MITPHPPHP ^8.1

Since Jan 5Pushed 10mo ago2 watchersCompare

[ Source](https://github.com/itplusx/headless-container)[ Packagist](https://packagist.org/packages/itplusx/headless-container)[ Docs](https://itplusx.de)[ RSS](/packages/itplusx-headless-container/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (3)Versions (8)Used By (0)

TYPO3 Extension `headless_container`
====================================

[](#typo3-extension-headless_container)

This TYPO3 extension makes it possible to use [EXT:container](https://github.com/b13/container) together with [EXT:headless](https://github.com/TYPO3-Initiatives/headless/).

Installation
------------

[](#installation)

### Installation with [`composer`](https://getcomposer.org/) (recommended)

[](#installation-with-composer-recommended)

```
$ composer require itplusx/headless-container
```

### Installation with the TYPO3 Extension Manager

[](#installation-with-the-typo3-extension-manager)

see: [Extension Management](https://docs.typo3.org/m/typo3/reference-coreapi/12.4/en-us/ExtensionArchitecture/HowTo/ExtensionManagement.html#installing-extensions)

Requirements and compatibility
------------------------------

[](#requirements-and-compatibility)

Requirementv1 &amp; v2v3PHP&gt;= 8.1&gt;= 8.1TYPO312.4 &amp; 13.412.4 &amp; 13.4[Headless](https://github.com/TYPO3-Headless/headless)44[Container](https://github.com/b13/container)2 - 3.1.1&gt;= 3.1.2Usage
-----

[](#usage)

1. Include TypoScript *([as described by the TypoScript Reference](https://docs.typo3.org/m/typo3/reference-typoscript/11.5/en-us/UsingSetting/Entering.html#include-typoscript-from-extensions))* or just add the Site Set to your Site Configuration *([as described by the Site sets Reference](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/SiteHandling/SiteSets.html#site-set-definition))*
2. Register your custom container element *([as described by EXT:container](https://github.com/b13/container/tree/2.0.5#registration-of-container-elements))*
3. Define TypoScript ...
    *(assuming you CType is `b13-2cols-with-header-container`)*
    - ... for simple container elements: ```
        tt_content.b13-2cols-with-header-container =< lib.container

        ```
    - ... for container elements with header TCA fields: ```
        tt_content.b13-2cols-with-header-container =< lib.containerWithHeader

        ```
    - ... for container elements with custom TCA fields:
        *(see [EXT:headless docs](https://docs.typo3.org/p/friendsoftypo3/headless/3.1/en-us/Developer/Index.html#create-custom-content-elements)for further info)*```
        tt_content.b13-2cols-with-header-container =< lib.container
        tt_content.b13-2cols-with-header-container.fields.content.fields {
          myCustomField = TEXT
          myCustomField.field = myCustomTcaField
        }

        ```
4. That's all! You should now see JSON output for your custom container element!

Example json output
-------------------

[](#example-json-output)

```
{
  "id": 2,
  "type": "b13-2cols-with-header-container",
  "colPos": 0,
  "categories": "",
  "appearance": {
    "layout": "default",
    "frameClass": "default",
    "spaceBefore": "",
    "spaceAfter": ""
  },
  "content": {
    "header": "Container Header",
    "subheader": "Container Subheader",
    "headerLayout": 0,
    "headerPosition": "",
    "headerLink": "",
    "myCustomField": "myCustomValue",
    "items": [
      {
        "config": {
          "name": "header",
          "colPos": 200
        },
        "contentElements": [
          {
            "id": 3,
            "type": "text",
            "colPos": 200,
            "categories": "",
            "appearance": {...},
            "content": {...}
          }
        ]
      },
      {
        "config": {
          "name": "left side",
          "colPos": 201
        },
        "contentElements": [
          {
            "id": 4,
            "type": "text",
            "colPos": 201,
            "categories": "",
            "appearance": {...},
            "content": {...}
          },
          {
            "id": 9,
            "type": "text",
            "colPos": 201,
            "categories": "",
            "appearance": {...},
            "content": {...}
          }
        ]
      },
      {
        "config": {
          "name": "right side",
          "colPos": 202
        },
        "contentElements": [
          {
            "id": 5,
            "type": "text",
            "colPos": 202,
            "categories": "",
            "appearance": {...},
            "content": {...}
          }
        ]
      }
    ]
  }
}
```

Contribution
------------

[](#contribution)

Any help on this project is very welcome! May it be as code contribution or just an idea for improvement. But we would like to ask you to follow some rules:

- **Issues:**
    When adding issues please always describe the bug/feature/task as detailed as possible. Only providing a title is not enough. Please use issue templates.
- **Commits:**
    Our team is following the [Conventional Commits](https://www.conventionalcommits.org/). We would like ask you stick to these rules whenever you want to contribute.
- **Pull Requests:**
    Before you submit a PR please create an issue first and link it to the pull request or at least add a PR description with detailed information about what this PR does. Otherwise we are not able to decide if this PR is worth going into the main branch.

---

 [ ![ITplusX - Internetagentur & Systemhaus](https://camo.githubusercontent.com/14e12de38879bb59be4344f31f58fc5bc6e048280cb75884751c46491af79afa/68747470733a2f2f6974706c7573782e64652f62616e6e6572732f637265617465642d62792d582d776974682d70617373696f6e2e737667) ](https://itplusx.de)

---

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance54

Moderate activity, may be stable

Popularity29

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 77.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~136 days

Total

5

Last Release

321d ago

Major Versions

v1.0.1 → v2.0.02024-01-03

v2.1.0 → v3.0.02025-07-01

PHP version history (2 changes)v1.0.0PHP ^7.4 || ^8.0

v2.0.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/5067c1ccc6c85eb7a689208ba50acbe5999aae1158dfd7603385e5ca93e049ea?d=identicon)[schloram](/maintainers/schloram)

---

Top Contributors

[![schloram](https://avatars.githubusercontent.com/u/13196174?v=4)](https://github.com/schloram "schloram (24 commits)")[![kitzberger](https://avatars.githubusercontent.com/u/1405149?v=4)](https://github.com/kitzberger "kitzberger (3 commits)")[![tobiasquadflieg](https://avatars.githubusercontent.com/u/31917593?v=4)](https://github.com/tobiasquadflieg "tobiasquadflieg (2 commits)")[![cehret](https://avatars.githubusercontent.com/u/5031075?v=4)](https://github.com/cehret "cehret (1 commits)")[![christophlehmann](https://avatars.githubusercontent.com/u/4953689?v=4)](https://github.com/christophlehmann "christophlehmann (1 commits)")

---

Tags

containerheadlesstypo3typo3-cmstypo3-cms-extensiontypo3-containertypo3-extensiontypo3-headless-cmstypo3-headless-container-supporttypo3-v11typo3-v12typo3-v13containerheadlessextensionTYPO3 CMStypo3Container Content Elements

### Embed Badge

![Health badge](/badges/itplusx-headless-container/health.svg)

```
[![Health](https://phpackages.com/badges/itplusx-headless-container/health.svg)](https://phpackages.com/packages/itplusx-headless-container)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
