grommasdietz / kirby-locale
Locale utilities for Kirby CMS
Package info
github.com/grommasdietz/kirby-locale
Type:kirby-plugin
pkg:composer/grommasdietz/kirby-locale
Requires
- php: ^8.2
- getkirby/composer-installer: ^1.2
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.93
- getkirby/cms: ^5.2
- phpunit/phpunit: ^12.5
- vimeo/psalm: ^6.19.1
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Locale utilities for Kirby CMS adds a Writer mark and an optional dialog select field so editors can tag language-specific fragments and store per-page title locales.
Requirements
- Kirby 5+
- PHP 8.2+
Installation
composer require grommasdietz/kirby-locale
Tip
If you don’t use Composer, you can download this repository and copy it to site/plugins/kirby-locale.
Quickstart
Writer mark
Enable the locale mark on any Writer field by adding it to the field’s marks list:
fields: text: type: writer marks: - locale
The Writer displays the locale mark in the toolbar and highlights tagged segments. Selections get wrapped in <span lang="…">.
Title locales
Activate the title locale selector via grommasdietz.locale.intendedTemplate in site/config/config.php. For a single template:
return [ 'grommasdietz.locale.intendedTemplate' => 'project', ];
See usage for multiple templates, custom locales and API routes.
Documentation
Full reference for usage, contributions and maintenance lives in documentation.
Changelog
See CHANGELOG.md for version history and changes.
Security
See SECURITY.md for security policies and reporting vulnerabilities.
Contributing
See CONTRIBUTING.md for guidance and expectations.
License
MIT © 2025 Grommas Dietz
