1. Вступ
Цей потужний інструмент дозволяє створювати динамічну таблицю лідерів для ваших клієнтів на основі їхніх покупок на WooCommerce. Заохочуйте конкуренцію, винагороджуйте найкращих клієнтів візуальними медалями та призами, підвищуючи залученість та лояльність.
За допомогою цього плагіна ви можете:
- Відображати список найкращих покупців щомісяця на основі щомісячної суми або кількості замовлень
- Автоматично призначати золоті, срібні та бронзові медалі.
- Призначати реальні продукти як призи для переможців.
- Надсилати сповіщення переможцям.
- CSV-файл із генерацією таблиці лідерів
Ця документація допоможе вам швидко встановити, налаштувати та використовувати всі функції плагіна.
2. Основні характеристики
- Динамічна таблиця лідерів: Відображайте список ваших клієнтів у режимі реального часу на основі налаштованих критеріїв.
- Система медалей: Автоматично присуджуйте золоті, срібні та бронзові медалі клієнтам з найвищим рейтингом.
- Підтримка шорткодів: Відображайте таблицю лідерів будь-де на вашому сайті за допомогою простого шорткоду.
- Зручний інтерфейс налаштувань: Простий інтерфейс для налаштування всіх опцій плагіна.
- Керування призами: Можливість налаштовувати та призначати щомісячні призи (товари з вашого магазину) для 3 найкращих позицій безпосередньо з адміністративного меню плагіна.
- Розрахунок щомісячної покупки: Точний розрахунок щомісячної суми покупки кожного користувача, враховуючи лише «виконані» замовлення для справедливого ранжування.
- Тільки зареєстровані користувачі: Забезпечення справедливості та точності даних шляхом включення лише зареєстрованих користувачів до змагання з таблиці лідерів.
- Детальна інформація про користувача (для адміністраторів/зареєстрованих користувачів): Адміністратори можуть переглядати дані користувача (повне ім’я, електронну пошту, телефон та посаду) в інтерфейсі таблиці лідерів. Увійшли користувачі можуть переглядати свій власний рейтинг та деталі в таблиці лідерів.
- CSV-файл з генерацією таблиці лідерів
Скріншоти плагіна
3. Встановлення та активація
- Завантажте плагін: ZIP-архів плагіна.
- Увійдіть у WordPress: Перейдіть до панелі адміністратора вашого сайту WordPress.
- Перейдіть до плагінів: У бічному меню перейдіть до розділу “Плагіни” > “Додати новий”.
- Завантаження плагіна: Натисніть кнопку “Завантажити плагін” у верхній частині сторінки.
- Вибір файлу: Натисніть “Вибрати файл” і виберіть завантажений ZIP-архів (
leaderboard-for-woocommerce.zip). - Встановлення: Натисніть кнопку “Встановити зараз”.
- Активувати: Після успішного встановлення натисніть кнопку “Активувати плагін”.
- Перейдіть до налаштувань: Тепер ви можете знайти налаштування плагіна в меню “WooCommerce” > “Налаштування” > вкладка “Таблиця лідерів”.
4. Налаштування плагіна
Усі налаштування плагіна доступні в панелі адміністратора WordPress: WooCommerce > Налаштування > Таблиця лідерів.
4.1. Загальні налаштування
[Заповніть цей розділ детальною інформацією про загальні налаштування. Наприклад:]
- Кількість покупців на сторінці: Встановіть максимальну кількість покупців, які будуть відображатися в таблиці лідерів на сторінці.
- Приховати елементи керування місяцем/роком: Поставте цей прапорець, щоб приховати випадаючі списки вибору місяця та року за замовчуванням. Це можна змінити атрибутом “hide_controls” у шорткоді.
- Приховати таблицю призів: Поставте цей прапорець, щоб приховати таблицю щомісячних призів за замовчуванням. Це можна змінити атрибутом “hide_prizes”ribute у шорткоді.
- Тема таблиці лідерів: Виберіть візуальну тему для таблиці лідерів.
4.2. Налаштування призів (щомісячні призи)
Цей розділ дозволяє вам призначати певні продукти WooCommerce як призи для переможців. Призи призначаються щомісяця.
- Знайдіть щомісячні призи в адміністративному меню WordPress у розділі WooCommerce.
- Натисніть кнопку «Додати новий щомісячний приз».
- Встановіть назву для потрібного місяця, наприклад, березень 2025. Виберіть місяць і рік у випадаючих списках відповідно (березень 2025).
- Виберіть товари для 1-3 місць як призи. Ви можете вибрати будь-яку їх кількість (PRO-версія).
P.S.У безкоштовній версії плагіна ви можете вибрати лише один приз за кожне місце
5. Використання шорткодів
Плагін надає зручний шорткод для відображення таблиці лідерів на будь-якій сторінці чи публікації.
5.1. Шорткод [leaderboard_monthly]
Цей шорткод відображає основну таблицю лідерів. Він має кілька атрибутів для налаштування відображення.
Доступні атрибути:
| Атрибут | Опис | Можливі значення | За замовчуванням |
|---|---|---|---|
місяць |
Вказує місяць, за який відображається таблиця лідерів. | Число від 1 до 12. | Поточний місяць. |
рік |
Вказує рік, за який відображається таблиця лідерів. | Чотиризначне число (наприклад, 2024). | Поточний рік. |
hide_controls |
Показати або приховати фільтри місяць/рік та пагінацію. | true або 1, false або 0 |
false |
per_page |
Максимальна кількість користувачів для відображення в таблиці на сторінці. | Будь-яке ціле число. | Значення з налаштувань плагіна (кількість покупців на сторінку). |
hide_prizes |
Приховати або показати таблицю призів. | true або 1, false або 0 |
false |
sort_by |
Критерії сортування (PRO версія) | amount, order_count |
amount |
Основне використання:
[leaderboard_monthly]Відображає таблицю лідерів за поточний місяць із налаштуваннями за замовчуванням.
Розширене використання:
[leaderboard_monthly month="5" year="2025" per_page="20" hide_controls="1" hide_prizes="1"]Відображає таблицю лідерів за травень 2025 року, 20 записів на сторінці, з прихованою пагінацією, випадаючими списками місяців і років, а також таблицею призів.
Ви можете використовувати шорткод безпосередньо у файлах шаблонів PHP:
<?php echo do_shortcode('[leaderboard_monthly month="5" year="2025" per_page="20"]'); ?>6. Сповіщення електронною поштою (PRO версія)
Плагін Leaderboard for WooCommerce містить автоматизовану систему сповіщень електронною поштою, щоб інформувати ваших найкращих клієнтів про їхні досягнення та призи.
- Вміст електронного листа: Кожен електронний лист – це персоналізоване вітальне повідомлення, яке містить:
- Ім’я переможця.
- Його переможну позицію (наприклад, “позиція 1”).
- Місяць та рік перемоги.
- Візуальний емодзі медалі (🥇, 🥈, 🥉), що відповідає їхньому рейтингу.
- Деталі призового(их) продукту(ів), який(і) вони виграли, включаючи назву продукту, мініатюру зображення (якщо є) та пряме посилання на продукт у вашому магазині.
- Обов’язкові дані: Електронні листи надсилаються лише за умови, що:
- Верх Покупці знайдено для вибраного місяця та року.
- Призи налаштовано для всіх 3 найкращих позицій для цього конкретного місяця та року.
- Користувач-переможець має дійсну адресу електронної пошти, пов’язану з його обліковим записом.
- Обробка помилок: Плагін реєструє помилки, якщо:
- Найкращих покупців не знайдено.
- Призи не налаштовано для всіх 3 найкращих позицій.
- Адреса електронної пошти користувача відсутня.
- Виникають проблеми з надсиланням електронних листів через функцію
wp_mail()WordPress (наприклад, проблеми з налаштуванням пошти сервера).
7. Генерація CSV-файлу (PRO версія)
Плагін Leaderboard for WooCommerce дозволяє експортувати дані таблиці лідерів у CSV-файл.
У меню адміністратора просто виберіть потрібний місяць і рік і натисніть кнопку “Експортувати в CSV”
8. Часті запитання (FAQ)
- Як розраховуються найкращі покупці?
- Плагін розраховує щомісячну суму покупок або кількість замовлень (PRO версія) для кожного користувача. Враховуються лише замовлення зі статусом «Завершено».
- Як призначаються призи?
- Ви можете встановити призи (товари з вашого магазину) за 1-е, 2-е та 3-є місця в адміністративному меню плагіна (розділ «Щомісячні призи»). Безкоштовна версія обмежена 1 призом за кожне місце.
9. Підтримка
Якщо у вас є запитання або виникли проблеми, не розглянуті в цій документації, будь ласка, зверніться до нашої служби підтримки.
© 2025 Олександр Каліновський. Усі права захищено.