=== Informator Podatkowy — kalkulatory ===
Contributors: semperparatus
Tags: calculator, tax, poland, vat, shortcode
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Eleven Polish tax calculators you can insert with a block or a shortcode. They compute in the browser: no cookies, no accounts, no data sent anywhere.

== Description ==

This plugin adds Polish tax calculators to WordPress. Every calculation runs **entirely in the visitor's browser**. Nothing is sent to any server, neither ours nor yours.

The calculators are written in Polish, because Polish tax law is what they compute. The plugin interface and this readme are the only parts in English.

**What you get**

* KSeF calculator — when mandatory e-invoicing starts for a given business, and the penalties; shows that the PLN 10,000 threshold works one way only
* Health contribution — by form of taxation, with lump-sum thresholds counted cumulatively
* Form of taxation — the full burden of three forms including social security, with the break-even point
* Does a UK Ltd make sense — five questions that filter out cases where it does not apply
* Creator income — donations, subscriptions and collaborations, and which is which for tax purposes
* Who determines IR35 status — after the threshold change of April 2026
* UK VAT threshold — zero pounds versus GBP 90,000, depending on whether the business is established in the UK
* Seafarer's path — income tax exemption versus the abolition relief
* Annual limits — the lump-sum tax limit, the quarterly lump-sum limit and the statutory bookkeeping limit, converted with the National Bank of Poland euro rate
* Tax deadline calendar — social security, VAT and income tax dates, shifted to the next working day where the law requires it
* VAT calculator — net to gross and back, showing the provision each rate comes from

**Privacy**

The calculators set no cookies, use no local storage and send nothing the visitor types. The plugin makes no outbound network requests from PHP. By default the JavaScript files are served from the plugin directory, so the visitor's browser never connects to an external domain.

An option lets you load the newest version from informatorpodatkowy.pl instead, so changes in the law reach your site within an hour rather than waiting for a plugin update. That option is **disabled by default** and has to be switched on deliberately.

**Accessibility and performance**

Each calculator is a single file of roughly 10 kB compressed, loaded as an ES module (so it does not block rendering) and only on the pages where the block or shortcode is actually used. The components use Shadow DOM, so your theme's styles cannot break them and their styles cannot leak onto your page.

== Installation ==

1. Upload the `informator-podatkowy` directory to `/wp-content/plugins/`, or install the plugin from the WordPress admin.
2. Activate the plugin from the Plugins screen.
3. Insert the "Kalkulator podatkowy" block in the editor, or use the shortcode.

Shortcode:

`[informator narzedzie="kalkulator-ksef" motyw="auto"]`

Attributes (their names are Polish because they are part of the public shortcode API and must stay stable):

* `narzedzie` — the tool identifier; the full list is under Settings → Informator Podatkowy
* `motyw` — `jasny` (light, default), `ciemny` (dark) or `auto`
* `cta-href` — the address of your contact form; omit it and no button appears
* `cta-tekst` — the button label

== Frequently Asked Questions ==

= Do the calculators send user data anywhere? =

No. Everything is computed in the browser. There are no cookies, no local storage and no network requests once the file has loaded. You can confirm this in the Network tab of your browser's developer tools.

= Do I need a cookie consent banner because of this plugin? =

Not because of this plugin. It sets no cookies. With the default settings the files are served from your own domain, so no connection to a third-party server is made at all.

= What happens when the law changes? =

With the default settings the thresholds are updated together with the plugin. If you want a faster reaction, enable loading from informatorpodatkowy.pl in the settings; changes then reach your site within an hour.

= Will a calculator break my site's design? =

It should not. The tools are web components using Shadow DOM: your CSS does not reach inside them and their CSS does not escape. You choose the colour scheme with the `motyw` attribute.

= Are the results tax advice? =

No. They are indicative. Every calculator states the legal position it is based on and what it does not compute. A tax decision depends on the facts of the case, which a form cannot capture.

= Which WordPress version is required? =

WordPress 6.5 and PHP 7.4. Version 6.5 is required because the plugin uses the built-in ES module support introduced there.

= May I remove the link to informatorpodatkowy.pl? =

Please do not. It is the only thing we ask in return. The link carries the `nofollow` attribute, so it affects neither your rankings nor ours.

== Screenshots ==

1. The KSeF calculator inserted in a post, light theme
2. The same calculator in the dark theme
3. The "Kalkulator podatkowy" block in the editor with its settings panel
4. The plugin settings screen with the list of tools and their shortcodes

== Changelog ==

= 1.1.1 =
* Fixed: the tool scripts were never loaded on the front end. Usage was recorded while the content was being rendered, but the enqueue ran earlier, in `wp_head`, so the list of used tools was always empty. The custom element appeared in the markup and nothing rendered in its place, with no console error and no log entry. Modules are now requested at render time, which is safe because script modules are printed in the footer.

= 1.1.0 =
* Three new tools: annual limits (lump-sum tax, quarterly lump-sum, statutory bookkeeping), the tax deadline calendar and the VAT calculator
* Limits converted with the National Bank of Poland euro rate from the first working day of October, with the rate and its date shown
* The calendar accounts for deadlines falling on a Saturday or a statutory holiday being moved to the next working day, including 24 December, a public holiday in Poland since 2025
* The VAT calculator shows, for every rate, the provision it comes from
* Minimum WordPress version raised to 6.5, which brings built-in ES module support
* Readme rewritten in English, as required by the plugin directory

= 1.0.0 =
* First release
* Eight calculators, a Gutenberg block and a shortcode
* Colour schemes: light, dark, automatic
* The script loads only on pages where a tool is actually used
* Optional loading of the newest rules from informatorpodatkowy.pl

== Upgrade Notice ==

= 1.1.1 =
Fixes calculators not appearing on the front end. Recommended for everyone.

= 1.1.0 =
Three new tools and a raised minimum WordPress version of 6.5.

= 1.0.0 =
First release.
