PHPackages                             grommasdietz/kirby-locale - 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. [Localization & i18n](/categories/localization)
4. /
5. grommasdietz/kirby-locale

ActiveKirby-plugin[Localization & i18n](/categories/localization)

grommasdietz/kirby-locale
=========================

Locale utilities for Kirby CMS

2.1.0(1mo ago)549[1 PRs](https://github.com/grommasdietz/kirby-locale/pulls)MITPHPPHP ^8.2CI passing

Since Oct 11Pushed 1mo agoCompare

[ Source](https://github.com/grommasdietz/kirby-locale)[ Packagist](https://packagist.org/packages/grommasdietz/kirby-locale)[ RSS](/packages/grommasdietz-kirby-locale/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (6)Versions (17)Used By (0)

Kirby Locale
============

[](#kirby-locale)

Locale utilities for [Kirby CMS](https://getkirby.com) adds a Writer mark and an optional dialog select field so editors can tag language-specific fragments and store per-page title locales.

[![Cover image showing an example of the plugin in use](/.github/assets/hero-image.png)](/.github/assets/hero-image.png)

Requirements
------------

[](#requirements)

- Kirby 5+
- PHP 8.2+

Installation
------------

[](#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
----------

[](#quickstart)

### Writer mark

[](#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 ``.

### Title locales

[](#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',
];
```

For multiple templates:

```
return [
    'grommasdietz.locale.intendedTemplate' => [
        'project',
        'note',
    ],
];
```

After configuration, Kirby's create and rename dialogs show the locale dropdown and save the choice as `title_locale`. Retrieve it in templates with `$page->title_locale()`.

### Options

[](#options)

Configure via `site/config/config.php`:

```
return [
    // Custom locales
    'grommasdietz.locale.locales' => [
        ['code' => 'en-GB', 'name' => 'English, United Kingdom'],
        ['code' => 'en-US', 'name' => 'English, United States'],
    ],

    // Optional: disable the ISO fallback catalog
    // 'grommasdietz.locale.catalog' => false,
];
```

### Documentation

[](#documentation)

Full reference for [usage](docs/usage/index.md), [contributions](docs/contributions/index.md) and [maintenance](docs/maintenance/index.md) lives in [documentation](docs/index.md).

---

Changelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md) for version history and changes.

---

Security
--------

[](#security)

See [SECURITY.md](SECURITY.md) for security policies and reporting vulnerabilities.

---

Contributing
------------

[](#contributing)

See [CONTRIBUTING.md](CONTRIBUTING.md) for guidance and expectations.

---

License
-------

[](#license)

[MIT](LICENSE.md) © 2025 Grommas Dietz

###  Health Score

45

—

FairBetter than 92% of packages

Maintenance91

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 81.9% 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 ~16 days

Recently: every ~36 days

Total

11

Last Release

49d ago

Major Versions

v1.0.7 → 2.0.02026-03-12

### Community

Maintainers

![](https://www.gravatar.com/avatar/0bb3d1cab7f30711576ede9d0547977e67d14de0fb70ab1b417ced695bb1d8f6?d=identicon)[grommasdietz](/maintainers/grommasdietz)

---

Top Contributors

[![grommasdietz](https://avatars.githubusercontent.com/u/136818759?v=4)](https://github.com/grommasdietz "grommasdietz (140 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (28 commits)")[![semantic-release-bot](https://avatars.githubusercontent.com/u/32174276?v=4)](https://github.com/semantic-release-bot "semantic-release-bot (3 commits)")

---

Tags

kirbykirby-cmskirby-pluginlocalelocaleslocalelocaleskirbykirby-pluginkirby-cms

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/grommasdietz-kirby-locale/health.svg)

```
[![Health](https://phpackages.com/badges/grommasdietz-kirby-locale/health.svg)](https://phpackages.com/packages/grommasdietz-kirby-locale)
```

###  Alternatives

[laravel-lang/locales

Basic functionality for working with localizations

134.5M12](/packages/laravel-lang-locales)[bnomei/kirby3-janitor

Kirby Plugin for running commands like cleaning the cache from within the Panel, PHP code or a cronjob

9339.9k2](/packages/bnomei-kirby3-janitor)[bnomei/kirby3-feed

Generate a Atom/JSON/RSS-Feed and XML-Sitemap from Pages-Collections

7224.8k](/packages/bnomei-kirby3-feed)[belugadigital/kirby-navigation

Kirby 5 field for hierarchical menus with drag & drop level indentation.

8713.4k](/packages/belugadigital-kirby-navigation)[bnomei/kirby3-dotenv

Kirby Plugin for environment variables from .env

4144.1k1](/packages/bnomei-kirby3-dotenv)[bnomei/kirby3-fingerprint

File Method and css/js helper to add cache-busting hash and optional Subresource Integrity to file

4130.5k1](/packages/bnomei-kirby3-fingerprint)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)