README

Level 1: Drop in a field component — click ✎ to edit, save, or cancel:

<twig:K:Entity:Field:String  :entity="user"    property="name" />
<twig:K:Entity:Field:Int     :entity="product" property="stock" />
<twig:K:Entity:Field:Bool    :entity="user"    property="active" />
<twig:K:Entity:Field:Date    :entity="event"   property="startsAt" />
<twig:K:Entity:Field:Enum    :entity="order"   property="status" />

Level 2: Association fields with live search:

<twig:K:Entity:Field:Relationship :entity="product"  property="category" />
<twig:K:Entity:Field:Collection   :entity="post"     property="tags" />

Level 3: Add Symfony Validator constraints to the entity — validation runs automatically before flushing:

#[Assert\NotBlank]
#[Assert\Length(max: 100)]
private ?string $name = null;

Level 4: Control who can edit by overriding EditabilityResolverInterface:

Kachnitel\EntityComponentsBundle\Components\Field\EditabilityResolverInterface:
    alias: App\Field\MyEditabilityResolver

Details: Inline-Edit Guide

Level 1: Implement TagInterface and TaggableInterface, drop in the component:

<twig:K:Entity:TagManager :entity="product" tagClass="App\\Entity\\Tag" />

Level 2: Read-only badge display:

<twig:K:Entity:TagManager :entity="product" tagClass="App\\Entity\\Tag" :readOnly="true" />

Level 3: Colored categories — return a hex color from getCategoryColor() on your Tag entity. Text color is flipped automatically for contrast.

Details: Tags Guide

Level 1: Register a FileHandlerInterface service, implement AttachableInterface, drop in the component:

<twig:K:Entity:AttachmentManager :entity="product" attachmentClass="App\\Entity\\Attachment" />

Level 2: Read-only display, custom collection property:

:config="{ readOnly: true, property: 'media' }"

Level 3: Per-attachment tagging:

:config="{ tagClass: 'App\\Entity\\Tag' }"

Details: Attachments Guide

Level 1: Implement CommentInterface and CommentableInterface, drop in the component:

<twig:K:Entity:CommentsManager :entity="article" commentClass="App\\Entity\\Comment" />

Level 2: Read-only display, custom collection property:

:config="{ readOnly: true, property: 'notes' }"

Level 3: Limit text length — add a MAX_TEXT_LENGTH constant to your Comment entity and the textarea maxlength is set automatically.

Details: Comments Guide

Level 1: Works out of the box for any entity relation or backed enum:

<twig:K:Entity:SelectRelationship :entity="order" property="region" />

Level 2: Access control, placeholder, label:

:config="{
    role: 'ROLE_EDITOR',
    placeholder: '— Select Region —',
}"

Level 3: Filter records or use a custom repository method:

:config="{ filter: { active: true } }"
:config="{ repositoryMethod: 'findActive' }"

Details: SelectRelationship Guide