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.
/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:
| Path | What it is | Edit? |
|---|---|---|
/bitrix/ | Vendor core — modules, components, default templates, kernel | NEVER |
/local/ | Your customizations — overrides core paths transparently | ALWAYS |
/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/.
/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
- Install the SimpleReview Chrome extension from the Chrome Web Store. Free with your own AI key (Claude Code or Codex), и есть встроенный режим, если ключа нет.
- Connect your Bitrix repo. Paste a GitHub / GitLab / самохост Gitea / Bitbucket URL. Если сайт ещё не на Git, выдайте SFTP-креды — SimpleReview сам сделает рабочую копию и будет коммитить в свою ветку.
- 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-задача:
- Settings (Настройки) → System Settings (Настройки продукта) → Modules (Модули)
- Or: Marketplace → Установленные решения
- Disable modules you don't use:
vote,blog,forum,learning,workflow,wiki,tasks,extranetif 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.
Comparison Table — Freelancer vs SimpleReview
| Step | Bitrix freelancer (₽1500-3000/час) | SimpleReview agent |
|---|---|---|
| Brief | 30 min Telegram + ТЗ | Type one sentence in the popup |
| FTP / repo setup | 30-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 missing | Often skipped → patches /bitrix/ by mistake | Auto-creates /local/templates/... mirror |
| Make the edit | 5-30 min | 5-30 seconds |
| Open a PR | Rare — usually FTP push | Always — review before merge |
| Cost for 1-line change | ₽1500-3000 (1 hour minimum) | ₽0 (BYO key) or pennies of API |
| Risk of breaking next update | High 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:
- Модули с 1С-интеграцией (Управление сайтом ↔ 1С:Предприятие через CommerceML). Catalog sync, order export, balance updates — деньги и склад идут через эти данные, ошибка стоит дороже разработчика.
- Миграция Bitrix24 ↔ Bitrix CMS. Это два разных продукта с разной структурой (REST API vs file-based), и автоматизированной миграции нет — каждый случай уникальный.
- Платёжные модули (ЮKassa, Robokassa, Сбербанк-эквайринг, Т-Банк). Любая правка платёжки требует ручного теста в sandbox + продакшен-инцидента ≠ простой опечатки.
- Сложная бизнес-логика: workflow в документообороте, кастомные инфоблоки с десятками свойств, агенты (cron-задачи Битрикса) с зависимостями.
- Security audit, особенно перед открытием админки в интернет или после установки стороннего модуля из Маркетплейса с низким рейтингом.
Это и есть та доля задач, для которой существует Vibers human-in-the-loop review: реальный человек смотрит ваш PR, шлёт fix-up при необходимости, аппрувит до мержа. Используйте agent для 80%, человека — для 20% которые отрабатывают свою почасовую ставку.
Перестаньте платить за «найти файл»
SimpleReview's Bitrix-aware agent читает ваш репозиторий, знает /bitrix/ → /local/ конвенцию, и открывает PR за секунды.
Сложная задача — модуль оплаты, миграция, аудит? Получить human review →
Frequently Asked Questions
/local/. Главное правило Битрикса: никогда не трогать /bitrix/ — следующее обновление перетрёт ваши изменения. Все кастомизации делаются через /local/templates/, /local/components/ и /local/php_interface/init.php. SimpleReview Chrome-extension знает эту конвенцию и пишет правки сразу в нужный файл в /local/, открывая Pull Request./bitrix/ + /local/. Дополнительно мы готовим модуль для 1С-Битрикс: Маркетплейс, который встраивает SimpleReview прямо в Контрольную панель./bitrix/, /local/, шаблоны, компоненты. Bitrix24 (облачный портал) — это другой продукт, и его UI правится через настройки портала, а не через файлы. Мы поддерживаем все коммерческие редакции CMS: Старт, Стандарт, Малый бизнес, Бизнес, Веб-кластер./bitrix/, /local/, .default/, шаблоны, компоненты), открывает PR за секунды, и стоит копейки API (или $0 на своём ключе Claude/Codex)./bitrix/ vs /local/ одинакова во всех коммерческих редакциях 1С-Битрикс: Управление сайтом начиная с версии 14.0. Разница только в наборе модулей (интернет-магазин, документооборот, e-mail-маркетинг и т.д.), но способ кастомизации шаблонов и компонентов идентичен. Веб-кластер добавляет особенности по кэшу — мы это учитываем.Related
Sources
- dev.1c-bitrix.ru — Официальная документация для разработчиков
- docs.bitrix24.com — Документация Bitrix24 (для контекста — это другой продукт, не CMS)
- marketplace.1c-bitrix.ru — Маркетплейс модулей и решений (где появится наш модуль)
- Курс «Разработчик Bitrix Framework» — раздел про
/local/и переопределение компонентов - SimpleReview — Chrome Web Store