Make hyphens easier in Neos CMS

Installs: 18 213

Dependents: 0

Suggesters: 0

Security: 0

Stars: 2

Watchers: 2

Forks: 4

Open Issues: 1


3.2.0 2023-05-29 16:50 UTC

This package is auto-updated.

Last update: 2024-03-29 18:46:09 UTC


Latest stable version Total downloads License GitHub forks GitHub stars GitHub watchers

Carbon.Hyphen Package for Neos CMS

Make hyphens easier

Optional word-breaks are hard to enter in Neos CMS. This package provides a Fusion wrapper for phpSyllable


composer require carbon/hyphen



Just use the Carbon.Hyphen:Text Fusion object as a processor or wrapper on the Fusion value that should be hyphenated.

superlongValue = 'supercalifragilisticexpialidocious'
superlongValue.@process.hyphenate = Carbon.Hyphen:Text {
  locale = 'en-gb'


Similar to text elements you can use Carbon.Hyphen:Html for HTML elements.

someFusionHtml.@process.hyphenate = Carbon.Hyphen:Html

Neos CMS integration example

You can easily activate hyphenation for all Neos CMS text- and headline nodetypes with following Fusion code:

prototype(Foo.Bar:Content.Text) {
  renderer.@process.hyphenate = Carbon.Hyphen:Html

prototype(Foo.Bar:Content.Headline) {
  title.@process.hyphenate = Carbon.Hyphen:Text

or directly on a specific parameter:

prototype(Foo.Bar:Component) {
    headline = Neos.Neos:Editable {
        property = 'headline'
        block = false

    renderer = afx`


locale (string) : Reference to the language in which the given string will be hyphenated
(Have a look at syllable languages for a reference of available languages)

threshold (integer, default = 0) : Minimum amount characters a word needs to have, before it is being hyphenated.

Custom language mappings

Probably you've got a language defined that is not available in syllable. For example, en is not available, but en-gb is. Because of that, you can map your language preset to another syllable language: Per default following settings are set in Settings.Carbon.yaml:

    # Throw exception if no hyphen definition is found
    throwException: true
      en: en-gb
      de-de: de
      de-at: de


This implementation was heavily inspired by packagefactory/hyphenate.