=== CítameIA ===
Contributors: gizmo13, freemius
Tags: seo, geo, aeo, schema, llms.txt
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.49.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Optimize your WordPress site so AI engines (ChatGPT, Gemini, Perplexity, Google AI Overviews) find you and cite you.

== Description ==

CítameIA automates the technical GEO (Generative Engine Optimization) and AEO (Answer Engine Optimization) tasks that agencies usually charge a lot for:

* Automatically generates schema.org markup (Organization/LocalBusiness, WebSite, Article, Product) across your site.
* `[citameia_faq]` shortcode to create FAQs that display on screen AND generate FAQPage schema.
* Generates and serves an llms.txt file with your business information in a format AI engines can read directly.
* Audit panel with a "citability score" and an actionable checklist.
* Content citability analyzer: paste text or a URL and get a score on 3 signals AI engines look for (direct answers, scannable structure, right length for the content type), with concrete suggestions to fix each one.
* Compatible with WooCommerce (automatic Product schema).
* Free version included. CítameIA Pro adds AI bot monitoring with history (including real human visits referred by ChatGPT, Perplexity, Gemini, or Claude), automatic reports (PDF, weekly email, verified-score badge), score trend history, and full AI mention testing breakdown.

**Note on language:** the plugin's admin interface (buttons, screens, messages) is currently in Spanish. This description is in English for reach, but Spanish is the plugin's source language for now — English translation via the WordPress.org community translation project is planned for a future release.

= Why GEO/AEO matters =

Search is changing. More people ask ChatGPT, Gemini, Perplexity, or Google AI Overviews directly instead of clicking through ten blue links. If your site isn't structured in a way these engines can parse and trust, you simply don't get mentioned — no matter how good your traditional SEO is. CítameIA closes that gap without requiring you to hire an agency or write a single line of code.

== Installation ==

1. Upload the `citameia` folder to `/wp-content/plugins/`.
2. Activate the plugin from the WordPress "Plugins" menu.
3. Go to "CítameIA" > "Business data" and fill in your information.
4. Go to "CítameIA" > "llms.txt" and click "Generate / update now".
5. Add the `[citameia_faq]` shortcode with `[citameia_faq_item]` to your key pages, or use the FAQ builder screen. (The old `[geo_faq]` / `[geo_faq_item]` names still work too, kept for backward compatibility.)
6. Check your score under "CítameIA" > "Panel".

== Frequently Asked Questions ==

= Is CítameIA free? =

Yes. The free version includes business data and schema.org generation, unlimited FAQ groups, schema validation, llms.txt, your current citability score, a content citability analyzer (paste text or a URL), Open Graph/Twitter Card tags, an external-presence checklist, and manual AI mention testing with 4 fixed questions. CítameIA Pro adds AI bot monitoring with history (including real human visits referred by ChatGPT, Perplexity, Gemini, or Claude), automatic reports (PDF, weekly email, badge), score history, and the full AI mention testing breakdown.

= What is the "citability score"? =

A 0-100 score summarizing how ready your site is for AI engines (ChatGPT, Gemini, Perplexity, Google AI Overviews) to understand, mention, and correctly cite it. It's calculated from technical checks (schema.org, llms.txt, structured FAQs) and external signals (presence on other sites, business-data consistency).

= Does it work alongside Yoast SEO or Rank Math? =

Yes. CítameIA detects if Yoast SEO, Rank Math, or Google for WooCommerce are already generating their own schema.org markup, and avoids duplicating it so you never end up with conflicting structured data on the same page.

= Is it compatible with WooCommerce? =

Yes, it automatically generates Product schema for your WooCommerce products.

= Does CítameIA send my site's data anywhere? =

CítameIA uses the Freemius SDK for Pro license management and aggregated, anonymous usage analytics. The first time you activate the plugin, you're explicitly asked whether you consent to sharing that data — you can use the free version without opting in.

= What happens if I cancel my Pro license? =

Your data and settings are not deleted. Pro-only features (AI bot monitoring, automatic reports, score history, and the full AI mention testing breakdown) lock again, but everything in the free version — including unlimited FAQ groups — keeps working normally.

== Screenshots ==

1. Main panel: citability score, trend, and category checklist.
2. Reports: downloadable PDF, automatic weekly email, and verified-score badge.
3. AI bot monitoring: real activity over the last 30 days, by engine.
4. External presence: checklist of trust signals outside your own site.
5. AI mention testing: fixed test questions and result logging.
6. Plans screen: comparison between CítameIA Free and Pro.

== Changelog ==

= 1.49.2 =
* Arreglo: si una página no tiene título (queda vacío en WordPress),
  "Páginas principales" en llms.txt generaba un link roto sin texto
  visible ("- []()"). Ahora usa un texto de respaldo legible derivado
  del link cuando el título está vacío.

= 1.49.1 =
* Arreglo: "Links que no combinan con su título" marcaba falsamente
  páginas como "Preguntas frecuentes" (link /faq/) — FAQ es un
  acrónimo reconocido, no una señal de contenido mal etiquetado.
* Arreglo: ese mismo chequeo, y "Páginas principales" en llms.txt,
  ahora también excluyen la página del comparador de YITH WooCommerce
  Compare — mismo criterio que ya aplicaba a wishlist.

= 1.49.0 =
* Nuevo (gratis): "Salud para agentes" ahora también detecta páginas y
  posts cuyo link no comparte ninguna palabra con su título — señal
  típica de contenido que viene de una plantilla o demo (por ejemplo,
  de un tema de tienda) y nunca se le actualizó el link al ponerle su
  título real. Aparece como "Links que no combinan con su título",
  con acceso directo para editar cada uno.

= 1.48.0 =
* Arreglo: "Páginas principales" en llms.txt ahora también excluye la
  página de wishlist si tienes instalado YITH WooCommerce Wishlist o
  TI WooCommerce Wishlist — el mismo criterio que ya aplicaba a
  carrito, checkout y cuenta.

= 1.47.0 =
* Arreglo: "Páginas principales" en llms.txt ya no incluye las páginas de utilidad de WooCommerce (carrito, checkout, mi cuenta, tienda) ni "Sample Page" — ninguna le aporta nada a una IA tratando de entender el negocio.
* Arreglo: el resumen del negocio en llms.txt ahora usa el formato blockquote (`>`) que pide el estándar, justo después del título.
* Arreglo: el chequeo de "llms.txt" en Salud para agentes marcaba
  incorrectamente el sitio como sin llms.txt cuando el hosting no
  permite escribir el archivo físico en la raíz del sitio, aunque el
  rewrite de respaldo del plugin ya lo estuviera sirviendo bien.
  Ahora, si no encuentra el archivo físico, confirma con una petición
  real a la URL pública antes de reportar el problema.

= 1.46.0 =
* Nuevo (Pro): "Visitas humanas referidas por IA" dentro de Monitoreo de IA — detecta cuando alguien llega desde un link que le dio ChatGPT, Perplexity, Gemini o Claude, con desglose por plataforma. Incluye un aviso honesto: es un estimado, no el total real, porque varias plataformas no siempre comparten ese dato.
* Nuevo (gratis): la pestaña "Citabilidad" ahora acepta una URL además de pegar texto — trae el contenido de la página automáticamente y lo analiza igual.
* Rediseño (gratis): "Tipo de contenido" en Citabilidad pasó de un menú desplegable a tarjetas seleccionables, con la descripción de cada opción siempre visible en vez de tener que elegir primero para verla.
* Mejora (gratis): las sugerencias de Citabilidad ahora son tarjetas expandibles, con explicación de por qué importa cada una y una lista concreta de pasos ("Cómo corregirlo").

= 1.45.0 =
* Nuevo: aviso amable pidiendo una reseña, que aparece solo en las pantallas del plugin después de 14 días de uso — con un botón directo a WordPress.org y otro para ocultarlo para siempre.
* Corregido: link del shortcode desactualizado en la descripción del plugin.

= 1.44.0 =
* Nuevo (gratis): pestaña "Citabilidad" dentro de "Pruebas en IA" — pega el texto de una página (o cópialo de tu editor) y recibe un score sobre 3 señales calculadas al instante, sin IA: respuesta directa, estructura escaneable, y longitud adecuada según el tipo de contenido. Incluye sugerencias concretas según qué falló.
* Nuevo (gratis): pestaña "Salud para agentes" dentro de "Pruebas en IA" — analiza tu contenido publicado (posts, páginas, y productos si usas WooCommerce) buscando imágenes sin texto alt o sin dimensiones declaradas (causa típica de un CLS alto), y confirma si tienes llms.txt. Los mismos criterios que usa Google en su categoría "Navegación con agentes" de PageSpeed Insights.
* "Pruebas en IA" ahora tiene navegación por pestañas (Menciones, Citabilidad, Salud para agentes) en vez de ser una sola pantalla.

= 1.43.0 =
* Nuevo (gratis): cada ítem del checklist de "Presencia externa" ahora trae una guía "¿Cómo lo consigo?" desplegable, con pasos concretos — no solo un checkbox y una frase de "por qué importa". Cubre los 7 casos (Google Business Profile, reseñas, LinkedIn para negocios digitales, redes sociales, directorios, consistencia NAP, y menciones externas).

= 1.42.1 - 1.42.10 =
* Cerrado el cumplimiento con WordPress.org al 100%: las 5 áreas Pro (Monitoreo de IA, Reportes, Historial del score, FAQ, Pruebas en IA) quedaron envueltas en is__premium_only(), verificado directo contra el zip real descargado de Freemius, no solo con Plugin Check.
* Eliminado el límite de "1 FAQ gratis" (calificaba como "usage quota", prohibido) — FAQ ilimitadas para todos. Nuevo (Pro): "Sugerir preguntas automáticamente".
* Overlay Checkout de Freemius integrado en la pantalla de planes, con la misma protección is__premium_only() para no exponer código externo en el build gratis.
* Encontrado y corregido un patrón no documentado: el proceso de build de Freemius reformatea arrays y llamadas largas, lo que puede desalinear comentarios "translators:" y phpcs:ignore de su línea objetivo — corregido en todos los casos detectados.
* Corregido: Plugin URI y Author URI con el mismo valor (motivo de rechazo automático en el primer envío).

= 1.41.5 =
* Cerrado el ciclo de correcciones del WordPress.org Plugin Check (versiones 1.41.1-1.41.5): missing translator comments, nonce checks sin wp_unslash(), wp_redirect() → wp_safe_redirect(), SQL sin preparar, y un bug real propio (27 comentarios "translators:" que habían quedado fuera del bloque <?php ?>, corregido y verificado). Quedan 2 advertencias conocidas sin suprimir ($product de WooCommerce, $geo_radar_faq_items) — falsos positivos verificados; el sniff no respeta comentarios de exención en esta herramienta.

= 1.41.0 =
* New: real Freemius SDK integration for Pro licensing and checkout.
* The "Get CítameIA Pro" button now uses the real Freemius checkout URL.
* Added Freemius's free/premium auto-deactivation safeguard to prevent conflicts if both versions are ever active at once.

= 1.40.0 =
* New: Plans screen (CítameIA Pro) showing free vs. Pro features side by side, with a monthly/annual pricing toggle.

= 1.39.0 =
* New: free/Pro split. AI bot monitoring, automatic reports, score history, unlimited FAQ groups, and the full AI mention testing breakdown are now Pro features. Everything else remains free.

= 1.38.2 =
* Fixed: the WordPress admin sidebar menu was not being translated to English; now all 10 entries switch correctly.

= 1.33.0 =
* New: Reports screen (PDF report, weekly email, shareable score badge, report history).
* New: AI bot monitoring with automatic exclusion of vulnerability-scanner traffic.
* New: competitor comparison table on the landing page.

= 1.19.0 =
* Major build-out: sub-dimension scoring, external presence checklist, "mentioned vs. cited with a link" distinction in AI mention testing, weekly automatic score snapshots.

= 1.13.0 =
* New core check: scans your robots.txt for GPTBot, ClaudeBot, PerplexityBot, Google-Extended, and other known AI crawlers being blocked.

= 1.9.0 =
* New "AI Mention Testing" screen: generates suggested blind questions based on your business data, with buttons to copy them and open ChatGPT/Gemini/Perplexity/Google directly. No paid APIs or API keys — an honest, manual log of real tests.

= 1.0.0 =
* Initial release: automatic schema, FAQ with schema, llms.txt, citability audit.

== Upgrade Notice ==
