README

Adds a content element to embed FlippingBook Publisher documents in TYPO3. Catalogs are organised in a two-level folder structure; the backend select shows grouped books automatically.

Features

• TYPO3 v13 and v14 compatible (Site Set ready)
• Embed via the official FlippingBook JavaScript embed script
• Two-level catalog folder structure with grouped backend select
• Configurable base directory via Extension Configuration
• Optional start page per content element (FlexForm)
• TypoScript auto-included via Site Set

Requirements

Installation

composer require oliverthiele/ot-flippingbook

After installation, activate the Site Set "OtFlippingbook" for your site in the TYPO3 backend.

Configuration

Extension Configuration

Set the base directory in the TYPO3 Extension Manager under ot_flippingbook:

Folder Structure

The extension reads two levels of sub-directories. The first level becomes the optgroup label; the second level contains the selectable books:

public/
└── flippingbook/
    ├── catalogs_en/
    │   ├── catalog-2023/
    │   └── catalog-2024/
    └── kataloge_de/
        ├── katalog-2023/
        └── katalog-2024/

The backend select displays the books grouped by their parent folder.

TypoScript

TypoScript is auto-included via the Site Set. For manual integration without Site Set:

@import 'EXT:ot_flippingbook/Configuration/TypoScript/constants.typoscript'
@import 'EXT:ot_flippingbook/Configuration/TypoScript/setup.typoscript'

Usage

1. Create a new content element and select FlippingBook as the content type.
2. Select the book from the dropdown.
3. Optionally enter a start page number.

The extension generates the embed <a> tag and loads the FlippingBook embed.js from the selected book's directory.

License

GPL-2.0-or-later — © 2025 Oliver Thiele