Skip to content

FriendsOfTYPO3/content-blocks

Repository files navigation

TYPO3 compatibility TYPO3 compatibility

TYPO3 CMS Content Blocks

This is the standalone repository for the TYPO3 Content Blocks project. Content Blocks provides a new API to create custom Content Types like Content Elements, Page Types or generic Record Types. Use it now in your TYPO3 v12/v13 project and eventually this will become a Core feature in TYPO3 v14 LTS.

URL
Repository: https://github.com/friendsoftypo3/content-blocks
Documentation: https://docs.typo3.org/p/friendsoftypo3/content-blocks/main/en-us/
TER: https://extensions.typo3.org/extension/content_blocks
Packagist: https://packagist.org/packages/friendsoftypo3/content-blocks
Examples: https://github.com/friendsoftypo3/content-blocks/tree/main/Build/content-blocks-examples

Roadmap 2024

Milestone Date
Content Blocks v0.6 26.02
Content Blocks v0.7 01.04
Core patch 01.04 - 23.04
TYPO3 v13.1 23.04
Review period 23.04 - 14.06
TYPO3 v13.2 02.07
Content Blocks compatibility v13 11.07
Content Blocks (partly) Core integration 17.09
Content Blocks 1.0 15.10

Installation

Require this package via composer:

composer req friendsoftypo3/content-blocks

Or install it via the Extension Manager in the TYPO3 backend. The extension key is content_blocks.

Usage

Refer to the Documentation on how to use the Content Blocks API.

JSON Schema

Enable validation and auto-completion with JSON schema

Developing

There is a ddev setup ready to use. Ensure ddev is installed on your machine. Then run:

ddev start
ddev composer install
touch .Build/public/FIRST_INSTALL
ddev launch

The default URL is https://content-blocks.ddev.site/. Continue with the TYPO3 installation process.

Testing

First install the composer dependencies:

composer install

Then run unit or functional tests by executing:

Build/Scripts/runTests.sh -s unit
Build/Scripts/runTests.sh -s functional

Hint

Be sure to exclude the .Build/public/typo3temp directory from indexing in your IDE (e.g. PhpStorm) before starting the tests.

Rendering the documentation

When you update the documentation you can try out rendering it locally (Docker required):

make docs

You can test if the syntax and references are ok with

make test-docs

Feedback

You can reach us on the TYPO3 Slack channel #cig-structuredcontent. We appreciate any constructive feedback.