PHPackages heimrichhannot/contao-hyphenator-bundle - 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. heimrichhannot/contao-hyphenator-bundle ActiveContao-bundle[Utility & Helpers](/categories/utility) heimrichhannot/contao-hyphenator-bundle ======================================= Word-Hyphenation for the contao content-management-system. 1.12.0(8mo ago)11.7k1[2 issues](https://github.com/heimrichhannot/contao-hyphenator-bundle/issues)LGPL-3.0-or-laterPHPPHP ^7.4 || ^8.0CI failing Since Jun 12Pushed 8mo ago5 watchersCompare [ Source](https://github.com/heimrichhannot/contao-hyphenator-bundle)[ Packagist](https://packagist.org/packages/heimrichhannot/contao-hyphenator-bundle)[ Docs](https://github.com/heimrichhannot/contao-hyphenator-bundle)[ RSS](/packages/heimrichhannot-contao-hyphenator-bundle/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (8)Dependencies (8)Versions (43)Used By (0) Contao Hyphenator Bundle ======================== [](#contao-hyphenator-bundle) [![](https://camo.githubusercontent.com/baa9045d83a08353ea6dc0fa12ce8bf3de653f0235bfdec7e38be9a5fe871675/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6865696d7269636868616e6e6f742f636f6e74616f2d68797068656e61746f722d62756e646c652e737667)](https://camo.githubusercontent.com/baa9045d83a08353ea6dc0fa12ce8bf3de653f0235bfdec7e38be9a5fe871675/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6865696d7269636868616e6e6f742f636f6e74616f2d68797068656e61746f722d62756e646c652e737667)[![](https://camo.githubusercontent.com/50d46ee4318294cb39ef496459060a685174fae81ba103730805f2f04abb95ed/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6865696d7269636868616e6e6f742f636f6e74616f2d68797068656e61746f722d62756e646c652e737667)](https://camo.githubusercontent.com/50d46ee4318294cb39ef496459060a685174fae81ba103730805f2f04abb95ed/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6865696d7269636868616e6e6f742f636f6e74616f2d68797068656e61746f722d62756e646c652e737667)[![](https://camo.githubusercontent.com/a947dcf33eef4057ebd4781da4fd2960b0d53154e7c123dcdb927acf7c90fd51/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f6865696d7269636868616e6e6f742f636f6e74616f2d68797068656e61746f722d62756e646c652f6d61737465722e737667)](https://travis-ci.org/heimrichhannot/contao-hyphenator-bundle/)[![](https://camo.githubusercontent.com/54f79329c8eea1387232771cbfc805d7b5895f0c8f4d9e751e840a88e0a34c40/68747470733a2f2f696d672e736869656c64732e696f2f636f766572616c6c732f6865696d7269636868616e6e6f742f636f6e74616f2d68797068656e61746f722d62756e646c652f6d61737465722e737667)](https://coveralls.io/github/heimrichhannot/contao-hyphenator-bundle) A contao bundle that grants server-side hyphenation (thanks to [vanderlee/phpSyllable](https://github.com/vanderlee/phpSyllable)). It does support headlines and paragraphs by default. This module also handles line break exceptions, in order to keep words like company names together and prevent line break (see `tl_page` backend entity). Options ------- [](#options) To extend the functionality, all options can be adjusted within your localconfig. OptionTypeDefaultDescriptionhyphenator\_tagsstring'h1:not(:empty):not(.hyphen-none), h2:not(:empty):not(.hyphen-none), h3:not(:empty):not(.hyphen-none), h4:not(:empty):not(.hyphen-none), h5:not(:empty):not(.hyphen-none), h6:not(:empty):not(.hyphen-none), p:not(:empty):not(.hyphen-none), a:not(:empty):not(.hyphen-none), dt:not(:empty):not(.hyphen-none), dd:not(:empty):not(.hyphen-none)'What type of selectors the hyphenator should look at.hyphenator\_wordMinint10Words under the given length will not be hyphenated altogether.hyphenator\_hyphenedLeftMinint6After hyphenation the resulting left part must have at least this many characters.hyphenator\_hyphenedRightMinint6After hyphenation the resulting right part must have at least this many characters.hyphenator\_hyphenstring­This character shall be used as Hyphen-Character.hyphenator\_skipPagesarrayemptyArray of Contao Page Ids, the Hyphenator should skip from hyphenation.hyphenator\_enableCachebooltrueEnable simple caching and do not hyphenate equal elements twice.hyphenator\_locale\_language\_mappingarray\['en' => 'en-us', 'cz' => 'cs'\]Map locale to hyphenator tex separation pattern dictionarySkip hyphenation ---------------- [](#skip-hyphenation) If you want to skip several tags from hyphenation simply add `hyphen-none` as css-class to the appropriate element or use the `tl_page.hyphenation` field. You also can add tags to be skipped to your project configuration. See configuration reference below Configuration reference ----------------------- [](#configuration-reference) ``` # Default configuration for extension with alias: "huh_hyphenator" huh_hyphenator: # Add tags you want to be skipped from hyphenating, to array (string without ) skip_tags: [] ``` Line break exceptions --------------------- [](#line-break-exceptions) Hyphenator comes with line break exception handling. Simply add `lineBreakExceptions` on `tl_page` and prevent line break for connected word groups like: - Company Names (search: `Heimrich & Hannot(?:\sGmbH)|Heimrich & Hannot(?:s)?`, will be replaced to: `Heimrich & Hannot GmbH`) - Prices and other units (search: `(\d|€)(\s)(\w)`, replace: `$1[nbsp]$3`, Example: `160.000 m²` -> `160.000 m²`, `167 Mio. €` -> `167 Mio. €`) As you can see, if you provide an replace pattern, than an regular expression will handle the replacement, otherwise if only an search pattern is provided, spaces will be protected with ` `. Requirements ------------ [](#requirements) - [vanderlee/phpSyllable](https://github.com/vanderlee/phpSyllable) - [wa72/htmlpagedom](https://github.com/wasinger/htmlpagedom) ### Health Score 42 — FairBetter than 90% of packages Maintenance39 Infrequent updates — may be unmaintained Popularity20 Limited adoption so far Community14 Small or concentrated contributor base Maturity80 Battle-tested with a long release history Bus Factor1 Top contributor holds 52.6% 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 ~66 days Recently: every ~302 days Total 41 Last Release 264d ago PHP version history (3 changes)1.0.0PHP ^7.1 1.11.3PHP ^7.1 || ^8.0 1.12.0PHP ^7.4 || ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/28ad3224d8727b622ebd229840eea6b9dbcb83eb0bd609e6ce65b614830ff538?d=identicon)[digitales@heimrich-hannot.de](/maintainers/digitales@heimrich-hannot.de) --- Top Contributors [![koertho](https://avatars.githubusercontent.com/u/12064642?v=4)](https://github.com/koertho "koertho (10 commits)")[![ericges](https://avatars.githubusercontent.com/u/25957923?v=4)](https://github.com/ericges "ericges (7 commits)")[![AlexejKossmann](https://avatars.githubusercontent.com/u/32612134?v=4)](https://github.com/AlexejKossmann "AlexejKossmann (1 commits)")[![cgoIT](https://avatars.githubusercontent.com/u/8972203?v=4)](https://github.com/cgoIT "cgoIT (1 commits)") --- Tags contaohyphenhyphenator ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/heimrichhannot-contao-hyphenator-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/heimrichhannot-contao-hyphenator-bundle/health.svg)](https://phpackages.com/packages/heimrichhannot-contao-hyphenator-bundle) ``` ### Alternatives [codefog/contao-haste haste extension for Contao Open Source CMS 42650.8k139](/packages/codefog-contao-haste)[madeyourday/contao-rocksolid-custom-elements Create your own, nestable content elements using a modular system. End the WYSIWYG chaos with your own content elements. 50341.9k12](/packages/madeyourday-contao-rocksolid-custom-elements)[codefog/contao-news_categories News Categories bundle for Contao Open Source CMS 3183.3k6](/packages/codefog-contao-news-categories)[terminal42/contao-folderpage Provides a new page type for Contao that allows you to group pages into folders. 18147.9k9](/packages/terminal42-contao-folderpage)[inspiredminds/contao-wowjs Integrates WOW.js for Contao content elements and form fields. 1813.0k](/packages/inspiredminds-contao-wowjs)[pdir/social-feed-bundle Social feed extension for Contao CMS 1414.8k](/packages/pdir-social-feed-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)