=== Upload-Post Social Auto-Post ===
Contributors: uploadpost
Tags: social media auto post, woocommerce, tiktok, instagram, social media scheduler
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.4.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Auto-post WooCommerce products to TikTok, Instagram, Facebook, Pinterest & 13 networks — with product videos, drip scheduling and sales analytics.

== Description ==

Every time you publish a product, this plugin posts its photos and an auto-generated caption to the social networks you choose — powered by the [Upload-Post](https://www.upload-post.com) API.

* **10 platforms**: Instagram, Facebook, TikTok, X (Twitter), LinkedIn, Pinterest, Threads, Bluesky, Reddit, Telegram.
* **Product videos for TikTok, Reels & Shorts**: turns the product images into a designed vertical video (3 templates, your logo, hook text) — rendered in the cloud, no ffmpeg on your server.
* **Sales attribution**: see which post generated which orders. Published links carry UTM parameters, orders are matched automatically, and Social Analytics shows revenue per post and per network.
* **Social Analytics**: views, likes, comments, engagement, orders and revenue per posted product — with a daily automatic refresh.
* **Drip scheduling**: bulk-post your whole catalog at a healthy 2–3 posts per day instead of flooding your feeds.
* **Zero-work captions**: template with `{name}`, `{price}`, `{short_description}`, `{url}` — or let AI write them.
* **Bring your own AI key (optional)**: add your free Google Gemini API key and captions are generated per-product, in your store's language, with hashtags. Calls go directly from your server to Google.
* **Manual control**: per-product "Post now" button and activity log.
* **Non-blocking**: posting runs in the background, product saves stay fast.

You need a free Upload-Post account (10 uploads/month included; paid plans for more volume). Connect your social accounts once at upload-post.com, paste your API key here, done.

== External services ==

This plugin sends product data (title, price, description, images, permalink) to the Upload-Post API (https://api.upload-post.com) to publish it on the social networks you select. See https://www.upload-post.com/privacy.
If (and only if) you enable AI captions and provide your own Google Gemini API key, product title/price/description are sent to Google's Generative Language API (https://generativelanguage.googleapis.com) to generate the caption. See https://policies.google.com/privacy.

== Installation ==

**Setup takes about 5 minutes:**

1. Install and activate the plugin (WooCommerce required).
2. Create your free Upload-Post account at [app.upload-post.com](https://app.upload-post.com) — the free plan includes 10 posts per month, no credit card needed.
3. Connect your social accounts at [app.upload-post.com/manage-users](https://app.upload-post.com/manage-users): create a profile (for example "my-shop") and click each network — Instagram, TikTok, YouTube, Facebook… — to log in securely with OAuth. Your social passwords are never shared with this plugin or your website.
4. Create an API key at [app.upload-post.com/api-keys](https://app.upload-post.com/api-keys) and copy it.
5. In your WordPress admin go to WooCommerce → Social Auto-Post, paste the key and press "Save & test connection". Your profile and connected networks load automatically.
6. Pick the platforms, tweak the caption template (or add your Gemini key for AI captions) and publish a product. That's it — the post goes out on its own.

== Frequently Asked Questions ==

= Do I need an Upload-Post account? =
Yes — the free tier includes 10 uploads per month. Upload-Post is the service that talks to each social network's official API, so you connect Instagram, TikTok, etc. once in their dashboard and this plugin never touches your social passwords.

= How do I connect my social networks? =
In [app.upload-post.com/manage-users](https://app.upload-post.com/manage-users), create a profile and click each network to authorize it via the network's own login (OAuth). A profile groups the accounts of one brand/store — if you manage several shops, create one profile per shop and pick the right one in the plugin settings.

= Where do I find my API key? =
In [app.upload-post.com/api-keys](https://app.upload-post.com/api-keys). Paste it in WooCommerce → Social Auto-Post and press "Save & test connection" — if the key is valid, your profiles appear automatically.

= The test says "no profiles found" =
Your API key is valid but you have not connected any social account yet. Go to [app.upload-post.com/manage-users](https://app.upload-post.com/manage-users), create a profile, connect at least one network and press "Save & test connection" again.

= Is the Gemini key required? =
No. Without it, captions come from your template. With it, captions are AI-generated per product at no cost to you beyond Google's own (free-tier) pricing.

= How does sales attribution work? Is it GDPR-friendly? =
Links published to social carry UTM parameters (utm_campaign identifies the product post). When a visitor arrives through one of them, a first-party cookie remembers it for 30 days (last click wins) and the order placed is tagged with the originating post and network. Everything happens inside your own store — no visitor data is sent to Upload-Post or anyone else. You can switch it off in settings; if your cookie banner manages marketing cookies, list the `upsap_attr` cookie there.

== Screenshots ==

1. Settings — connect with one click, pick your profile and the networks it has connected.
2. Video templates — choose the look of your product videos by seeing them.
3. Social Analytics — views, likes, engagement, orders and attributed revenue per posted product.
4. Product editor — publish status per network with direct links to each post, and a "Post now" button.

== Changelog ==

= 0.4.0 =
* Sales attribution: UTM-tagged links, order matching, revenue and orders per post in Social Analytics.
* Social Analytics screen: views, likes, comments, engagement per posted product with daily auto-refresh.
* Success-timed review prompt.

= 0.3.0 =
* Video templates (Clean / Dark / Promo) with visual picker, hook text and logo overlay.
* Drip scheduling for bulk posting; guided onboarding; more networks (13 photo / 8 video).

= 0.2.0 =
* Product video generation: vertical slideshow (Ken Burns) from product images, published to TikTok / Instagram Reels / YouTube Shorts / Facebook / Threads.
* Per-platform publish results with post links, per-product opt-out, Social column, bulk "Post to social", first comment, Upload-Post queue support.

= 0.1.0 =
* Initial release: auto-post products on publish, photo carousels, caption templates, optional Gemini captions, per-product Post now, activity log.
