=== Orshot – Dynamic Open Graph & Featured Images ===
Contributors: orshot
Tags: image-generation, featured-image, og-image, social-image, automation
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

Auto-generate featured images and Open Graph images from Orshot templates. Includes a Gutenberg block for inline renders.

== Description ==

**Orshot** lets you connect your WordPress site to [Orshot](https://orshot.com) — a template-based image, PDF, and video generation platform — and automatically produce visual assets for your content.

= Features =

* **Auto Featured Images** – Automatically generate a featured image from an Orshot template every time you publish a post. The post title, excerpt, and category are injected into the template.
* **Open Graph / Social Images** – Pre-generate OG images for social sharing when a post is published. The plugin injects the appropriate `og:image` and `twitter:image` meta tags.
* **Gutenberg Block** – Insert the *Orshot Image* block into any post or page to pick a template, generate an image, and embed it inline.
* **Upload Receiver** – Orshot can push rendered files directly into your WordPress media library as a storage connection.
* **Template Picker** – Browse and select templates from your Orshot workspace without leaving WordPress.

= How It Works =

1. Install and activate the plugin.
2. Go to **Settings → Orshot** and click **Connect to Orshot**.
3. Authorize the connection in your Orshot account (OAuth — no API keys to copy).
4. Choose default templates for featured images and OG images.
5. Publish a post and watch the images generate automatically.

= Third-Party Service =

This plugin connects to the **Orshot** external service to generate images and other assets from templates.

* **[Plugin Documentation](https://orshot.com/docs/integrations/wordpress)**
* **Service website:** [https://orshot.com](https://orshot.com)
* **Terms of Service:** [https://orshot.com/terms](https://orshot.com/terms)
* **Privacy Policy:** [https://orshot.com/privacy](https://orshot.com/privacy)

Data sent to Orshot includes: post title, excerpt, category name, author display name, and site name — only when a render is triggered. OAuth tokens are stored locally in your WordPress database and transmitted over HTTPS.

== Installation ==

1. Upload the `orshot` folder to `/wp-content/plugins/`.
2. Activate the plugin through the **Plugins** menu.
3. Navigate to **Settings → Orshot** and connect your Orshot account.

== Frequently Asked Questions ==

= Do I need an Orshot account? =

Yes. You can [create a free account](https://orshot.com/pricing) at orshot.com

= What data is sent to Orshot? =

When a render is triggered (on publish or via the Gutenberg block), the plugin sends the post title, excerpt, category, author name, and site name to the Orshot API over HTTPS. No other data is transmitted without an explicit user action.

= Can I choose which post types get auto-generated images? =

Yes. In **Settings → Orshot** you can enable or disable auto-generation per post type (Posts, Pages, or any custom post type).

= Can I use this with my existing SEO plugin? =

The plugin outputs `og:image` and `twitter:image` meta tags. If your SEO plugin already outputs these tags, you may want to disable the OG image feature in Orshot settings to avoid duplicates, or use your SEO plugin's hooks to filter the output.

= Where are generated images stored? =

All generated images are saved to your WordPress media library as standard attachments.

== Screenshots ==

1. Settings page — connect to Orshot and configure auto-generation.
2. Template picker modal.
3. Gutenberg block in the editor.

== Changelog ==

= 1.0.0 =
* Initial release.
* OAuth connection to Orshot.
* Auto featured image generation on publish.
* OG / social image pre-generation.
* Gutenberg block for inline image generation.
* Upload receiver REST endpoint for Orshot storage push.

== Upgrade Notice ==

= 1.0.0 =
Initial release.