PHPackages                             kesabr/kirby-soft-hyphen - 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. kesabr/kirby-soft-hyphen

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

kesabr/kirby-soft-hyphen
========================

Helper to use a designated character in the panel to create a soft hyphen in the frontend

v1.0.2(yesterday)03↑2900%MITJavaScriptPHP >=8.1.0

Since Jun 9Pushed yesterdayCompare

[ Source](https://github.com/kesabr/kirby-soft-hyphen)[ Packagist](https://packagist.org/packages/kesabr/kirby-soft-hyphen)[ RSS](/packages/kesabr-kirby-soft-hyphen/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (2)Versions (3)Used By (0)

Kirby Soft Hyphen
=================

[](#kirby-soft-hyphen)

[![Kirby 4](https://camo.githubusercontent.com/76f93e94b81de2831e264d3dbb4eb18e82abfa9c34f3409df6c8d3eb787e41a5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4b697262792d342d434630423346)](https://getkirby.com) [![Kirby 5](https://camo.githubusercontent.com/0b9f288bb7703f6aa6d3bdba760ccb12f79e06913dcbfba9df5e3d54e3b98947/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4b697262792d352d434630423346)](https://getkirby.com) [![Packagist](https://camo.githubusercontent.com/3693a6513967eda642416b742e63aaa26cbf4fc3023bd2cb7caf17b7bd5dc7f8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b65736162722f6b697262792d736f66742d68797068656e)](https://packagist.org/packages/kesabr/kirby-soft-hyphen)

Take control of hyphenation — place soft hyphens exactly where you want them, right from the panel. Soft hyphens are invisible in the browser but tell the browser to break and hyphenate at that position when the line is too long. No more relying on automatic hyphenation algorithms that break words in the wrong place.

The plugin adds a **soft hyphen button to the Writer toolbar**.

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

[](#installation)

**Via Composer:**

```
composer require kesabr/kirby-soft-hyphen
```

**Manual:** Drop the `kirby-soft-hyphen` folder into `site/plugins/` of your Kirby project.

Features
--------

[](#features)

- A soft hyphen button for the Writer field.
- Soft hyphens are highlighted inside the Writer.
- `->softHyphen()` field method to clean soft hyphen markup before frontend output.
- `||` shorthand for inserting soft hyphens in text and textarea fields.

Usage
-----

[](#usage)

### Writer field

[](#writer-field)

Add `softHyphen` to the `marks` list of any writer field in your blueprint:

```
fields:
  text:
    type: writer
    marks:
      - bold
      - # your marks
      - softHyphen
```

### Field method `->softHyphen()`

[](#field-method--softhyphen)

Call `->softHyphen()` on any field before outputting it in a template:

```

```

**Writer fields** — The writer stores soft hyphens wrapped in `` for editor visibility. `->softHyphen()` strips those spans so only the bare `­` entity remains in the frontend HTML. The soft hyphens technically work even without this call (the entity is already inside the span), but calling it keeps your markup clean.

**Text / textarea fields** — Type `||` where you want a soft hyphen. `->softHyphen()` is required to convert `||` → `­` in the output.

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance100

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

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

Total

2

Last Release

1d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/109b56b7b0cde41d8c2569ab44ebc14d2b15dd8315b43e12920cd1f72637434a?d=identicon)[kesabr](/maintainers/kesabr)

### Embed Badge

![Health badge](/badges/kesabr-kirby-soft-hyphen/health.svg)

```
[![Health](https://phpackages.com/badges/kesabr-kirby-soft-hyphen/health.svg)](https://phpackages.com/packages/kesabr-kirby-soft-hyphen)
```

###  Alternatives

[distantnative/retour-for-kirby

Manage redirects and track 404s right from the Kirby CMS Panel

14695.1k1](/packages/distantnative-retour-for-kirby)[belugadigital/kirby-navigation

Kirby 5 field for hierarchical menus with drag & drop level indentation.

8613.8k](/packages/belugadigital-kirby-navigation)[medienbaecker/kirby-modules

Easily add modules to your pages

885.4k1](/packages/medienbaecker-kirby-modules)[arnoson/kirby-vite

Vite helper for Kirby CMS

9763.1k3](/packages/arnoson-kirby-vite)[medienbaecker/kirby-alter

241.6k](/packages/medienbaecker-kirby-alter)

PHPackages © 2026

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