About bitrix-components
A component development reference for Bitrix developers, covering structure, templates, caching, SEF, and AJAX. It also documents constraints for parameter handling, output escaping, and cache keys.
Key features
- 01Component directory and file structure rules
- 02Template lookup, overrides, and rendering guidance
- 03Caching, pagination, SEF, and AJAX rules
- 04Component parameter-casting requirements
- 05Output escaping and cache-key constraints
Use cases
- 01Scaffold a local custom Bitrix component
- 02Find template override and rendering guidance
- 03Build components with pagination or SEF
- 04Configure component caching and AJAX actions
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ bxmaximum/ bitrix-framework-skills --skill bitrix-componentsAfter installing, type/bitrix-componentsin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
rules/cache-sef-ajax.mdstructure.mdtemplate.mdDetails
From the project READMEBitrix components
Baseline: main 23.0+ · Verified: main 26.800.0
| Task | Read |
|---|---|
Placement, scaffold, class.php, params, .description.php, .parameters.php | rules/structure.md |
Template search order and overrides, template.php, result_modifier.php, component_epilog.php | rules/template.md |
| Result cache, paged list, complex SEF, AJAX actions | rules/cache-sef-ajax.md |
PageNavigation, pager templates | bitrix-cms-basics |
| Grid, filter, toolbar in templates | bitrix-ui |
Invariants
- Own components in
/local/components/<vendor>/; kernel components are changed only by copying their template to/local/templates/<site>/components/…. - Logic in
class.phpand services; templates only render$arResult, escaping output. onPrepareComponentParams()casts every param;~KEYis the raw value.- Everything that changes output is in the cache key (user groups, page number, filter).
- Nested components get
$componentas the 4thIncludeComponent()argument. - AJAX through
Controllerableactions with prefilters and signed parameters.
Comments
Markdown supported