Етикетки товарів

Етикетки (badges), це кольорові значки на фото товарів. Вони допомагають клієнтам швидко розпізнати акції, новинки, бестселери та товари з низьким залишком.

Увімкнення модуля

Перейдіть до WooCommerce > Polski > Магазинні модулі та увімкніть Етикетки товарів. Модуль замінить стандартний значок “Розпродаж!” налаштовуваними етикетками.

Автоматичні етикетки

Генеруються автоматично на основі даних товару. Після увімкнення працюють одразу на всіх товарах.

Розпродаж (sale)

З’являється, коли товар має акційну ціну. За замовчуванням показує відсоток знижки (наприклад, -25%) замість тексту “Розпродаж!”.

Налаштування формату:

Опція	Опис	Приклад
Відсоток	Відсоток знижки	-25%
Сума	Сума заощадження	-50 zł
Текст	Власний текст	Акція
Відсоток + сума	Обидва значення	-25% (-50 zł)

// Зміна формату значка розпродажу
add_filter('polski/badges/sale_format', function (): string {
    return 'percentage'; // 'percentage', 'amount', 'text', 'both'
});

Для варіативних товарів відсоток рахується від варіанта з найбільшою знижкою.

Новинка (new)

З’являється на товарах, доданих протягом останніх X днів. За замовчуванням 14 днів.

// Зміна періоду новинки
add_filter('polski/badges/new_days', function (): int {
    return 30; // товари, додані протягом останніх 30 днів
});

Низький залишок на складі (low stock)

З’являється, коли залишок на складі впаде нижче порогу. Поріг встановлюється в WooCommerce > Налаштування > Товари > Склад > Поріг низького залишку.

Текст етикетки: Останні X шт.! (де X, це поточна кількість).

// Власний текст етикетки низького залишку
add_filter('polski/badges/low_stock_text', function (string $text, int $stock): string {
    if ($stock <= 3) {
        return 'Ostatnie sztuki!';
    }
    return sprintf('Zostało %d szt.', $stock);
}, 10, 2);

Бестселер

З’являється на товарах, що найкраще продаються. За замовчуванням топ 10 товарів.

// Зміна ліміту бестселерів
add_filter('polski/badges/bestseller_limit', function (): int {
    return 20;
});

Список бестселерів кешується в transient API (за замовчуванням 24 години).

Ручні етикетки (для кожного товару)

Ви також можете додавати власні значки до окремих товарів. У редакторі товару відкрийте Дані товару > Етикетки.

Опції ручної етикетки:

• Текст, вміст, що відображається на значку (наприклад, “Рекомендуємо”, “Eco”, “Безкоштовна доставка”)
• Колір фону, колір значка (color picker)
• Колір тексту, колір тексту на значку
• Позиція, лівий верх, правий верх, лівий низ, правий низ
• Пріоритет, порядок відображення, коли товар має кілька етикеток

Максимум 4 етикетки на товарі (автоматичні + ручні разом). Ліміт захищає мініатюру від захаращення.

// Зміна ліміту етикеток на товарі
add_filter('polski/badges/max_per_product', function (): int {
    return 3;
});

Позиціонування етикеток

Автоматичні етикетки мають типові позиції:

Етикетка	Типова позиція
Розпродаж	Лівий верх
Новинка	Правий верх
Низький залишок	Лівий низ
Бестселер	Правий верх

Змініть позиції в налаштуваннях модуля. Дві етикетки в одній позиції розташовуються вертикально.

Форми етикеток

Доступні форми:

• Прямокутник, типовий
• Прямокутник із заокругленими кутами, border-radius
• Коло, для коротких текстів (наприклад, “-25%”)
• Стрічка, декоративна форма зі скосом

Налаштування в опціях: WooCommerce > Polski > Магазинні модулі > Етикетки > Форма.

Видимість етикеток

Етикетки відображаються на:

• Сторінках категорій та архівів (картки товарів)
• Сторінці окремого товару (головне фото)
• Слайдері товарів (модуль слайдера)
• Швидкому перегляді (модуль quick view)
• Результатах пошуку

Ви можете вимкнути етикетки для окремих місць:

// Вимкнення етикеток на сторінці окремого товару
add_filter('polski/badges/show_on_single', '__return_false');

Етикетки для варіативних товарів

Для варіативних товарів (variable products):

• Розпродаж, показує найбільший відсоток знижки серед усіх варіантів
• Низький залишок, з’являється, коли хоча б один варіант має низький залишок
• Новинка, на основі дати додавання товару (не варіанта)

Стилізація CSS

CSS-класи:

• .polski-badge, базовий клас етикетки
• .polski-badge--sale, розпродаж
• .polski-badge--new, новинка
• .polski-badge--low-stock, низький залишок
• .polski-badge--bestseller, бестселер
• .polski-badge--custom, ручна етикетка
• .polski-badge--top-left, позиція лівий верх
• .polski-badge--top-right, позиція правий верх
• .polski-badge--bottom-left, позиція лівий низ
• .polski-badge--bottom-right, позиція правий низ
• .polski-badge--rectangle, прямокутна форма
• .polski-badge--circle, форма кола
• .polski-badge--ribbon, форма стрічки

Приклад стилізації:

.polski-badge--sale {
    background-color: #dc2626;
    color: #ffffff;
    font-weight: 700;
    font-size: 0.75rem;
    padding: 4px 8px;
}

Продуктивність

Етикетки кешуються в meta товару (_polski_badges_cache) та оновлюються під час збереження товару. Бестселери перераховуються раз на 24 години (transient API).

Усунення проблем

Етикетка розпродажу не показує відсоток, перевірте, чи товар має встановлену звичайну ціну. Без неї неможливо обчислити відсоток.

Ручна етикетка не з’являється, перевірте ліміт етикеток. Якщо товар уже має 4 етикетки, ручна не відобразиться.

Етикетки перекривають кнопку швидкого перегляду, змініть позицію етикеток або кнопки quick view в налаштуваннях.

Повідомлення про проблеми: github.com/wppoland/polski/issues

Ця сторінка має виключно інформаційний характер і не є юридичною консультацією. Перед впровадженням проконсультуйтеся з юристом. Polski for WooCommerce, це програмне забезпечення з відкритим кодом (GPLv2), що надається без гарантій.