- JavaScript 95.9%
- PHP 4%
- CSS 0.1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Wtyczka nie działała od pierwszego wydania i nie było tego widać. Użycie narzędzia oznaczał shortcode (i blok) w trakcie renderowania treści, a właściwe wp_enqueue_script_module() wykonywał callback wpięty w wp_enqueue_scripts. Ten hook biegnie w wp_head, czyli PRZED wypisaniem treści — więc w chwili, gdy kolejka pytała o listę użytych narzędzi, lista była zawsze pusta. Żaden moduł nie trafiał na stronę. Objaw był podstępny: znacznik <kalkulator-…> pojawiał się w HTML-u poprawnie, strona zwracała 200 i wyglądała na sprawną, tylko w miejscu kalkulatora nie było nic. Bez błędu w konsoli, bez wpisu w logu, bez ostrzeżenia z Plugin Check. Poprawka: moduł zamawiany jest teraz od razu, w informator_oznacz_uzycie(), czyli w momencie renderowania. Jest to bezpieczne, bo moduły skryptowe wypisują się w stopce, a stopka zawsze następuje po treści. Osobny callback i jego hook zostały usunięte; tablica $informator_uzyte służy już tylko za zabezpieczenie przed wielokrotnym zamówieniem tego samego narzędzia. Wykryte przy uruchomieniu wtyczki na realnej instalacji i obejrzeniu strony w przeglądarce. Sprawdzone po poprawce: trzy narzędzia na jednej stronie ładują się, renderują i liczą. Plugin Check nadal bez błędów. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> |
||
| assets/narzedzia | ||
| blok | ||
| .gitignore | ||
| informator-podatkowy.php | ||
| LICENSE | ||
| README.md | ||
| readme.txt | ||
| uninstall.php | ||
Informator Podatkowy — wtyczka WordPressa
Osiem kalkulatorów podatkowych do wstawienia blokiem Gutenberga albo
shortcode'em. Liczą wyłącznie w przeglądarce: bez ciasteczek, bez
localStorage, bez wysyłania czegokolwiek na serwer.
Strona projektu: https://informatorpodatkowy.pl/dla-webmasterow/
Szybki start
[informator narzedzie="kalkulator-ksef" motyw="auto"]
Atrybuty: narzedzie, motyw (jasny | ciemny | auto), cta-href, cta-tekst.
Pełna lista narzędzi: Ustawienia → Informator Podatkowy.
Skąd biorą się pliki w assets/narzedzia/
To zbudowane komponenty webowe (Lit, Shadow DOM), każdy samowystarczalny,
~10 kB po gzipie. Nie edytować ich tutaj — źródła są w semper-lit/
w repozytorium serwisu, a wtyczka-wp/spakuj.sh kopiuje świeży build przy
pakowaniu. Ręczna zmiana zostanie nadpisana przy najbliższym wydaniu.
Zasady, których wtyczka się trzyma
- Zero połączeń sieciowych po stronie PHP. Wtyczka nigdzie nie dzwoni.
- Pliki JS w paczce, nie z CDN-a. Wymóg repozytorium WordPress.org, a przy okazji: strona działa niezależnie od naszego serwera, a przeglądarka odwiedzającego nie łączy się z obcą domeną. Opcja ładowania najświeższej wersji z informatorpodatkowy.pl jest domyślnie wyłączona.
- Skrypt tylko tam, gdzie użyto narzędzia — nie na każdej podstronie.
- Blok renderowany po stronie serwera tą samą funkcją co shortcode, więc nie mogą się rozjechać.
- Edytor bloku bez JSX — brak kroku budowania, więc to, co w repozytorium, jest tym, co się wykonuje.
Rozwój
php -l informator-podatkowy.php # składnia
../spakuj.sh # build ZIP do pobrania
Przed zgłoszeniem do WordPress.org: zrzuty ekranu (readme deklaruje cztery) i przejście Plugin Check.
Licencja
GPL-2.0-or-later.