Barcodes
Добавляет штрихкоды Code 128, EAN-13 и QR в коллекции товаров Payload с печатью этикеток и опциональными кнопками в админке.
Установка
pnpm add payload-barcodes Описание
Плагин добавляет штрихкод и QR-код в документы товаров. Значение берётся из поля, которое вы укажете. Энкодеры для Code 128, EAN-13 и QR написаны по спецификации прямо в пакете, без сторонних зависимостей и вызовов внешних сервисов. Плагин построен поверх `@payloadcms/plugin-ecommerce` и работает с теми коллекциями, которые вы передадите в конфигурации. На каждой указанной коллекции регистрируется хук `afterChange`. Он срабатывает после записи документа, поэтому трансформирующие хуки (например, генерация slug) уже отработали. Хук сохраняет значение, формат symbology и текст ошибки, если значение невозможно закодировать. Запись происходит только при изменениях, а запрос помечается так, чтобы исключить повторный вызов хука. Настройки хранятся в глобале со slug `barcodes` (можно переопределить): имя поля-источника, формат (`code128` или `ean13`), что несёт QR (само значение или URL по шаблону), шаблон URL и флаг показа подписи. Эндпоинт `/api/barcodes/print` возвращает HTML-страницу с этикетками, чёрными на белом фоне. Страница вызывает диалог печати при загрузке, каждая этикетка умещается на одной странице. Доступ только для аутентифицированных пользователей. Изображения нигде не сохраняются. Оба кода отрисовываются при запросе страницы, поэтому изменение настроек сразу отражается на всех этикетках, а в базе не остаётся устаревших данных. Версия QR ограничена 10 (271 байт при уровне коррекции L, 213 при M), что покрывает артикул, SKU или URL товара. Code 128 использует набор B, печатные символы от пробела до тильды. EAN-13 проверяется, но не корректируется; функция `completeEan13` доступна для самостоятельного вычисления контрольной цифры. Запись через хук требует второго сохранения при создании нового документа, так как хук выполняется после первой записи. Главный entry point не импортирует React, что совместимо с частями Payload, стабильными между минорными релизами. Компонент `PrintButtons` подключается опционально из `payload-barcodes/client` и отрисовывает кнопки Print Barcode и Print QR Code без собственной стилизации, кроме отступов. Это позволяет наследовать стили админки. Если кнопки сломаются, сама печать продолжит работать.
О пакете
- Имя пакета
payload-barcodes- Последняя версия
1.0.0- Размер
- 50 кБ
- Лицензия
- MIT
- Загрузок в неделю
- 2
- Последняя публикация
- 21 авг. 2026 г.
Ещё от Poseidonas
Профиль автораAI Manager
Плагин Payload для автогенерации товарных описаний, заголовков, атрибутов и переводов через Claude, ChatGPT, Gemini или Kimi с пропуском уже сгенерированного контента.
EU VAT
Рассчитывает НДС ЕС для магазинов на Payload и записывает разбивку по каждому заказу: ставки, реверсивный заряд, проверку VIES и отчёт OSS.
Stock Reservation
Проверяет наличие варианта и цену до оплаты, резервирует остатки до подтверждения и закрывает пробелы чекаута в официальном плагине Payload ecommerce.
Stock Alerts
Отправляет письмо при падении остатков товара или варианта ниже порога, с поддержкой бэкордера и публичным полем статуса.
Shipping Rates
Добавляет зоны доставки, расчет стоимости и endpoint для quoted в магазинах на @payloadcms/plugin-ecommerce.
Shipping Classes
Добавляет поля веса, размеров и класса доставки в коллекции товаров и вариантов Payload с каноническим хранением в граммах и миллиметрах.
Похожие плагины
Ещё в категории «Коммерция»Product Reviews
Плагин добавляет в Payload v3 коллекцию reviews с оценкой от 1 до 5, модерацией статусов и данными aggregateRating для Google.
Stripe
Связывает коллекции Payload с ресурсами Stripe, обрабатывает webhook-события и проксирует вызовы API.
Tpay E-commerce Payment Adapter
Платёжный адаптер Tpay для @payloadcms/plugin-ecommerce: BLIK, банковские переводы и карты с проверкой вебхуков и учётом склада.
Google Merchant Center Ecommerce Integration
Синхронизируйте продукты из Payload CMS с Google Merchant Center.