=== 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.5.2
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
* **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
* **More coming soon**

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:

* 10 free generations per month
* 5 active apps
* Articles with internal links, external links & FAQ schema
* Calculators, timers, comparison tables & checklists
* No credit card required

= Starter Plan - $20/mo (Optional) =

For professionals and agencies:

* 50 generations per month
* Premium AI models (GPT-4o, Claude Sonnet)
* 20 active apps
* **AI Hero Images** - photorealistic featured images generated for every article
* **AI Site Analysis** - scans your site and suggests widgets that fit your niche
* **White Label** - remove TalkGenAI branding
* Use on unlimited websites

= 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 10 generations per month and 5 active widgets. No credit card required. 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 Checklist** - AI-generated step-by-step checklists with progress tracking
4. **BMI Calculator** - Describe any calculator and the AI builds it instantly with full functionality
5. **Countdown Timer** - Professional countdown timers for sales, launches, and events
6. **Comparison Table** - AI-researched comparison tables with specs, checkmarks, and formatting
7. **App Dashboard** - Manage all your generated widgets and articles, copy shortcodes, and filter by type

== Changelog ==

= 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
