=== Vidal Geo AI ===
Contributors: vidaldigitalmiami
Tags: seo, geo, schema, json-ld, faq
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.6.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Vidal Geo AI revisa cada página de tu WordPress y le pone nota (0-100): qué tiene, qué le falta y cómo arreglarlo. Gratis y sin cuenta, trabaja solo dentro de tu sitio; con la clave de Vidal Flow, el agente GEO hace el trabajo por ti con IA.

== Description ==

**Dos modos en un solo plugin.**

**Modo free (sin clave, sin cuenta, sin coste):** Vidal Geo AI trabaja solo dentro de tu WordPress.

* **Revisión local con la misma nota 0-100 del agente**: título, meta descripción, canonical, un solo H1, datos estructurados, teléfono y nombre visibles, FAQ visible, precios y enlaces internos. Cada página guarda su nota y sus **huecos** (lo que le falta, en lenguaje claro) en el panel.
* **Campos SEO propios por página**: título, meta descripción, canonical y noindex, editables desde el editor y emitidos en el `<head>`. Si ya usas Yoast, Rank Math, AIOSEO o SEOPress, Vidal Geo AI lo detecta y **no duplica etiquetas**.
* **Esquema de tu negocio (LocalBusiness)** generado desde una **ficha local** que rellenas en el plugin: nombre, tipo de negocio, teléfono, dirección, horario, zonas y perfiles sociales.
* **FAQ propio**: escribe las preguntas de cada página y muéstralas con el bloque «FAQ de Vidal Geo AI» o el shortcode `[vidal_faq]`; el esquema FAQPage sale solo cuando el FAQ es visible.
* **Revisión de sitemap y robots**: Vidal Geo AI lee tu `robots.txt` y tu sitemap como los leería un buscador — bloqueos totales, bots bloqueados, sitemap no anunciado o caído, URLs anunciadas que dan 404, 403 o redirigen — y por cada problema te da **las instrucciones exactas para repararlo**. Vidal Geo AI no genera ni modifica esos archivos.

**Modo agente (con la clave de Vidal Flow):** el cerebro de Vidal Geo AI, en Vidal Flow, lee cada página al publicar y hace el trabajo con IA: nota con desglose, esquema JSON-LD y FAQ redactados solo con datos reales de la ficha de tu sitio en Flow. Lo que no consta, no lo inventa: queda marcado como **hueco**.

Qué hace:

* Al publicar o actualizar una página, entrada o producto, manda su **dirección (URL)** al cerebro. No manda el HTML: el cerebro lee la página directamente, como la leería un buscador (y valida que la URL sea de tu sitio antes de leerla).
* El cerebro devuelve una **nota de 0 a 100** con el desglose hallazgo a hallazgo, el **esquema JSON-LD** construido desde la ficha y, cuando hace falta, un **FAQ redactado solo con datos de la ficha y de la propia página**. Lo que no consta, no se inventa: queda marcado como **hueco** en el panel.
* El plugin guarda cada revisión y la aplica: el esquema sale en el `<head>` de la página (solo si es JSON válido) y el FAQ se muestra donde pongas el shortcode `[seo_faq]`.
* Panel propio en el menú **Vidal Geo AI**: ajustes, botón «Revisar ahora» y la tabla de páginas con nota, estado del FAQ, huecos y errores.

Reglas duras: el plugin nunca rompe el sitio ni el guardado de un contenido (todo fallo queda registrado en la revisión de esa página), la clave del sitio nunca se muestra, y el esquema nunca lleva estrellas propias (aggregateRating): el cerebro no las genera y el plugin no las añade.

= Cómo se guardan las revisiones =

En options de WordPress con `autoload=false` (una por página, `vga_rev_<md5 del slug>`, más un índice de slugs). Sin tabla propia ni migraciones, y sin cargar memoria en cada visita.

= Cómo se casa la portada =

Si una página es la portada del sitio (la página frontal configurada en WordPress), su revisión se guarda con el slug **«home»** y la URL de la raíz, igual que en el plugin de VidalPress. El resto de contenidos se casa por su slug (`post_name`).

== Installation ==

1. Sube el ZIP en Plugins → Añadir nuevo → Subir plugin, y actívalo.
2. Abre el menú **Vidal Geo AI** y rellena la **ficha de tu negocio** (local): con ella Vidal Geo AI genera tu esquema y sabe qué comprobar en cada página.
3. Pulsa **Revisar ahora (local)** para la primera pasada (máx. 20 páginas) o publica algo: en modo free, Vidal Geo AI revisa la página al guardarla.
4. En cada página, usa la caja **«Vidal Geo AI — modo free»** del editor para su título, descripción, canonical y sus preguntas frecuentes; muestra el FAQ con el bloque «FAQ de Vidal Geo AI» o el shortcode `[vidal_faq]`.
5. ¿Quieres el modo agente? Pega la **clave del sitio** de Vidal Flow en los ajustes: el cerebro pasa a revisar al publicar (máx. 5 páginas por pasada) y el FAQ del agente se muestra con el shortcode `[seo_faq]`.

== Frequently Asked Questions ==

= ¿Necesito una cuenta o clave? =

Para el modo free, no: sin clave el plugin revisa en local, emite tus campos SEO, genera el esquema de tu negocio desde la ficha local y te da el FAQ propio, sin enviar nada. La clave del sitio (la emite Vidal Flow para tu web) solo hace falta para el modo agente, donde el cerebro hace el trabajo con IA.

= ¿El plugin manda el contenido de mis páginas a un servidor? =

No manda el HTML: manda solo la URL pública de cada página, su slug y su título. El cerebro descarga la página pública él mismo, tras validar que el host de la URL es el de tu sitio.

= ¿Vidal Geo AI puede romper mi sitio? =

No debería: cada llamada va capturada y cualquier fallo se anota en la revisión de la página, sin interrumpir publicaciones ni visitas. El esquema solo se imprime si es JSON válido.

= ¿Funciona con WooCommerce? =

Sí: los productos (`product`) entran en el barrido igual que páginas y entradas. En la v0.1.0 el esquema de un producto es el del negocio más el FAQPage (el cerebro de la Fase 1 no genera todavía el Product/Offer individual de cada producto).

== Changelog ==

= 0.6.0 =
* WooCommerce transactional pages (cart, checkout, my account) are excluded from reviews on purpose: they are purchase forms, not pages for search engines. Product pages keep being reviewed as usual.
* Connected mode: each review now notes whether the page shows a contact/quote form (informational, no score change).

= 0.5.1 =
* New name: the product is now Vidal Geo AI (formerly Seo / Vidal GEO Agent). Same plugin, same settings, same site key.

= 0.5.0 =
* Vidal Geo AI suggests more, in the same review: a proposed H1 when the page has none, the exact contact line when your business phone is not on the page, share text (Open Graph) when the page has none, and the images missing alt text with a proposed alt for each — all written only from your business record and the page, shown in the panel as ready-to-use texts.
* New Apply fixes: an internal-links block (your homepage and sibling pages, with their real titles) for pages that link too little, and a panel alert with a one-click fix when the whole site is set to discourage search engines.

= 0.4.0 =
* Connected mode: fixes with an Apply button. Where Vidal Geo AI finds a problem, the panel shows the prepared fix next to it: the drafted FAQ ready to go visible on the page (Apply / Remove), and a suggested title and meta description when yours are missing or weak (Apply, with Undo restoring your previous values). The generated schema stays automatic, now with a per-page off switch. Everything applied is recorded on the page row.
* The brain now returns the title/description suggestion in the same review (no extra AI call).

= 0.3.0 =
* Nueva revisión de sitemap y robots (sección propia en el panel, en los dos modos): robots inexistente o que bloquea todo el sitio, Googlebot y rastreadores de buscadores con IA bloqueados, sitemap no anunciado en el robots o que no responde, XML inválido, sitemap-índice seguido hasta 5 hijos, y comprobación en vivo de hasta 50 URLs anunciadas (404/403/410/5xx/redirecciones) — cada problema con su instrucción exacta de reparación. Vidal Geo AI no escribe sitemap.xml ni robots.txt.

= 0.2.0 =
* Modo free sin agente: revisión local con la misma nota 0-100 (motor VGA_Scorer), tabla de páginas con notas locales y huecos, campos SEO propios por página con detección de Yoast/Rank Math/AIOSEO/SEOPress (sin duplicar etiquetas), ficha local del negocio con esquema LocalBusiness, y FAQ propio ([vidal_faq] y bloque) con su esquema FAQPage. El modo agente queda intacto y manda cuando hay clave.

= 0.1.0 =
* Primera versión: ajustes, barrido al publicar y con botón, esquema en wp_head validado como JSON, shortcode [seo_faq], panel con tabla de notas y huecos, y modo URL (el cerebro descarga la página).
