Añádelos en el functions.php de tu tema o en un plugin pequeño. Los hooks que solo sirven para conectar el plugin gratuito con Pro no aparecen aquí.
El endpoint rápido y los filtros
Vireo registra cada vista a través de un endpoint pequeño que carga WordPress sin tus plugins ni tu tema, así que es rápido. Si usas cualquiera de estos filtros, Vireo lo detecta y registra las vistas por la ruta estándar admin-ajax.php, donde se ejecuta tu código:
vireo_trust_proxy_headers, vireo_beacon_rate_limit_per_minute, vireo_beacon_rate_limit_shard_keys, vireo_honor_opt_out, vireo_bot_ua_pattern, vireo_bot_signatures, vireo_geo_country_headers, vireo_buffer_dir_max_bytes, vireo_headless_allowed_origins, vireo_shorten_ip.
| Hook |
Tipo |
Argumentos |
Qué hace |
vireo_force_direct_endpoint |
filtro |
bool|null $force (por defecto null) |
false registra todas las vistas por admin-ajax.php. true usa el endpoint rápido sin probarlo antes, para hostings que bloquean las peticiones de un sitio a sí mismo. Los filtros de arriba, y una dirección de endpoint en otro host, siguen usando admin-ajax.php. |
vireo_endpoint_url |
filtro |
string $url |
La dirección a la que el tracker envía las vistas. Por defecto, el endpoint.php del plugin. Si apunta a otro host, por ejemplo porque una CDN lo reescribió, Vireo usa admin-ajax.php en su lugar. |
Vireo comprueba el endpoint al activarse y después una vez por hora, así que un cambio en cualquiera de los dos filtros surte efecto en la siguiente comprobación.
Seguimiento
| Hook |
Tipo |
Argumentos |
Qué hace |
vireo_load_tracking_script |
filtro |
bool $load (por defecto true) |
Devuelve false para mantener el tracker fuera de la página actual. |
vireo_print_tracking_script |
acción |
ninguno |
Llámala con do_action() antes de </body> en una plantilla sin wp_footer(). Imprime el tracker una vez. |
vireo_honor_opt_out |
filtro |
bool $honor (por defecto true) |
Devuelve false para contar a los visitantes que envían Do Not Track o Global Privacy Control. |
vireo_require_consent |
filtro |
bool $require (por defecto false) |
Devuelve true para esperar el consentimiento para estadísticas de un plugin de WP Consent API. |
vireo_collect_web_vitals |
filtro |
bool $collect (por defecto true) |
Devuelve false para dejar de recoger Core Web Vitals. |
vireo_auto_event_download_exts |
filtro |
string $exts, extensiones unidas por | |
Los tipos de archivo que registra el evento automático de descargas de archivos. Por defecto pdf|zip|rar|7z|doc|docx|xls|xlsx|ppt|pptx|csv|mp3|mp4|mov|wav|dmg|pkg|exe|apk. |
vireo_track_form_success |
filtro |
bool $track (por defecto true) |
Devuelve false para dejar de registrar eventos form_success de los plugins de formularios. |
vireo_form_success |
acción |
string $value, string $id, string $title |
Se dispara cuando un plugin de formularios acepta un envío que Vireo cuenta. $value es el valor del evento, $id el id que el plugin de formularios da al formulario y $title el título del formulario. |
vireo_amp_has_consent |
filtro |
bool $has (por defecto false) |
En páginas AMP, mientras se exige consentimiento para estadísticas, el tracker solo se imprime si esto devuelve true. Lo establece una integración de consentimiento que muestra su aviso en la salida AMP. |
vireo_shorten_ip |
filtro |
bool $shorten |
Activa o desactiva el acortamiento de IP sea cual sea el ajuste «Acortar las direcciones IP». Parte de ese ajuste. |
vireo_track_wpra |
filtro |
bool $track (por defecto true) |
Devuelve false para dejar de contar los clics en los elementos de WP RSS Aggregator. |
vireo_track_spotlight |
filtro |
bool $track (por defecto true) |
Devuelve false para dejar de contar los clics en los feeds de Spotlight. |
vireo_show_admin_bar |
filtro |
bool $show, int $user_id |
Si la barra de herramientas muestra las páginas vistas de hoy para este usuario. Parte del ajuste Barra de herramientas. |
// Keep the tracker off a landing page used for ad tests.
add_filter( 'vireo_load_tracking_script', function ( $load ) {
return is_page( 'ad-test' ) ? false : $load;
} );
Bots y recuento
| Hook |
Tipo |
Argumentos |
Qué hace |
vireo_bot_ua_pattern |
filtro |
string $pattern, una expresión regular sin delimitadores |
Sustituye todo el patrón de bots. Las coincidencias se informan como Otros bots. |
vireo_bot_signatures |
filtro |
array $signatures, de categoría a regex combinada |
La lista ampliada de bots, generada a partir de Matomo Device Detector. Devuelve un array vacío para omitirla y quedarte solo con la lista propia de Vireo. |
vireo_visitor_path_cap |
filtro |
int $cap (por defecto 5) |
El máximo de vistas de una misma página que un visitante puede sumar en un día. |
vireo_visitor_daily_cap |
filtro |
int $cap (por defecto 50) |
El máximo de vistas que un visitante puede sumar en un día. |
vireo_beacon_rate_limit_per_minute |
filtro |
int $limit (por defecto 60) |
Páginas vistas aceptadas por minuto desde una misma dirección. 0 o menos desactiva el límite. |
vireo_beacon_rate_limit_shard_keys |
filtro |
int $keys (por defecto 2000) |
Cuántas direcciones recuerda cada archivo de límite de tasa antes de descartar las más antiguas. 0 o menos las conserva todas. Consulta el endpoint rápido. |
vireo_is_datacenter_hit |
filtro |
bool $is_datacenter, string $ip, string $path, string $ua |
Si una primera visita sin referente cuenta como tráfico de una red de hosting. Parte de los rangos de hosting incluidos. Solo se usa mientras Redes de hosting está activado en Ajustes, Seguimiento, Geolocalización. |
vireo_referrer_spam_hosts |
filtro |
string[] $hosts |
Hosts tratados como spam de referentes, además de la lista incluida y los que hayas bloqueado. Dominios en minúsculas; los subdominios coinciden. |
vireo_own_hosts |
filtro |
array $hosts, URL o hosts |
Hosts que nunca se cuentan como referentes porque son este sitio. Parte de las direcciones propias del sitio y del front-end headless. |
vireo_ai_sources |
filtro |
array $map, de etiqueta a regex de host |
Los asistentes de IA que se reconocen como referentes. |
// Recognise another assistant as an AI referrer.
add_filter( 'vireo_ai_sources', function ( $map ) {
$map['Example AI'] = '(^|\.)example-ai\.com$';
return $map;
} );
Proxies y direcciones
| Hook |
Tipo |
Argumentos |
Qué hace |
vireo_trust_proxy_headers |
filtro |
bool $trust (por defecto false) |
Devuelve true para leer la dirección del visitante de CF-Connecting-IP, X-Forwarded-For o X-Real-IP cuando la petición viene de un proxy de confianza. |
vireo_trusted_proxies |
filtro |
array $cidrs |
Redes cuyas cabeceras de reenvío se consideran fiables. Por defecto, loopback, rangos privados y Cloudflare. |
vireo_geo_country_headers |
filtro |
array $headers |
Claves de $_SERVER de las que se lee un código de país que proporciona tu hosting o CDN, como HTTP_CF_IPCOUNTRY. |
add_filter( 'vireo_trust_proxy_headers', '__return_true' );
add_filter( 'vireo_trusted_proxies', function ( $cidrs ) {
$cidrs[] = '203.0.113.0/24'; // Your load balancer.
return $cidrs;
} );
Headless y sitios conectados
| Hook |
Tipo |
Argumentos |
Qué hace |
vireo_headless_post_id |
filtro |
int $post_id, string $path, string $site, int $claimed |
Asocia una ruta del front-end a una entrada cuando la coincidencia por ruta no puede. $site es el origen del front-end y $claimed el ID que declaró la página. |
vireo_headless_allowed_origins |
filtro |
array $origins |
Orígenes que pueden enviar páginas vistas con la etiqueta headless. Parte del ajuste «Dirección del sitio front-end». |
vireo_connected_sites_limit |
filtro |
int $limit (por defecto 1) |
Cuántos sitios conectados permite esta instalación, con un tope de 100. |
vireo_mainwp_enabled |
filtro |
bool $enabled (por defecto true) |
Devuelve false para impedir que un panel de MainWP lea las cifras de este sitio. |
vireo_mainwp_proxied_abilities |
filtro |
string[] $names |
Los informes que un panel de MainWP puede ejecutar en este sitio. Parte de las habilidades de solo lectura de Vireo, y Pro añade sus informes. Solo se ejecutan habilidades de solo lectura, diga lo que diga la lista, y get-sites y get-sites-overview no se ejecutan nunca. |
// Front end serves posts under /blog/ while WordPress has them at the root.
add_filter( 'vireo_headless_post_id', function ( $post_id, $path ) {
if ( $post_id || 0 !== strpos( $path, '/blog/' ) ) {
return $post_id;
}
return url_to_postid( home_url( substr( $path, 5 ) ) );
}, 10, 2 );
API REST, habilidades y MCP
| Hook |
Tipo |
Argumentos |
Qué hace |
vireo_rest_permission_callback |
filtro |
bool $allowed, WP_REST_Request $request |
Añade una condición a la API REST. Se ejecuta solo después de superar la comprobación de capacidad, así que puede restringir el acceso, nunca ampliarlo. |
vireo_abilities_permission_callback |
filtro |
bool $allowed, array $input |
Lo mismo para las habilidades y las herramientas MCP. |
vireo_mcp_tools |
filtro |
array $tools, nombres de habilidades |
Las habilidades que se ofrecen como herramientas en el servidor MCP. Pro añade las suyas a través de este filtro. |
vireo_mcp_server_description |
filtro |
string $description |
La descripción que el servidor MCP da a los asistentes de IA cuando se conectan. |
Panel y datos
| Hook |
Tipo |
Argumentos |
Qué hace |
vireo_public_dashboard_allowed |
filtro |
bool $allowed (por defecto true) |
Con el panel público activado, devuelve false para rechazar a los visitantes sin sesión en esta petición. |
vireo_404_redirect_engine |
filtro |
string $engine |
Qué herramienta guarda las redirecciones creadas desde Enlaces rotos: vireo, srm (Safe Redirect Manager), redirection o rank-math. Parte de un plugin de redirecciones compatible cuando hay uno activo, y si no de vireo. Cualquier otro valor vuelve a vireo. |
vireo_matomo_allow_private_hosts |
filtro |
bool $allow (por defecto false) |
Devuelve true para que la importación de Matomo pueda llegar a un Matomo en una red privada. |
vireo_statistics_reset |
acción |
ninguno |
Se dispara después de que Restablecer estadísticas haya vaciado las tablas de Vireo, para que los add-ons vacíen las suyas. |
vireo_annotation_capability |
filtro |
string $cap (por defecto edit_others_posts) |
La capacidad necesaria para añadir notas. |
vireo_drivers_limit |
filtro |
int $limit |
Cuántos elementos que han subido o bajado lista Qué ha cambiado en cada sentido: 3 en la versión gratuita, 10 con Pro. |
vireo_overview_card_tab |
filtro |
string $tab, callable $cb |
En qué pestaña del Resumen aparece una tarjeta de un add-on enganchada a vireo_overview_after_core: content, campaigns, speed o issues. |
vireo_overview_tab_{tab} |
acción |
string $start, string $end, bool $compare |
Imprime una tarjeta en una pestaña del Resumen: vireo_overview_tab_search, _content, _campaigns, _speed o _issues. |
vireo_email_brand |
filtro |
array $brand con logo_url (cadena, vacía por defecto), accent (color hexadecimal como #0f172a, el predeterminado; cualquier otro valor vuelve a él) y show_vireo (bool, true por defecto) |
Cómo se ve el resumen por correo: un logo sobre el título, el color del botón «Ver el panel completo» y si el pie nombra a Vireo Analytics. Los ajustes de marca blanca de Vireo Pro lo usan. |
vireo_hour_stats_retention_days |
filtro |
int $days (por defecto 7, de 1 a 90) |
Cuánto tiempo se conserva el tráfico por horas para el gráfico por horas. |
vireo_plausible_max_bytes |
filtro |
int $bytes (por defecto 1 GB) |
Lo máximo que puede ocupar una exportación de Plausible al descomprimirse. |
vireo_after_flush |
acción |
ninguno |
Se dispara después de que cada lote de vistas nuevas llegue a la base de datos, más o menos una vez por minuto. |
vireo_goal_completed |
acción |
int $goal_id, string $visitor_hash, int $ts, float $value, string $date |
Se dispara con cada objetivo completado al registrarse, con el hash con sal del visitante (vacío cuando no hay), la hora Unix, el valor del objetivo y la fecha en la hora local del sitio. Es el único punto en el que una conversión todavía lleva a su visitante, así que escucha aquí para las secuencias. El hash cambia cada día y no identifica a nadie. |
vireo_allowed_query_vars |
filtro |
string[] $keys (por defecto page_id, p, tag, cat, product, attachment_id) |
Parámetros de consulta que se conservan en la ruta de una página. Los demás se descartan, así que /pricing/?ref=mail cuenta como /pricing/. |
vireo_404_max_new_rows_per_day |
filtro |
int $max (por defecto 500) |
Cuántas entradas nuevas de Enlaces rotos se registran en un día, cada una con una dirección que falta y desde dónde se enlazaba. Las visitas a entradas ya registradas ese día siguen contando. 0 o menos quita el límite. |
vireo_buffer_dir_max_bytes |
filtro |
int $bytes (por defecto 250 MB) |
Lo máximo que puede contener la carpeta de datos de Vireo mientras las vistas esperan a guardarse, entre este sitio y sus sitios conectados. Pasado ese límite, las vistas nuevas se descartan hasta que el guardado se ponga al día. Solo se alcanza cuando el guardado se ha detenido, algo que informa Salud del sitio. Consulta el endpoint rápido. |
vireo_network_activation_limit |
filtro |
int $limit (por defecto 200, de 1 a 10000) |
Cuántos sitios configura al momento la activación de red. El resto se configura la primera vez que se carga una de sus páginas. |
Funciones
vireo_track_event( string $name, string $value = '' ): bool
Registra un evento personalizado desde PHP. El nombre solo conserva a-z, 0-9, _ y -, y tanto el nombre como el valor se recortan a 100 caracteres. Devuelve false si el nombre queda vacío tras la limpieza. Consulta Eventos y enlaces rotos.
Pro
| Hook |
Tipo |
Argumentos |
Qué hace |
vireo_tracked_taxonomies |
filtro |
string[] $taxonomies (por defecto category, post_tag) |
Las taxonomías de Categorías y etiquetas principales. |
vireo_download_extensions |
filtro |
string[] $extensions, en minúsculas, sin punto |
Tipos de archivo que Pro cuenta como descargas. |
vireo_page_vitals_retention_days |
filtro |
int $days (por defecto 180, de 30 a 3650) |
Cuánto tiempo se conserva la velocidad por página. |
vireo_transitions_retention_days |
filtro |
int $days (por defecto 90, de 1 a 730) |
Cuánto tiempo se conservan las rutas de página a página. |
vireo_funnel_retention_days |
filtro |
int $days (por defecto 30, de 1 a 365) |
Cuánto tiempo se conservan los registros de pasos de embudo. |
vireo_transitions_max_new_pairs_per_day |
filtro |
int $max (por defecto 2000) |
Cuántos pares nuevos de página a página registra en un día Adónde va la gente después. Los pares ya registrados siguen contando. 0 o menos quita el límite. |
vireo_ai_report_content |
filtro |
string $html, array $data |
La parte escrita por IA del informe por correo de Pro, antes de que entre en el correo. |
vireo_ai_model_preference |
filtro |
string[] $models |
Los modelos que el informe por correo de Pro y Ask Vireo piden a tu proveedor de IA, por orden de preferencia. |
vireo_ask_tools |
filtro |
string[] $tools |
Las habilidades que puede usar Ask Vireo. Solo se conservan los nombres que empiezan por vireo-analytics/get-. |
vireo_ask_system_prompt |
filtro |
string $prompt, string[] $tools |
La instrucción con la que Ask Vireo empieza cada pregunta. |
vireo_search_retention_days |
filtro |
int $days (por defecto 90, de 7 a 730) |
Cuánto tiempo se conservan los registros de búsqueda en el sitio. |
vireo_search_live_min_length |
filtro |
int $length (por defecto 3) |
Los caracteres mínimos que necesita lo escrito en un cuadro de búsqueda en vivo para registrarse. |
vireo_search_live_debounce_ms |
filtro |
int $ms (por defecto 900) |
Cuánto espera el tracker después de que se deja de escribir antes de registrar una búsqueda en vivo. |
vireo_heatmap_retention_days |
filtro |
int $days (por defecto 90, de 7 a 3650) |
Cuánto tiempo se conservan los datos de los mapas de calor. |
vireo_heatmap_segment_cap |
filtro |
int $cap (por defecto 40, de 5 a 500) |
Cuántos segmentos sigue un mapa de calor, cada uno una combinación de canal, campaña, país y navegador. |
vireo_pro_short_link_prefix |
filtro |
string $prefix (por defecto to) |
La ruta bajo la que viven los enlaces cortos de campaña: /to/slug. |
vireo_affiliate_patterns |
filtro |
string[] $patterns, como /go/* |
Las rutas del mismo host que Pro cuenta como enlaces de afiliado. Parte del ajuste Informes, o de los valores por defecto de Pro. |
vireo_content_type_values |
filtro |
array $values, de tipo de contenido a etiqueta en plural |
Los tipos de contenido que ofrece el filtro Tipo de contenido. Parte de todos los tipos de contenido públicos salvo los adjuntos. |
vireo_ai_crawler_alert_drop_ratio |
filtro |
float $ratio (por defecto 0.10, de 0.01 a 0.9) |
La fracción de las peticiones diarias habituales de rastreadores de IA por debajo de la cual tiene que caer cada día de una bajada para que salte la alerta. |
vireo_ai_crawler_alert_min_baseline |
filtro |
float $median (por defecto 20, mínimo 1) |
Las peticiones diarias habituales de rastreadores de IA que necesita un sitio antes de poder alertar. |
vireo_alert_webhook_allow_http |
filtro |
bool $allow (por defecto false) |
Devuelve true para aceptar direcciones de webhook http:// sin cifrar en las alertas de tráfico, para desarrollo local. |
vireo_alert_webhook_allowed_hosts |
filtro |
string[] $hosts |
Hosts a los que puede apuntar un webhook aunque se resuelvan dentro de tu red. Solo se lee en sitios locales o de desarrollo, o cuando VIREO_DEV_WEBHOOK_ALLOWLIST está definida. |
vireo_wpshake_endpoint |
filtro |
string $url |
Adónde van los eventos cuando el canal WPShake está conectado, para un panel autoalojado o de desarrollo. |
vireo_pro_site_abilities |
filtro |
string[] $tools |
Las habilidades que admiten un argumento site para sitios conectados. Añade una solo si todas las tablas que lee siguen al sitio por el que se pregunta; si no, responde con las cifras de este sitio. |
vireo_mainwp_timeout |
filtro |
int $seconds (por defecto 10) |
De cuánto tiempo dispone un hijo de MainWP para responder a la pregunta de un asistente de IA. |