README

WordPress plugin that improves text wrapping for long compound words in languages like German, Norwegian, Swedish, and Dutch.

Features

• 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/hyphenator dictionaries 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_content output.

Requirements

• PHP 8.3+
• WordPress 6.8+

Installation

1. Download ps-hyphenate.zip
2. Upload via Plugins → Add New → Upload Plugin
3. Activate via WordPress Admin → Plugins
4. 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-hyphenate

Exception Dictionary

Add entries in Settings → PS Hyphenate → Exception dictionary.

Single hyphens in the replacement mark soft hyphen positions. Double hyphens mark a soft break before a visible compound hyphen.

Automatic Updates

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.

Development

composer install
composer test

Tests use Pest with Brain Monkey for WordPress function mocks.

License

GPL-2.0-or-later