=== Likert Survey ===
Contributors: sebastian
Tags: likert scale, survey, post feedback, ajax survey, user engagement, reader comments
Requires at least: 6.0
Tested up to: 6.7
Stable tag: 1.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Turn your blog posts into an interactive feedback machine using two-step Likert scale surveys and reader comments.

== Description ==

Likert Survey is a lightweight, high-performance, and user-friendly plugin that automatically appends interactive article rating surveys to the end of your blog posts. It features an advanced two-step user engagement flow (Progressive Disclosure) driven by asynchronous AJAX technology.

The reader first clicks an intuitive rating icon (from 1 to 5 stars). Once the system successfully logs the vote in the background, it seamlessly fades in an optional text area inviting the user to share more context or feedback. All collected entries are stored in a dedicated, isolated custom SQL database table to ensure maximum server performance and zero database bloat.

= Key Features =
* **Two-Step AJAX Workflow:** A seamless, zero-page-reload transitional flow shifting from icon selection directly to text comment submission.
* **Full Admin Panel Customization:** Change every piece of frontend text, field labels, survey questions, and success/error response messages directly from the dashboard. No .po/.mo translation files required.
* **Post Editor Metabox:** All text feedback left by readers for a specific article is listed inside a clean table at the very bottom of that post's edit screen.
* **Aggregated Ratings Summary:** A dedicated dashboard screen that beautifully summarizes the total score distribution counts for each blog post.
* **Smart Database Migrator:** Safely creates and automatically appends missing database columns (like the comments schema upgrade) upon activation or reactivation without wiping existing production records.
* **Core-Level Security:** Fully reinforced with cryptographic WP nonce verifications, strict textarea sanitization, and database input preparation rules.

== Installation ==

1. Upload the entire `likert-survey` directory to your server's `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu screen inside your WordPress dashboard.
3. Navigate to the new 'Likert Test' menu item in your admin sidebar to customize your survey's question and labels.
4. The rating form will automatically append to the bottom of all single blog posts. Alternatively, you can manually embed it anywhere using the `[likert_form]` shortcode.

== Frequently Asked Questions ==

= Can I completely translate the frontend texts into my preferred language? =
Absolutely. Every single label, icon description, prompt question, and alert notification can be customized directly under **Likert Test -> General Settings**.

= Where can I view the actual text comments left by users? =
The macro statistical counts (how many people gave 1 star vs 5 stars) are available under **Likert Test -> Ratings Summary**. The individual text feedback and comments written by readers are displayed inside a dedicated metabox panel at the very bottom of that specific post's individual editing interface.

= Does deleting the plugin wipe my collected survey data? =
The plugin respects your live production data. Under the main settings tab, you will find a toggle option named "Delete data on uninstall". If checked, completely deleting the plugin will drop the SQL tables and wipe all logs. If left unchecked, your feedback database will remain safe on your server in case of accidental deactivation.

== Changelog ==

= 1.0.0 =
* Initial stable release.
* Implemented the two-stage progressive disclosure AJAX engine (Rating -> Comment).
* Added a comprehensive administrative text customization dashboard panel.
* Embedded the custom administrative reader feedback comments Metabox within post edit screens.
* Integrated the automated database schema column modifier script running on plugin activation lifecycle events.

-----------------------------------------------------------------------------------------------------------------------------

Zmień swoje wpisy blogowe w interaktywne narzędzie opinii dzięki dwuetapowym ankietom skali Likerta i komentarzom czytelników.

== Description ==

Likert Survey to lekka, wydajna i przyjazna dla użytkownika wtyczka, która automatycznie dodaje interaktywne ankiety oceny artykułów na końcu Twoich wpisów na blogu. Wykorzystuje zaawansowany, dwuetapowy proces zaangażowania (Progressive Disclosure) oparty na technologii AJAX.

Użytkownik najpierw klika intuicyjną ikonę oceny (od 1 do 5), a po pomyślnym zapisie system płynnie wyświetla dodatkowe, opcjonalne pole tekstowe z prośbą o uzasadnienie opinii. Wszystkie zebrane dane trafiają do dedykowanej tabeli bazy danych, zapewniając pełne bezpieczeństwo i optymalną wydajność serwera.

= Główne zalety =
* **Dwuetapowy formularz AJAX:** Płynne przejście od wyboru oceny do wpisania komentarza bez przeładowywania strony.
* **Pełna personalizacja w kokpicie:** Możliwość zmiany każdego tekstu, etykiety, pytania oraz komunikatów sukcesu/błędu bezpośrednio z panelu administracyjnego.
* **Metabox w edytorze wpisu:** Wszystkie komentarze zostawione przez czytelników dla danego artykułu są widoczne bezpośrednio na dole jego ekranu edycji w panelu admina.
* **Podsumowanie ocen:** Przejrzysta tabela w kokpicie sumująca liczbę poszczególnych ocen dla każdego artykułu.
* **Automatyczna migracja bazy:** Bezpieczne tworzenie i aktualizacja struktury tabel SQL przy aktywacji/reaktywacji wtyczki bez utraty danych.
* **Bezpieczeństwo na poziomie Core WP:** Pełna weryfikacja kluczy nonce oraz rygorystyczne oczyszczanie danych tekstowych i bazodanowych.

== Installation ==

1. Prześlij cały katalog `likert-survey` do katalogu `/wp-content/plugins/`.
2. Aktywuj wtyczkę w menu 'Wtyczki' w panelu WordPressa.
3. Przejdź do nowej zakładki 'Likert Test' w menu bocznym kokpitu, aby dostosować teksty formularza.
4. Formularz automatycznie pojawi się pod treścią każdego pojedynczego wpisu blogowego. Możesz go również osadzić ręcznie za pomocą shortcodu `[likert_form]`.

== Frequently Asked Questions ==

= Czy mogę zmienić domyślne polskie teksty na inny język? =
Tak. Wszystkie etykiety, opisy ikonek, treść pytania oraz przyciski zmienisz w zakładce **Likert Test -> General Settings**. Wtyczka nie wymaga edycji plików językowych .po/.mo.

= Gdzie mogę przeglądać oceny i komentarze? =
Zbiorcze statystyki (ile osób przyznało daną ocenę) znajdziesz w zakładce **Likert Test -> Ratings Summary**. Treść konkretnych komentarzy tekstowych przypisanych do danego artykułu wyświetla się w specjalnej sekcji na samym dole edytora tego konkretnego posta.

= Czy odinstalowanie wtyczki czyści bazę danych? =
Wtyczka dba o porządek w bazie danych, ale szanuje Twoje dane produkcyjne. W ustawieniach głównych znajdziesz opcję "Delete data on uninstall". Jeśli ją zaznaczysz, całkowite usunięcie wtyczki trwale skasuje tabelę z ocenami oraz konfigurację. Jeśli opcja pozostanie odznaczona, Twoje dane będą bezpieczne w bazie na wypadek pomyłkowego kliknięcia.

== Changelog ==

= 1.0.0 =
* Pierwsze stabilne wydanie.
* Implementacja dwuetapowego przesyłania danych przez AJAX (Ocena -> Komentarz).
* Dodanie panelu administracyjnego z pełną personalizacją etykiet.
* Wdrożenie dedykowanego Metaboxa z komentarzami w edytorze wpisów WordPress.
* Automatyczne dopisywanie nowych kolumn do bazy danych przy reaktywacji wtyczki.