=== FileDroppr - PDF Tracking & Analytics ===
Contributors: nickzer0
Tags: pdf, share, analytics, tracking, documents
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Share PDFs as secure, trackable links and see readership analytics right in your WordPress dashboard.

== Description ==

FileDroppr turns your PDFs into secure, trackable share links - and surfaces who read them inside wp-admin.

* Upload a PDF from the FileDroppr admin page and get a trackable share link.
* See your files, view counts, and expiry at a glance; open the full readership analytics with one click.
* A dashboard widget shows recent reads (file, reader country, pages read, when).
* Embed a tracked link anywhere with the `[filedroppr uuid="..."]` shortcode.

You need a free FileDroppr account and an API key (Account → API keys at filedroppr.com). Readership analytics, password protection, and expiry follow your FileDroppr plan.

This plugin is a client for the FileDroppr service (https://filedroppr.com); PDFs you share are uploaded to your FileDroppr account over HTTPS.

== Installation ==

1. Upload the `filedroppr` folder to `/wp-content/plugins/`, or install the zip via Plugins → Add New → Upload.
2. Activate the plugin.
3. Go to **FileDroppr → Settings**, paste your API key (from filedroppr.com/account → API keys), and save.

== Frequently Asked Questions ==

= Where do I get an API key? =
Create one at filedroppr.com/account under "API keys". It starts with `fk_live_`.

= Is my API key stored securely? =
It's stored in your site's options table and sent only to filedroppr.com over HTTPS. Treat it like a password; revoke it anytime from your FileDroppr account.

== External services ==

This plugin is a client for FileDroppr (https://filedroppr.com), the external service it depends on to store and share your PDFs and to report readership analytics. A free FileDroppr account and an API key are required.

The plugin sends data to FileDroppr over HTTPS only when you actively use it:

* When you upload a PDF (FileDroppr -> Files), that PDF file is sent to your FileDroppr account to create a secure, trackable share link.
* When you view your files, a file's analytics, or the "Recent reads" dashboard widget, the plugin sends authenticated requests to read that data.
* When you open a file's QR code, the plugin requests the QR image for that file.

Every request includes your FileDroppr API key as a bearer token. Nothing is sent until you take one of the actions above, and the plugin contacts no other external service.

Service provided by FileDroppr. Terms of Service and Privacy Policy: https://filedroppr.com/terms

== Changelog ==

= 1.0.0 =
* Initial public release.
* API-key settings with a connection test, PDF upload, and a files list with view counts and expiry.
* In-admin readership analytics per file (summary, breakdowns, recent sessions).
* QR code for each share link, with a one-click PNG download.
* "Recent reads" dashboard widget and the `[filedroppr]` shortcode.
* Responses are cached briefly so admin screens stay responsive; clear errors for oversized uploads; uninstall removes stored settings.
