# CBX Documentation

> CBX (ConfigBox) is a product configurator and e-commerce platform by Rovexo, for Joomla, WordPress, Magento 2 and standalone hosts. This index covers version 3.x (released).

Every link below points at the page's markdown source. The same page in HTML is the same url without the trailing `index.md`.

The unreleased 4.0 preview is indexed separately at https://docs.configbox.at/docs/4.0-preview/llms.txt — do not mix the two when answering about a running installation.

## Features

- [CBX — Features](https://docs.configbox.at/docs/features/index.md): What CBX can do, at a glance. This track is the showcase: each section makes the case for one capability area the way you would to a prospect or a decision-m…
- [Feature: the customization layer](https://docs.configbox.at/docs/features/customization-layer/index.md): Extend CBX without forking it. Most configurator projects don't fail at launch — they fail at the second update, when a year of ad-hoc core edits collides wi…
- [Latest features](https://docs.configbox.at/docs/features/latest/index.md): What's new in CBX since the 4.0 line opened — across the storefront, the admin, the HTTP API, the CLI, the MCP server, the AI assistant, payments, catalog operations and the extension layer.
- [Latest features: the admin](https://docs.configbox.at/docs/features/latest/admin-experience/index.md): What's new in the CBX backend — dark mode, on-screen help, one save path, and new screens for API tokens, product transfer, the payment ledger and the assistant's journal.
- [Latest features: the AI assistant](https://docs.configbox.at/docs/features/latest/ai-assistant/index.md): What's new in the configurator chat advisor — it acts through the same API the page uses, journals every action, and files what it could not do as measured demand.
- [Latest features: catalog operations](https://docs.configbox.at/docs/features/latest/catalog-operations/index.md): What's new for catalog work — move a product between installs, delete one and its whole graph, and control per property what travels on a copy, a delete and an export.
- [Latest features: the command line](https://docs.configbox.at/docs/features/latest/cli/index.md): What's new on the command line — the configbox suite on Joomla, WordPress and Magento 2, deploy gates that exit non-zero, and a reserved namespace for site-specific commands.
- [Latest features: the configurator and the storefront](https://docs.configbox.at/docs/features/latest/configurator-and-storefront/index.md): What's new for shoppers — an AI advisor beside the configurator, a reactive client state, headless configuration, and the address and checkout fixes that stop orders being lost.
- [Latest features: the HTTP API](https://docs.configbox.at/docs/features/latest/http-api/index.md): What's new for integrators — a token-authenticated REST surface over the whole catalog, described by a generated OpenAPI 3.1 document, plus a runtime API for configuring a product headlessly.
- [Latest features: the MCP server](https://docs.configbox.at/docs/features/latest/mcp-server/index.md): What's new for AI tooling — typed MCP tools that let an assistant read and author a CBX catalog, including conditional rules, calculations and whole-product transfer.
- [Latest features: payments and commerce](https://docs.configbox.at/docs/features/latest/payments-and-commerce/index.md): What's new in payments — a payment ledger, an explicit state machine, settlement by return, webhook or poll, and a roster of fourteen providers with their verification status stated.
- [Latest features: platform and extensibility](https://docs.configbox.at/docs/features/latest/platform-and-extensibility/index.md): What's new for developers and integrators — generated record classes and schemas, prepared statements, exceptions instead of a silent false, and the new customization hooks.

## Admin Guide

- [CBX Admin Guide](https://docs.configbox.at/docs/admin-guide/index.md): Task-oriented, plain-language documentation for the people who set up and run a CBX store.
- [The AI product assistant](https://docs.configbox.at/docs/admin-guide/ai-assistant/index.md): A chat advisor on your configurator pages that explains the product, makes selections for the visitor, and reports what your store is missing.
- [Connect your own AI assistant](https://docs.configbox.at/docs/admin-guide/ai-assistant/connect-your-own-ai-assistant/index.md): Let an AI assistant you already use — Claude, or any tool that speaks MCP — work inside your store, with a token that says exactly what it may touch.
- [Read the conversation journal](https://docs.configbox.at/docs/admin-guide/ai-assistant/read-the-conversation-journal/index.md): Every assistant conversation, its signals, the full timeline of what happened, and the AI-written lessons review.
- [Read Conversation Insights](https://docs.configbox.at/docs/admin-guide/ai-assistant/run-the-insights-report/index.md): The observatory over the assistant's conversations - how the recommendation backlog is moving, and the earlier snapshot reports.
- [Work the recommendations](https://docs.configbox.at/docs/admin-guide/ai-assistant/send-recommendations-to-your-team/index.md): The living to-do list from your assistant's conversations, split by who can act - with a contact per group and an email the assistant writes for you.
- [Set up the assistant](https://docs.configbox.at/docs/admin-guide/ai-assistant/set-up-the-assistant/index.md): Every setting in the AI Configurator Assistant group, from the API key to house rules, permissions and the journal.
- [Work the wishlist](https://docs.configbox.at/docs/admin-guide/ai-assistant/work-the-wishlist/index.md): The assistant files what your store is missing, categorized for the team that can fix it - content gaps, feature requests, bug reports.
- [Customers, taxes, shipping & payment](https://docs.configbox.at/docs/admin-guide/commerce/index.md): Who pays what, how it's taxed, how it ships and how it's paid — the commerce setup.
- [Manage currencies](https://docs.configbox.at/docs/admin-guide/commerce/manage-currencies/index.md): Base vs default currency, exchange multipliers, and adding a new currency safely.
- [Payment providers](https://docs.configbox.at/docs/admin-guide/commerce/payment-providers/index.md): Every built-in payment provider - what it offers, which fields it needs, where its credentials come from, and how to test it.
- [Set up customer groups](https://docs.configbox.at/docs/admin-guide/commerce/set-up-customer-groups/index.md): B2B vs B2C, who may buy vs quote, and automatic volume discounts — all per customer group.
- [Set up payment methods](https://docs.configbox.at/docs/admin-guide/commerce/set-up-payment-methods/index.md): Payment options at checkout - pick a provider, enter its credentials, add surcharges, restrict by group or country.
- [Set up shipping](https://docs.configbox.at/docs/admin-guide/commerce/set-up-shipping/index.md): Shippers, zones, and weight-band shipping methods — what the customer is offered and charged.
- [Set up taxes](https://docs.configbox.at/docs/admin-guide/commerce/set-up-taxes/index.md): Tax classes, place-based rate overrides on the geography records, and the EU VAT flags.
- [Getting started](https://docs.configbox.at/docs/admin-guide/getting-started/index.md): Pick your platform, log in, and learn the screens that work the same everywhere.
- [Read the dashboard](https://docs.configbox.at/docs/admin-guide/getting-started/check-the-dashboard/index.md): The health-check screen — what its warnings mean and which ones need action.
- [Log in and find CBX](https://docs.configbox.at/docs/admin-guide/getting-started/log-in-and-find-cbx/index.md): Where the admin area lives, how to sign in, and what the CBX menu contains.
- [Run CBX on a Joomla site](https://docs.configbox.at/docs/admin-guide/getting-started/platform/cbx-on-joomla/index.md): What is specific to Joomla — where the menu lives, the CBX menu item types that build your storefront, and clean URLs.
- [Run CBX on a Magento 2 site](https://docs.configbox.at/docs/admin-guide/getting-started/platform/cbx-on-magento2/index.md): Where CBX lives in the Magento admin, why the menu is shorter — and where the full Magento documentation is.
- [Run CBX on a WordPress site](https://docs.configbox.at/docs/admin-guide/getting-started/platform/cbx-on-wordpress/index.md): What is different when your CBX store runs on WordPress — logging in, the menu, and putting CBX content on your pages.
- [Run the setup wizard](https://docs.configbox.at/docs/admin-guide/getting-started/run-the-setup-wizard/index.md): The first-run assistant — licence, languages, taxes, store information and currencies.
- [Schedule the recurring scripts](https://docs.configbox.at/docs/admin-guide/getting-started/schedule-the-recurring-scripts/index.md): The one scheduled job a CBX store needs, what it does, and how to tell that it is running.
- [Work the list and edit screens](https://docs.configbox.at/docs/admin-guide/getting-started/the-admin-screens/index.md): The shared conventions of every CBX screen — lists, edit forms, translatable fields, publish switches.
- [CBX on Magento 2](https://docs.configbox.at/docs/admin-guide/magento2/index.md): What changes when CBX runs inside a Magento 2 store — and which parts of this guide apply to you.
- [Connect a CBX product to a Magento product](https://docs.configbox.at/docs/admin-guide/magento2/connect-a-magento-product/index.md): Attach a CBX product to a Magento catalog product so the configurator appears on its product page.
- [Orders & daily operations](https://docs.configbox.at/docs/admin-guide/orders/index.md): Process orders, send the right emails, manage customers and moderate reviews.
- [Manage customers](https://docs.configbox.at/docs/admin-guide/orders/manage-customers/index.md): Customer records — addresses, VAT numbers, group membership, and guest accounts.
- [Moderate reviews](https://docs.configbox.at/docs/admin-guide/orders/moderate-reviews/index.md): The review queue — approving, editing and removing customer product reviews.
- [Process an order](https://docs.configbox.at/docs/admin-guide/orders/process-an-order/index.md): Find an order, read it, change its status, and produce the invoice and manufacturing slip.
- [Handle quotations and saved carts](https://docs.configbox.at/docs/admin-guide/orders/quotations-and-saved-carts/index.md): The two non-purchase flows — Request Quote and Save Cart — and where they land in Orders.
- [Set up the order emails](https://docs.configbox.at/docs/admin-guide/orders/set-up-order-emails/index.md): The status-triggered notification templates — subjects, bodies, placeholders, and testing them.
- [Track payments](https://docs.configbox.at/docs/admin-guide/orders/track-payments/index.md): The payments screen - see what was paid, settle bank transfers, investigate a payment that went wrong.
- [Pricing & calculations](https://docs.configbox.at/docs/admin-guide/pricing/index.md): Where prices come from, and the three ways to compute them — formulas, code, matrices.
- [Build a calculation](https://docs.configbox.at/docs/admin-guide/pricing/build-a-calculation/index.md): The drag-and-drop Formula editor — and when to reach for the Code or Matrix style instead.
- [Price with a lookup matrix](https://docs.configbox.at/docs/admin-guide/pricing/price-with-a-matrix/index.md): Build a two-dimensional lookup table — rows, columns, brackets, spreadsheet import and multipliers.
- [Charge recurring (subscription) prices](https://docs.configbox.at/docs/admin-guide/pricing/recurring-pricing/index.md): Bill an answer or the product base price on a repeating cycle alongside the one-off price.
- [Set product weight for shipping](https://docs.configbox.at/docs/admin-guide/pricing/weight-and-shipping-weight/index.md): Give answers and products a weight so weight-based shipping can price delivery.
- [Where prices come from](https://docs.configbox.at/docs/admin-guide/pricing/where-prices-come-from/index.md): The pricing building blocks — base price, answer prices, calculations, overrides — and how they add up.
- [Write a code expression](https://docs.configbox.at/docs/admin-guide/pricing/write-a-code-expression/index.md): The Code calculation style — placeholders A–D, the keyword reference, and worked examples.
- [Products & configurator](https://docs.configbox.at/docs/admin-guide/products/index.md): Build configurable products — the product tree, pages, questions, answers, and the storefront experience.
- [Add a product](https://docs.configbox.at/docs/admin-guide/products/add-a-product/index.md): Create the product record — titles, URL slugs, list placement, images, base price and visibility.
- [Add answers to a question](https://docs.configbox.at/docs/admin-guide/products/add-answers/index.md): The choices customers pick from — prices, images, defaults, ordering and availability.
- [Add pages and questions](https://docs.configbox.at/docs/admin-guide/products/add-pages-and-questions/index.md): Create the configurator steps and the inputs on them — every question type explained.
- [Copy and retire products](https://docs.configbox.at/docs/admin-guide/products/copy-and-retire-products/index.md): Duplicate a product to reuse its structure, and take a product offline without deleting it.
- [Edit from the storefront as a manager](https://docs.configbox.at/docs/admin-guide/products/edit-from-the-storefront/index.md): Tweak a product while looking at the live configurator, using the manager's inline edit controls.
- [How a product fits together](https://docs.configbox.at/docs/admin-guide/products/how-a-product-fits-together/index.md): The Product → Pages → Questions → Answers model, and where rules, calculations and the preview attach.
- [Manage product lists](https://docs.configbox.at/docs/admin-guide/products/manage-product-lists/index.md): The catalogs your storefront shows — membership, ordering, and templates.
- [Move products between sites](https://docs.configbox.at/docs/admin-guide/products/move-products-between-sites/index.md): Export a product from one CBX site and import it into another — for example from a staging site to the live one.
- [Add product detail panes](https://docs.configbox.at/docs/admin-guide/products/product-detail-panes/index.md): The titled info blocks — specs, care, delivery — shown on a product's storefront detail page.
- [Set up the visual preview](https://docs.configbox.at/docs/admin-guide/products/set-up-the-visual-preview/index.md): Live product visualization — 2D composite images per answer, or a 3D ShapeDiver model.
- [Rules — conditional logic](https://docs.configbox.at/docs/admin-guide/rules/index.md): Show, hide or grey out questions and answers depending on what the customer picks.
- [Build a rule](https://docs.configbox.at/docs/admin-guide/rules/build-a-rule/index.md): The visual rule editor — drag conditions, combine with AND/OR, group with parentheses.
- [Control what happens on change](https://docs.configbox.at/docs/admin-guide/rules/control-what-happens-on-change/index.md): Hide vs grey out, auto-selecting defaults, and resolving selections that became invalid.
- [Rule recipes](https://docs.configbox.at/docs/admin-guide/rules/rule-recipes/index.md): Ready-made patterns for the situations every configurator runs into.
- [Store settings](https://docs.configbox.at/docs/admin-guide/settings/index.md): The global Settings screen, your store information, the customer-fields matrix and languages.
- [Keep your store information current](https://docs.configbox.at/docs/admin-guide/settings/keep-store-information-current/index.md): The company identity behind invoices, quotes and emails — and why it must be right.
- [Manage API tokens](https://docs.configbox.at/docs/admin-guide/settings/manage-api-tokens/index.md): Create, scope, revoke and retire the access tokens that let external software and AI assistants work with your store.
- [Tailor the customer fields](https://docs.configbox.at/docs/admin-guide/settings/tailor-the-customer-fields/index.md): Decide, per flow, which address/customer fields appear and which are required.
- [Tour the Settings sections](https://docs.configbox.at/docs/admin-guide/settings/tour-the-settings-sections/index.md): A guided walk through every section of the Settings screen — what each one decides, which switches matter, and where to go deeper.

## Concepts & Functionality

- [Calculation Authoring](https://docs.configbox.at/docs/functional/calculation_authoring/index.md): A functional description of how an admin builds calculations — the named, product-scoped formulas that produce a number . This is the authoring/usage view: w…
- [Commerce-Setup Forms](https://docs.configbox.at/docs/functional/commerce_setup/index.md): A functional description of the forms an admin uses to set up the commercial side of the shop — customer segmentation & discounts, currencies, taxes, geograp…
- [Admin Configuration & Settings](https://docs.configbox.at/docs/functional/configuration/index.md): A functional description of every configuration option a shop admin can set in CBX — what each option is for and what it affects in the running application. …
- [Configurator-Building Forms](https://docs.configbox.at/docs/functional/configurator_building/index.md): A functional description of the forms an admin uses to build a configurable product — what each field is for and what it affects in the running shop. Usage-c…
- [Evaluating CBX — the technical facts](https://docs.configbox.at/docs/functional/evaluation/index.md): What CBX runs on, how it integrates, and what a technical evaluation should know - requirements, ionCube, APIs, licensing.
- [Operations Forms](https://docs.configbox.at/docs/functional/operations/index.md): A functional description of the forms an admin uses to run the shop day-to-day — processing orders, managing customers, moderating reviews, configuring trans…
- [Rule Authoring](https://docs.configbox.at/docs/functional/rule_authoring/index.md): A functional description of how an admin builds rules — the conditional logic that decides whether a question or answer is shown/active in the configurator. …
- [Frontend User Stories](https://docs.configbox.at/docs/functional/user_stories/index.md): What a customer can do in a CBX storefront, told as user stories and organized by epic — from browsing the catalog through configuring, buying, and managing …

## Customization

- [CBX — Customization Guides](https://docs.configbox.at/docs/customization/index.md): How-to guides for extending CBX through its upgrade-safe customization layer — one directory per install, resolved by KenedoPlatform::p->getDirCustomization.…
- [Admin UI Migration Guide (major release)](https://docs.configbox.at/docs/customization/admin_ui_migration/index.md): Who this is for: developers with customization work on the CBX admin UI — custom CSS, custom admin JS, or overridden backend view/property templates. The upc…
- [Assets (CSS) & JavaScript (AMD)](https://docs.configbox.at/docs/customization/assets_and_amd/index.md): How to add your own CSS and JavaScript to the CBX frontend/admin without a build step. Two things make this different from a normal Joomla extension: there i…
- [Custom Calc Term Types](https://docs.configbox.at/docs/customization/custom_calc_term_types/index.md): How to add your own calculation term type to CBX — a new kind of building block an admin can drop into a formula calculation, which the pricing engine evalua…
- [Custom CLI commands — the configbox custom namespace](https://docs.configbox.at/docs/customization/custom_cli_commands/index.md): Add site-specific command-line commands to the ConfigBox CLI suite without touching core: one file in the upgrade-safe customization layer declares your comm…
- [Creating Custom Kenedo Properties](https://docs.configbox.at/docs/customization/custom_properties/index.md): A practical, end-to-end guide to building your own Kenedo Property — the unit that turns one line in a model's property-definition array into a form widget, …
- [Custom Question Types](https://docs.configbox.at/docs/customization/custom_question_types/index.md): How to add your own question type to CBX — a new kind of input the configurator renders, with its own template, its own admin fields, and its own rules about…
- [Custom Rule Condition Types](https://docs.configbox.at/docs/customization/custom_rule_conditions/index.md): How to add your own condition type to the CBX rule engine — a new kind of "if…" that admins can drop into a rule in the Rule Editor and that the engine evalu…
- [Overview & Extension-Point Map](https://docs.configbox.at/docs/customization/customization_overview/index.md): The orientation guide for the whole customization track. It explains what the customization layer is, the one rule that governs almost all of it , every exte…
- [Events & Observers (reacting to what CBX does)](https://docs.configbox.at/docs/customization/events_and_observers/index.md): How to run your own code when something happens in CBX — an order is placed, a record is stored, a tax rate is computed, a customer registers — without modif…
- [Extending Stock Models (adding/overriding fields)](https://docs.configbox.at/docs/customization/extending_stock_models/index.md): How to add a field to an existing CBX model — or tweak how an existing field appears — without editing the core model file. This is the modelpropertycustomiz…
- [On-Screen Help](https://docs.configbox.at/docs/customization/help_customization/index.md): How to make the admin's on-screen help describe your installation: amend or replace the note on any screen, add your own articles in a Customizations section…
- [Language Overrides (changing displayed text)](https://docs.configbox.at/docs/customization/language_overrides/index.md): How to change the wording of CBX's interface text — relabel a field, reword a tooltip, retitle a button — without editing core language files. This is the la…
- [Overriding Controllers & Models (changing behavior)](https://docs.configbox.at/docs/customization/overriding_controllers_and_models/index.md): How to change what CBX does — a controller action, a model's query/validation/storage logic — from the customization layer. The key fact to internalise first…
- [Overriding Views & Templates](https://docs.configbox.at/docs/customization/overriding_views_and_templates/index.md): The most common customization task: change what a screen looks like without editing core files. This guide covers the two layers that produce a screen — the …
- [Payment (PSP) Connectors](https://docs.configbox.at/docs/customization/payment_connectors/index.md): How to add a payment method to CBX — an integration with a payment service provider — by dropping a connector folder into the customization layer. A connecto…
- [Question types the AI understands and controls](https://docs.configbox.at/docs/customization/question_types_and_ai/index.md): How to build a custom question type that the chat advisor (and every headless client — the runtime API, MCP-driven tooling, tests) can understand and operate…
- [System Overrides & Boot Hooks (the escape hatch)](https://docs.configbox.at/docs/customization/system_overrides_and_boot_hooks/index.md): The last-resort customization mechanism: replacing a framework/helper class that has no per-type loader, and running your own PHP at boot — defining global h…

## Developer Reference

- [Developer Reference](https://docs.configbox.at/docs/technical/index.md): The reference for CBX internals - Kenedo, the API surfaces, the engines and the tooling.
- [Admin theming — the --cb- token layer, light / dark / auto](https://docs.configbox.at/docs/technical/admin_theming/index.md): > Scope: how the CBX backend decides its colour scheme and where its colours come from — the > data-bs-theme anchor, getAdminColorScheme per platform, the --…
- [External API contract](https://docs.configbox.at/docs/technical/api_contract/index.md): > Status: largely met. This is the contract every CBX endpoint satisfies — admin CRUD, > authentication, and the end-user configurator — so that the product …
- [The four ways in](https://docs.configbox.at/docs/technical/api_surfaces/index.md): CBX can be driven from four directions. They look different, authenticate differently and are documented separately — but below a certain line they are the s…
- [API tokens and scopes](https://docs.configbox.at/docs/technical/api_tokens_and_scopes/index.md): > Audience: developers integrating with CBX, and the admins who hand them tokens · > Scope: the one credential every API caller presents, and the vocabulary …
- [The Price Calculation Engine, in Detail](https://docs.configbox.at/docs/technical/calculation_engine/index.md): > Scope: how calculations are created, stored, processed, and — most > importantly — extended in the customization layer · Last reviewed: 2026-08-02
- [The configurator chat advisor](https://docs.configbox.at/docs/technical/chat_advisor/index.md): > Scope: the Claude-backed chat assistant on the configurator and cart — concept, architecture, > the tool surface, page driving, the knowledge model, the wi…
- [CBX CLI command suite](https://docs.configbox.at/docs/technical/cli_commands/index.md): > Maintenance contract: this document is the reference for the CLI suite and must change in the same > commit as the commands. If you add, remove or change a…
- [Configurator Questions & Answers, in Detail](https://docs.configbox.at/docs/technical/configurator_questions/index.md): > Scope: how the configurator's questions and answers are rendered to HTML, how the > browser reacts to a selection, how that selection round-trips to the se…
- [The configurator client store](https://docs.configbox.at/docs/technical/configurator_store/index.md): > Scope: configbox/store — the configurator page's client-side state: the tree, the actions, the > selectors, the legacy bridge, and how customization JavaSc…
- [Rich-text editor image upload](https://docs.configbox.at/docs/technical/editor_image_upload/index.md): > Scope: what happens when an operator drops, pastes or picks an image in a ConfigBox rich-text > field — the endpoint, the downscale-and-WebP pipeline, wher…
- [The entity API](https://docs.configbox.at/docs/technical/entity_api/index.md): CRUD over the CBX catalog, over HTTP, authenticated with bearer tokens, described by OpenAPI 3.1 and the JSON Schemas the component already ships.
- [Talking to the server from the frontend: server.request](https://docs.configbox.at/docs/technical/frontend_requests/index.md): Audience: anyone writing CBX frontend or admin JavaScript. TL;DR: server.makeRequest handed you a jqXHR and left you to figure out what happened. server.requ…
- [Host-Adaptation Stylesheets (anti-bleed CSS)](https://docs.configbox.at/docs/technical/host_stylesheets/index.md): > Scope: the per-platform/per-theme stylesheets under assets/css/hosts/ — how they load, what > belongs in them, and their naming convention · Last reviewed:…
- [The HTTP API, from the inside](https://docs.configbox.at/docs/technical/http_api/index.md): How a request becomes a record. This is the implementation article: the layers, the paths through them, and the classes that do the work. For using the API, …
- [KenedoController, in Detail](https://docs.configbox.at/docs/technical/kenedo_controller/index.md): A deep reference for KenedoController — the front-controller / request-dispatch layer of CBX's bespoke "Kenedo" MVC framework — plus the minimum of KenedoMod…
- [KenedoDatabase, the database layer](https://docs.configbox.at/docs/technical/kenedo_database/index.md): A reference for KenedoDatabase — the one class every query in CBX goes through. It is a thin, deliberate wrapper over mysqli: you set a query, you run it, yo…
- [KenedoModel, in Detail](https://docs.configbox.at/docs/technical/kenedo_model/index.md): A deep reference for KenedoModel — the data layer of CBX's bespoke "Kenedo" MVC framework — plus the minimum of KenedoController and KenedoProperty needed to…
- [Kenedo MVC — Architecture, Base Tasks & Property-Driven Data](https://docs.configbox.at/docs/technical/kenedo_mvc/index.md): A comprehensive description of the Kenedo framework that underpins CBX: its MVC request lifecycle, the base controller tasks every controller inherits, and —…
- [KenedoView, in Detail](https://docs.configbox.at/docs/technical/kenedo_view/index.md): A deep reference for KenedoView — the view layer of CBX's bespoke "Kenedo" MVC framework — plus the minimum of KenedoController and KenedoModel needed to see…
- [MCP server](https://docs.configbox.at/docs/technical/mcp_server/index.md): CBX can expose itself to an AI assistant over the Model Context Protocol , so the assistant can work with the catalog through real, typed tools instead of be…
- [The MCP server, from the inside](https://docs.configbox.at/docs/technical/mcp_server_internals/index.md): How a tool call becomes a record. This is the implementation article: the layers, the transport, and the classes that do the work. For running the server and…
- [Database Schema Upgrades & Migrations](https://docs.configbox.at/docs/technical/migrations/index.md): > Scope: how CBX creates and evolves its database schema — the runtime migration runner, the > version ledger, fresh-install bootstrapping, the per-version u…
- [Kenedo MVC — Base Tasks in Detail](https://docs.configbox.at/docs/technical/mvc_tasks/index.md): A deep look at every base controller task Kenedo provides (display, edit, store/apply, delete, publish, storeOrdering, cancel, copy, …) — what each one does,…
- [Payments (the 2026 subsystem)](https://docs.configbox.at/docs/technical/payments/index.md): > Scope: how the CLASSIC checkout takes money — the provider contract, the payment ledger, the > state machine, settlement, logging, the admin surfaces, and …
- [Product transfer (export / import)](https://docs.configbox.at/docs/technical/product_transfer/index.md): > Scope: moving a product between ConfigBox installations — the package format, how the export > decides what belongs to a product, the two import modes and …
- [Property definition settings — storage, validation and the keys that govern them](https://docs.configbox.at/docs/technical/property_definition_settings/index.md): A property definition is the array a model's getPropertyDefinitions returns per field. It drives the admin form, the list view, the SQL a read builds, and — …
- [Kenedo property types — overview](https://docs.configbox.at/docs/technical/property_types/index.md): A property type is the class that decides how one field behaves: how it renders, how it reads and writes, what column it is, and what it validates. The type …
- [Property type articles](https://docs.configbox.at/docs/technical/property-types/index.md): One article per Kenedo property type. Start with the overview — it carries the settings every type accepts , the storage kinds, the storeExternally mechanism…
- [Boolean](https://docs.configbox.at/docs/technical/property-types/boolean/index.md): Yes/no, stored as text.
- [Calculation](https://docs.configbox.at/docs/technical/property-types/calculation/index.md): A reference to a calculation, picked from the calculations of the relevant product.
- [CalculationOverride](https://docs.configbox.at/docs/technical/property-types/calculationoverride/index.md): Per-customer-group calculation overrides, serialised into one column.
- [Childentries](https://docs.configbox.at/docs/technical/property-types/childentries/index.md): Embeds another model's list view inside this record's edit form, so the child records can be listed, added, edited and deleted without leaving the parent. Th…
- [Datetime](https://docs.configbox.at/docs/technical/property-types/datetime/index.md): A date and time value, rendered as a native <input type="date">.
- [Dropdown](https://docs.configbox.at/docs/technical/property-types/dropdown/index.md): One value from a set, rendered as a select. It folds in the former dedicated enum type.
- [File](https://docs.configbox.at/docs/technical/property-types/file/index.md): An uploaded file of any type: the file goes on disk under dirBase, the filename goes in the column. The same machinery as image minus the image processing — …
- [Countryselect, stateselect, countyselect](https://docs.configbox.at/docs/technical/property-types/geography-selects/index.md): Three cascading pickers for the country → state → county hierarchy. Each stores the referenced record's id.
- [Groupstart and groupend](https://docs.configbox.at/docs/technical/property-types/group/index.md): A collapsible section in the edit form. A pair: groupstart opens, groupend closes.
- [GroupPrice](https://docs.configbox.at/docs/technical/property-types/groupprice/index.md): Per-customer-group price overrides for a single price field, serialised into one column.
- [Id](https://docs.configbox.at/docs/technical/property-types/id/index.md): The primary key. Every model with a table has exactly one.
- [Image](https://docs.configbox.at/docs/technical/property-types/image/index.md): An uploaded image: the file goes on disk under dirBase, the filename goes in the column, and any number of derived versions — thumbnails, web-optimised copie…
- [Join](https://docs.configbox.at/docs/technical/property-types/join/index.md): An integer foreign key, with the referenced record's display value joined in so lists and forms can show something a human recognises.
- [Json](https://docs.configbox.at/docs/technical/property-types/json/index.md): A column holding a JSON document, edited as raw text in a textarea and validated as JSON.
- [Multiselect](https://docs.configbox.at/docs/technical/property-types/multiselect/index.md): Several values at once, stored as rows in a cross-reference table rather than as a column.
- [Note](https://docs.configbox.at/docs/technical/property-types/note/index.md): Static explanatory text on the form.
- [Number](https://docs.configbox.at/docs/technical/property-types/number/index.md): One configurable numeric type covering integers, decimals, money and percentages. It replaced dedicated integer and money types — do not reintroduce those.
- [Ordering](https://docs.configbox.at/docs/technical/property-types/ordering/index.md): The sort position of a record within its set.
- [Paymentmethodparams](https://docs.configbox.at/docs/technical/property-types/paymentmethodparams/index.md): The per-connector settings of a payment method. The shape is decided by the chosen connector, not by the property definition.
- [Pseudojoin](https://docs.configbox.at/docs/technical/property-types/pseudojoin/index.md): A picker whose options come from a model method rather than a table, storing the option's own string key: a template folder name, a PSP connector name, a lan…
- [Published](https://docs.configbox.at/docs/technical/property-types/published/index.md): The publish flag — a boolean specialised for the one field nearly every entity has.
- [Radio](https://docs.configbox.at/docs/technical/property-types/radio/index.md): One value from a small set, rendered as radio buttons.
- [Rule](https://docs.configbox.at/docs/technical/property-types/rule/index.md): A visibility or pricing rule, authored on a drag-and-drop surface and evaluated by the engine.
- [Shapedivermodel, shapediverparameter, shapediverparametervalue, shapedivergeometry](https://docs.configbox.at/docs/technical/property-types/shapediver/index.md): The ShapeDiver integration: a reference to a 3D model, to one of its parameters, to a value of such a parameter, and to a geometry within it.
- [String](https://docs.configbox.at/docs/technical/property-types/string/index.md): A text value. The most common property type, and the fallback shape several others render as.
- [Taxclassrates](https://docs.configbox.at/docs/technical/property-types/taxclassrates/index.md): The tax rates of one geographic zone, one rate per tax class.
- [Translatable](https://docs.configbox.at/docs/technical/property-types/translatable/index.md): A text value per active language, stored in #configboxstrings — an EAV table, not a column on the model's own table.
- [The Rule Engine, in Detail](https://docs.configbox.at/docs/technical/rule_engine/index.md): > Scope: how conditional logic is created, stored, processed, and — most importantly — > extended in the customization layer · Last reviewed: 2026-08-02
- [The runtime API — configuring a product without a browser](https://docs.configbox.at/docs/technical/runtime_api/index.md): For anyone writing a client that has to configure a CBX product and put it in a cart: an AI assistant, a headless storefront, a mobile app, an integration te…
- [Type generation — record classes and JSON schemas](https://docs.configbox.at/docs/technical/type_generation/index.md): > Scope: the generator behind configbox:generate-types — what it emits, from what, and why · > Last reviewed: 2026-08-02

## Platform Guides

- [CBX on Joomla — Platform Guide](https://docs.configbox.at/docs/platform/joomla/joomla_platform_guide/index.md): > Audience: integrators and developers running CBX on Joomla · Scope: what is specific to the Joomla edition — installation, the extensions that ship, storef…
- [SEF (clean) URLs for CBX / Kenedo on Joomla](https://docs.configbox.at/docs/platform/joomla/sef_urls/index.md): > Audience: developers & AI agents · Scope: how CBX/Kenedo turns query-string links into > clean SEF paths on Joomla, how to give a custom page its own clean…
- [CBX on Magento 2 — Platform Guide](https://docs.configbox.at/docs/platform/magento2/magento2_platform_guide/index.md): > Audience: integrators and developers running CBX on Magento 2 · Scope: what is different about the Magento 2 edition — installation, the admin area, connec…
- [CBX on WordPress — Platform Guide](https://docs.configbox.at/docs/platform/wordpress/wordpress_platform_guide/index.md): > Audience: integrators and developers running CBX on WordPress · Scope: how the > WordPress edition is wired — the adapter plugin, routing/URLs, the /cb-api…

## Migrating to 4.0

- [Customization code migration to CBX 4](https://docs.configbox.at/docs/migration-to-cb4/index.md): Task-oriented guides for realigning existing site customizations to the breaking changes introduced in CBX 4.
- [Deep dive: the option/answer collapse (xref → answer)](https://docs.configbox.at/docs/migration-to-cb4/answers-collapse-deep-dive/index.md): Audience: a developer — or an AI instructed to make an extensively-customized CBX site compatible with CBX 4. This is the exhaustive reference behind the sum…
- [Looking up assignments: ConfigboxAssignmentsHelper](https://docs.configbox.at/docs/migration-to-cb4/assignments-lookups/index.md): Applies to: any customization that reads ConfigboxCacheHelper::getAssignments. Status: getAssignments still works and is not going away. This is a better way…
- [CBX 4 — breaking changes log (for customizations)](https://docs.configbox.at/docs/migration-to-cb4/breaking-changes-log/index.md): The running, dated index of every core change that can break customization code in data/customization/. Append a new entry at the top whenever core work intr…
- [CBX 4 — consolidated old → new identifier cheat-sheet](https://docs.configbox.at/docs/migration-to-cb4/CHEATSHEET/index.md): One flat lookup table of every renamed/removed identifier in the CBX 4 refactor, across all domains . Built for the "amend the customizations" workflow: load…
- [The customer field rename — before → after reference](https://docs.configbox.at/docs/migration-to-cb4/customer-field-rename/index.md): The exhaustive reference for the CBX 4 rename of the customer record's fields (#configboxusers and the frozen per-order snapshot #cbcheckoutorderusers). Read…
- [The element → question rename — before → after reference](https://docs.configbox.at/docs/migration-to-cb4/element-question-rename/index.md): The exhaustive reference for the CBX 4 rename of the "element" entity to "question". Read this for any customization that touches the configurator question e…
- [Errors are exceptions now — what customization code has to change](https://docs.configbox.at/docs/migration-to-cb4/exceptions-and-validation/index.md): CBX used to report a refusal by returning false and parking a sentence in setError. That protocol is being retired in favour of exceptions, and the change re…
- [Playbook: model-property customizations after the answer/option collapse](https://docs.configbox.at/docs/migration-to-cb4/model-property-customizations/index.md): Applies to: files under data/customization/modelpropertycustomization/ that customize the removed option/answer models. Prerequisite reading: the general cus…
- [Operator retraining brief (CBX 4)](https://docs.configbox.at/docs/migration-to-cb4/operators-what-changed/index.md): A focused checklist of the concrete admin changes staff need to be walked through after upgrading — what moved, what a word now means, and what behaves diffe…
- [For decision makers: should we upgrade to CBX 4?](https://docs.configbox.at/docs/migration-to-cb4/whats-new-for-decision-makers/index.md): For owners and managers weighing the upgrade — especially sites still running CBX 2 (the older, one-off-priced generation). This lays out the concrete advant…
- [What's new for developers (CBX 4)](https://docs.configbox.at/docs/migration-to-cb4/whats-new-for-devs/index.md): New and changed capabilities that matter when you build on, extend, or operate CBX 4 as a developer. For how to fix customization code broken by these, see t…
- [What's new for operators (CBX 4)](https://docs.configbox.at/docs/migration-to-cb4/whats-new-for-operators/index.md): For shop managers and staff who build products and run the store in the CBX backend. This is the "what's better / what looks different" overview. For the con…