Когда стандартных блоков Concrete CMS недостаточно?
Встроенные блоки (Content, Image, Form) покрывают 80% типовых задач. Но остальные 20% — например, карточка преимущества с иконкой, ссылкой и выбором макета — требуют собственного блока. Мы создали десятки таких блоков: от простых текстовых плашек до интеграций с внешними API. Опытный инженер спроектирует кастомный блок так, что время внесения правок сократится на 40%, а дублирование кода исчезнет. В одном интернет-магазине мы заменили три разных плагина одним блоком Feature Card — LCP упал на 300 мс, поддержка упростилась. Если вы столкнулись с этими проблемами — закажите разработку кастомного блока, и мы предложим эффективное решение.
Три типичные проблемы, которые решает кастомный блок
- Негибкость стандартных блоков. Вы не добавите поле для иконки или переключатель макета в блок Content — только через кастом. 2. Дублирование кода. Если одинаковый набор полей используется на нескольких страницах, без кастомного блока придётся копировать HTML в каждый редактор. 3. Кэширование. Стандартные блоки кэшируются по умолчанию, но для сложных структур нужно настраивать параметры вручную — в собственном контроллере это делается парой строк.
Как мы разрабатываем кастомные блоки
Используем проверенную архитектуру: контроллер отвечает за валидацию и сохранение данных, шаблон — только за вывод. Для хранения полей применяем db.xml, управляем файлами через Concrete\Core\File\File. Рассмотрим блок Feature Card для интернет-магазина: 4 макета, иконка из файлового менеджера, кэширование вывода с TTL 3600 секунд.
Пошаговая инструкция по созданию блока
- Создайте структуру каталога:
blocks/feature-card/с файламиcontroller.php,db.xml,add.php,edit.php,view.php,icon.png(48×48). Для альтернативных шаблонов добавьте папкуtemplates/. - Опишите схему БД в
db.xml: определите поля, их типы и ключи. Concrete CMS автоматически создаст таблицу при установке пакета. - Реализуйте контроллер: наследуйте
BlockController, задайте свойства кэширования и таблицы, переопределите методыadd(),edit(),view(),save()иvalidate(). - Создайте шаблоны вывода:
view.phpдля отображения, альтернативные шаблоны вtemplates/для разных макетов. - Установите блок: через пакет или напрямую в
application/blocks/— он появится в редакторе сайта.
Структура блока
Блок располагается в packages/my-package/blocks/my-block/ или application/blocks/my-block/:
blocks/feature-card/
controller.php # логика, валидация, CRUD
db.xml # схема таблицы БД
add.php # форма добавления блока
edit.php # форма редактирования (обычно include add.php)
view.php # шаблон вывода на странице
icon.png # иконка (48×48)
templates/ # альтернативные шаблоны вывода
compact.php
db.xml — схема хранения данных
<?xml version="1.0"?>
<schema version="0.3">
<table name="btFeatureCard">
<field name="bID" type="I">
<KEY/>
<UNSIGNED/>
</field>
<field name="headline" type="C" size="255"/>
<field name="subheadline" type="C" size="255"/>
<field name="body" type="X2"/>
<field name="link_url" type="C" size="512"/>
<field name="link_text" type="C" size="100"/>
<field name="icon_fID" type="I">
<UNSIGNED/>
</field>
<field name="layout" type="C" size="50">
<DEFAULT value="default"/>
</field>
</table>
</schema>
controller.php
<?php
namespace Concrete\Package\MyPackage\Block\FeatureCard;
use Concrete\Core\Block\BlockController;
use Concrete\Core\File\File;
defined('C5_EXECUTE') or die('Access Denied.');
class Controller extends BlockController {
protected $btTable = 'btFeatureCard';
protected $btInterfaceWidth = 600;
protected $btInterfaceHeight = 500;
protected $btCacheBlockRecord = true;
protected $btCacheBlockOutput = true;
public function getBlockTypeName(): string { return 'Feature Card'; }
public function getBlockTypeDescription(): string { return 'Карточка преимущества с иконкой и ссылкой'; }
public function add(): void {
$this->set('layout_options', ['default' => 'Стандартный', 'horizontal' => 'Горизонтальный']);
}
public function edit(): void {
$this->add();
if ($this->icon_fID) {
$this->set('icon_file', File::getByID($this->icon_fID));
}
}
public function view(): void {
if ($this->icon_fID) {
$this->set('iconFile', File::getByID($this->icon_fID));
}
}
public function save(array $args): void {
$args['headline'] = strip_tags($args['headline'] ?? '');
$args['subheadline'] = strip_tags($args['subheadline'] ?? '');
$args['body'] = $args['body'] ?? '';
$args['link_url'] = filter_var($args['link_url'] ?? '', FILTER_SANITIZE_URL);
$args['link_text'] = strip_tags($args['link_text'] ?? '');
$args['icon_fID'] = (int)($args['icon_fID'] ?? 0);
$args['layout'] = in_array($args['layout'], ['default', 'horizontal']) ? $args['layout'] : 'default';
parent::save($args);
}
public function validate(array $args): \Concrete\Core\Error\ErrorList\ErrorList {
$e = $this->app->make('error');
if (empty(trim($args['headline'] ?? ''))) {
$e->add('Заголовок обязателен');
}
return $e;
}
}
view.php
<?php defined('C5_EXECUTE') or die('Access Denied.'); ?>
<div class="feature-card feature-card--<?= h($layout) ?>">
<?php if ($iconFile): ?>
<div class="feature-card__icon">
<img src="<?= $iconFile->getRelativePath() ?>" alt="">
</div>
<?php endif; ?>
<div class="feature-card__body">
<?php if ($headline): ?><h3><?= h($headline) ?></h3><?php endif; ?>
<?php if ($subheadline): ?><p class="subheadline"><?= h($subheadline) ?></p><?php endif; ?>
<?php if ($body): ?><div class="text"><?= nl2br(h($body)) ?></div><?php endif; ?>
<?php if ($link_url && $link_text): ?>
<a href="<?= h($link_url) ?>" class="btn"><?= h($link_text) ?></a>
<?php endif; ?>
</div>
</div>
Официальная документация Concrete CMS описывает минимальный набор файлов: controller.php, db.xml, add.php, edit.php, view.php. Подробнее о разработке блоков — в официальной документации.
Как настроить кэширование для блока?
Параметры кэша задаются в контроллере. Установка btCacheBlockRecord и btCacheBlockOutput в true включает кэш записи и HTML-вывода. TTL управляется свойством btCacheBlockOutputLifetime. Для блоков с POST-данными обязательно отключать кэш после отправки: btCacheBlockOutputOnPost = false. Это предотвращает показ устаревшего контента после редактирования. Правильная конфигурация кэширования снижает TTFB на 100–200 мс.
Блок с несколькими записями (список элементов)
Для блоков типа «список элементов» используется btExportTables и дочерняя таблица. В контроллере укажите protected $btExportTables = ['btFeatureList', 'btFeatureListItems'];. Сохранение дочерних записей выполняется в методе save(): сначала удаляются старые, затем вставляются новые с учётом сортировки.
Пример структуры дочерней таблицы
<field name="sort" type="I">
<UNSIGNED/>
<DEFAULT value="0"/>
</field>
Сроки разработки блока
| Сложность | Описание | Срок |
|---|---|---|
| Простой | Текст + изображение + ссылка | 4–8 ч |
| Средний | Список элементов, галерея, табы | 1–2 дня |
| Сложный | Интеграция с API, кастомный JS | 2–5 дней |
Что входит в работу
- Контроллер, шаблоны (view + альтернативные), схема БД (db.xml).
- Валидация полей и безопасная обработка данных.
- Кэширование вывода с оптимальным TTL.
- Миграция существующих данных (если требуется).
- Документация по установке и использованию.
- Обучение редакторов работе с блоком.
- Гарантия 6 месяцев на код.
Ускорение разработки с помощью альтернативных шаблонов
Используйте альтернативные шаблоны — это позволяет менять внешний вид без изменения логики. Для однотипных блоков (например, несколько вариантов карточек) создайте один контроллер с переключателем макета в форме редактирования. Это сокращает время разработки в 2–3 раза.
Сравнение: кастомный блок vs готовые решения
| Критерий | Кастомный блок | Готовый плагин |
|---|---|---|
| Гибкость | Полная | Ограничена настройками |
| Производительность | Оптимизирован под задачу | Часто избыточен |
| Совместимость с обновлениями | Контролируется | Может сломаться |
| Время внедрения | 4 ч – 5 дней | 1–2 дня (если подходит) |
Кастомные блоки в 3 раза быстрее загружаются при правильном кэшировании — LCP снижается на 200–400 мс. Экономия бюджета за счёт отказа от плагинов может составлять до 50%.
Оценим ваш проект за 1 рабочий день. Просто напишите нам — мы подберем оптимальное решение для ваших задач.