Каталог: галереи, размерные сетки, импорт и экспорт
Основы — категории, опции, варианты, цены, остаток — разобраны в быстром старте и разделе разработчику. Эта страница про четыре вещи, у которых своего раздела нет больше нигде.
Галерея товара
Несколько картинок на товар, основная первой. Своей таблицы под галерею у магазина нет, и это правило, а не экономия: галерея у PageBlocks уже есть целиком. pb_files — полиморфное хранилище: владелец строкой, поле полем, порядок сортировкой, подпись названием; загрузку и удаление делает его контроллер, а строки достаёт сама модель по имени поля. {$product->gallery} работает без единой нашей строки.
Поэтому магазин не создаёт схему, а объявляет поле. Поле называется gallery, тип — galleryfield в конструкторе продукта.
galleryfield — платный тип поля PageBlocks
На бесплатной редакции поле в форме не нарисуется, и загружать будет некуда. Это осознанный выбор: своя галерея означала бы второй механизм хранения файлов на том же сайте.
Витрина к отсутствию готова. При пустой галерее шаблон печатает одиночную картинку ровно как до появления поля, и галерея из одного кадра тоже считается пустой: переключать не с чего, а лишняя обвязка вокруг единственного снимка — это разъехавшаяся вёрстка на каждом товаре, у которого галерею не заполнили.
Само поле приехало с PageBlocks alfa36 — этот выпуск и вышел, чтобы его оживить. На платформе старше галерее негде жить. См. Что где лежит.
На уже работающем магазине поле приезжает миграцией
Сид пропускает поля, которые есть, а конструктор товара заведён задолго до галереи. То есть на работающем магазине сид её не добавил бы никогда: код галереи есть, а поля в форме нет, и заполнить её нечем. Чистая установка получает поле сидом, обновление — миграцией.
Печатаются только картинки, в порядке сортировки. Видео, положенное в галерею, пропускается, а не выводится тегом img.
Размерные сетки
Сетка — запись справочника, а не кусок текста, вклеенный в каждый товар: pb_shop_size_charts, своя вкладка Размерные сетки.
| Поле | Что в нём |
|---|---|
key | ключ |
name | как называется |
option_id | какую опцию сетка объясняет — «Размер», «Размер обуви» |
source | сама таблица текстом: первая строка — заголовки, первый столбец — размеры |
note | как мерить |
Сетка прикручивается полем конструктора size_chart_id и наследуется: своя сетка товара главнее, иначе берётся у его категории, иначе у родительской, до десяти уровней. Заполнять её у категории — обычный путь; у товара заполняют, когда у этой модели посадка не как у остальных в категории.
На странице товара сетка рисуется таблицей, и строка с выбранным покупателем размером подсвечивается — ровно поэтому сетка и называет опцию, а не висит сама по себе.
Найденная, но невыложенная сетка не покажет ничего
Наследование ищет ближайшую и не перескакивает через невыложенную, чтобы искать выше. Снимете сетку категории с публикации — таблица у этих товаров исчезнет, а не возьмётся от деда.
Импорт и экспорт: CSV и xlsx
Оба формата, в обе стороны, из раздела магазина. Без этого каталог любого размера не наполнить — поэтому это в ядре, а не модулем.
GET /mgr/pbs/catalog/export/csv
GET /mgr/pbs/catalog/export/xlsx
POST /mgr/pbs/catalog/importКолонки
В порядке выгрузки, и порядок не косметика — его видит человек, открывший файл в Excel. Сначала то, чем строка опознаётся, потом что это такое, потом деньги, потом склад, потом широкие текстовые колонки, уезжающие вправо:
alias sku type title categories currency price old_price
track_stock stock weight image menuindex published description contentПлюс те, что порождаются устройством вашего магазина:
price_<КОД>иold_price_<КОД>на каждую валюту сверх базовой;option_<КЛЮЧ>на каждую опцию справочника.
Как читается строка
Одна строка — это либо товар, либо вариант, и решает колонка sku: пусто — строка описывает товар, заполнено — вариант товара, названного в alias. То есть товар с тремя размерами — это четыре строки: своя и три вариантов.
Шесть колонок читаются только из строки товара и у вариантов игнорируются: type, categories, currency, track_stock, description, content. Они принадлежат товару, и вариант со своей категорией был бы противоречием, а не переопределением.
Ключ опознания — псевдоним у товара и артикул у варианта, а не id. Именно это делает импорт идемпотентным: тот же файл, применённый дважды, обновляет, а не удваивает.
Пустая ячейка при обновлении значение не стирает
Она означает «не указано», а не «очистить». Для обычного случая это верно — колонка, которую кто-то удалил из таблицы, не должна вытереть описания у всех товаров, — но и очистить поле опустошением ячейки нельзя. Очищайте в менеджере.
И ещё одно, что стоит знать: у alias нет уникального индекса в базе. Импорт считает его ключом, поэтому два товара с одинаковым псевдонимом получат импорт на тот, который попадётся первым. Записано как дефект; пока он не исправлен, не заводите повторяющихся псевдонимов.
Импорт отчитывается, сколько товаров и вариантов создано, сколько обновлено и сколько строк пропущено.
Дальше
- SEO и фиды — YML-фид, который не то же самое, что экспорт выше
- Настройки — настройки каталога и шаблоны страниц