=== FARM QR Code Generator ===
Contributors: yannishimself
Tags: qr code, qr, shortlink, woocommerce, redirect
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.3.5
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Generate scannable QR codes with short, branded redirects for any post, page, or WooCommerce product. Pure PHP, no APIs.

== Description ==

QR Code Generator creates scannable QR codes for your WordPress content. Each post, page, or WooCommerce product gets a compact short URL (`/go/{base36}`) that 301-redirects to the original permalink.

**Key Features:**

* Pure PHP QR code engine — no external APIs, no JavaScript rendering
* Short URLs via `/go/{base36}` with permanent 301 redirects
* Works with posts, pages, and WooCommerce products
* Customizable pixel size, quiet zone, and colours
* One-click generate, download, and copy from the editor sidebar
* Lightweight — only requires the PHP GD extension
* ISO/IEC 18004 compliant QR encoding

**How It Works:**

1. Edit any post, page, or product
2. Find the "QR Code" meta box in the sidebar
3. Click "Generate QR Code"
4. Download the PNG or copy the short URL

== Installation ==

1. Upload the `farm-qr-code-generator` folder to `/wp-content/plugins/`
2. Activate the plugin through the "Plugins" menu in WordPress
3. (Optional) Configure settings under Tools > QR Code Generator
4. Edit any post and use the QR Code meta box in the sidebar

**Requirements:**

* PHP 7.4 or higher
* PHP GD extension (enabled on most hosts)
* WordPress 5.0 or higher

== Frequently Asked Questions ==

= Does this plugin require an external API? =

No. QR codes are generated entirely in PHP on your server using the GD image library.

= What post types are supported? =

By default: posts, pages, and WooCommerce products. You can select which post types to enable in Tools > QR Code Generator.

= Can I customise the QR code appearance? =

Yes. Go to Tools > QR Code Generator to change the pixel size, quiet zone (margin), and dark/light colours.

= Do existing QR codes update when I change settings? =

No. After changing settings, click "Regenerate QR Code" on each post to apply the new appearance.

= Where are the QR code images stored? =

In your uploads directory under `wp-content/uploads/qr-codes/`. They are automatically deleted when a post is permanently deleted.

= Does the short URL work without pretty permalinks? =

The `/go/{base36}` rewrite requires pretty permalinks to be enabled (Settings > Permalinks — anything other than "Plain").

== Screenshots ==

1. QR Code meta box in the post editor sidebar
2. Settings page under Tools > QR Code Generator

== Changelog ==

= 1.3.0 =
* Added customisable dark and light colours
* Added configurable pixel size and quiet zone
* Added post type selection in settings
* Added copy-to-clipboard for short URLs

= 1.2.0 =
* Added settings page under Tools
* Improved QR code rendering reliability

= 1.1.0 =
* Added WooCommerce product support
* Added download button for QR code PNG

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.3.0 =
New colour and size customisation options. Existing QR codes are not affected — regenerate them to apply new settings.