SEO и фиды для площадок
Товары и разделы магазина — не ресурсы MODX, поэтому ничто, обходящее дерево ресурсов, их не найдёт. Ровно эту задачу и решают три раздела ниже.
Микроразметка
Страница товара печатает JSON-LD: Product с предложениями и BreadcrumbList. Страницы разделов печатают список. Включено по умолчанию и настройки не требует.
Product несёт название, адрес, картинку, описание и одну из двух форм предложения:
- простой
Offerс ценой — у обычного товара; AggregateOfferсlowPrice,highPriceиofferCount— у составного.
Почему JSON-LD, а не микроданные в вёрстке
Решение принято под эту витрину, и главная причина — составной товар. Его цену страница на сервере не печатает: блок цены остаётся пустым, его заполняет скрипт магазина, когда покупатель выберет размер. Вешать itemprop="price" там не на что — узла с ценой в ответе сервера нет, и микроданные либо соврали бы нулём, либо молчали. Варианты при этом на сервере известны, поэтому JSON-LD печатает честный AggregateOffer там, где микроданным печатать нечего.
Две причины помельче, но в ту же сторону: разметку, расползшуюся атрибутами по дивам, владелец теряет при первой же правке вёрстки, и у одного блока одно правило экранирования вместо правила в каждом атрибуте.
У товара без цены в текущей валюте блока предложений не печатается вовсе. Это намеренно: Offer без цены Google считает ошибкой и выбрасывает товар целиком, а price: 0 обещал бы бесплатно. Витрина такой товар тоже не продаёт — цена в карточке пустая.
Точкой переопределения это не является. Сайт, которому нужна своя разметка, печатает её из своего чанка карточки, а не правит эту.
Карта сайта
По умолчанию выключена. Впишите в pbshop_sitemap_route адрес, который хотите, — например sitemap-shop.xml, — и маршрут появится.
Это запасной путь, а не основной
Основной — добавить адреса магазина секцией в ту карту, которую сайт уже собирает: Seo\CatalogUrls отдаёт их ровно для этого.
Настройка пуста по умолчанию — решение, обратное префиксу каталога, и причина есть. Карту сайта почти на любом сайте уже кто-то делает, и /sitemap.xml занят. Магазин, забравший этот адрес при установке, отнял бы у сайта карту целиком и отдал бы вместо неё один каталог.
Написать туда sitemap.xml можно. Это просто осознанный выбор хозяина сайта, а не умолчание пакета.
Одна карта, пока каталог в неё помещается; 5000 адресов на файл, а не разрешённые стандартом 50 000, потому что карту читает робот и ответ, который не дошёл, не увидит никто. Каталог больше отвечает индексом карт, а не первой страницей: молча обрезать хвост значило бы оставить магазину на двадцать тысяч товаров карту, которая выглядит полной, тогда как остальное просто не индексируется — и заметить это можно только пересчётом.
changefreq и priority здесь нет, и фильтра robots.txt тоже. Если часть каталога закрыта от индексации, нужен свой контроллер поверх CatalogUrls — там фильтр и применяют: компонент не может опереться на site-owned слой, где это правило живёт.
Open Graph не реализован. Сказано прямо, чтобы не искали: тегов OG не печатается нигде. Это слой шаблона страницы сайта.
Фиды для площадок
YML-фид для двух украинских площадок:
https://ваш-сайт/pbshop/feed/prom.xml
https://ваш-сайт/pbshop/feed/rozetka.xmlЭто не Яндекс.Маркет
Оба фида — потомки YML, и из-за этого их легко принять за один формат с мелкими расхождениями. Они написаны по документации самих площадок, а не по спецификации Яндекса, и это не один формат.
Адрес лежит под pbshop/, а не под префиксом каталога, намеренно: ссылку вбивают в кабинет площадки один раз, и она не должна меняться от того, что владелец переименовал витрину из /shop в /katalog. Фид работает и при выключенной витрине: магазин может торговать только на площадках.
Чем эти два различаются
| Prom | Rozetka | |
|---|---|---|
| Варианты | group_id склеивает предложения в товар с различиями | такого поля нет вовсе — каждый вариант отдельным предложением, склеивает сама площадка при модерации |
| Портальная категория | принимает у предложения | только атрибутом у категории |
| Лишние теги | игнорирует | названы причиной провала импорта |
| Остаток | необязателен | обязателен у каждого предложения |
Последняя строка и есть причина, по которой состав предложения собирается разрешённым списком под каждую площадку, а не «как у Prom, только убрать лишнее». У Prom написано, что не описанные в документации теги будут проигнорированы; у Rozetka такого обещания нет, зато «лишние или отсутствующие теги» названы причиной провала импорта.
Чем настраивается
| Настройка | Умолчание | Что делает |
|---|---|---|
pbshop_feed_currency | пусто | валюта фида; пусто — валюта магазина |
pbshop_feed_company | пусто | юрлицо в шапке фида |
pbshop_feed_vendor | пусто | производитель у товаров, у которых своего нет |
pbshop_feed_ttl | 60 | сколько минут собранный файл живёт на диске |
pbshop_feed_key | пусто | непустое значение требует ?key= в адресе |
У фида валюта ровно одна
Цены в pbShop фиксированные на валюту и по курсу не пересчитываются — см. Валюты. Rozetka требует rate у каждой валюты, то есть ровно то, чего у этого магазина нет. Она же принимает только UAH, USD и EUR.
Пустой feed_company означает, что тег не печатается: пустой <company> площадка читает как ошибку, а не как «не указано». feed_vendor существует потому, что у Rozetka <vendor> обязателен у каждого предложения, а колонки под него нет: у товара он берётся полем конструктора vendor или brand.
Фид кешируется на диске и пересобирается, когда устарел, а записывается атомарно — чтобы робот никогда не забрал недописанный файл. Час, а не «каждый раз»: за фидом робот приходит по своему расписанию, и сборка на каждый заход означала бы полный обход каталога по чужому запросу, то есть способ положить магазин, запросив фид десять раз подряд.
feed_key пуст потому, что фид и так публичен по смыслу, а площадка войти по паролю не умеет. Но каталог целиком одним файлом забирают и конкуренты, поэтому способ закрыть адрес обязан быть.
Чего здесь нет
- Ecommerce-событий для GA4 и Метрики. Не печатаются.
shop.js— место, где им жить. - Обмена с 1С, МойСклад, CRM. Это платные модули, и про них стоит сказать прямо: задела под них в ядре пока нет ни одного куска. Ни
external_idу товара, ни хозяина цены и остатка, ни событийPRODUCT_*, ни журнала обменов. Если покупаете в расчёте на будущий обмен — покупайте по тому, что на этом сайте.
Канонический адрес товара с 301 с чужого, ЧПУ и поля seo_title / seo_description у товара и категории работают и относятся к каталогу — см. быстрый старт. Отфильтрованные и отсортированные страницы закрыты noindex,follow, а постраничность остаётся открытой.