=== QROVA QR Codes & Girocode ===
Contributors: miliienko
Tags: qr code, girocode, epc, vcard, woocommerce
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

QR codes for links, Wi-Fi, vCard and WhatsApp — plus an EPC payment code on unpaid WooCommerce orders. Generated in the browser.

== Description ==

This plugin creates QR codes **directly in the browser**. Nothing is sent to a third-party server, no image files are written to your server, and nothing about your visitors is recorded.

**What you can do with it**

* A code for a website, an email address or a phone number
* Wi-Fi access to print and hang up — guests scan instead of typing the password
* A digital business card (vCard) for trade fairs, flyers or your email signature
* A WhatsApp contact with a prefilled message
* **An EPC payment code (Girocode) on WooCommerce orders**

**The payment code for invoices**

With advance payment or bank transfer, customers type IBAN, amount and payment reference by hand. That is where transposed digits and missing order numbers come from, and matching payments to orders turns into manual work.

The EPC payment code per EPC069-12 solves this: the customer scans it with a banking app, and payee, IBAN, amount and payment reference are already filled in. The code appears automatically on every order that is not paid yet.

The standard is used by banks in the SEPA euro area (Germany, Austria, Switzerland for euro accounts, and others), so the code is shown only for orders in EUR.

**How to place a code**

As the block "QR Code" in the editor, or as a shortcode:

`[qrova_qr data="https://example.com" size="200" download="yes"]`

With `download="yes"` buttons for PNG and SVG appear. SVG scales without loss and is therefore the format print shops ask for — from a business card to a poster.

**Privacy**

Codes are generated locally by the bundled library qrcode-generator (MIT licence). There is no connection to an external service, no tracking and no cookies, so the plugin can be used without a cookie notice.

**Static and dynamic codes**

The codes created here are static: the target is part of the pattern. What is printed stays — that is reliable and free, but it cannot be changed after printing.

If you want to change the target later, or evaluate scans, you need dynamic codes with a redirect. This plugin deliberately does not do that, because it requires a server that performs the redirect. The difference is explained on the [plugin page](https://qrova.io/wordpress-plugin/).

== Installation ==

1. Install and activate the plugin.
2. Open the "QR Codes" menu, create a code and download it as PNG or SVG — or copy the shortcode shown there.
3. For the payment code on orders: under "QR Codes" enter the account holder and IBAN, then switch the display on.

== Frequently Asked Questions ==

= Is any data sent to an external service? =

No. Codes are generated in the browser. Neither your content nor visitor data leaves your website.

= Does the plugin work without WooCommerce? =

Yes. WooCommerce is only needed for the payment code on orders. Every other function works independently.

= Which size does a code need for printing? =

A rule of thumb is one tenth of the reading distance: for 50 cm distance about 5 cm edge length. For printing use the SVG file, it stays sharp at any size.

= Why does my code look different after a change? =

Every content produces its own pattern. Change the text and the code changes — a code that is already printed still leads to the old target.

= Can I change the target of a printed code afterwards? =

Not with static codes, that is inherent to the format. Dynamic codes with a redirect are needed for that.

= Which currencies does the payment code support? =

The EPC standard covers euro payments inside SEPA, so the code is only displayed for orders in EUR.

== Third-party library ==

The plugin bundles [qrcode-generator](https://github.com/kazuhikoarase/qrcode-generator) 1.4.4 by Kazuhiko Arase, published under the MIT licence. Both the readable source (`assets/qrcode.js`) and the minified build (`assets/qrcode.min.js`) are included, along with the licence text (`assets/qrcode-LICENSE.txt`). The library runs in the browser only.

== Screenshots ==

1. Generator in the admin area: enter an address, the code appears at once - built in the browser, nothing leaves the site

== Changelog ==

= 1.0.1 =
* Removed the bundled translation files — translations are handled through translate.wordpress.org

= 1.0.0 =
* First release
* Generator for links, Wi-Fi, vCard, WhatsApp, email and phone
* Block and shortcode
* Download as PNG and SVG
* EPC payment code on unpaid WooCommerce orders

== Upgrade Notice ==

= 1.0.1 =
Housekeeping only, no functional change.

= 1.0.0 =
First release.
