commit 32fb50819d3127153efc57106ef7fe424d239d3e Author: nertyog Date: Sun Jul 5 20:06:44 2026 +0300 Initial commit with readme and instructions diff --git a/Instruction ru-uk-en.txt b/Instruction ru-uk-en.txt new file mode 100644 index 0000000..ca6a12b --- /dev/null +++ b/Instruction ru-uk-en.txt @@ -0,0 +1,112 @@ +============================================================================= +Poll Widget [NAT] +Version: 1.0.0 +Compatibility: OpenCart 3.0.x / ocStore 3.0.x +Author: NAT +Contact: info@nat.od.ua +============================================================================= + +--- [ РУССКИЙ ] ------------------------------------------------------------- + +ОПИСАНИЕ: +Poll Widget [NAT] — это функциональный модуль для создания опросов и голосований на вашем сайте. +1. Позволяет создавать опросы с мультиязычными вопросами и вариантами ответов. +2. Гибкие правила голосования: разрешение/запрет голосования для гостей, настройка лимита голосов на одного пользователя или IP-адрес. +3. Настраиваемый формат результатов: вывод в процентах, в количестве голосов, всё вместе или скрытие результатов (только текст благодарности). +4. Встроенный дизайн: полное управление цветами виджета (фон, текст, кнопки, полосы прогресса) прямо из админки с помощью удобного ColorPicker. +5. Продвинутая статистика: просмотр реальных голосов, возможность ручной корректировки результатов (управление статистикой) и подробный журнал голосов с фиксацией IP, имени пользователя и страницы, с которой был отдан голос. + +УСТАНОВКА: +1. Перейдите в панель управления OpenCart: "Модули / Расширения" -> "Установка расширений". +2. Загрузите архив `poll_widget_nat.ocmod.zip`. +3. Перейдите в "Модули / Расширения" -> "Модификаторы" и нажмите синюю кнопку "Обновить" (Очистить кэш). +4. Перейдите в "Система" -> "Пользователи" -> "Группы пользователей", выберите вашу группу (Administrator), нажмите "Выделить все" в правах просмотра и изменения, затем сохраните. +5. Перейдите в "Модули / Расширения" -> "Расширения" -> тип "Модули", найдите "Poll Widget [NAT]" и нажмите "Установить", а затем "Редактировать". + +ОБНОВЛЕНИЕ: +1. Загрузите новый архив через "Установка расширений" поверх старого. +2. Обновите кэш в разделе "Модификаторы". +3. Очистите кэш браузера (Ctrl+F5) на странице настроек модуля. + +УДАЛЕНИЕ: +1. Перейдите в "Модули / Расширения", найдите модуль и нажмите красную кнопку "Деинсталлировать". +2. Перейдите в "Установка расширений", найдите модуль в истории загрузок и удалите его файлы. +3. Обновите кэш модификаторов. + +ИНСТРУКЦИЯ ПО ИСПОЛЬЗОВАНИЮ: +- Создание опроса: Добавьте новый опрос, заполните вопросы и ответы для нужных языков, настройте права для гостей и лимиты. +- Внешний вид: Перейдите во вкладку "Дизайн и цвета", чтобы настроить палитру виджета под стиль вашего магазина. +- Статистика: Во вкладке "Статистика и накрутка" вы можете видеть реальные данные, добавлять бонусные голоса и отслеживать в журнале, кто и на какой странице проголосовал. +- Вывод на сайте: Чтобы виджеты появились в магазине, перейдите в Дизайн -> Схемы (Layouts) и добавьте созданные модули в нужные позиции на выбранных страницах. + + +--- [ УКРАЇНСЬКА ] ---------------------------------------------------------- + +ОПИС: +Poll Widget [NAT] — це функціональний модуль для створення опитувань та голосувань на вашому сайті. +1. Дозволяє створювати опитування з мультимовними питаннями та варіантами відповідей. +2. Гнучкі правила голосування: дозвіл/заборона голосування для гостей, налаштування ліміту голосів на одного користувача або IP-адресу. +3. Налаштовуваний формат результатів: виведення у відсотках, у кількості голосів, все разом або приховування результатів (тільки текст подяки). +4. Вбудований дизайн: повне керування кольорами віджета (фон, текст, кнопки, смуги прогресу) прямо з адмінки за допомогою зручного ColorPicker. +5. Просунута статистика: перегляд реальних голосів, можливість ручного коригування результатів (управління статистикою) та детальний журнал голосів із фіксацією IP, імені користувача та сторінки, з якої було віддано голос. + +ВСТАНОВЛЕННЯ: +1. Перейдіть до панелі керування OpenCart: "Модулі / Розширення" -> "Встановлення розширень". +2. Завантажте архів `poll_widget_nat.ocmod.zip`. +3. Перейдіть до "Модулі / Розширення" -> "Модифікатори" і натисніть синю кнопку "Оновити". +4. Перейдіть до "Система" -> "Користувачі" -> "Групи користувачів", виберіть вашу групу (Administrator), натисніть "Виділити все" у правах перегляду та зміни, збережіть. +5. Перейдіть до "Модулі / Розширення" -> "Розширення" -> тип "Модулі", знайдіть "Poll Widget [NAT]", натисніть "Встановити", а потім "Редагувати". + +ОНОВЛЕННЯ: +1. Завантажте новий архів через "Встановлення розширень" поверх старого. +2. Оновіть кеш у розділі "Модифікатори". +3. Очистіть кеш браузера (Ctrl+F5) на сторінці налаштувань модуля. + +ВИДАЛЕННЯ: +1. Перейдіть у "Модулі / Розширення", знайдіть модуль та натисніть червону кнопку "Деінсталювати". +2. Перейдіть у "Встановлення розширень", знайдіть модуль в історії та видаліть його файли. +3. Оновіть кеш модифікаторів. + +ІНСТРУКЦІЯ З ВИКОРИСТАННЯ: +- Створення опитування: Додайте нове опитування, заповніть питання та відповіді для потрібних мов, налаштуйте права для гостей та ліміти. +- Зовнішній вигляд: Перейдіть у вкладку "Дизайн та кольори", щоб налаштувати палітру віджета під стиль вашого магазину. +- Статистика: У вкладці "Статистика та керування" ви можете бачити реальні дані, додавати бонусні голоси та відстежувати в журналі, хто і на якій сторінці проголосував. +- Виведення на сайті: Щоб віджети з'явилися в магазині, перейдіть до Дизайн -> Схеми (Layouts) і додайте створені модулі в потрібні позиції на обраних сторінках. + + +--- [ ENGLISH ] ------------------------------------------------------------- + +DESCRIPTION: +Poll Widget [NAT] is a powerful tool for creating responsive voting widgets and polls on your store. +1. Create unlimited polls with multi-language questions and answers. +2. Flexible voting rules: allow/disallow guest voting and set strict limits on how many times a single user or IP can vote. +3. Customizable results: display results as percentages, vote counts, both, or hide them entirely (showing only a thank-you message). +4. Built-in visual customization: adjust the widget's background, text, borders, buttons, and progress bar colors directly from the admin panel using color pickers. +5. Advanced statistics and management: view real stats, manually adjust/boost vote counts, and monitor a detailed log of voters (including Name, IP, Date, and the exact Page URL where the vote was cast). + +INSTALLATION: +1. Go to OpenCart admin panel: "Extensions" -> "Installer". +2. Upload the `poll_widget_nat.ocmod.zip` archive. +3. Go to "Extensions" -> "Modifications" and click the blue "Refresh" button. +4. Go to "System" -> "Users" -> "User Groups", edit your group (Top Administrator), click "Select All" for Access and Modify permissions, then Save. +5. Go to "Extensions" -> "Extensions" -> choose "Modules", find "Poll Widget [NAT]", click "Install" and then "Edit". + +UPDATE: +1. Upload the new zip file via Extension Installer over the old one. +2. Refresh modifications cache. +3. Hard refresh your browser cache (Ctrl+F5) on the module settings page. + +UNINSTALLATION: +1. Go to Extensions -> Modules, click the red "Uninstall" button next to the module. +2. Go to the Extension Installer history and delete the module files. +3. Refresh modifications cache. + +INSTRUCTION: +- Poll Creation: Navigate to the module settings, click "Add New", configure the question and answers per language, and set guest/limit rules. +- Design: Use the "Design & Colors" tab to set the color scheme for your widget so it perfectly matches your theme. +- Stats Management: Go to the "Statistics & Management" tab to view real votes, add custom "bonus" votes to specific answers, and track exactly where and who is voting in the logs. +- Layouts Assignment: To display the widgets on your storefront, go to Design -> Layouts, select your desired layout (e.g., Home, Category, Information), and add the created module to your preferred position. + +_________ + +Support: info@nat.od.ua \ No newline at end of file diff --git a/readme.txt b/readme.txt new file mode 100644 index 0000000..6785ae1 --- /dev/null +++ b/readme.txt @@ -0,0 +1,48 @@ +Terms & Conditions (License & Support Policy) +By purchasing and downloading this extension, you strictly agree to the following terms: + +Single Domain License: One purchase allows you to install and use the extension on exactly one (1) live domain and one (1) local/test environment. You need a separate License Key for each additional live project. + +License Activation: The module requires a License Key to function. Please email info@nat.od.ua with your Order ID and Domain Name after purchase to receive your key. + +Support: We provide free technical support for bugs and standard installation issues. Support is available via email (info@nat.od.ua). Please allow up to 24-48 hours for a response. + +Compatibility: The module is guaranteed to work on standard OpenCart / ocStore installations. We cannot guarantee out-of-the-box compatibility with heavily customized core files or third-party checkout/theme modules, though we will do our best to assist you. + +Refund Policy: We offer a 100% refund if the extension is completely non-functional on a standard OpenCart setup and our support team is unable to fix it. We do not issue refunds for "change of mind" or if you have already requested and received a domain license key. + +Distribution: The code is open-source (no IonCube), meaning you can modify it for your own needs. However, you may not resell, redistribute, share, or publish this extension in any form. + + +DESCRIPTION: +Poll Widget [NAT] is a powerful tool for creating responsive voting widgets and polls on your store. +1. Create unlimited polls with multi-language questions and answers. +2. Flexible voting rules: allow/disallow guest voting and set strict limits on how many times a single user or IP can vote. +3. Customizable results: display results as percentages, vote counts, both, or hide them entirely (showing only a thank-you message). +4. Built-in visual customization: adjust the widget's background, text, borders, buttons, and progress bar colors directly from the admin panel using color pickers. +5. Advanced statistics and management: view real stats, manually adjust/boost vote counts, and monitor a detailed log of voters (including Name, IP, Date, and the exact Page URL where the vote was cast). + +INSTALLATION: +1. Go to OpenCart admin panel: "Extensions" -> "Installer". +2. Upload the `poll_widget_nat_OC_30_1_0.ocmod.zip` archive. +3. Go to "Extensions" -> "Modifications" and click the blue "Refresh" button. +4. Go to "System" -> "Users" -> "User Groups", edit your group (Top Administrator), click "Select All" for Access and Modify permissions, then Save. +5. Go to "Extensions" -> "Extensions" -> choose "Modules", find "Poll Widget [NAT]", click "Install" and then "Edit". + +UPDATE: +1. Upload the new zip file via Extension Installer over the old one. +2. Refresh modifications cache. +3. Hard refresh your browser cache (Ctrl+F5) on the module settings page. + +UNINSTALLATION: +1. Go to Extensions -> Modules, click the red "Uninstall" button next to the module. +2. Go to the Extension Installer history and delete the module files. +3. Refresh modifications cache. + +INSTRUCTION: +- Poll Creation: Navigate to the module settings, click "Add New", configure the question and answers per language, and set guest/limit rules. +- Design: Use the "Design & Colors" tab to set the color scheme for your widget so it perfectly matches your theme. +- Stats Management: Go to the "Statistics & Management" tab to view real votes, add custom "bonus" votes to specific answers, and track exactly where and who is voting in the logs. +- Layouts Assignment: To display the widgets on your storefront, go to Design -> Layouts, select your desired layout (e.g., Home, Category, Information), and add the created module to your preferred position. + +Support: info@nat.od.ua \ No newline at end of file