﻿=== MICROFACTOR AI Visibility ===
Contributors: guniang1
Tags: seo, ai, geo, chatgpt, brand-visibility
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.4.9
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Check whether ChatGPT, Claude, and Gemini mention your brand. Connect an account, subscribe, and scan from wp-admin.

== Description ==

MICROFACTOR AI Visibility helps marketers see if AI assistants mention their brand in shopper-style prompts.

ChatGPT, Claude, and Gemini are trademarks of their respective owners. This plugin is not affiliated with or endorsed by OpenAI, Anthropic, or Google.

**Works with Rank Math SEO and Yoast SEO**

MICROFACTOR complements classic SEO plugins. It does not replace title tags, meta descriptions, Open Graph, sitemaps, or Schema generated by Rank Math or Yoast. When those plugins are active, MICROFACTOR shows a coexistence notice in wp-admin.

**What you can do**

* Claim an API key with email only (no password), or paste an existing key to connect
* Save brand name, category, hero products, and competitors
* Subscribe to Starter / Growth / Pro plans
* Run AI visibility scans and view the latest score and scenarios
* Add `[microfactor_geo]` to a page to show region-aware content to visitors

**External services**

This plugin connects to the MICROFACTOR cloud API to:

* Issue or validate an API key and store it on your site (the key is your credential)
* Save brand setup and competitor lists
* Process paid visibility scans via the cloud service (which may call AI providers such as ForAI / OpenAI-compatible APIs)
* Process authenticated GEO lookups for the `[microfactor_geo]` visitor experience
* Forward the visitor IP to the MICROFACTOR cloud API for location lookup; the cloud service uses ipwho.is for GEO data
* Start Stripe Checkout / Customer Portal for subscriptions (handled by the cloud service, not directly by this plugin)
* Send a periodic install heartbeat (site URL, site name, plugin/WP/PHP versions, and whether Rank Math or Yoast is active) so MICROFACTOR can operate the service

Account email, API key validation, brand data, competitors, scan results, and install heartbeats are sent to the MICROFACTOR cloud when you use those features. Without connecting, the plugin only stores local settings. The Cloud API base URL is hidden from the normal Account UI (developers can reveal it with `WP_DEBUG` or the `metis_ai_show_api_base` filter).

**Requirements**

* A self-hosted WordPress site (or WordPress.com plan that allows custom plugins)
* Outbound HTTPS from your server to the cloud API
* A paid subscription to run scans (account registration itself is free)

== Installation ==

1. Install from Plugins → Add New, or upload the plugin zip
2. Activate **MICROFACTOR AI Visibility**
3. Go to **MICROFACTOR → Account**, claim a new API key with your email (or paste an existing key), then complete **Setup**
4. Choose a **Plan**, then run a scan from **Setup** results / scan actions
5. Optional: add `[microfactor_geo]` to a page. The shortcode keeps the API key server-side and shows a location-aware content variant to each visitor.

== Frequently Asked Questions ==

= Do I need my own OpenAI API key on WordPress? =

No. Keys stay on the MICROFACTOR cloud. Your site only stores a MICROFACTOR API key after you connect.

= I lost my API key. What now? =

Email support@microfactorglobal.com from the address you used when claiming the key. We can rotate the key. There is no password reset — the API key is your credential.

= Is the plugin free? =

Installing and connecting an account is free. Running scans requires a paid plan processed through Stripe on the MICROFACTOR cloud.

= Can I use my own API server? =

Yes, if you self-host a compatible cloud API. The Cloud API / API base URL field is hidden for normal merchants. Enable `WP_DEBUG` in `wp-config.php`, or return true from the `metis_ai_show_api_base` filter, then save a custom URL under **MICROFACTOR → Account**.

= Does this work on WordPress.com? =

Only on plans that allow uploading custom plugins (e.g. Business). Free WordPress.com sites cannot install this zip.

= Where are the legal policies? =

Privacy Policy, Contact information, Refund Policy, and Shipping Policy are all available in wp-admin under **MICROFACTOR → Legal & policies**. Privacy is also summarized in the External services section above.

= What is your refund policy? =

All sales are final. Once a subscription or one-time payment is processed we do not offer refunds, returns, or store credit, including for unused scans or dissatisfaction with results. You may cancel a subscription at any time to stop future billing, but cancellation does not refund amounts already paid. See **MICROFACTOR → Legal & policies → Refund Policy**.

= How is the service delivered? Is there shipping? =

There is no physical shipping. MICROFACTOR AI Visibility is a digital service: scan results and reports are delivered inside the plugin dashboard or by email, according to your plan's timeline. See **MICROFACTOR → Legal & policies → Shipping Policy**.

= Where can I get support? =

Email support@microfactorglobal.com. You can also find contact information in wp-admin under **MICROFACTOR → Legal & policies**.

== Screenshots ==

1. Account connect / register screen
2. Brand setup
3. Plans
4. Dashboard score

== Changelog ==

= 1.4.9 =
* Connect with API key as the primary flow; claim a key with email only (no password)
* Keep legacy email/password behind a collapsed section
* Document key backup and support rotation

= 1.4.8 =
* Detect Rank Math SEO and Yoast SEO; show coexistence notice in MICROFACTOR screens
* Send throttled install heartbeats to the cloud for operator install tracking
* Document works-with Rank Math / Yoast in the plugin description

= 1.4.7 =
* Add the `[microfactor_geo]` shortcode for server-side, region-aware visitor content
* Add the shared cloud GEO API and public Demo experience

= 1.4.6 =
* New Legal & policies admin page (Privacy Policy, Contact, Refund Policy, Shipping Policy)
* Updated readme FAQs for privacy, refunds, delivery, and support

= 1.4.5 =
* Website URL field: fixed scheme prefix (http:// or https://) + host input

= 1.4.4 =
* Default cloud API URL no longer contains "wordpress"

= 1.4.3 =
* Plugin Check: translators comments, SVG escaping via wp_kses, wp_safe_redirect for Stripe URLs

= 1.4.2 =
* Remove WordPress.com marketing links; Author URI → GitHub; support/privacy via email

= 1.4.1 =
* Scenario results: click a question to expand and read the full AI answer (Mentioned / Not mentioned badges kept)

= 1.4.0 =
* Obsidian Signal admin UI: ice-teal accent, Plus Jakarta Sans + JetBrains Mono, sharper Setup wizard chrome
* Progressive crawl / scan loading card (elapsed + checklist)

= 1.3.x =
* Setup-first wizard (crawl, heroes, competitors, keywords, GEO scan)
* Plan soft-trim for hero products and competitors; Starter scan quota every 2 days (server-enforced)

= 1.2.7 =
* Remove marketing Plugin URI, donate link, and WordPress.com privacy/contact URLs (those pages returned 410)
* Keep Author URI on the WordPress.org profile; cloud API default unchanged

= 1.2.6 =
* Sanitize product and competitor lines with sanitize_text_field
* Limit readme tags to five
* Remove load_plugin_textdomain for WordPress.org hosting

= 1.2.5 =
* Rebrand to MICROFACTOR AI Visibility (display name, slug, text domain, and user-facing strings)
* Default cloud API set to the MICROFACTOR cloud service

= 1.2.4 =
* Rebrand to GEO Mention Radar (display name, text domain, and user-facing strings) for WordPress.org trademark compliance

= 1.2.3 =
* Hide Cloud API / API base URL on Account for normal users; show only when `WP_DEBUG` is on or `metis_ai_show_api_base` filter returns true (save handler unchanged)

= 1.2.2 =
* Disconnected admin empty states use pure white surfaces (no amber/warn tint)

= 1.2.1 =
* Center admin content horizontally; replace Account login/register dropdown with CSS tabs (no Mode select)

= 1.2.0 =
* Tech visuals: score gauge, model marks, empty-state diagrams, plan header graphics, and crisp SVG status glyphs (admin UI)

= 1.1.2 =
* UI polish: typography, surfaces, controls

= 1.1.1 =
* Added tasteful admin motion: staggered page enter, button press/hover feedback, and subtle hover on scenarios, plan cards, and badges (respects prefers-reduced-motion)

= 1.1.0 =
* Redesigned wp-admin UI: light precision dashboard shell, status strip, score hero, mention badges, sectioned setup, plan comparison cards, and clearer account connection states

= 1.0.0 =
* Initial public release: account connect, setup, plans, scan dashboard

== Upgrade Notice ==

= 1.4.2 =
Remove WordPress.com marketing URLs from plugin headers and meta links.

= 1.4.1 =
Soft-launch build: expandable scenario answers, Setup wizard, and cloud-enforced plan scan quotas. Requires MICROFACTOR cloud API.

= 1.2.7 =
Drop dead marketing URLs from plugin headers and readme. Cloud API default is unchanged.

= 1.2.6 =
Sanitization, five readme tags, and WordPress.org translation loading.

= 1.2.5 =
Rebrand to MICROFACTOR AI Visibility. Request slug microfactor-ai-visibility when resubmitting to WordPress.org.

= 1.2.4 =
Rebrand to GEO Mention Radar. Update before resubmitting to WordPress.org.

= 1.2.3 =
Cloud API endpoint hidden from Account UI unless WP_DEBUG or metis_ai_show_api_base.

= 1.2.2 =
Pure white disconnected admin surfaces. Update to load refreshed styles.

= 1.2.1 =
Centered admin layout and clearer Login / Create account tabs on Account.

= 1.2.0 =
Admin tech visuals and SVG diagrams. Update to load refreshed styles.

= 1.1.2 =
Admin UI polish (typography, surfaces, controls). Update to load refreshed styles.

= 1.1.1 =
Admin UI motion polish. Update to load refreshed styles.

= 1.1.0 =
Admin UI redesign. Update the plugin to load refreshed styles.

= 1.0.0 =
Initial release.
