How to Fix and Customize 1С-Bitrix Sites Without Touching the Core

Bitrix's #1 rule: never edit core files in /bitrix/. All customization goes through /local/. But finding which file in /local/templates/, /local/components/, or /local/php_interface/init.php to touch — and not breaking the update path — is what separates a $40/hr freelancer hour from a 3-second SimpleReview PR. Our SimpleReview Chrome extension already knows the Bitrix file layout and the "/local/ override" rule, so it edits the right file the first time and opens a PR you review.

mystore.ru
SimpleReview extension
+7 (495) 555-0099 · Доставка по РФ Личный кабинет · Избранное · Заказ
Корзина · 0 ₽
Смартфон Pro 256
79 990 ₽
Ноутбук Air 13"
119 990 ₽
Наушники Pro 2
24 990 ₽
+7 (495) 555-0099 · Доставка по РФ Личный кабинет · Избранное
Корзина · 0 ₽
FREEБесплатная доставка от 3 000 ₽ — каждый день
✓ Копирайт Битрикса убран · footer.php пропатчен · PR #42 готов
Популярные товары
Комментарий×
убрать копирайт Битрикса|
Fix it ✓ Done
Bitrix expert · ready
waiting for selection…
Detected
Platform1С-Битрикс 23
Шаблонmain
Filefooter.php
Fix plan
Удалить блок "Сайт работает на 1С-Битрикс" из /local/templates/main/footer.php · 1 файл
Result
Брендинг Битрикса убран. Лицензия не нарушена (коммерческая редакция).
✓ PR #42 opened
fix(footer): drop 1С-Битрикс copyright
footer.php · -4 lines
Кликни SimpleReview → выбери копирайт → Fix it → PR готов, без программиста
Есть правка по сайту на Битриксе, за которую фрилансер просит 2-3 тысячи? → SimpleReview найдёт нужный файл в /local/, откроет PR, не сломает обновление ядра.

Key Takeaways

  • Never edit /bitrix/ core — every Bitrix update will overwrite your changes. Always use /local/.
  • Most Bitrix edits are template-level (/local/templates/[theme]/) or component-template-level (/local/templates/[theme]/components/) — SimpleReview's Bitrix-aware agent knows this layout.
  • SimpleReview's agent knows the /bitrix//local/ override convention and writes to the correct path — it never patches core files.
  • Мы готовим модуль для 1С-Битрикс: Маркетплейс, который встраивает SimpleReview прямо в Контрольную панель (раздел Marketplace → Решения партнёров) — кнопка «Edit with SimpleReview» рядом с любым шаблоном или компонентом.
  • For payment-module / «Мой кабинет» / API integration work — use Vibers human-in-the-loop review: a real person checks the PR before you merge it to production.

The /bitrix/ vs /local/ Rule — Why Most Freelancer Hours Are Wasted

1С-Битрикс ships ~50,000 PHP files in the /bitrix/ directory. The temptation, for a quick freelancer, is to open /bitrix/templates/.default/header.php, edit it, save, done. That's a $2,000 mistake — the next time the client clicks SiteUpdate in the admin (and clients always click it), every edited file is overwritten with the vendor version.

The correct convention, baked into Bitrix since version 14.0:

PathWhat it isEdit?
/bitrix/Vendor core — modules, components, default templates, kernelNEVER
/local/Your customizations — overrides core paths transparentlyALWAYS
/upload/User uploads (images, files, infoblock attachments)Auto

The override is path-mirroring. If a component lives at /bitrix/components/bitrix/news.list/, you copy it to /local/components/bitrix/news.list/ and Битрикс automatically picks the /local/ version. Same for templates: /bitrix/templates/.default/ is overridden by /local/templates/.default/.

Warning: Some old tutorials suggest editing /bitrix/templates/[theme]/ directly. This was the pre-14.0 way and is now broken — the directory still exists for backward-compatibility but is the first thing wiped on update. Use /local/templates/[theme]/.

Three-Click Workflow with SimpleReview

  1. Install the SimpleReview Chrome extension from the Chrome Web Store. Free with your own AI key (Claude Code or Codex), и есть встроенный режим, если ключа нет.
  2. Connect your Bitrix repo. Paste a GitHub / GitLab / самохост Gitea / Bitbucket URL. Если сайт ещё не на Git, выдайте SFTP-креды — SimpleReview сам сделает рабочую копию и будет коммитить в свою ветку.
  3. Open your storefront, click the SimpleReview icon, click the element you want to change. Type the change in plain Russian or English: «убери Powered by 1C-Bitrix из футера», «добавь reCAPTCHA в форму обратной связи», «переведи кнопку В корзину на Купить сейчас». Click Fix it. The agent finds the corresponding file in /local/, creates the override if needed, and opens a Pull Request.

Common Bitrix Edits — and Where They Live

Hide "Powered by 1C-Bitrix" from the footer

The brand link is rendered by the footer template, usually inside a $APPLICATION->ShowPanel() region or a hardcoded block. The agent locates the active template (Settings → System → Site list → Template column), copies /bitrix/templates/[theme]/footer.php to /local/templates/[theme]/footer.php if it doesn't exist yet, and removes the line:

<?php
// /local/templates/[theme]/footer.php — before
<div class="footer-credit">
  Powered by <a href="https://www.1c-bitrix.ru/">1C-Bitrix</a>
</div>
<?$APPLICATION->ShowPanel(); ?>
</body></html>

// after — credit removed, ShowPanel() kept (it's the admin edit panel, do NOT remove)
<?$APPLICATION->ShowPanel(); ?>
</body></html>

Note: $APPLICATION->ShowPanel() renders the floating Битрикс admin edit panel for logged-in admins — keep it. The agent never removes that line.

Add reCAPTCHA to the contact form

The standard contact form is rendered by bitrix:main.feedback. To customize, copy its template:

# Source (do not edit):
/bitrix/components/bitrix/main.feedback/templates/.default/template.php

# Override target (where SimpleReview writes):
/local/templates/[theme]/components/bitrix/main.feedback/.default/template.php

The agent inserts the reCAPTCHA snippet right before the submit button, registers the secret-key check in /local/php_interface/init.php via an OnBeforeFormAdd event handler, and adds the site-key constant to /local/.settings_extra.php. Three files, one PR.

Fix the "критическая ошибка" (500) after a module update

The classic Bitrix 500: white screen with "Произошла критическая ошибка" or "Critical error" after a module update or kernel patch. 90% of cases are stale cache. Fix order:

# 1. Clear all cache layers
rm -rf /var/www/[site]/bitrix/cache/*
rm -rf /var/www/[site]/bitrix/managed_cache/*
rm -rf /var/www/[site]/bitrix/stack_cache/*

# 2. Verify DB credentials still match
cat /var/www/[site]/bitrix/php_interface/dbconn.php
# expects: $DBHost, $DBLogin, $DBPassword, $DBName

# 3. Check OPcache / APCu wasn't pinned to old bytecode
php -r "opcache_reset();"

# 4. If still broken — enable error display temporarily
# /bitrix/.settings.php → 'exception_handling' → 'debug' => true

SimpleReview's agent reads your hosting logs (or asks for the error output), pinpoints which of the three causes hit you, and either submits a config-fix PR or — if the error is in a vendor module — flags it for a human Vibers reviewer instead of guessing.

Translate "Add to Cart" / "В корзину" button text

Catalog button labels live in language files, NOT templates. The agent goes to:

/local/templates/[theme]/components/bitrix/catalog.element/.default/lang/ru/template.php
/local/templates/[theme]/components/bitrix/catalog.element/.default/lang/en/template.php

# inside, edit the constant:
<?php
$MESS["CATALOG_ADD"] = "Купить сейчас"; // was "В корзину"
$MESS["CATALOG_BUY"] = "Заказать в один клик";

This is the difference that saves the hour: a freelancer often patches the .tpl directly with hardcoded text, breaking i18n. The agent does it the Битрикс-correct way.

Speed up admin panel

The admin panel slowdown is almost always 5-10 unused modules loading on every request. Не лезьте в код — это admin-задача:

  1. Settings (Настройки) → System Settings (Настройки продукта) → Modules (Модули)
  2. Or: Marketplace → Установленные решения
  3. Disable modules you don't use: vote, blog, forum, learning, workflow, wiki, tasks, extranet if it's not a corporate portal.

The agent recognizes this as an admin-side task and won't generate code for it — it tells you to flip the switches yourself. Knowing when not to write code is half the value.

Bitrix Marketplace — Our Module

1С-Битрикс: Маркетплейс — №1 канал в РФ/СНГ для коммерческих модулей и шаблонов. Наш модуль (в работе) ставится через стандартный установщик: Marketplace → Каталог → найти "SimpleReview" → Установить. После активации в Битрикс-админке появляется кнопка "Edit with SimpleReview" рядом с любым шаблоном или компонентом — клик → правка → PR в репозиторий, который ваш разработчик ревьюит.

Если у вас сейчас сайт на Битрикс и есть GitHub/GitLab/самохост Bitbucket — наша Chrome-extension уже работает (без модуля): установить SimpleReview из Chrome Web Store.

Что встраивает модуль: отдельную кнопку в редакторе шаблонов (Контент → Структура сайта → Шаблоны), команду в контекстное меню компонента на публичной части (только для авторизованных админов), и пункт «SimpleReview» в раздел Marketplace → Решения партнёров.

Comparison Table — Freelancer vs SimpleReview

StepBitrix freelancer (₽1500-3000/час)SimpleReview agent
Brief30 min Telegram + ТЗType one sentence in the popup
FTP / repo setup30-60 min (every time)Once, then cached
Find the right file in /local/ vs /bitrix/30-90 min (depends on theme + module mix)Instant — knows the override convention
Create override path if missingOften skipped → patches /bitrix/ by mistakeAuto-creates /local/templates/... mirror
Make the edit5-30 min5-30 seconds
Open a PRRare — usually FTP pushAlways — review before merge
Cost for 1-line change₽1500-3000 (1 hour minimum)₽0 (BYO key) or pennies of API
Risk of breaking next updateHigh if they touched /bitrix/Zero — only writes to /local/

When You Do Want a Live Developer

This guide isn't anti-freelancer — it's anti-paying-an-hour-for-five-minutes. You absolutely want a human in the loop when:

Это и есть та доля задач, для которой существует Vibers human-in-the-loop review: реальный человек смотрит ваш PR, шлёт fix-up при необходимости, аппрувит до мержа. Используйте agent для 80%, человека — для 20% которые отрабатывают свою почасовую ставку.

Перестаньте платить за «найти файл»

SimpleReview's Bitrix-aware agent читает ваш репозиторий, знает /bitrix//local/ конвенцию, и открывает PR за секунды.

Установить SimpleReview Chrome Extension →

Сложная задача — модуль оплаты, миграция, аудит? Получить human review →

Frequently Asked Questions

Можно ли править сайт на Битриксе без программиста?
Да — для большинства правок шаблонов, текстов кнопок, файлов компонентов в /local/. Главное правило Битрикса: никогда не трогать /bitrix/ — следующее обновление перетрёт ваши изменения. Все кастомизации делаются через /local/templates/, /local/components/ и /local/php_interface/init.php. SimpleReview Chrome-extension знает эту конвенцию и пишет правки сразу в нужный файл в /local/, открывая Pull Request.
Как установить SimpleReview на Битрикс-сайт?
Установите Chrome-расширение из Chrome Web Store, подключите Git-репозиторий сайта (GitHub/GitLab/самохост Bitbucket/Gitea) или дайте SFTP-доступ. Расширение определяет Битрикс по структуре файлов и наличию /bitrix/ + /local/. Дополнительно мы готовим модуль для 1С-Битрикс: Маркетплейс, который встраивает SimpleReview прямо в Контрольную панель.
Что если у меня сайт на 1С-Битрикс: Управление сайтом, а не Bitrix24?
Именно для Битрикс: Управление сайтом (1С-Bitrix CMS) расширение и предназначено — там есть /bitrix/, /local/, шаблоны, компоненты. Bitrix24 (облачный портал) — это другой продукт, и его UI правится через настройки портала, а не через файлы. Мы поддерживаем все коммерческие редакции CMS: Старт, Стандарт, Малый бизнес, Бизнес, Веб-кластер.
Это безопасно для продакшен-сайта?
SimpleReview никогда не пушит в продакшен ветку напрямую — каждое изменение это Pull Request, который вы проверяете и мержите. В худшем случае вы отклоняете PR. Рекомендуем держать staging-копию (Битрикс-хостинги обычно её предоставляют через Резервное копирование → Восстановить на тестовом домене) и тестировать там перед мержем в продакшен.
Чем это отличается от заказа фрилансера за 2-3 тыс рублей за правку?
Скоростью и стоимостью повторной работы. Фрилансер тратит 1-2 часа просто чтобы развернуть окружение, найти нужный шаблон и понять структуру именно вашей редакции и темы — сама правка часто занимает 5 минут. SimpleReview уже знает структуру Битрикса (/bitrix/, /local/, .default/, шаблоны, компоненты), открывает PR за секунды, и стоит копейки API (или $0 на своём ключе Claude/Codex).
Работает ли это для редакций «Малый бизнес»/«Бизнес»/«Веб-кластер»?
Да. Структура /bitrix/ vs /local/ одинакова во всех коммерческих редакциях 1С-Битрикс: Управление сайтом начиная с версии 14.0. Разница только в наборе модулей (интернет-магазин, документооборот, e-mail-маркетинг и т.д.), но способ кастомизации шаблонов и компонентов идентичен. Веб-кластер добавляет особенности по кэшу — мы это учитываем.

Related

Sources