obsidian/Магазин обуви (apelsincom)/Быстрый старт для нового разработчика (apelsincom).md

Быстрый старт для нового разработчика (apelsincom)

Эта страница для того, кто впервые открыл проект. Идите по шагам сверху вниз. Непонятные слова — в Глоссарий (apelsincom).

1. Получите доступы

Сервер, FTP и домен — на странице Доступы и окружение (apelsincom). Админка в этом проекте может быть недоступна — работаем по FTP и через API.

Скачайте к себе по FTP папку /local/ — это все доработки сайта. Ядро /bitrix/ целиком тянуть не нужно.

2. Разберитесь, как всё устроено

• Прочитайте Архитектура и структура каталогов (apelsincom) — общая картина и правило «всё в /local/».
• Прочитайте Компоненты и шаблоны компонентов — здесь ключевая особенность: своих компонентов нет, вся вёрстка и логика вывода — в переопределённых шаблонах штатных компонентов.
• Загляните в REST API (richcode.api) — сайт отдаёт наружу REST-интерфейс; для этого проекта это важнее, чем витрина.
• Бегло — Маршрутизация и ЧПУ (apelsincom) и Инфоблоки и каталог (apelsincom).

3. Сразу узнайте про «грабли»

Это лучше прочитать до того, как что-то менять — Известные проблемы и рекомендации (apelsincom):

• Номер инфоблока каталога (2) зашит в коде во многих местах.
• В webroot лежит публичный бэкап shoes.zip (~1.27 ГБ) — риск утечки.
• В шаблоне умного фильтра валяется файл-дубль template copy 1.php.
• Рядом с активными шаблонами лежат исходные bootstrap_v4 — не перепутайте, какой правите.

4. Проверьте, что всё работает

• Откройте витрину: главная, каталог /catalog/, карточка товара.
• Проверьте, отвечает ли API по настроенному пути (по умолчанию /api/). Точный путь и токены — в настройках модуля richcode.api (нужен админ) либо у прежней команды. См. REST API (richcode.api).
• Посмотрите свежий error_log в корне аккаунта на предмет ошибок.

5. Сделайте первое простое изменение

Тренируйтесь на чём-то безопасном:

1. Поправьте текстовую область в /include/ (например, контакты в подвале — сейчас там демо-данные). Как — в Компоненты и шаблоны компонентов#Include-области.
2. Сбросьте кэш и проверьте страницу (Кэширование и обслуживание (apelsincom)).

Чего лучше не делать на старте:

• Не трогать ядро /bitrix/ — работайте только в /local/.
• Не менять номер инфоблока и коды свойств без полной проверки — они зашиты в шаблонах и в API.
• Не выкладывать и не генерировать бэкапы в webroot.
• Не делать массовых правок без резервной копии.

См. также

• Магазин обуви (apelsincom) — Обзор
• Архитектура и структура каталогов (apelsincom)
• Известные проблемы и рекомендации (apelsincom)