Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Пункт редактирования блока LANDING_BLOCK», проанализируем лучшие практики и покажем, как правильно использовать пункт редактирования в реальных задачах.
Пункт редактирования блока LANDING_BLOCK
Тут может не хватать некоторых данных — дополним в ближайшее время
- не указаны типы параметров
- не указана обязательность параметров
На данный момент разработчики имеют возможность внедриться в пункты редактирования любого блока. В случае такой регистрации рядом с кнопками блока «Редактировать» и «Дизайн» появится кнопка вызова вашего приложения.
Код для встройки приложения зависит от кода блока и в общем виде выглядит так: LANDING_BLOCK_<CODE>. Если в случае системного блока все понятно, и вместо <CODE> нужно вставить код блока (примеры ниже), то в случае встраивания в зарегистрированный вами же блок нужно подставить его идентификатор.
Например:
1. Регистрируем блок. Метод вернет ID блока. Пусть он равен 1132, для примера.
2. При регистрации места встраивания указываем код: LANDING_BLOCK_repo_1132 (или LANDING_BLOCK_REPO_1132, регистр не важен).
Входящие параметры и конфигурация метода
Для данного места встраивания доступны параметры:
| Параметр | Описание | С версии |
|---|---|---|
IDunknown | – идентификатор блока. | |
CODEunknown | – символьный код блока. | |
LIDunknown | – идентификатор страницы. |
Получить параметры можно из PLACEMENT_OPTIONS:
$placement = isset($_REQUEST['PLACEMENT_OPTIONS'])
? json_decode($_REQUEST['PLACEMENT_OPTIONS'], true)
: [];Практические примеры использования в коде
- JS
try
{
const response = await $b24.callMethod(
'landing.repo.bind',
{
fields: {
PLACEMENT: 'LANDING_BLOCK_04.1.one_col_fix_with_title',
PLACEMENT_HANDLER: 'https://cpe/rt/placement.php',
TITLE: 'My block'
}
}
);
const result = response.getData().result;
if(result.error())
console.error(result.error());
else
console.info(result);
}
catch(error)
{
console.error('Error:', error);
}- PHP
try {
$response = $b24Service
->core
->call(
'landing.repo.bind',
[
'fields' => [
'PLACEMENT' => 'LANDING_BLOCK_04.1.one_col_fix_with_title',
'PLACEMENT_HANDLER' => 'https://cpe/rt/placement.php',
'TITLE' => 'My block',
],
]
);
$result = $response
->getResponseData()
->getResult();
if ($result->error()) {
error_log($result->error());
} else {
echo 'Success: ' . print_r($result->data(), true);
}
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error binding landing block: ' . $e->getMessage();
}- BX24.js
BX24.callMethod(
'landing.repo.bind',
{
fields: {
PLACEMENT: 'LANDING_BLOCK_04.1.one_col_fix_with_title',
PLACEMENT_HANDLER: 'https://cpe/rt/placement.php',
TITLE: 'My block'
}
},
function(result)
{
if(result.error())
console.error(result.error());
else
console.info(result.data());
}
);Если вы хотите встроить универсальное приложение для каждого блока, следует указывать код со *:
- JS
try
{
const response = await $b24.callMethod(
'landing.repo.bind',
{
fields: {
PLACEMENT: 'LANDING_BLOCK_*',
PLACEMENT_HANDLER: 'https://cpe/rt/placement.php',
TITLE: 'My block'
}
}
);
const result = response.getData().result;
if(result.error())
console.error(result.error());
else
console.info(result);
}
catch(error)
{
console.error('Error:', error);
}- PHP
try {
$response = $b24Service
->core
->call(
'landing.repo.bind',
[
'fields' => [
'PLACEMENT' => 'LANDING_BLOCK_*',
'PLACEMENT_HANDLER' => 'https://cpe/rt/placement.php',
'TITLE' => 'My block',
],
]
);
$result = $response
->getResponseData()
->getResult();
if ($result->error()) {
error_log($result->error());
} else {
echo 'Success: ' . print_r($result->data(), true);
}
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error binding landing repository: ' . $e->getMessage();
}- BX24.js
BX24.callMethod(
'landing.repo.bind',
{
fields: {
PLACEMENT: 'LANDING_BLOCK_*',
PLACEMENT_HANDLER: 'https://cpe/rt/placement.php',
TITLE: 'My block'
}
},
function(result)
{
if(result.error())
console.error(result.error());
else
console.info(result.data());
}
)Обновление блока из приложения
В открывающемся приложении доступна команда на обновление конкретного блока. Подразумевается, что после работы с блоком, из которого вызвано приложение, вам может потребоваться его обновить. Делается это через команду refreshBlock.
Пример
- JS
try
{
const response = await $b24.callMethod(
'placement.call',
{
type: 'refreshBlock',
params: {
id: 123 // блок с идентификатором 123
}
}
);
const result = response.getData().result;
console.log('Блок успешно обновлен');
// закрываем слайдер
}
catch( error )
{
console.error('Error:', error);
}- PHP
try {
$response = $b24Service
->placement
->call(
'refreshBlock',
[
'id' => 123, // блок с идентификатором 123
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Блок успешно обновлен';
// закрываем слайдер
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Ошибка при обновлении блока: ' . $e->getMessage();
}- BX24.js
BX24.placement.call(
'refreshBlock',
{
id: 123 // блок с идентификатором 123
},
function()
{
console.log('Блок успешно обновлен');
// закрываем слайдер
}
);💡 Экспертное мнение и рекомендации
Практические рекомендации:
- При написании кастомных компонентов для «Пункт редактирования блока LANDING_BLOCK» всегда разделяйте бизнес-логику и представление (шаблон).
- Используйте отладку SQL-запросов через конструкцию
$wpdb->last_queryили стандартный трекер Битрикса, чтобы контролировать нагрузку.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru
