f7media/f7hyphenator

Provides a hyphenator ViewHelper to add ­ to text output

Installs: 0

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

Open Issues: 0

Type:typo3-cms-extension

pkg:composer/f7media/f7hyphenator

1.0.0 2025-10-01 11:40 UTC

This package is auto-updated.

Last update: 2025-10-08 10:02:56 UTC


README

TYPO3 compatibility TYPO3 compatibility

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/