=== Tarkle Send ===
Contributors: tarkle
Tags: file transfer, file request, file sharing, embed, iframe
Requires at least: 5.0
Requires PHP: 7.4
Tested up to: 7.0
Stable tag: 0.3.0
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed Tarkle Send transfers, file requests, and download links on your WordPress site with simple shortcodes.

== Description ==

Tarkle Send allows you to embed file transfers, file request forms, and download links directly into your WordPress pages and posts using simple shortcodes.

**Three Shortcodes:**

1. **[tsend_download]** - Create a direct download link to a transfer
2. **[tsend_transfer]** - Embed a transfer viewer (files available for download)
3. **[tsend_file_request]** - Embed a file request form (let visitors upload files)

**Features:**

- One-time token setup from your Tarkle Send dashboard
- Secure token-based authentication
- Automatic branding and styling from your workspace settings
- Browser-to-storage file uploads (no server processing)
- Full input sanitization and WordPress security standards
- Works with any WordPress theme

**Setup:**

1. Install and activate the plugin
2. Go to Settings > Tarkle Send
3. Paste your secret token from Tarkle Send Settings > Developers
4. Use the shortcodes in your pages and posts

For detailed usage examples, see the documentation after activation.

== Installation ==

1. Upload the `tarkle-send` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to Settings > Tarkle Send and paste your secret token
4. Use the shortcodes in your content

== Frequently Asked Questions ==

= What is Tarkle Send? =

Tarkle Send is a file transfer and file request service. For more information, visit https://tarkle.com/send

= Do I need an API key? =

The plugin requires a secret token generated in your Tarkle Send workspace under Settings > Developers. No separate API key is needed.

= How do I get the slug for my transfer or file request? =

Log in to your Tarkle Send workspace and look at the URL of your transfer or file request. The slug is the unique identifier at the end of the URL.

= Can I customize the appearance? =

The appearance is controlled by your Tarkle Send workspace settings. CSS classes can be added to the download button shortcode.

= Are uploads secure? =

Yes. File uploads happen directly from the browser to Tarkle Send's storage, bypassing your WordPress server entirely.

= What are the shortcode attributes? =

**[tsend_download]**
- slug (required): Transfer slug
- text (optional): Link text (default: "Download")
- class (optional): CSS classes for styling

**[tsend_transfer]**
- slug (required): Transfer slug
- width (optional): Iframe width (default: "100%")
- height (optional): Iframe height (default: "600px")

**[tsend_file_request]**
- slug (required): File request slug
- width (optional): Iframe width (default: "100%")
- height (optional): Iframe height (default: "700px")

== Screenshots ==

1. Settings page - Configure your workspace subdomain
2. Shortcode examples - Documentation on plugin settings page

== Changelog ==

= 0.3.0 =
* Renamed shortcodes to tsend_ prefix per WordPress.org plugin guidelines to avoid naming conflicts
* Replaced inline script tags with wp_add_inline_script() for proper WordPress standards compliance
* Improved plugin review compliance

= 0.2.0 =
* Secret tokens now use the unified tk_ format. Generate your token in Tarkle Send under Settings > Developers. Existing tokens continue to work.

= 0.1.0-beta =
* Beta release for testing and review
* Three shortcodes: tsend_download, tsend_transfer, tsend_file_request
* Token-based signed URLs with HMAC-SHA256 verification
* Automatic 5-minute caching of signed URLs
* WordPress security compliance and input sanitization
* Support for custom domains and workspace subdomains

== Support ==

For support, visit https://tarkle.com or contact Tarkle support.

== License ==

This plugin is licensed under the GPL v2 or later. See LICENSE file for details.
