=== Kalkulator dodatku mieszkaniowego ===
Contributors: wmkopr
Tags: housing allowance, calculator, municipality, social assistance
Requires at least: 5.6
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 2.5.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Oblicza orientacyjną wysokość dodatku mieszkaniowego lokalnie w przeglądarce, bez wysyłania danych formularza na serwer.

== Description ==

Wtyczka udostępnia kalkulator orientacyjnej wysokości dodatku mieszkaniowego. Dodaj shortcode `[dmwk_dodatek_mieszkaniowy]` do strony i skonfiguruj wartości referencyjne w menu **Ustawienia > Dodatek mieszkaniowy**.

Pola liczbowe mogą korzystać z dużej klawiatury ekranowej przeznaczonej dla terminali dotykowych. Administrator może ją włączyć lub wyłączyć w menu **Ustawienia > Dodatek mieszkaniowy**. Pola liczb całkowitych i dziesiętnych korzystają z odpowiedniego układu klawiatury, a standardowe wprowadzanie danych z klawiatury fizycznej pozostaje dostępne.

Kalkulator uwzględnia:

* powierzchnię normatywną zależną od liczby osób w gospodarstwie domowym,
* zwiększenie powierzchni związane z niepełnosprawnością,
* dopuszczalne przekroczenie powierzchni normatywnej,
* kryterium dochodowe i nadwyżkę dochodu,
* wydatki przypadające na powierzchnię normatywną,
* ryczałty za brak centralnego ogrzewania, ciepłej wody i gazu przewodowego,
* udział własny gospodarstwa domowego,
* ustawowy limit dodatku, który rada gminy może ustalić w zakresie 50–90%,
* minimalną kwotę dodatku,
* podział wypłaty pomiędzy zarządcę budynku i wnioskodawcę.

= Prywatność =

Wartości wpisywane przez użytkownika nie są wysyłane do WordPressa ani żadnej usługi zewnętrznej. JavaScript wykonuje wszystkie obliczenia w przeglądarce użytkownika. Wtyczka nie zapisuje plików cookie, nie rejestruje tras REST API ani akcji AJAX.

Na serwerze zapisywane są wyłącznie ustawienia wprowadzone przez administratora. Wtyczka nie łączy się automatycznie z żadną usługą zewnętrzną.

= Ważne zastrzeżenie =

Wynik ma charakter informacyjny i nie stanowi decyzji administracyjnej ani porady prawnej. Uprawnienie do świadczenia i ostateczną wysokość dodatku ustala właściwy organ na podstawie złożonego wniosku i dokumentów. Administrator powinien weryfikować dane referencyjne po zmianach przepisów, nowych komunikatach Głównego Urzędu Statystycznego lub Urzędu Regulacji Energetyki oraz zmianach uchwał rady gminy.

Podstawowe źródła:

* [Ustawa o dodatkach mieszkaniowych](https://eli.gov.pl/eli/DU/2021/2021/ogl)
* [Komunikaty dotyczące przeciętnego wynagrodzenia – GUS](https://stat.gov.pl/sygnalne/komunikaty-i-obwieszczenia/)
* [Przeciętna cena energii elektrycznej dla gospodarstw domowych – URE](https://www.ure.gov.pl/pl/energia-elektryczna/ceny-wskazniki/7853,dok.html)

== Installation ==

1. Zainstaluj wtyczkę z pliku ZIP albo skopiuj jej katalog do `/wp-content/plugins/`.
2. Włącz wtyczkę.
3. Przejdź do **Ustawienia > Dodatek mieszkaniowy** i zweryfikuj dane referencyjne.
4. Dodaj shortcode `[dmwk_dodatek_mieszkaniowy]` do wybranej strony.

== Shortcode ==

Podstawowe użycie:

`[dmwk_dodatek_mieszkaniowy]`

Dostępne atrybuty:

* `tytul` – nagłówek wyświetlany nad formularzem; pusta wartość ukrywa nagłówek.
* `daty` – `tak` (domyślnie) albo `nie`; wartość `nie` ukrywa pola dat i wykorzystuje bieżącą datę witryny.
* `ile_osob` – początkowa liczba osób w gospodarstwie domowym.
* `rodo` – wartość `nie` ukrywa informację o przetwarzaniu danych dla danej instancji shortcodu.

Przykład:

`[dmwk_dodatek_mieszkaniowy tytul="Sprawdź orientacyjną kwotę" daty="nie"]`

== Frequently Asked Questions ==

= Czy wynik jest prawnie wiążący? =

Nie. Wynik jest wyłącznie wartością orientacyjną. Uprawnienie do świadczenia i wysokość dodatku ustala właściwy organ w decyzji administracyjnej.

= Czy wtyczka zapisuje dane wpisane do kalkulatora? =

Nie. Dane pozostają w przeglądarce użytkownika i nie są wysyłane na serwer. Wtyczka przechowuje jedynie konfigurację wprowadzoną przez administratora.

= Czy dane referencyjne są aktualizowane automatycznie? =

Nie. Brak automatycznych połączeń zewnętrznych ogranicza udostępnianie danych i zależność od innych usług, ale administrator musi aktualizować wartości po opublikowaniu nowych komunikatów urzędowych lub zmianach uchwał rady gminy.

= Czy kalkulator działa z pamięcią podręczną stron? =

Tak. Każde obliczenie jest wykonywane lokalnie i nie wymaga nonce ani dodatkowego żądania HTTP.

= Jakie formaty liczb są akceptowane? =

Akceptowane są liczby nieujemne z maksymalnie czterema miejscami po przecinku. Można używać przecinka dziesiętnego i spacji jako separatora tysięcy, na przykład `3 200,50`.

== Changelog ==

= 2.5.1 =

* Dodano sanityzację przesłanych ustawień przed ich walidacją i zapisaniem.
* Dodano escapowanie sformatowanej informacji o prywatności w chwili wyświetlania.
* Dodano unikalny prefiks `dmwk_` do nazwy shortcodu.

= 2.5.0 =

* Dodano ustawienie administratora umożliwiające włączanie i wyłączanie klawiatury ekranowej.
* Przywrócono standardową klawiaturę numeryczną lub dziesiętną urządzenia, gdy klawiatura ekranowa jest wyłączona.

= 2.4.0 =

* Dodano dużą klawiaturę ekranową dla terminali dotykowych.
* Dodano oddzielne tryby wprowadzania liczb całkowitych i dziesiętnych z przyciskami czyszczenia, usuwania ostatniego znaku i zatwierdzania.

= 2.3.0 =

* Przygotowano metadane i dokumentację wtyczki dla katalogu WordPress.org.
* Zaktualizowano deklarację zgodności z WordPressem 7.0.
* Zmieniono prefiksy globalnych klas, funkcji, stałych i opcji na unikalny prefiks `dmwk` oraz dodano migrację z wersji lokalnych.
* Skorygowano datę obowiązywania zmienionych zasad obliczeń na 1 lipca 2021 r.
* Ustawiono ustawowy bazowy limit dodatku na 70% oraz zakres modyfikacji przez gminę na 50–90%.
* Zaktualizowano domyślną cenę energii elektrycznej na podstawie oficjalnych danych za 2026 r. i uwzględniono podatek VAT.
* Dodano ścisłą walidację liczb całkowitych i dat oraz zabezpieczono tabele ustawień przed zapisaniem pustego zestawu danych.
* Usunięto wywołania zewnętrznych usług rejestracji wtyczki.
* Dodano usuwanie danych wtyczki podczas odinstalowania.

= 2.2.0 =

* Dodano informacje o autorze i odnośnik do pomocy.
* Rozszerzono walidację ustawień i danych kalkulatora.
* Przeniesiono wszystkie obliczenia do przeglądarki użytkownika.
