bitrix-landing

name	bitrix-landing
description	Covers Landing module — sites/landings, blocks repository, publish/unpublish flow, hooks (Metrika/GA/pixels), customization limits vs classic CMS. Applied for Sites24/landing pages, storefronts, knowledge bases on landing. Key terms — Landing, Site, Block, BlockRepo, publication, unpublic, hooks, PAGE, STORE.

Landing Sites (landing)

Baseline: main 23.0+. Verified against kernel module landing in this repo.

Block-based sites (Sites24 / Landing) live in module landing, not in classic site templates. For classic CMS sites/templates/menus see skill bitrix-cms-basics.

\Bitrix\Main\Loader::includeModule('landing');

Entity Model

Layer	Facade	Internal ORM
Site	\Bitrix\Landing\Site	\Bitrix\Landing\Internals\SiteTable
Page (landing)	\Bitrix\Landing\Landing	\Bitrix\Landing\Internals\LandingTable
Block instance	\Bitrix\Landing\Block	\Bitrix\Landing\Internals\BlockTable
Domain / folder	\Bitrix\Landing\Domain, \Bitrix\Landing\Folder	internals tables

Site and Landing extend \Bitrix\Landing\Internals\BaseTable and expose ORM-style getList / add / update / delete. Prefer facades over raw internals.

Site types (see \Bitrix\Landing\Site\Type): PAGE, STORE, SMN, scopes KNOWLEDGE, GROUP, MAINPAGE, pseudo-scope crm_forms.

Publication paths (constants on \Bitrix\Landing\Manager):

• Manager::PUBLICATION_PATH — /pub/site/
• Manager::PUBLICATION_PATH_SITEMAN — /lp/

Create / Read Pages

use Bitrix\Landing\Landing;
use Bitrix\Landing\Site;

// List pages of a site
$res = Landing::getList([
    'select' => ['ID', 'TITLE', 'CODE', 'ACTIVE', 'PUBLIC', 'SITE_ID'],
    'filter' => ['SITE_ID' => $siteId, '=DELETED' => 'N'],
]);

// Instance for block/publish operations
$landing = Landing::createInstance($landingId);
if (!$landing->exist()) {
    // missing / inaccessible
}

// Create page from demo template code
$addResult = Landing::addByTemplate($siteId, 'empty', [
    'TITLE' => 'Promo',
    'CODE' => 'promo',
]);

Sites:

$siteUrl = Site::getPublicUrl($siteId, full: true, hostInclude: true);
$addSite = Site::addByTemplate('empty', 'PAGE');

Blocks Overview

Blocks are HTML fragments from a repository (BlockRepo::BLOCKS_DIR = 'blocks'). Paths resolved via BlockRepo::getGeneralPaths() — typically /bitrix/blocks/ and /local/blocks/ (getLocalPath('blocks')).

use Bitrix\Landing\Block;
use Bitrix\Landing\Block\BlockRepo;

$landing = Landing::createInstance($landingId, ['skip_files' => false]);

// Add block by repository code (e.g. '01.big_with_text')
$block = $landing->addBlock('01.big_with_text', [
    // optional content overrides
]);

$blocks = $landing->getBlocks(); // id => Block
$one = $landing->getBlockById($blockId);

// Repository catalog (sections + codes)
$repo = (new BlockRepo())->getRepository();

Useful block APIs: Block::createFromRepository(), Block::publicationBlocks(), getManifest(), saveContent() / content mutators on the instance.

Custom blocks: place under /local/blocks/<namespace>/<code>/ with block.php + .description.php (same layout as kernel install/blocks/bitrix/...). Clear repo cache after deploy: Block::clearRepositoryCache() / BlockRepo cache.

Publish Flow

Orienting APIs (do not invent REST wrappers):

Action	API
Publish one page	$landing->publication() → bool
Dry-run publish errors	$landing->fakePublication()
Unpublish page	$landing->unpublic()
Publish whole site	Site::publication($siteId, mark: true) → Result
Unpublish site	Site::unpublic($siteId) / Site::publication($id, false)
Public URL	$landing->getPublicUrl(), Site::getPublicUrl()
Rights	$landing->canPublication(), $landing->canEdit()

$landing = Landing::createInstance($landingId);
if ($landing->canPublication() && $landing->publication()) {
    $url = $landing->getPublicUrl();
} else {
    $errors = $landing->getError(); // \Bitrix\Landing\Error
}

$siteResult = Site::publication($siteId, true);
if (!$siteResult->isSuccess()) {
    foreach ($siteResult->getErrors() as $error) {
        // verification / access errors
    }
}

AJAX/public-action layer (admin UI): \Bitrix\Landing\PublicAction\Landing::publication($lid) and related methods in publicaction/landing.php — same domain, UI-oriented.

Soft delete: Landing::markDelete / markUnDelete, Site::markDelete — recycle bin, not hard delete().

Hooks (SEO / Counters)

Page/site extras via \Bitrix\Landing\Hook / Landing::getAdditionalFields / saveAdditionalFields. Relevant hook classes under lib/hook/page/:

• YaCounter — Yandex.Metrika counter ID
• GaCounter, Gtm — Google Analytics / GTM
• MetaMain, MetaOg, MetaRobots, MetaYandexVerification, MetaGoogleVerification
• PixelFb, PixelVk, Robots

Do not confuse with \Bitrix\Landing\Metrika\Metrika — that is Bitrix product analytics (AnalyticsEvent) on publish, not Yandex.Metrika.

Landing vs Classic CMS

Need	Prefer
Marketing LP, block builder, STORE landing	landing
Multisite + PHP templates, menus, includes	classic CMS (bitrix-cms-basics)
Structured catalog/news with properties	iblock (bitrix-iblocks)
Deep custom PHP page logic	classic template / component — not a landing block

Landing pages are not site templates under /local/templates/. Mixing: a Bitrix site (CSite) can host publication paths; content model is still Landing entities.

Customization Limits

• Prefer hooks, custom blocks in /local/blocks/, REST/placements — avoid editing /bitrix/modules/landing/.
• Tariff/restriction gates: \Bitrix\Landing\Restriction\Manager, Manager::FEATURE_* constants.
• Rights: \Bitrix\Landing\Rights, \Bitrix\Landing\Role.
• Dynamic blocks / CRM forms have separate scopes — check Site\Type before assuming public URL.
• Internal URL rules: \Bitrix\Landing\Internals\UrlRewriteTable (b_landing_urlrewrite) maps RULE → LANDING_ID inside a landing site — not a global SEO 301 table.

Checklist

• Loader::includeModule('landing') before facades.
• Mutate via Landing / Site / Block, not ad-hoc SQL on b_landing_*.
• Publish through publication() / Site::publication() after canPublication().
• Custom blocks under /local/blocks/, cache cleared.
• Counters/meta via hooks / additional fields — not hardcoded in every block.
• Classic CMS tasks stay outside Landing (see bitrix-cms-basics).