f7media/f7hyphenator

Provides a hyphenator ViewHelper to add ­ to text output

1.0.0 2025-10-01 11:40 UTC

Requires

• typo3/cms-core: ^12.4 || ^13.4
• typo3fluid/fluid: ^2.7 || ^4.0
• vanderlee/syllable: 1.*

GPL-3.0-or-later

• Marc Willmann
• Simon Pritzkat-Gerthenrich
• Patricia Tiedemann

• frontend
• typo3

README

TYPO3 Extension f7hyphenator

The "f7hyphenator" extension provides a ViewHelper to add ­ word breakpoints based on vanderlee/phpSyllable in Fluid.

This helps ensuring that longer words break up more nicely inside their containers when displayed in responsive layout.

Features

• plain and simple: a Fluid ViewHelper to use wherever you need it
• Language is automatically set based on current context of rendered FE page
• Alternatively you could also use the stateless service inside php

Usage

<f7:hyphenator>{record.title}</f7:hyphenator>
<f7:hyphenator minTextLength="8" minWordLength="12">{record.title}</f7:hyphenator>

Alternative inline notation and enchaining

{record.title -> f7:hyphenator()}
{record.title -> f7:hyphenator(minWordLength: 12)}
{record.title -> f7:hyphenator() -> f:format.stripTags()}

If needed, you could also directly call the stateless service directly from PHP:

use F7\F7hyphenator\Service\HyphenationService;

$hyphenatedText = HyphenationService::hyphenateString($text, $minWordLength, $minTextLength);

Settings

Parameter	Required	Type	Default	Description
minWordLength	no	int	0	words shorter than this value won't be processed
minTextLength	no	int	0	texts shorter than this value won't be processed at all

Known Issues

• Blacklist is currently hardcoded in HyphenationService
• Blacklisted words are not recognised in dash-separated words (e.g. blacklisted "TYPO3" in "TYPO3-Website")

Contact

For any inquiries or support requests, please contact F7 Media GmbH.

	URL
Repository:	https://github.com/f7media/f7hyphenator/
TER:	https://extensions.typo3.org/extension/f7hyphenator/