README

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

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.

Feedback and Support

You can reach us on the TYPO3 Slack channel #cig-structuredcontent. We appreciate any constructive feedback and will help you, if you have any problems.

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

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

friendsoftypo3 / content-blocks

Maintainers

Details