PHPackages                             shel/neos-hyphens - 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 & Helpers](/categories/utility)
4. /
5. shel/neos-hyphens

ActiveNeos-plugin[Utility & Helpers](/categories/utility)

shel/neos-hyphens
=================

A plugin for Neos CMS which provides hyphens for the inline editor

1.6.0(4mo ago)20200.7k↓12.3%6[1 PRs](https://github.com/Sebobo/Shel.Neos.Hyphens/pulls)1GPL-3.0JavaScriptCI passing

Since May 23Pushed 4mo ago2 watchersCompare

[ Source](https://github.com/Sebobo/Shel.Neos.Hyphens)[ Packagist](https://packagist.org/packages/shel/neos-hyphens)[ GitHub Sponsors](https://github.com/sebobo)[ Patreon](https://www.patreon.com/shelzle)[ RSS](/packages/shel-neos-hyphens/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (20)Used By (1)

Hyphens CKEditor5 plugin for Neos CMS
=====================================

[](#hyphens-ckeditor5-plugin-for-neos-cms)

[![Latest Stable Version](https://camo.githubusercontent.com/679d3e12e3fccdb6541db91eb7d0c79cc42662d17a9920eb7f5297d0e96f8d52/68747470733a2f2f706f7365722e707567782e6f72672f7368656c2f6e656f732d68797068656e732f762f737461626c65)](https://packagist.org/packages/shel/neos-hyphens)[![Total Downloads](https://camo.githubusercontent.com/b0c1fa1ec21e9c767bf9acf56aec294698b2633beb2ea3a6afaddb9d7d82e039/68747470733a2f2f706f7365722e707567782e6f72672f7368656c2f6e656f732d68797068656e732f646f776e6c6f616473)](https://packagist.org/packages/shel/neos-hyphens)[![License](https://camo.githubusercontent.com/5087b41ef1f9d9789b2f210add97fe8cc531c0e68dd7137cb720679407b63f8e/68747470733a2f2f706f7365722e707567782e6f72672f7368656c2f6e656f732d68797068656e732f6c6963656e7365)](https://packagist.org/packages/shel/neos-hyphens)

Introduction
------------

[](#introduction)

This package provides a button to insert soft hyphens and non-breaking spaces for the inline editor in Neos CMS.

Many browsers support some kind of hyphenation via CSS, but it doesn't work reliably on all systems and not with all languages. See the [CanIuse](https://caniuse.com/#feat=css-hyphens) table for details.

Therefore this package provides a manual way to insert them. You should be careful with using the CSS-based hyphenation in combination with the manual hyphens as results can be unexpected.

It's compatible with Neos CMS 4.3, 5, 7 and 8 but only the active Neos LTS versions receive new bug fixes.

Example
-------

[](#example)

In the backend, this plugin will add the option to add soft hyphens. They will look like this while editing:

[![Visible hyphens while editing](Documentation/neos-backend-hyphens.jpg)](Documentation/neos-backend-hyphens.jpg)

And in the frontend will convert this:

[![Unwanted hyphenation without soft hyphens](Documentation/neos-frontend-before.jpg)](Documentation/neos-frontend-before.jpg)

Into this:

[![Expected hyphenation](Documentation/neos-frontend-after.jpg)](Documentation/neos-frontend-after.jpg)

And in action:

[![Expected hyphenation](Documentation/example.gif)](Documentation/example.gif)

Advantages
----------

[](#advantages)

- Your editors gain control over word breaks.
- Stores the special character in the database with their UTF8 representation, which the browser interprets as `­`.
- You don't need other characters which you replace with correct characters in the frontend.
- Should work fine with Elasticsearch and other search engines.

### Planned features

[](#planned-features)

See [enhancement issue list](https://github.com/Sebobo/Shel.Neos.Hyphens/issues?utf8=%E2%9C%93&q=is%3Aissue+label%3Aenhancement+).

Installation
------------

[](#installation)

Run this in your site package

```
composer require --no-update shel/neos-hyphens
```

Then run `composer update` in your project directory.

How to use
----------

[](#how-to-use)

### Hyphen

[](#hyphen)

Enable it for a node with editable text like this:

```
'Neos.NodeTypes:Text':
  properties:
    text:
      ui:
        inline:
          editorOptions:
            hyphens: true
```

This will add a new button to insert a soft hyphen. As an alternative, you can use the shortcut `Ctrl + Shift + -` to add a new soft hyphen. To change the shortcut keys, have a look at the [Settings.yaml](Configuration/Settings.yaml#L12) file.

### Non-breaking space

[](#non-breaking-space)

Enable it for a node with editable text like this:

```
'Neos.NodeTypes:Text':
  properties:
    text:
      ui:
        inline:
          editorOptions:
            nbsp: true
```

This will add a new button to insert a non-breaking space.

Customization
-------------

[](#customization)

### Hyphen & non-breaking space styling in the backend

[](#hyphen--non-breaking-space-styling-in-the-backend)

You can provide your own styling by referencing your own stylesheet. See the file `Override.Page.fusion` on how the default styling is included.

You can either override the configuration from your own package and just use your stylesheet or you can add yours and use both.

Contributions
-------------

[](#contributions)

Contributions are very welcome!

Please create detailed issues and PRs.

**If you use this package and want to support or speed up it's development, [get in touch with me](mailto:hyphens@helzle.it).**

Or you can also support me directly via [patreon](https://www.patreon.com/shelzle).

License
-------

[](#license)

See [License](./LICENSE.txt)

###  Health Score

56

—

FairBetter than 98% of packages

Maintenance78

Regular maintenance activity

Popularity44

Moderate usage in the ecosystem

Community20

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 78.3% of commits — single point of failure

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 ~143 days

Recently: every ~247 days

Total

18

Last Release

123d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5c9f106db319e8698dcb4aedfe8034f0442d379ebbd78fcd67b884999b2236f1?d=identicon)[Sebobo](/maintainers/Sebobo)

---

Top Contributors

[![Sebobo](https://avatars.githubusercontent.com/u/596967?v=4)](https://github.com/Sebobo "Sebobo (65 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (7 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (4 commits)")[![jonnitto](https://avatars.githubusercontent.com/u/4510166?v=4)](https://github.com/jonnitto "jonnitto (3 commits)")[![Benjamin-K](https://avatars.githubusercontent.com/u/3098031?v=4)](https://github.com/Benjamin-K "Benjamin-K (2 commits)")[![rolandschuetz](https://avatars.githubusercontent.com/u/735982?v=4)](https://github.com/rolandschuetz "rolandschuetz (1 commits)")[![so-grimm](https://avatars.githubusercontent.com/u/119854907?v=4)](https://github.com/so-grimm "so-grimm (1 commits)")

---

Tags

hacktoberfestinsert-hyphensnbspneos-cmssoft-hyphenseditorCKEditorflowNeosneoscmshyphens

### Embed Badge

![Health badge](/badges/shel-neos-hyphens/health.svg)

```
[![Health](https://phpackages.com/badges/shel-neos-hyphens/health.svg)](https://phpackages.com/packages/shel-neos-hyphens)
```

###  Alternatives

[shel/neos-colorpicker

A plugin for Neos CMS which provides a colorpicker editor

1494.4k6](/packages/shel-neos-colorpicker)[techdivision/ckstyles

Neos package which enables you adding your custom style classes for the CkEditor with a simple Yaml configuration

21166.3k](/packages/techdivision-ckstyles)[moc/notfound

Neos CMS package that loads a normal editable page for displaying a 404 error

18167.5k](/packages/moc-notfound)[carbon/includeassets

Include your assets (css, js) in an easy way into Neos

14228.6k10](/packages/carbon-includeassets)[shel/neos-workspace-module

An alternative workspace module with additional features for Neos CMS

1738.6k1](/packages/shel-neos-workspace-module)[shel/neos-terminal

Neos CMS Ui terminal for running Eel expressions and other commands

1441.3k](/packages/shel-neos-terminal)

PHPackages © 2026

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