=== AI Content Generator & Calculator Builder by TalkGenAI – GEO, SEO & Widgets ===
Contributors: talkgenai
Tags: ai content generator, article generator, internal-links, seo, calculator
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 2.6.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered article generator with internal links, FAQ schema, AI images & GEO optimization. Build calculators, timers & comparison tables.

== Description ==

**SEO got you here. GEO takes you further.**

[youtube https://www.youtube.com/watch?v=ynFS1kJpXlM]

Google isn't the only one answering questions anymore. ChatGPT, Gemini, and Perplexity are serving answers directly to your audience. TalkGenAI helps you create content that AI engines can trust, cite, and recommend. Every article is structured to strengthen your E-E-A-T signals — so both search engines and AI models see your site as an authoritative source.

= AI-Powered Content Generation =

Generate publish-ready articles right inside WordPress. Every article includes:

* **Internal Links** - Automatically links to your existing content, building topical authority across your site
* **External Links** - Cites authoritative sources that AI engines trust and verify
* **FAQ Sections + JSON-LD Schema** - Structured Q&A that AI engines can pull directly into conversational answers
* **AI Hero Image** - Generates a photorealistic featured image matched to your article topic (paid plans)
* **Meta Descriptions** - Optimized summaries tuned for both traditional and AI-powered search
* **Save as WordPress Draft** - One click publishes directly to your WordPress drafts — no copy/paste needed
* **Any Language** - Write in English, Hebrew, Spanish, French, German, and more

Just type your topic, toggle on the features you want, and TalkGenAI generates a complete, publish-ready article in seconds.

= Interactive Widget Builder =

TalkGenAI is also an **AI-powered widget builder**. Instead of configuring complex settings or hiring a developer, you describe what you need:

*"Create a mortgage calculator with loan amount, interest rate, and term length"* - done in 10 seconds.

* **Calculators** - Mortgage, BMI, ROI, cost estimators, quote generators, loan, savings, currency converters
* **Interactive Charts** - Bar, line & pie charts with hover tooltips, axis labels and auto-extracted data
* **Infographics** - Stats cards, key points, timelines & step flows that highlight article data
* **Countdown Timers** - Sales countdowns, product launches, event timers, Pomodoro timers
* **Comparison Tables** - Product specs, pricing plans, affiliate charts (AI researches the data for you)
* **To-Do Lists & Checklists** - Onboarding flows, shopping lists, process trackers

Every widget is **responsive**, **lightweight**, and works with **Elementor, Divi, Gutenberg, and Beaver Builder** via a simple shortcode.

= How It Works (4 Steps) =

1. Open the TalkGenAI dashboard in your WordPress admin
2. Type what you want: *"Build a calorie calculator for women"* or *"Write an article about home workout routines"*
3. Preview the result - tweak it by chatting: *"Add an FAQ section"*, *"Make the button blue"*
4. Copy the shortcode, paste it into any page or post

= Why Site Owners Choose TalkGenAI =

**Internal links generated automatically.** TalkGenAI scans your existing content and links every article to relevant pages on your site — building topical authority without manual work.

**Publish-ready in one click.** Articles include internal links, external citations, FAQ schema, meta description, and an AI hero image. Save directly as a WordPress draft — no copy/paste.

**GEO-ready from day one.** Your articles are structured with internal links, external citations, and FAQ sections that AI engines like ChatGPT and Gemini can trust and cite.

**One plugin instead of many.** Most sites need a calculator plugin, a timer plugin, a table plugin. That means 3+ plugins to maintain, update, and troubleshoot. TalkGenAI replaces them all.

**No coding, no configuration screens.** Other plugins make you drag fields around and configure formulas. With TalkGenAI, you describe the result and the AI writes the HTML, CSS, and JavaScript.

**Lightweight output.** Each widget is self-contained code - no framework dependencies, no external scripts loaded on your frontend.

= Real Examples =

Here are actual prompts that produce working results:

* *"Write an article about the best protein powders for beginners"* (generates article with internal links to your site, external sources, FAQ schema, and AI hero image)
* *"Mortgage calculator - monthly payment based on home price, down payment, interest rate, and loan term"*
* *"Countdown timer to December 31, 2026 with days, hours, minutes, seconds"*
* *"Compare iPhone 16 vs Samsung S25 - screen, battery, camera, price"* (AI fills in the specs)
* *"BMI calculator with metric and imperial units"*
* *"Pricing table for 3 plans: Basic $9/mo, Pro $29/mo, Enterprise $99/mo"*

= Free Plan Included =

Start building immediately — no credit card required:

* **15 credits / month** (resets monthly)
* 1 website
* Standard AI model
* Articles with internal links, external links & FAQ schema
* ⚡ **Interactive apps embedded inside articles** — charts, infographics, calculators auto-generated alongside every article
* Standalone widgets: calculators, timers, comparison tables & checklists

= Starter Plan — $39/mo =

For creators and growing sites:

* **150 credits / month**
* Up to 5 websites
* Premium AI models (better quality, longer articles)
* 🖼️ **AI Hero Image** — photorealistic featured image generated for every article
* 🎙️ **Brand Voice** — learns your writing style from existing content and applies it to every new article

= Growth Plan — $89/mo =

For growing businesses:

* **400 credits / month**
* Up to 10 websites
* Everything in Starter, plus email support

= Agency Plan — $199/mo =

For agencies managing multiple sites:

* **1,000 credits / month**
* Unlimited websites
* Everything in Growth, plus dedicated WhatsApp account manager

= Privacy & External Service Notice =

**This plugin connects to an external API service to provide AI generation.**

**Service Provider:**

* **Service**: TalkGenAI
* **Service URL**: [https://app.talkgen.ai](https://app.talkgen.ai)
* **Terms of Service**: [Read Terms](https://app.talkgen.ai/terms)
* **Privacy Policy**: [Read Privacy Policy](https://app.talkgen.ai/privacy)

**Data collected when you generate a widget or article:**

* The text prompt you enter (e.g., "Create a BMI calculator")
* WordPress site URL, WordPress version, PHP version (for compatibility)
* Timestamp, IP address (for security), and User ID

**Data we do NOT collect:**

* Your site's database, posts, pages, or media
* Passwords or personal credentials
* Data from other plugins

You are responsible for reviewing and testing all generated widgets and articles before publishing. AI can make mistakes - always verify calculations and content.

== Installation ==

= Automatic Installation =

1. In your WordPress admin, go to **Plugins > Add New**
2. Search for **"TalkGenAI"**
3. Click **Install Now**, then **Activate**
4. Register for a free API key at [https://app.talkgen.ai](https://app.talkgen.ai)
5. Enter your API key in **TalkGenAI > Settings**
6. Go to **TalkGenAI > Generate App** and describe your first widget or article

= Manual Installation =

1. Download the plugin ZIP file
2. Go to **Plugins > Add New > Upload Plugin**
3. Upload the ZIP and click **Install Now**
4. Activate the plugin
5. Register at [https://app.talkgen.ai](https://app.talkgen.ai) for your free API key
6. Enter the key in **TalkGenAI > Settings**

== Frequently Asked Questions ==

= What is GEO (Generative Engine Optimization)? =
GEO is the shift from traditional SEO to optimizing for AI-powered search engines like ChatGPT, Gemini, and Perplexity. Instead of just ranking in Google, GEO ensures your content is structured so AI engines can trust, cite, and recommend it. TalkGenAI generates articles that are GEO-ready out of the box.

= How do I get started? =
Install the plugin, get a free API key at [app.talkgen.ai](https://app.talkgen.ai), and type your first prompt. Watch the [setup video](https://www.youtube.com/watch?v=ynFS1kJpXlM) for a quick walkthrough.

= Is it really free? =
Yes. The free plan gives you 15 credits per month — no credit card required. An article costs 5 credits, a widget costs 1 credit. You can upgrade later if you need more.

= Do I need to know HTML or JavaScript? =
No. You describe what you want in any language - TalkGenAI supports English, Hebrew, Spanish, French, German, and more. The AI writes all the code.

= How do the internal and external links work? =
When generating an article, TalkGenAI scans your existing posts and pages to find relevant internal link opportunities — and automatically inserts them into the article. It also cites authoritative external sources. This builds topical authority and signals credibility to both traditional search engines and AI engines like ChatGPT and Gemini.

= Does it generate images for articles? =
Yes. On paid plans, TalkGenAI generates a photorealistic AI hero image for every article using GPT-Image-1. The image is matched to your article topic and inserted automatically. Free plan articles do not include image generation.

= Can I publish directly to WordPress? =
Yes. After generating an article, click "Save as Draft" to push it directly to your WordPress drafts. It appears in your Posts list ready to review and publish — no copy/paste required.

= Can I customize the design after generating? =
Yes. Just tell the AI what to change: *"Make the background dark"*, *"Use a larger font"*, *"Add more FAQ questions"*. You can iterate as many times as you want within a single generation.

= Does it work with my page builder? =
Yes. TalkGenAI outputs a standard WordPress shortcode like `[talkgenai_app id="123"]`. This works in Gutenberg, Elementor, Divi, Beaver Builder, WPBakery, and any theme that supports shortcodes.

= Can I put multiple widgets on the same page? =
Yes. Each widget is fully self-contained. You can place a calculator and a countdown timer on the same page and they work independently.

= What kinds of calculators can it build? =
Mortgage, BMI, ROI, cost estimators, quote generators, loan calculators, savings calculators, currency converters, calorie calculators, tip calculators - anything you can describe.

== Screenshots ==

1. **Article Generation** - Enter a topic, toggle on internal links, external links, FAQ & AI image, and generate a publish-ready article in seconds
2. **Generated Article Preview** - Full article with headings, internal links, AI hero image, and one-click Save as Draft button
3. **Interactive Chart** - Bar, line & pie charts auto-generated from article data with axis labels and hover tooltips
4. **Infographic Widget** - Animated stats cards, key points, timelines and step flows embedded inside articles
5. **BMI Calculator** - Describe any calculator and the AI builds it instantly with full functionality
6. **Countdown Timer** - Professional countdown timers for sales, launches, and events
7. **Comparison Table** - AI-researched comparison tables with specs, checkmarks, and formatting
8. **App Dashboard** - Manage all your generated widgets and articles, copy shortcodes, and filter by type

== Changelog ==

= 2.6.6 - 2026-03-21 =
* Improvement: Widget content anchoring — calculators, comparison tables, and timers now always use exact numbers, values, and durations from the article instead of invented data
* Improvement: Article refinement is now fully asynchronous — no more timeouts on longer articles; progress bar shown during refinement
* Improvement: External links validated on generation — broken links (404) removed, duplicates deduplicated, none placed in the intro paragraph
* Fix: Domain mismatch between API key and active site now shown as a clear warning banner in the plugin admin

= 2.6.4 - 2026-03-15 =
* Feature: Article Refinement — iterate on generated articles with natural language instructions (e.g. "make it more formal", "add a section about pricing"). Paid plans only, 2 credits per refinement.
* Feature: Brand Voice tip shown in article empty state for paid users who haven't created a voice yet — one-click shortcut to set up their first voice
* Improvement: Articles now consistently reach the requested length target (short ~500 words, medium ~900, long ~1400)
* Improvement: Actual word count shown after article generation and after each refinement
* Improvement: Downloaded HTML for Hebrew and Arabic articles now includes correct RTL direction and text alignment
* Improvement: Refine panel UI — orange send button, correct message bubble alignment, no horizontal scroll, taller transcript area
* Fix: "Refine your article" upgrade nudge now uses orange brand colors instead of purple

= 2.6.3 - 2026-03-12 =
* Feature: Form preferences are now remembered across sessions in both WordPress plugin and SaaS dashboard — article options (FAQ, links, image, interactive app, length, writing style) are saved locally and restored on next visit
* Feature: Credit pre-check with descriptive error messages — free plan users see a clear breakdown (e.g. "5 for article + 3 for image = 8 total") when bonus credits are insufficient for image generation
* Feature: Upgrade nudge shown after article generation for free users, with direct link to billing
* Feature: Create Draft button now animates with a green glow after both article and interactive app are ready
* Improvement: Meta Description, FAQ Schema, and SEO Checklist now collapsed in an accordion after article result — cleaner view by default
* Improvement: Advanced options panel is now open by default for quicker access
* Improvement: Brand Voice profile preview is now collapsible (collapsed by default)
* Fix: Upgrade links now point directly to the billing tab

= 2.6.2 - 2026-03-11 =
* Feature: Interactive apps (charts, infographics, calculators) embedded inside articles are now available on all plans including Free
* Improvement: Free plan credit display corrected to 15 credits/month

= 2.6.1 - 2026-03-07 =
* Fix: Calculator "more info" toggle now works reliably across all themes — JS inline styles used instead of CSS class toggling; plugin-level footer script also initialises toggles on existing published articles so no regeneration is needed
* Fix: Article hero image now placed before the 3rd H2 (below the fold) to avoid impacting Largest Contentful Paint on mobile
* Fix: Article images now include a responsive srcset with 400px and 480px sizes — reduces mobile image payload and passes Lighthouse "properly sized images" audit
* Fix: Article images use lazy loading to avoid render-blocking on mobile
* Improvement: Meta descriptions extended to 145–155 characters for fuller Google search snippets
* Security: `$_POST['custom_urls']` now correctly unslashed before sanitization (PHPCS compliance)

= 2.6.0 - 2026-03-03 =
* Feature: Interactive Chart widget — bar, line & pie charts with axis titles, hover tooltips and auto-extracted article data
* Feature: Infographic widget — animated stats cards, key points, timelines and step flows embedded inside articles
* Feature: Smart widget placement — widgets are embedded at the most relevant section inside the article, not just appended at the end
* Feature: Brand Voice — create and apply custom writing voices to article generation
* Improvement: Widget decision engine now prioritizes high-value widgets (charts, calculators, infographics) over generic lists
* Improvement: Chart sizing is now compact with dynamic Y-axis padding so labels are never clipped
* Improvement: Chart bars use a bright 8-color palette for better readability
* Security: App previews now render inside a sandboxed iframe instead of direct script execution
* Security: Chart color and direction inputs are validated against strict whitelists
* Security: Sanitizer fallback now returns empty string instead of unsanitized input
* Fix: First paragraph no longer stripped when creating a WordPress draft with a featured image
* Fix: PUT/PATCH API requests now correctly attach the JSON body

= 2.5.2 - 2026-02-28 =
* Feature: Brand Voice section now always visible for premium users in the article generator — shows a "no voices yet" message with a link to create one when none exist
* Fix: Brand Voice dropdown was hidden on localhost due to domain filtering — resolved for local WordPress testing
* Fix: API key generation error code mismatch — website limit error now correctly triggers the upgrade prompt
* Fix: Dashboard tab state is now preserved across page refreshes — active tab is saved in the URL hash

= 2.5.1 - 2026-02-21 =
* Improvement: AI-generated article images now use gpt-image-1 for more realistic, photographic results
* Improvement: Image generation included at no extra credit cost for all paid plans
* Improvement: Image prompts now intelligently describe a scene based on the article topic
* Fix: Image title attribute now matches alt text for better SEO and accessibility
* UI: Updated demo video

= 2.5.0 - 2026-02-17 =
* Feature: FAQ JSON-LD schema now included in generated articles and WordPress drafts
* Feature: Copy Visual button now copies rich formatted content (not raw HTML code)
* Feature: Code tab shows FAQ schema alongside article HTML
* Fix: FAQ and external link options now properly passed for app-based articles
* UI: Standalone mode is now the default article generation mode
* UI: Article mode toggle redesigned with purple active state

= 2.4.9 - 2026-02-16 =
* Branding: Updated plugin title and tags to reflect AI content generation capabilities

= 2.4.7 - 2026-02-12 =
* Maintenance: Pre-release validation and stability improvements

= 2.4.6 - 2026-02-07 =
* Feature: Standalone article generation (articles not tied to a specific app)
* Maintenance: Minor improvements and cleanup

= 2.4.5 - 2026-01-24 =
* UI: Improved admin UI visibility and readability
* Install: More reliable database setup on activation and self-healing table creation
* Feature: Added sticky flag for apps

= 2.4.4 - 2026-01-18 =
* New: Smart Comparison Table Builder - create responsive comparison tables, pricing charts, and spec sheets with AI-researched data
* Feature: Added Comparison Table app type to the generation menu
* UI: Responsive table styles with checkmarks, cross marks, and winner badges

= 2.4.3 - 2026-01-18 =
* SEO: Updated plugin metadata to improve discoverability

= 2.4.2 - 2026-01-11 =
* Article Generation: Improved context with app URL and internal link candidates for smarter linking
* Performance: Optimized internal link candidate query

= 2.4.1 - 2025-12-18 =
* Fix: "Keep Calculator" reliably closes the overlay popup in admin preview
* Fix: Prevents chat transcript from leaking into subsequent AI requests

= 2.4.0 - 2025-12-04 =
* Security: Removed external CDN dependency - now using custom modal system
* Fix: "Get App Ideas" shows proper upgrade modal for free users
* New: "Generate New" button for quick workflow
* New: Clickable example prompts that auto-fill chat input
* UX: User-friendly error messages throughout
* Compatibility: Tested with WordPress 6.9

= 2.3.1 - 2025-11-30 =
* Improved error handling with clear messages when AI providers are temporarily unavailable

= 2.2.0 - 2025-11-30 =
* New: Bonus Credits System - earn credits for premium AI features
* Bonus credits are prioritized over plan credits
* Visual display of bonus credits in admin dashboard

= 1.0.0 - 2025-10-19 =
* Initial Release
* AI-powered app generation with multiple AI providers
* Template library for instant creation
* Live preview and shortcode embedding
* Automatic site registration with free monthly credits
* WordPress 6.4+ and PHP 8.2+ compatibility
