=== Visual TL;DR by StartupHub.AI ===
Contributors: startuphubai
Tags: ai, diagrams, tldr, seo, ai agents
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-generated flow diagrams that summarize every article you publish, in 4-10 colour-coded concept cards. Built for AI agents and skim-readers.

== Description ==

Visual TL;DR is the format the agent web needs. Every article you publish gets a single inline diagram that compresses the story into 4-10 concept cards plus the relationships between them. Readers see the gist in 2 seconds. AI agents (Claude, ChatGPT, Perplexity, etc.) read the structured diagram instead of scraping your whole HTML.

= What you get =

* **6-10 concept nodes per diagram**, colour-coded by role: cause (blue), key technology (purple), effect (green), result (orange), neutral concept (gray).
* **3-way toggle**: Quick (essential nodes only), Explain (with descriptions), Deeper (all nodes + descriptions).
* **Mobile-first layout** — tall Gantt cascade that scales cleanly to phones.
* **SEO-indexable** — JSON-LD ImageObject + hidden text summary so Google reads the diagram content as text.
* **1080×1080 social image** auto-rendered for LinkedIn / Bluesky / X carousel posts.
* **Markdown export** — agents can copy the diagram in 200 tokens via the embedded base64 markdown.

= How it works =

1. Install + activate the plugin.
2. Grab an API key from [startuphub.ai/visual-tldr-wordpress](https://www.startuphub.ai/visual-tldr-wordpress) (free tier available).
3. Paste the key in *Settings → Visual TL;DR*.
4. Publish a post — a diagram appears under the first paragraph automatically.

= Pricing =

The plugin is free. Diagram generation is metered by API key:

* **Free** — limited diagrams per month, includes the "From startuphub.ai" attribution footer.
* **Paid** — higher monthly limits, removes the attribution footer, premium support.

Pricing details and signup at [startuphub.ai/visual-tldr-wordpress](https://www.startuphub.ai/visual-tldr-wordpress).

= Privacy =

The plugin sends post title, content, excerpt, and permalink to `https://www.startuphub.ai/api/v1/visual-tldr/generate`. The content is used to generate the diagram and is not retained beyond what's needed to render the result. Your API key is stored in WordPress options (encrypted by your host's standard practice).

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`, or install via *Plugins → Add New*.
2. Activate from the *Plugins* menu.
3. Go to *Settings → Visual TL;DR*.
4. Paste your StartupHub.AI API key.
5. Publish a post — the diagram appears.

== Frequently Asked Questions ==

= Do I need an OpenAI / Gemini API key? =

No. StartupHub.AI handles the AI inference using our own keys — you pay us for the service. Pricing covers Gemini costs plus the SVG generation, social image rendering, and storage.

= Where in the post does the diagram appear? =

After the first `</p>` of the post content. You can disable auto-injection in settings and use the `[visual_tldr]` shortcode instead to control placement manually.

= Can I disable per post? =

Yes. Every post has a *Visual TL;DR* meta box in the sidebar with a "Disable for this post" checkbox.

= Does it work with Elementor / Divi / Gutenberg / classic editor? =

Yes — the plugin hooks into the `the_content` filter, which all major page builders respect for the main post body.

= How do I regenerate a diagram? =

Open the post in the editor and click "Regenerate now" in the Visual TL;DR meta box.

= Does the diagram render on mobile? =

Yes. The SVG uses a tall-Gantt layout that's narrower than it is tall, so it fits a phone screen naturally without overflow.

== Changelog ==

= 1.0.0 =
* Initial release.
