# erdnaxelaweb/ibexadesignintegration architecture

> Architecture diagram of the GitHub repository erdnaxelaweb/ibexadesignintegration, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/erdnaxelaweb/ibexadesignintegration
- Repository: https://github.com/erdnaxelaweb/ibexadesignintegration

## Overview

Ibexa Design Integration is a CMS bridge that turns Ibexa data into template-friendly values and supports static design development. The principal dynamic workflow renders a pager UI, requests its API, builds search results from pager definitions and filters, then returns normalized results with cache tags. Content, blocks, taxonomy, fake-data generation, component rendering, and Twig integration are additional documented capabilities. Edges reflect explicit source-index references, excerpts, or README statements; unsampled subsystems are included where supported, without inferring their internal calls.

Main entry points: [`lib/Pager/PagerBuilder.php`](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Pager/PagerBuilder.php) (Pager Builder), [`bundle/Controller/Api/PagerController.php`](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/bundle/Controller/Api/PagerController.php) (Pager API), [`lib/Transformer/ContentTransformer.php`](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Transformer/ContentTransformer.php) (Content Transformer), [`bundle/Controller/PagerRenderController.php`](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/bundle/Controller/PagerRenderController.php) (Pager Renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pager["Pager Search"]
  node_render["Pager Renderer"]
  node_search_app["Search App"]
  node_api["Pager API"]
  node_pager_builder["Pager Builder<br/>[PagerBuilder.php]"]
  node_pager_defs["Pager Definitions"]
  node_filter_defs["Filter Definitions"]
  node_filter_transformer["Filter Definition Transformer"]
  node_filter_chain["Filter Chain"]
  node_filter_handlers["Filter Handlers"]
  node_sort_chain["Sort Handlers"]
  node_search_types["Search Types"]
  node_search_data["Search Data<br/>[SearchData.php]"]
  node_pager_response["Pager Response"]
end

subgraph group_content["Content Abstraction"]
  node_content_transform["Content Transformer"]
  node_field_transform["Field Transformers"]
  node_content_value["Content Values<br/>[Content.php]"]
  node_content_fields["Content Fields"]
  node_content_model["Content Model"]
  node_taxonomy["Taxonomy Support"]
end

subgraph group_design["Static Design Bridge"]
  node_block_transform["Block Transformers"]
  node_block_attributes["Block Attribute Transformers"]
  node_fake_generation["Fake Data Generators"]
  node_components["Components"]
  node_twig["Twig Rendering<br/>[Renderer.php]"]
  node_twig_extension["Twig Functions<br/>[Extension.php]"]
end

subgraph group_integration["CMS Integration"]
  node_definitions["Definition Configuration<br/>[Configuration.php]"]
  node_document_parser["Document Result Parser"]
  node_document_adapter["Document Search Adapter"]
  node_search_fields["Search Field Resolver"]
  node_definition_generators["Definition Generators"]
end

node_visitor(("Template / Request"))
node_ibexa["Ibexa CMS"]
node_cache[("HTTP Cache")]

node_visitor -->|"requests render"| node_render
node_render -->|"fetches HTML"| node_search_app
node_render -->|"generates API URL"| node_api
node_visitor -.->|"requests pager data"| node_api
node_api -->|"builds pager"| node_pager_builder
node_api -->|"normalizes form"| node_pager_response
node_api -->|"adds cache tags"| node_cache
node_api -->|"loads definition"| node_pager_defs
node_pager_builder -->|"reads definition"| node_pager_defs
node_pager_builder -->|"uses search type"| node_search_types
node_pager_builder -->|"creates search data"| node_search_data
node_pager_defs -->|"contains filters"| node_filter_defs
node_filter_transformer -->|"creates definitions"| node_filter_defs
node_filter_transformer -->|"configures handlers"| node_filter_chain
node_filter_chain -->|"dispatches filters"| node_filter_handlers
node_filter_chain -->|"resolves criteria"| node_filter_defs
node_pager_builder -.->|"uses filters"| node_filter_chain
node_pager_builder -.->|"uses sorting"| node_sort_chain
node_pager_builder -.->|"searches CMS"| node_ibexa
node_content_transform -->|"transforms fields"| node_field_transform
node_content_transform -->|"creates values"| node_content_value
node_content_value -->|"extends model"| node_content_model
node_content_transform -->|"fills fields"| node_content_fields
node_content_transform -.->|"loads CMS data"| node_ibexa
node_ibexa -.->|"transforms content"| node_content_transform
node_taxonomy -.->|"adapts taxonomy"| node_ibexa
node_block_transform -.->|"transforms attributes"| node_block_attributes
node_fake_generation -->|"supplies fake pager"| node_api
node_components -.->|"renders components"| node_twig
node_twig_extension -->|"uses content values"| node_content_value
node_twig -->|"dispatches pager render"| node_render
node_definitions -->|"configures integration"| node_ibexa
node_document_adapter -->|"parses results"| node_document_parser
node_document_parser -->|"reads configuration"| node_definitions
node_search_fields -.->|"resolves search fields"| node_ibexa
node_definition_generators -.->|"generates definitions"| node_definitions

click node_render "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/bundle/Controller/PagerRenderController.php"
click node_api "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/bundle/Controller/Api/PagerController.php"
click node_pager_builder "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Pager/PagerBuilder.php"
click node_pager_defs "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Definition/PagerDefinition.php"
click node_filter_defs "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Definition/PagerFilterDefinition.php"
click node_filter_transformer "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Definition/Transformer/PagerFilterDefinitionTransformer.php"
click node_filter_chain "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Pager/Filter/ChainFilterHandler.php"
click node_filter_handlers "https://github.com/erdnaxelaweb/ibexadesignintegration/tree/main/lib/Pager/Filter/Handler"
click node_sort_chain "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Pager/Sort/ChainSortHandler.php"
click node_search_types "https://github.com/erdnaxelaweb/ibexadesignintegration/tree/main/lib/Pager/SearchType"
click node_search_data "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Value/SearchData.php"
click node_pager_response "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Normalizer/FormViewNormalizer.php"
click node_content_transform "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Transformer/ContentTransformer.php"
click node_field_transform "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Transformer/FieldValueTransformer.php"
click node_content_value "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Value/Content.php"
click node_content_fields "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Value/ContentFieldsCollection.php"
click node_content_model "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Value/AbstractContent.php"
click node_taxonomy "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Transformer/TaxonomyEntryTransformer.php"
click node_block_transform "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Transformer/BlockTransformer.php"
click node_block_attributes "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Transformer/BlockAttributeValueTransformer.php"
click node_fake_generation "https://github.com/erdnaxelaweb/ibexadesignintegration/tree/main/lib/Fake"
click node_components "https://github.com/erdnaxelaweb/ibexadesignintegration/tree/main/lib/Component"
click node_twig "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Twig/Renderer.php"
click node_twig_extension "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Templating/Twig/Extension.php"
click node_definitions "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/bundle/DependencyInjection/Configuration.php"
click node_document_parser "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Document/DocumentSearchResultParser.php"
click node_document_adapter "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Value/DocumentSearchAdapter.php"
click node_search_fields "https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Document/SearchFieldResolver.php"
click node_definition_generators "https://github.com/erdnaxelaweb/ibexadesignintegration/tree/main/lib/Service"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_render,node_search_app,node_api,node_pager_builder,node_pager_defs,node_filter_defs,node_filter_transformer,node_filter_chain,node_filter_handlers,node_sort_chain,node_search_types,node_search_data,node_pager_response toneBlue
class node_content_transform,node_field_transform,node_content_value,node_content_fields,node_content_model,node_taxonomy,node_cache toneAmber
class node_block_transform,node_block_attributes,node_fake_generation,node_components,node_twig,node_twig_extension,node_visitor toneMint
class node_definitions,node_document_parser,node_document_adapter,node_search_fields,node_definition_generators toneRose
class node_ibexa toneIndigo
```

## Components

### Pager Search

- [Pager Renderer](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/bundle/Controller/PagerRenderController.php): `bundle/Controller/PagerRenderController.php`
- **Search App**
- [Pager API](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/bundle/Controller/Api/PagerController.php): `bundle/Controller/Api/PagerController.php`
- [Pager Builder](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Pager/PagerBuilder.php): `lib/Pager/PagerBuilder.php`
- [Pager Definitions](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Definition/PagerDefinition.php): `lib/Definition/PagerDefinition.php`
- [Filter Definitions](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Definition/PagerFilterDefinition.php): `lib/Definition/PagerFilterDefinition.php`
- [Filter Definition Transformer](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Definition/Transformer/PagerFilterDefinitionTransformer.php): `lib/Definition/Transformer/PagerFilterDefinitionTransformer.php`
- [Filter Chain](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Pager/Filter/ChainFilterHandler.php): `lib/Pager/Filter/ChainFilterHandler.php`
- [Filter Handlers](https://github.com/erdnaxelaweb/ibexadesignintegration/tree/main/lib/Pager/Filter/Handler): `lib/Pager/Filter/Handler`
- [Sort Handlers](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Pager/Sort/ChainSortHandler.php): `lib/Pager/Sort/ChainSortHandler.php`
- [Search Types](https://github.com/erdnaxelaweb/ibexadesignintegration/tree/main/lib/Pager/SearchType): `lib/Pager/SearchType`
- [Search Data](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Value/SearchData.php): `lib/Value/SearchData.php`
- [Pager Response](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Normalizer/FormViewNormalizer.php): `lib/Normalizer/FormViewNormalizer.php`

### Content Abstraction

- [Content Transformer](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Transformer/ContentTransformer.php): `lib/Transformer/ContentTransformer.php`
- [Field Transformers](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Transformer/FieldValueTransformer.php): `lib/Transformer/FieldValueTransformer.php`
- [Content Values](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Value/Content.php): `lib/Value/Content.php`
- [Content Fields](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Value/ContentFieldsCollection.php): `lib/Value/ContentFieldsCollection.php`
- [Content Model](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Value/AbstractContent.php): `lib/Value/AbstractContent.php`
- [Taxonomy Support](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Transformer/TaxonomyEntryTransformer.php): `lib/Transformer/TaxonomyEntryTransformer.php`

### Static Design Bridge

- [Block Transformers](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Transformer/BlockTransformer.php): `lib/Transformer/BlockTransformer.php`
- [Block Attribute Transformers](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Transformer/BlockAttributeValueTransformer.php): `lib/Transformer/BlockAttributeValueTransformer.php`
- [Fake Data Generators](https://github.com/erdnaxelaweb/ibexadesignintegration/tree/main/lib/Fake): `lib/Fake`
- [Components](https://github.com/erdnaxelaweb/ibexadesignintegration/tree/main/lib/Component): `lib/Component`
- [Twig Rendering](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Twig/Renderer.php): `lib/Twig/Renderer.php`
- [Twig Functions](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Templating/Twig/Extension.php): `lib/Templating/Twig/Extension.php`

### CMS Integration

- [Definition Configuration](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/bundle/DependencyInjection/Configuration.php): `bundle/DependencyInjection/Configuration.php`
- [Document Result Parser](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Document/DocumentSearchResultParser.php): `lib/Document/DocumentSearchResultParser.php`
- [Document Search Adapter](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Value/DocumentSearchAdapter.php): `lib/Value/DocumentSearchAdapter.php`
- [Search Field Resolver](https://github.com/erdnaxelaweb/ibexadesignintegration/blob/main/lib/Document/SearchFieldResolver.php): `lib/Document/SearchFieldResolver.php`
- [Definition Generators](https://github.com/erdnaxelaweb/ibexadesignintegration/tree/main/lib/Service): `lib/Service`

### Other components

- **Template / Request**
- **Ibexa CMS**
- **HTTP Cache**

## Connections

- Template / Request → Pager Renderer: requests render
- Pager Renderer → Search App: fetches HTML (evidence: `bundle/Controller/PagerRenderController.php`)
- Pager Renderer → Pager API: generates API URL (evidence: `bundle/Controller/PagerRenderController.php`)
- Template / Request → Pager API: requests pager data
- Pager API → Pager Builder: builds pager (evidence: `bundle/Controller/Api/PagerController.php`)
- Pager API → Pager Response: normalizes form (evidence: `bundle/Controller/Api/PagerController.php`)
- Pager API → HTTP Cache: adds cache tags (evidence: `bundle/Controller/Api/PagerController.php`)
- Pager API → Pager Definitions: loads definition (evidence: `bundle/Controller/Api/PagerController.php`)
- Pager Builder → Pager Definitions: reads definition (evidence: `lib/Pager/PagerBuilder.php`)
- Pager Builder → Search Types: uses search type (evidence: `lib/Pager/PagerBuilder.php`)
- Pager Builder → Search Data: creates search data (evidence: `lib/Pager/PagerBuilder.php`)
- Pager Definitions → Filter Definitions: contains filters (evidence: `lib/Definition/PagerDefinition.php`)
- Filter Definition Transformer → Filter Definitions: creates definitions (evidence: `lib/Definition/Transformer/PagerFilterDefinitionTransformer.php`)
- Filter Definition Transformer → Filter Chain: configures handlers (evidence: `lib/Definition/Transformer/PagerFilterDefinitionTransformer.php`)
- Filter Chain → Filter Handlers: dispatches filters (evidence: `lib/Pager/Filter/ChainFilterHandler.php`)
- Filter Chain → Filter Definitions: resolves criteria (evidence: `lib/Pager/Filter/ChainFilterHandler.php`)
- Pager Builder → Filter Chain: uses filters
- Pager Builder → Sort Handlers: uses sorting
- Pager Builder → Ibexa CMS: searches CMS
- Content Transformer → Field Transformers: transforms fields (evidence: `lib/Transformer/ContentTransformer.php`)
- Content Transformer → Content Values: creates values (evidence: `lib/Transformer/ContentTransformer.php`)
- Content Values → Content Model: extends model (evidence: `lib/Value/Content.php`)
- Content Transformer → Content Fields: fills fields (evidence: `lib/Transformer/ContentTransformer.php`)
- Content Transformer → Ibexa CMS: loads CMS data
- Ibexa CMS → Content Transformer: transforms content
- Taxonomy Support → Ibexa CMS: adapts taxonomy
- Block Transformers → Block Attribute Transformers: transforms attributes
- Fake Data Generators → Pager API: supplies fake pager (evidence: `bundle/Controller/Api/PagerController.php`)
- Components → Twig Rendering: renders components
- Twig Functions → Content Values: uses content values (evidence: `lib/Templating/Twig/Extension.php`)
- Twig Rendering → Pager Renderer: dispatches pager render (evidence: `lib/Twig/Renderer.php`)
- Definition Configuration → Ibexa CMS: configures integration
- Document Search Adapter → Document Result Parser: parses results (evidence: `lib/Value/DocumentSearchAdapter.php`)
- Document Result Parser → Definition Configuration: reads configuration (evidence: `lib/Document/DocumentSearchResultParser.php`)
- Search Field Resolver → Ibexa CMS: resolves search fields
- Definition Generators → Definition Configuration: generates definitions
