klytos-custom-fields

name: klytos-custom-fields description: Guide for creating and managing custom fields and metadata in Klytos CMS. Use when attaching extra data to pages, users, or custom post types, storing metadata on entities, working with the Meta API, or using the Field Manager. Covers two systems: MetaManager for free-form key-value data and FieldManager for structured typed fields with 27 field types, validation rules, and schema enforcement.

Klytos Custom Fields & Metadata

Two Systems

1. MetaManager — Free-form key-value on any entity (flexible, no schema)
2. FieldManager — Structured fields on Custom Post Types (typed, validated, 27 types)

MetaManager (Free-Form)

klytos_get_meta(string $collection, string $entityId, string $key): mixed
klytos_set_meta(string $collection, string $entityId, string $key, mixed $value): void
klytos_delete_meta(string $collection, string $entityId, string $key): bool
klytos_get_all_meta(string $collection, string $entityId): array

Key Convention: plugin_id.key_name

klytos_set_meta('pages', 'about', 'seo-pro.schema_type', 'Organization');
$schema = klytos_get_meta('pages', 'about', 'seo-pro.schema_type'); // 'Organization'
$all = klytos_get_all_meta('pages', 'about'); // ['seo-pro.schema_type' => 'Organization']

Hooks

FieldManager (Structured, 27 Types)

Via MCP

klytos_add_custom_field:

{"post_type_id": "products", "field_id": "price", "field_type": "number", "label": "Price", "required": true, "validation": {"min": 0}}

klytos_add_custom_field (select):

{"post_type_id": "products", "field_id": "condition", "field_type": "select", "label": "Condition", "options": [{"value": "new", "label": "New"}, {"value": "used", "label": "Used"}]}

klytos_add_custom_field (repeater):

{"post_type_id": "products", "field_id": "specs", "field_type": "repeater", "label": "Specs", "sub_fields": [{"field_id": "name", "field_type": "text", "label": "Name"}, {"field_id": "value", "field_type": "text", "label": "Value"}]}

klytos_set_bulk_field_values:

{"post_type_id": "products", "entry_slug": "iphone", "values": {"price": 999, "condition": "new", "specs": [{"name": "Storage", "value": "256GB"}]}}

klytos_update_custom_field / klytos_remove_custom_field / klytos_get_field_types

When to Use Which

Source Files

• Meta manager: core/meta-manager.php
• Field manager: core/post-type-manager.php
• MCP tools: core/mcp/tools/custom-field-tools.php
• Global meta functions: core/helpers-global.php (lines 518-572)