=== 4ul.ink Toolkit ===
Contributors: vunova
Tags: short links, qr code, sharing, analytics, automation
Requires at least: 6.5
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 0.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create protected short links, QR codes, sharing actions and compact analytics for WordPress content.

== Description ==

4ul.ink Toolkit connects published posts and pages to your 4ul.ink workspace. Create a
short link manually or automatically on first publication, add a dynamic Gutenberg block
or shortcode, show a locally generated QR code, and refresh 30-day analytics in the editor.

The plugin connects directly to the documented 4ul.ink API over HTTPS. Its API token stays
on the WordPress server in a non-autoloaded option (or in FOURULINK_API_TOKEN), and is never
rendered into public pages or browser JavaScript. API retries are idempotent.

== Installation ==

1. Upload and activate the plugin ZIP in WordPress. Version 0.2 upgrades version 0.1 in place.
2. In 4ul.ink Account, create a token with Full links and analytics access.
3. Open Settings > 4ul.ink, paste the token, save and test the connection.
4. Optionally enable automatic link creation for newly published posts and pages.
5. Use the editor panel, the 4ul.ink Toolkit block, or `[fourulink mode="all"]`.

== Frequently Asked Questions ==

= Will automatic publishing create duplicates? =

No. The job is scheduled once, checks saved metadata first and uses a deterministic
Idempotency-Key when calling 4ul.ink.

= Does the QR code contact another service? =

No. QR generation runs in the visitor's browser using the bundled MIT-licensed qrcodejs library.

= Does it track visitors in WordPress? =

No. Redirects, Nova Shield processing and privacy-conscious aggregate analytics remain on 4ul.ink.

= Which shortcode modes are available? =

Use `link`, `share`, `qr` or `all`. Example: `[fourulink mode="share"]`.

== Privacy ==

When an authorized editor creates a short link, the plugin sends the public content URL,
title, optional alias and selected UTM parameters to 4ul.ink. When an editor refreshes
analytics, WordPress requests aggregate link statistics. The plugin does not send visitors,
passwords, post bodies, comments, customer records or cookies to 4ul.ink.

== Changelog ==

= 0.2.0 =
* Added opt-in background link creation on first publication.
* Added the dynamic 4ul.ink Toolkit Gutenberg block and `[fourulink]` shortcode.
* Added local QR generation and privacy-preserving share actions.
* Added on-demand 30-day click analytics in the editor and recent-links table.
* Preserved the version 0.1 plugin directory, settings and post metadata for in-place upgrades.

= 0.1.0 =
* Initial release with token connection, manual links, aliases, UTM fields and recent links.
