=== AI Topic Writer ===
Contributors: bwpexperts
Tags: ai, content generation, seo, automatic posts, openai
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 8.3.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically researches topics and writes complete SEO-optimised articles for your site on a schedule, using Anthropic, OpenAI, or Google as the writing engine.

== Description ==

AI Topic Writer researches a relevant topic for your site's niche, writes a complete SEO-optimised article (with a title, meta description, focus keyword, tags, and category), fetches or generates a featured image, adds internal and outbound links, and publishes it to WordPress — all on an automatic schedule, or on demand from the Settings page.

Key features:

* Choose an AI engine (Anthropic Claude, OpenAI, or Google Gemini) to research topics and write articles.
* Automatic featured images from Pexels, Unsplash, Google Image Search (reuse-licensed only), your own uploaded image pool, or AI-generated images (OpenAI).
* Automatic internal (your own site) and outbound (Wikipedia) links added to every article.
* Adjustable word count, with optional randomised length per article for variety.
* Human-readability tuning aimed at natural, human-sounding writing.
* Publish immediately, or save as drafts for review.
* Schedule daily, weekly, or multiple times per day spread evenly across 24 hours.
* Manual "Research & Generate Now" button with live background progress.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/ai-topic-writer` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to Settings → AI Topic Writer (or Posts → Auto Writer AI) to configure your AI engine, API key, niche, and scheduling.

== Frequently Asked Questions ==

= Which AI services does this plugin support? =

Anthropic (Claude), OpenAI, and Google (Gemini). You provide your own API key for whichever engine you choose, and can switch between them at any time.

= Does this plugin cost anything to use? =

The plugin itself is free. However, most AI engines charge for API usage based on your own account with that provider — check your chosen provider's pricing. Google's Gemini API offers a limited free tier.

= Can I review articles before they're published? =

Yes — set "Publish as" to "Draft" in the settings, and articles will be created as drafts for you to review and publish manually.

== Changelog ==

= 3.8.0 =
* Strengthened the "human readability" writing style to further reduce AI-detectable patterns.

= 3.7.0 =
* Improved error reporting when adding images to the image pool.

= 3.6.0 =
* Featured images sourced from the image pool no longer reuse the same photo for the in-article embedded image; a separate image is fetched from the configured stock APIs instead.

= 3.0.0 =
* Added a "Test API Key" / "Test" button for AI and image-source API keys.

= 2.9.0 =
* Added Google Image Search (Custom Search JSON API) as an image source.

= 2.0.0 =
* Fixed Gemini responses being cut off due to internal "thinking" token usage.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 3.8.0 =
Improves article writing style for more natural, human-sounding content.
