Introduction

Table of Contents

What does it do?

This TYPO3 extension is an add-on to the schema extension. It provides additional schema.org terms related to bibliography: https://schema.org/docs/bib.home.html.

For more information about the schema extension have a look into the documentation.

The schema.org vocabulary

The schema.org vocabulary is evolving, approx. every 2-3 times a year a new version is released. The TYPO3 extensions are updated when changes are made to the according vocabulary. The classes for the type models and view helpers are generated by the schema-generator library.

Release management

This extension uses semantic versioning which basically means for you, that

  • Bugfix updates (for example, 1.0.0 => 1.0.1) just includes small bug fixes or security relevant stuff without breaking changes.
  • Minor updates (for example, 1.0.0 => 1.1.0) includes new features and smaller tasks without breaking changes.
  • Major updates (for example, 1.0.0 => 2.0.0) breaking changes which can be refactorings, features or bug fixes.

Installation

Target group: Administrators

The recommended way to install this extension is by using Composer. In your Composer-based TYPO3 project root, just type:

composer req brotkrueml/schema-bib
Copied!

and the recent stable version will be installed.

In a legacy installation, you can also install the extension from the TYPO3 Extension Repository (TER).

Developer corner

Target group: Developers, Integrators

Table of Contents

Using the API

The API can be used like described in the schema manual. Use the TypeFactory for instantiating a model type class:

EXT:my_extension/Classes/Controller/MyController.php
<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\Controller;

use Brotkrueml\Schema\Type\TypeFactory;

final class MyController
{
    public function __construct(
        private readonly TypeFactory $typeFactory,
    ) {
    }

    public function doSomething(): void
    {
        // ...

        $comicStory = $this->typeFactory->create('ComicStory');

        // ...
    }
}
Copied!

Using the view helpers

The Fluid view helpers can be used like described in the schema manual:

<schema:type.comicStory
   -id="https://example.org/#some-comic-story"
   name="some comic story"
/>
Copied!

The Fluid namespace schema is the same as for the core vocabulary.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

2.5.0 - 2025-09-09

Added

  • Compatibility with EXT:schema v4

2.4.0 - 2025-04-01

Updated

  • schema.org definition to version 29.0

2.3.0 - 2025-03-12

Changed

  • Switch from RegisterAdditionalTypePropertiesEvent to AdditionalPropertiesInterface

2.2.0 - 2024-11-22

Updated

  • schema.org definition to version 28.1

2.1.0 - 2024-02-04

Added

  • Compatibility with TYPO3 v13

Updated

  • schema.org definition to version 25.0

2.0.0 - 2023-10-23

Added

  • Compatibility with schema version 3

Removed

  • Compatibility with TYPO3 v10
  • Compatibility with PHP < 8.1
  • Compatibility with schema version 1 and 2

1.3.0 - 2023-05-22

Updated

  • schema.org definition to version 19.0

1.2.1 - 2022-12-09

Fixed

  • Type error in event listener for PHP < 7.4

1.2.0 - 2022-11-01

Added

  • Compatibility with TYPO3 v12

Updated

  • schema.org definition to version 15.0

Removed

  • Compatibility with TYPO3 v9

1.1.0 - 2021-07-07

Added

  • Allow usage with EXT:schema v2

Updated

  • schema.org definition to version 13.0

1.0.1 - 2021-04-08

Fixed

  • Register slot for additional properties in TYPO3 v9

1.0.0 - 2021-04-06

Initial release with schema definition version 12.0

Sitemap