johannschopplich/kirby-tools-utils

Shared utility classes for Kirby Tools plugins

0.1.2 2026-05-01 07:41 UTC

Requires (Dev)

• getkirby/cms: ^5
• phpunit/phpunit: ^12

AGPL-3.0-or-later

• Johann Schopplich

Published on Packagist.org on 2026-05-01 07:41 UTC

README

Shared utility classes for Kirby Tools plugins. This package provides common model and field resolution logic used across multiple plugins to avoid ambiguous class resolution when multiple plugins are installed together.

Classes

ModelResolver

Resolves Kirby CMS models from different identifier formats:

• resolveFromId: Resolves a model from a model ID (e.g., site, page-id, file-id)
• resolveFromPath: Resolves a model from a Panel view path (e.g., site, pages/xxx, pages/xxx/files/yyy)

FieldResolver

Resolves blueprint fields from Kirby models:

• resolveModelFields: Creates a Kirby Form from the model's blueprint fields and returns field properties (excluding title, slug, and field values)

FieldNormalizer

Normalizes blueprint field definitions to their base types:

• resolveBaseType: Resolves a custom field type to its standard base type by following the extends chain
• normalizeFields: Normalizes a fields array, recursing into nested fields and fieldsets[*].tabs[*].fields

Used By

• kirby-content-translator
• kirby-copilot
• kirby-minimap

License

AGPL License © 2026-PRESENT Johann Schopplich