Skip to content

Каталог: галереи, размерные сетки, импорт и экспорт ​

Основы — категории, опции, варианты, цены, остаток — разобраны в быстром старте и разделе разработчику. Эта страница про четыре вещи, у которых своего раздела нет больше нигде.

Галерея товара ​

Несколько картинок на товар, основная первой. Своей таблицы под галерею у магазина нет, и это правило, а не экономия: галерея у 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-фид, который не то же самое, что экспорт выше
  • Настройки — настройки каталога и шаблоны страниц

pbShop — магазин для сайтов на PageBlocks