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

Requirement	Version
TYPO3	^13.4 \| ^14.3
PHP	>=8.2

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:

Key	Default	Description
`flippingBookDirectory`	`public/flippingbook/`	Filesystem path relative to the project root

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

Create a new content element and select FlippingBook as the content type.
Select the book from the dropdown.
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.

oliverthiele / ot-flippingbook

Maintainers

Package info

Statistics

Security