oliverthiele/ot-faq

FAQ extension with output of structured data in JSON format.

Maintainers

Details

github.com/oliverthiele/ot_faq

Homepage

Source

Issues

Installs: 7 074

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 2

Forks: 2

Open Issues: 0

Type:typo3-cms-extension

pkg:composer/oliverthiele/ot-faq

v4.0.1 2025-09-17 20:27 UTC

Requires

GPL-2.0-or-later a69221260a6239e6094d89c7c99ea2fda60b95f3

This package is auto-updated.

Last update: 2025-10-17 20:41:05 UTC

README

This TYPO3 extension outputs structured data for an FAQPage.

Installation

Install the extension via Composer:

composer require oliverthiele/ot-faq

Then include the TypoScript in your root template or site-package extension:

Constants:

@import "EXT:ot_faq/Configuration/TypoScript/constants.typoscript"

Setup:

@import "EXT:ot_faq/Configuration/TypoScript/setup.typoscript"

Don’t forget to update the database schema!

Adding FAQs

Add the FAQ plugin once per page. (I deliberately decided not to use IRRE.) The plugin outputs only the headline and defines the position where the FAQs appear. In the TYPO3 List module you can then create the individual questions and answers.

Be sure to follow the Google FAQPage guidelines

By default, the Bootstrap-5–based template renders both the FAQ list and the structured data in JSON-LD format.

New in v4.0.1

  • Supports TYPO3 site sets.
  • PHP 8.4 compatibility.
  • No more deprecated TYPO3 function calls.
  • The DB field pages can again be used for storing FAQs.

New in v4.0.0

  • TCA configuration optimized for TYPO3 v13.

  • The extension is now registered as a CType instead of list_type.

    Use the upgrade wizard to update existing content elements.

New in v3.0.0

  • TCA configuration optimized for TYPO3 v12.

New in v2.0.5:

  • The storagePid (pages field) can now be used in the plugin.

    Make sure no FAQ is output twice.

    If you need to display FAQs on multiple pages, disable structured-data output via the checkbox on one of those pages.

General Notes

  • Each question should be unique across the entire site.
  • Every question must stand on its own and not refer to others.
  • Write questions exactly as a user might ask them (e.g. to Alexa or Siri).
  • Questions should be unique on the whole website.
  • Each question should stand on its own and not refer to the other questions.
  • Questions should be written exactly as they would be asked to Alexa or Siri.

Planned Improvements

  • Add an RTE configuration that allows only a restricted set of HTML tags.

Changes

v3.0.0

  • Dropped support for TYPO3 v11.

v2.0.5

  • Added TYPO3 v12 support.
  • Added support for storing FAQs in folders.
  • Improved code quality.