Menú de la documentaciónHooks y filtros

Hooks y filtros

Las acciones y los filtros que ofrecen Vireo Analytics y Vireo Pro a propietarios de sitios y desarrolladores, con sus argumentos y valores por defecto.

En esta página

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.

Actualizado el 13 de octubre de 2026. ¿Algo está mal o falta? Avísanos.