first commit
This commit is contained in:
191
README.MD
Normal file
191
README.MD
Normal file
@@ -0,0 +1,191 @@
|
||||
<p align="center">
|
||||
<img src="logo.png" width="128" alt="Product Countdown Module Logo">
|
||||
</p>
|
||||
|
||||
<h1 align="center">Product Discount Countdown for PrestaShop</h1>
|
||||
|
||||
<p align="center">
|
||||
<img src="https://img.shields.io/badge/PrestaShop-1.7.8%2B-blue.svg?logo=prestashop" alt="PrestaShop Version">
|
||||
<img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License: MIT">
|
||||
<a href="https://secure.wayforpay.com/donate/dd579282b23b4">
|
||||
<img src="https://img.shields.io/badge/Donate-WayForPay-orange.svg" alt="Donate via WayForPay">
|
||||
</a>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
A free, feature-rich PrestaShop module that displays a real-time countdown timer for products with specific prices (discounts), creating a sense of urgency to boost your sales.
|
||||
</p>
|
||||
|
||||
<hr>
|
||||
|
||||
<p align="center">
|
||||
<strong><a href="#-english">English</a></strong> | <strong><a href="#-українська">Українська</a></strong> | <strong><a href="#-русский">Русский</a></strong>
|
||||
</p>
|
||||
|
||||
<hr>
|
||||
|
||||
## 🇬🇧 English <a name="-english"></a>
|
||||
|
||||
Boost your store's conversion rate by visually highlighting limited-time offers. This module adds a customizable countdown timer directly on the product page for any item with an expiring specific price, encouraging customers to make a purchase before the deal is gone.
|
||||
|
||||
### ✨ Key Features
|
||||
|
||||
* **Real-Time Countdown:** Displays days, hours, minutes, and seconds remaining for a special offer.
|
||||
* **Highly Customizable:**
|
||||
* Set a **display threshold** (e.g., only show the timer if the offer ends in less than 30 days).
|
||||
* Choose the **display position** (after price, near add to cart, etc.).
|
||||
* Customize all **front-end text**.
|
||||
* Select custom **background and text colors** for the badge to match your theme.
|
||||
* Option to display the name of the Catalog Price Rule (e.g., "Black Friday Sale").
|
||||
* Add your own styles with a **Custom CSS** field.
|
||||
* **AJAX Compatible:** The timer correctly reloads when a customer changes product combinations (attributes).
|
||||
* **Smart Logic:**
|
||||
* Automatically detects the customer's country or uses the store's default.
|
||||
* Choose what happens when the timer expires: hide, reload the page, or show a message.
|
||||
* **Modern & Translatable:** Built using PrestaShop's modern translation system.
|
||||
* **Lightweight:** Clean code ensures minimal impact on your site's performance.
|
||||
|
||||
### 📸 Screenshots
|
||||
|
||||
#### Admin Configuration Interface
|
||||
*Manage all settings from a clean and intuitive back-office panel.*
|
||||
|
||||
|
||||
#### Front-End Countdown Timer
|
||||
*A clear and attractive timer displayed on the product page.*
|
||||
|
||||
|
||||
### ⚙️ Compatibility
|
||||
|
||||
* **PrestaShop:** Version 1.7.8 or newer.
|
||||
|
||||
### 🛠️ Installation
|
||||
|
||||
1. Download the latest release `.zip` file from the [releases page](https://github.com/panariga/productcountdown/releases).
|
||||
2. In your PrestaShop Back Office, navigate to **Modules > Module Manager**.
|
||||
3. Click on **"Upload a module"** and select the `.zip` file you downloaded.
|
||||
4. After installation, click **"Configure"** to set up the module.
|
||||
|
||||
### ❤️ Support & Contribution
|
||||
|
||||
This module is completely free and developed in my spare time. If you find it useful and it helps your business, please consider showing your appreciation with a small donation. Your support helps cover the costs of development and motivates me to continue improving this module and creating new ones.
|
||||
|
||||
<p align="center">
|
||||
<a href="https://secure.wayforpay.com/donate/dd579282b23b4" target="_blank" rel="noopener noreferrer">
|
||||
<img src="https://img.shields.io/badge/Donate-WayForPay-orange.svg" alt="Donate" style="height: 50px !important;width: 180px !important;" >
|
||||
</a>
|
||||
</p>
|
||||
|
||||
Found a bug or have a feature request? Please [open an issue](https://github.com/panariga/productcountdown/issues) on GitHub.
|
||||
|
||||
### 📄 License
|
||||
|
||||
This module is released under the [MIT License](LICENSE).
|
||||
|
||||
---
|
||||
|
||||
## 🇺🇦 Українська <a name="-українська"></a>
|
||||
|
||||
Збільшуйте конверсію вашого магазину, візуально виділяючи обмежені в часі пропозиції. Цей модуль додає таймер зворотного відліку на сторінку товару для будь-якого продукту з акційною ціною, що закінчується, спонукаючи клієнтів зробити покупку, доки пропозиція діє.
|
||||
|
||||
### ✨ Ключові можливості
|
||||
|
||||
* **Таймер у реальному часі:** Показує дні, години, хвилини та секунди, що залишилися до кінця акції.
|
||||
* **Гнучке налаштування:**
|
||||
* Встановіть **поріг відображення** (наприклад, показувати таймер, лише якщо акція закінчується менш ніж за 30 днів).
|
||||
* Виберіть **позицію для відображення** (після ціни, біля кнопки "Додати в кошик" тощо).
|
||||
* Налаштуйте всі **тексти, що бачить користувач**.
|
||||
* Виберіть **колір фону та тексту** для таймера, щоб він пасував до вашої теми.
|
||||
* Можливість показувати назву правила каталогу цін (напр., "Чорна п'ятниця").
|
||||
* Додайте власні стилі за допомогою поля **Custom CSS**.
|
||||
* **Сумісність з AJAX:** Таймер коректно перезавантажується, коли клієнт змінює комбінації товару (атрибути).
|
||||
* **Розумна логіка:**
|
||||
* Автоматично визначає країну клієнта або використовує країну магазину за замовчуванням.
|
||||
* Виберіть дію після закінчення таймера: приховати, перезавантажити сторінку або показати повідомлення.
|
||||
* **Сучасний та перекладний:** Створений з використанням сучасної системи перекладів PrestaShop.
|
||||
* **Легкий:** Чистий код забезпечує мінімальний вплив на продуктивність вашого сайту.
|
||||
|
||||
### 📸 Скріншоти
|
||||
|
||||
*(Дивіться скріншоти в англійській секції вище)*
|
||||
|
||||
### ⚙️ Сумісність
|
||||
|
||||
* **PrestaShop:** Версія 1.7.8 або новіша.
|
||||
|
||||
### 🛠️ Встановлення
|
||||
|
||||
1. Завантажте останню версію `.zip` файлу зі [сторінки релізів](https://github.com/panariga/productcountdown/releases).
|
||||
2. У вашій адмін-панелі PrestaShop перейдіть до **Модулі > Менеджер модулів**.
|
||||
3. Натисніть **"Завантажити модуль"** та виберіть завантажений `.zip` файл.
|
||||
4. Після встановлення натисніть **"Налаштувати"**, щоб сконфігурувати модуль.
|
||||
|
||||
### ❤️ Підтримка та внесок
|
||||
|
||||
Цей модуль є повністю безкоштовним і розроблений у мій вільний час. Якщо він вам подобається і допомагає вашому бізнесу, будь ласка, підтримайте його невеликим внеском. Ваша підтримка допомагає покрити витрати на розробку та мотивує мене продовжувати вдосконалювати цей модуль та створювати нові.
|
||||
|
||||
<p align="center">
|
||||
<a href="https://secure.wayforpay.com/donate/dd579282b23b4" target="_blank" rel="noopener noreferrer">
|
||||
<img src="https://img.shields.io/badge/Donate-WayForPay-orange.svg" alt="Підтримати" style="height: 50px !important;width: 180px !important;" >
|
||||
</a>
|
||||
</p>
|
||||
|
||||
Знайшли помилку або маєте ідею? Будь ласка, [створіть issue](https://github.com/panariga/productcountdown/issues) на GitHub.
|
||||
|
||||
### 📄 Ліцензія
|
||||
|
||||
Цей модуль випущено під [ліцензією MIT](LICENSE).
|
||||
|
||||
---
|
||||
|
||||
## 🇷🇺 Русский <a name="-русский"></a>
|
||||
|
||||
Увеличивайте конверсию вашего магазина, визуально выделяя ограниченные по времени предложения. Этот модуль добавляет таймер обратного отсчета на страницу товара для любого продукта с истекающей специальной ценой, побуждая клиентов совершить покупку, пока предложение действует.
|
||||
|
||||
### ✨ Ключевые возможности
|
||||
|
||||
* **Таймер в реальном времени:** Показывает дни, часы, минуты и секунды, оставшиеся до конца акции.
|
||||
* **Гибкая настройка:**
|
||||
* Установите **порог отображения** (например, показывать таймер, только если акция заканчивается менее чем через 30 дней).
|
||||
* Выберите **позицию для отображения** (после цены, возле кнопки "Добавить в корзину" и т.д.).
|
||||
* Настройте все **тексты, которые видит пользователь**.
|
||||
* Выберите **цвет фона и текста** для таймера, чтобы он соответствовал вашей теме.
|
||||
* Возможность отображать название правила каталога цен (напр., "Черная пятница").
|
||||
* Добавьте собственные стили с помощью поля **Custom CSS**.
|
||||
* **Совместимость с AJAX:** Таймер корректно перезагружается, когда клиент меняет комбинации товара (атрибуты).
|
||||
* **Умная логика:**
|
||||
* Автоматически определяет страну клиента или использует страну магазина по умолчанию.
|
||||
* Выберите действие после окончания таймера: скрыть, перезагрузить страницу или показать сообщение.
|
||||
* **Современный и переводимый:** Создан с использованием современной системы переводов PrestaShop.
|
||||
* **Легковесный:** Чистый код обеспечивает минимальное влияние на производительность вашего сайта.
|
||||
|
||||
### 📸 Скриншоты
|
||||
|
||||
*(Смотрите скриншоты в английской секции выше)*
|
||||
|
||||
### ⚙️ Совместимость
|
||||
|
||||
* **PrestaShop:** Версия 1.7.8 или новее.
|
||||
|
||||
### 🛠️ Установка
|
||||
|
||||
1. Скачайте последнюю версию `.zip` файла со [страницы релизов](https://github.com/panariga/productcountdown/releases).
|
||||
2. В вашей админ-панели PrestaShop перейдите в **Модули > Менеджер модулей**.
|
||||
3. Нажмите **"Загрузить модуль"** и выберите скачанный `.zip` файл.
|
||||
4. После установки нажмите **"Настроить"**, чтобы сконфигурировать модуль.
|
||||
|
||||
### ❤️ Поддержка и вклад
|
||||
|
||||
Этот модуль является полностью бесплатным и разработан в мое свободное время. Если он вам нравится и помогает вашему бизнесу, пожалуйста, поддержите его небольшим пожертвованием. Ваша поддержка помогает покрыть расходы на разработку и мотивирует меня продолжать улучшать этот модуль и создавать новые.
|
||||
|
||||
<p align="center">
|
||||
<a href="https://secure.wayforpay.com/donate/dd579282b23b4" target="_blank" rel="noopener noreferrer">
|
||||
<img src="https://img.shields.io/badge/Donate-WayForPay-orange.svg" alt="Поддержать" style="height: 50px !important;width: 180px !important;" >
|
||||
</a>
|
||||
</p>
|
||||
|
||||
Нашли ошибку или есть идея? Пожалуйста, [создайте issue](https://github.com/panariga/productcountdown/issues) на GitHub.
|
||||
|
||||
### 📄 Лицензия
|
||||
|
||||
Этот модуль выпущен под [лицензией MIT](LICENSE).
|
||||
Reference in New Issue
Block a user