PHPackages                             f7media/f7hyphenator - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. f7media/f7hyphenator

ActiveTypo3-cms-extension[Utility &amp; Helpers](/categories/utility)

f7media/f7hyphenator
====================

Provides a hyphenator ViewHelper to add &amp;shy; to text output

2.0.0(1mo ago)06221[1 issues](https://github.com/f7media/f7hyphenator/issues)GPL-3.0-or-laterPHP

Since Oct 1Pushed 1mo agoCompare

[ Source](https://github.com/f7media/f7hyphenator)[ Packagist](https://packagist.org/packages/f7media/f7hyphenator)[ Docs](https://f7.de)[ RSS](/packages/f7media-f7hyphenator/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (2)Dependencies (6)Versions (3)Used By (0)

[![TYPO3 compatibility](https://camo.githubusercontent.com/d3c77bdf69d29d12ee1445e6056eb84c365f1ec3241d8b69254c1ed4429f15fd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5459504f332d31342e332d6666383730303f6d61784167653d33363030266c6f676f3d7479706f33)](https://get.typo3.org/)

TYPO3 Extension `f7hyphenator`
==============================

[](#typo3-extension-f7hyphenator)

The "f7hyphenator" extension provides a ViewHelper to add `&shy;` word breakpoints based on [vanderlee/phpSyllable](https://github.com/vanderlee/phpSyllable)in Fluid.

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

Features
--------

[](#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
-----

[](#usage)

```
{record.title}
{record.title}
```

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

[](#settings)

ParameterRequiredTypeDefaultDescription`minWordLength`noint0words shorter than this value won't be processed`minTextLength`noint0texts shorter than this value won't be processed at allKnown Issues
------------

[](#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
-------

[](#contact)

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

URL**Repository:****TER:**

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance94

Actively maintained with recent releases

Popularity19

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~244 days

Total

2

Last Release

31d ago

Major Versions

1.0.0 → 2.0.02026-06-02

### Community

Maintainers

![](https://www.gravatar.com/avatar/33aaa09425c6da7f40ec1acda921e72ff2a3bd3e3bde1c70606f99ecb074a594?d=identicon)[f7media](/maintainers/f7media)

---

Top Contributors

[![f7-media-user](https://avatars.githubusercontent.com/u/111432863?v=4)](https://github.com/f7-media-user "f7-media-user (3 commits)")[![shinaio](https://avatars.githubusercontent.com/u/1822563?v=4)](https://github.com/shinaio "shinaio (3 commits)")[![lukaswittenf7](https://avatars.githubusercontent.com/u/158159334?v=4)](https://github.com/lukaswittenf7 "lukaswittenf7 (1 commits)")

---

Tags

frontendtypo3

### Embed Badge

![Health badge](/badges/f7media-f7hyphenator/health.svg)

```
[![Health](https://phpackages.com/badges/f7media-f7hyphenator/health.svg)](https://phpackages.com/packages/f7media-f7hyphenator)
```

###  Alternatives

[typo3/cms-redirects

TYPO3 CMS Redirects - Create manual redirects, list existing redirects and automatically createredirects on slug changes.

167.4M80](/packages/typo3-cms-redirects)[pagemachine/typo3-formlog

Form log for TYPO3

23238.6k8](/packages/pagemachine-typo3-formlog)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

103519.9k53](/packages/friendsoftypo3-content-blocks)[typo3/cms-styleguide

TYPO3 extension to showcase TYPO3 Backend capabilities

106760.3k33](/packages/typo3-cms-styleguide)[wazum/sluggi

TYPO3 extension for URL slug management with inline editing, auto-sync, locking, access control, and redirects

40529.5k](/packages/wazum-sluggi)[xima/xima-typo3-frontend-edit

Frontend Edit - This extension provides an edit button for editors within frontend content elements.

1414.3k](/packages/xima-xima-typo3-frontend-edit)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
