=== Nexus Global AI Content Assistant ===
Contributors:  Muhammad Nazemi
Tags: seo, ai, ai  writer, gemini, chatgpt
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Your AI content team, built into WordPress. Write fully SEO-optimized articles and generate stunning AI images in one click — no browser tabs, no copy-pasting.

== Description ==

Every article you publish needs a dozen small, tedious decisions: a title that earns the click, a meta description that doesn't get truncated, alt text on every image, internal links that actually make sense, a score that tells you whether it's even ready to publish. Most of us either skip half of it or burn twenty minutes per post doing it by hand.

**Nexus Global AI Content Assistant** turns that twenty minutes into one click. It writes complete, SEO-optimized articles and generates matching AI images for every post — a full AI content and SEO workspace built directly into the WordPress post editor, with no browser tabs, no copy-pasting into ChatGPT, and no exporting your content anywhere you can't see it.

= 🧠 Your AI, Your Choice =

Nexus isn't locked to one AI vendor. Bring your own API key from any of five providers and switch between them per module, per post, whenever you want:

* **Google Gemini** — fast, generous free tier, built-in image generation
* **OpenAI (ChatGPT / GPT)** — the model most writers already trust
* **Anthropic Claude** — famous for careful, well-structured long-form writing
* **DeepSeek** — exceptional value for high-volume content teams
* **Groq** — near-instant inference when speed matters more than anything

Every provider gets a live **model picker with a Segarkan (Refresh) button** that pulls the current list of models straight from that provider's API — so when a vendor ships a new model, you're using it the same day, not waiting on a plugin update.

= ⚠️ A Straight Answer About AI =

AI is extraordinarily good, and it is not infallible. Always review generated titles, statistics, external links, and image relevance before you hit publish — the same way you'd review a junior writer's first draft. You stay the editor. Nexus just does the first 80% of the work.

= 🚀 One Panel, Every SEO Field Filled =

Open the **Nexus AI SEO** meta-box on any post and pick the modules you want:

* **SEO Title** — click-worthy, keyword-forward title variations, synced automatically to Yoast, Rank Math, AIOSEO, SEOPress, and Squirrly
* **Slug / URL Keyword** — clean, SEO-friendly permalink
* **Meta Description** — compelling copy inside the character limit, synced to every major SEO plugin's meta field
* **Featured Snippet** — a tight paragraph aimed straight at Google's Position 0
* **Focus Keyword, LSI & Long-Tail Keywords** — your primary keyword, semantically related terms, *and* AI-suggested long-tail phrases real searchers actually type
* **Key Takeaways** — a polished, scannable summary block auto-inserted into the article for skim-readers
* **FAQ with JSON-LD Schema** — up to 20 question/answer pairs, rendered as an accessible accordion and marked up for rich results
* **Social Media Copy** — platform-tuned Facebook and Twitter/X copy, written straight into every major SEO plugin's Open Graph and Twitter Card fields
* **Internal Links** — AI finds the right anchor phrase already in your article and wraps it in a link automatically. No manual hunting.
* **External Links** — AI flags claims that need authority backing and drafts anchor text; *you* supply the URL, so you never end up linking to a hallucinated page
* **Table of Contents** — auto-inserted above your first H2, fully styled, no shortcodes

= 📊 SEO Grader & Critique =

A live, visual scorecard for every post — not a black box, an actual second opinion:

* Animated 0–100 score gauge that fills in as it loads
* Per-category breakdown bars (title, meta, content, readability, structure)
* Search-intent badge (informational, navigational, transactional, commercial)
* E-E-A-T signal chips, content-gap analysis against what's already ranking, and key NLP entities Google expects to see
* A plain-English critique with specific, actionable fixes — not just a number
* Re-run any time with one click, using whichever AI provider you trust most for judgment calls

= 🖼️ Image Planter =

A full image workflow per article, separate from the main panel so it never gets in your way:

* AI scans every H2 and generates descriptive alt text, a caption, and an image-generation prompt for each one
* Generate the image directly from that prompt — Gemini 2.5 Flash Image and Imagen 4 supported, with automatic fallback
* Or upload your own via the standard WordPress Media Picker
* One-click copy on every prompt, for use in any external image tool you prefer
* Every generated or uploaded image is sideloaded into your Media Library with proper alt text — no orphaned files

= ✍️ AI Writer & Editor =

A genuine writing studio, not a one-shot generator:

* **8 writing presets** (Blog Umum, Viral/Hiburan, Review Produk, Lifestyle, Sales/Landing Page, Edukasi/SEO, News/Aktual, Press Release) plus 15+ selectable tones and a custom Brand Persona so every article sounds like *you*, not a generic AI
* **Saran Topik** — enter one keyword, get 10 topic ideas with hook angles
* **Saran Kata Kunci Ekor Panjang** — the same, but for specific long-tail search phrases, so you start writing already knowing what people are typing into Google
* Generate a full article or a structured outline, inserted straight into Gutenberg or Classic Editor
* **AI Editor mode** — select existing content and apply targeted edits (tighten, expand, rewrite, translate, change tone, fix grammar, and more), each with a plain-language description of exactly what it will do before you run it
* Server-side undo/redo history — every AI-written version is one click away, no fear of losing a good draft

= 🔌 Works With Your Existing SEO Plugin =

Nexus doesn't replace Yoast, Rank Math, AIOSEO, SEOPress, or Squirrly — it feeds them. Every generated field is written directly into that plugin's own meta keys, so your existing setup, sitemaps, and schema keep working exactly as they do today. Think of Nexus as the AI assistant your SEO plugin never had.

= 🛠️ Fully Customisable, Fully Yours =

Every prompt Nexus sends to the AI is editable under **Settings → Nexus AI Prompt** — no code required. Tune temperature, link limits, image counts, FAQ count, output language, and the exact system directive sent with every request. Set a Brand Persona once and every AI Writer article inherits your voice automatically.

= 🌐 Built for the World =

Every user-facing string ships wrapped for translation (`nexus-ai-seo` text domain). Bahasa Indonesia and English translations are bundled; a `.pot` file is included for anyone who wants to add their own language.

== Installation ==

1. Upload the `nexus-ai-seo` folder to `/wp-content/plugins/`, or install directly from the WordPress Plugin Directory.
2. Activate the plugin from the **Plugins** menu.
3. Go to **Settings → Nexus AI SEO** and add an API key for at least one provider (Gemini, OpenAI, Claude, DeepSeek, or Groq). You only need one to start.
4. Optionally set your **Brand Persona** text on the same settings page so AI Writer output sounds like you.
5. Visit **Settings → Nexus AI Prompt** to review limits and customise prompt templates (optional — sensible defaults are already set).
6. Open any post or page. One unified **🧠 Nexus AI Suite** meta-box appears below the editor, with a Mode switcher for:
   - **🧠 AI SEO** — the main SEO generation panel (titles, meta, snippets, links, schema, and more)
   - **✍️ AI Penulis** — full article & outline generation
   - **✏️ AI Editor** — rewrite, expand, summarise, translate, and other edit actions
   - **🔍 AI Analisis** — SEO Grader & Critique: score gauge, category breakdown, E-E-A-T, content gaps, NLP entities
   - **🖼️ AI Gambar** — Image Planter: per-H2 image management and AI image generation

== Frequently Asked Questions ==

= Do I need to remove my existing SEO plugin? =
No. Nexus works *alongside* Yoast, Rank Math, AIOSEO, SEOPress, and Squirrly, filling their fields automatically. Think of it as an AI assistant for the setup you already have.

= Which AI provider should I use? =
Whichever you already trust or have credits with — Nexus doesn't play favourites. Gemini has the most generous free tier and native image generation. OpenAI and Claude are excellent for long-form writing quality. DeepSeek is extremely cost-effective at volume. Groq is the fastest if you're iterating quickly. You can even use a different provider per module.

= Do I need API keys for all five providers? =
No — just one. Add keys for additional providers any time you want to compare output or switch.

= Where do I get an API key? =
Google Gemini: https://aistudio.google.com/ · OpenAI: https://platform.openai.com/api-keys · Anthropic Claude: https://console.anthropic.com/ · DeepSeek: https://platform.deepseek.com/ · Groq: https://console.groq.com/keys

= What models can I use for image generation? =
By default Nexus uses **Gemini 2.5 Flash Image**, available on any standard Gemini key. **Imagen 4** is offered as a first-choice option where your account has access, with automatic fallback if it isn't available. Click **Segarkan** in the Image Planter to pull the live model list for your key.

= Does it work with Gutenberg? =
Yes — fully compatible with the Block Editor and the Classic Editor.

= What happens if the AI returns a truncated or malformed response? =
Nexus detects truncation and attempts automatic JSON repair. If repair succeeds, your content is applied normally. If it can't be recovered, you get a clear error suggesting fewer active modules or a model with a larger context window — never a silent failure.

= Can I customise the AI prompts? =
Yes. Every prompt template is editable under **Settings → Nexus AI Prompt**, no code required.

= Is the plugin translation-ready? =
Yes. Indonesian (`id_ID`) and English (`en_US`) are bundled; translate the included `.pot` file for any other language.

= Will it conflict with caching plugins? =
No. All AI processing happens in wp-admin only. Frontend output uses the standard `the_content` and `wp_head` hooks and is fully compatible with page caching.

= Is my content sent anywhere without my knowledge? =
No. Nexus only contacts an AI provider when you explicitly click a generate/analyse/refresh button. Nothing runs automatically, on a schedule, or on page views. See "External Services" below for exactly what's sent to which provider.

== External Services ==

Nexus AI SEO connects to external, third-party AI providers to generate content on your behalf. **You control which providers are used** by choosing which API keys to add in Settings — a provider is only contacted if you've configured a key for it *and* you click a button that uses it. No request is ever sent automatically, on a schedule, or without direct user action.

**What is sent, in every case:** your post title, post content (or relevant excerpts), and the specific instructions for the module you triggered (e.g. "write a meta description," "suggest alt text for this image"). No visitor data, no personally identifiable information about your site's readers, and no data from posts you are not actively editing is ever transmitted.

**1. Google Gemini API** (`generativelanguage.googleapis.com`)
Used for text generation and AI image generation (Gemini 2.5 Flash Image, Imagen 4) when a Gemini key is configured.
Provider: Google LLC

* [Terms of Service](https://policies.google.com/terms)
* [Gemini API Additional Terms](https://ai.google.dev/gemini-api/terms)
* [Privacy Policy](https://policies.google.com/privacy)

**2. OpenAI API** (`api.openai.com`)
Used for text generation when an OpenAI key is configured.
Provider: OpenAI, L.L.C.

* [Terms of Use](https://openai.com/policies/terms-of-use/)
* [Privacy Policy](https://openai.com/policies/privacy-policy/)

**3. Anthropic Claude API** (`api.anthropic.com`)
Used for text generation when a Claude key is configured.
Provider: Anthropic PBC

* [Commercial Terms of Service](https://www.anthropic.com/legal/commercial-terms)
* [Privacy Policy](https://www.anthropic.com/legal/privacy)

**4. DeepSeek API** (`api.deepseek.com`)
Used for text generation when a DeepSeek key is configured.
Provider: Hangzhou DeepSeek Artificial Intelligence Co., Ltd.

* [Open Platform Terms of Service](https://cdn.deepseek.com/policies/en-US/deepseek-open-platform-terms-of-service.html)
* [Privacy Policy](https://cdn.deepseek.com/policies/en-US/deepseek-privacy-policy.html)

**5. Groq API** (`api.groq.com`)
Used for high-speed text generation when a Groq key is configured.
Provider: Groq, Inc.

* [Terms of Use](https://groq.com/terms-of-use)
* [Privacy Policy](https://groq.com/privacy-policy)


**6. Image sideloading (user- or AI-supplied URLs)**
When you generate or select an image, Nexus downloads it into your Media Library via a standard HTTP request. No personal data is attached to this request beyond the download itself — it is not tied to a fixed third-party domain, since the URL is whatever you or the AI provided.

== Changelog ==

