WordPress plugin that improves text wrapping for long compound words in languages like German, Norwegian, Swedish, and Dutch.
- CSS hyphenation — Enables native browser hyphenation on frontend content.
- Soft hyphen exceptions — Insert explicit break points via an exception dictionary at render time.
- TeX pattern fallback — Automatic hyphenation using
org_heigl/hyphenatordictionaries for 30+ locales (German, Norwegian (Bokmål/Nynorsk), Danish, Dutch, Swedish, Icelandic, English, Spanish, French, Italian, Portuguese, Polish, Czech, Slovak, Slovenian, Hungarian, and many more). - Locale-aware — Prefix exceptions with a locale (e.g.
nb_NO:digitaliserings-organisasjon). - Case-preserving — Matches exceptions case-insensitively but renders with original casing.
- Non-destructive — Processes at render time; saved post content is never modified.
- Block-aware — Filters Gutenberg blocks and classic
the_contentoutput.
- PHP 8.3+
- WordPress 6.8+
- Download
ps-hyphenate.zip - Upload via
Plugins → Add New → Upload Plugin - Activate via
WordPress Admin → Plugins - Configure exceptions via
Settings → PS Hyphenate
Plugin updates are handled automatically via GitHub. No need to manually download and install updates.
Composer:
composer require soderlind/ps-hyphenateAdd entries in Settings → PS Hyphenate → Exception dictionary.
| Format | Example |
|---|---|
| Explicit | Donaudampfschifffahrtsgesellschaft=Donau-dampf-schiff-fahrts-gesellschaft |
| Visible compound hyphen | nb_NO:personvernforordningen=per-son-vern--for-ord-nin-gen |
| Shorthand | digitaliserings-organisasjon |
| Locale-prefixed | nb_NO:menneske-rettighets-organisasjon |
Single hyphens in the replacement mark soft hyphen positions. Double hyphens mark a soft break before a visible compound hyphen.
This plugin supports automatic updates from GitHub releases via soderlind/wordpress-github-updater.
When a new release is published on GitHub, WordPress will detect and offer the update through the standard plugin update mechanism.
composer install
composer testTests use Pest with Brain Monkey for WordPress function mocks.
GPL-2.0-or-later