soderlind/ps-hyphenate

WordPress plugin that improves wrapping of long compound words with native hyphenation and optional render-time soft hyphen exceptions.

Maintainers

Package info

github.com/soderlind/ps-hyphenate

Type:wordpress-plugin

pkg:composer/soderlind/ps-hyphenate

Statistics

Installs: 16

Dependents: 0

Suggesters: 0

Stars: 1

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

1.0.2 2026-05-06 05:49 UTC

Requires

Requires (Dev)

GPL-2.0-or-later ad9a3b3a77f41febb4d37e5b7c3e8ab8df24f91a

  • Per Soderlind

This package is auto-updated.

Last update: 2026-05-06 05:49:58 UTC

README

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

Screenshot 2026-05-06 at 01 14 03

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.

Format Example
Explicit Donaudampfschifffahrtsgesellschaft=Donau-dampf-schiff-fahrts-gesellschaft
Shorthand digitaliserings-organisasjon
Locale-prefixed nb_NO:menneske-rettighets-organisasjon

Hyphens in the replacement mark soft hyphen positions.

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