PixelYourSite icon
Analytics & Tracking

PixelYourSite hooks reference

  • By PixelYourSite
  • v11.4.5 New
  • Updated

PixelYourSite 11.4.5 has 10 actions and 127 filters, read directly from its source code on Nov 17, 2026. The list updates automatically when a new version is released.

How to use these hooks

Actions let you run your own code at a specific moment. Filters let you change a value before the plugin uses it. Put your code in a child theme's functions.php or a code-snippets plugin, never in the plugin's own files, because updates overwrite them.

functions.phpyour child theme
// Run your own code when PixelYourSite fires an action
add_action( 'pys_pro_mcp_adapter_init', function( $object ) {
	// Your code runs here.
}, 10, 1 );

// Change a value PixelYourSite is about to use
add_filter( 'pys_pro_mcp_adapter_validation_enabled', function( $value, $server_id, $object ) {
	// Change $value here.
	return $value;
}, 10, 3 );

Parts of a name in {braces} are filled in at runtime (for example a post type or field ID). Choose Example on any hook for a ready-to-edit snippet.

All hooks

  • vendor_prefix/wordpress/mcp-adapter/includes/Core/McpServer.php line 140 · used in 8 places
    /**
     * Filters whether MCP protocol validation is enabled for a server.
     */
    apply_filters( 'pys_pro_mcp_adapter_validation_enabled', \false, $this->server_id, $this );
  • pys_client_ip

    filter
    includes/class-pys.php line 1030 · used in 3 places
    /**
     * Filters the resolved client IP address.
     */
    apply_filters( 'pys_client_ip', $ip, 'resolved' );
  • includes/functions-common.php line 2886 · used in 2 places
    /**
     * Filters the account id before it is hashed.
     */
    apply_filters( 'pys_external_id_user_value', (string) $user_id, $user_id );
  • includes/functions-common.php line 2899 · used in 2 places
    /**
     * Filters the whole set of external ids for one event.
     */
    apply_filters( 'pys_external_ids', $ids, $user_id );
  • modules/facebook/class-facebook-rest-api.php line 233 · used in 2 places
    /**
     * Filters whether a REST tracking request is allowed.
     */
    apply_filters( 'pys_rest_event_permission', $is_same_origin, $request );
  • modules/facebook/facebook-server.php line 349
    /**
     * filter pys_before_send_fb_server_event Help add custom options or get data
     * from event before send FacebookAds\Object\ServerSide\Event $event String
     * $pixel_Id String EventId
     */
    apply_filters( 'pys_before_send_fb_server_event', $event, $pixel_Id, $event->getEventId() );
  • includes/functions-gdpr.php line 72
    /**
     * Cookiebot can be embedded by hand (theme, tag manager) with no WP plugin;
     * the plugin check cannot see that. The filter lets such a site unlock the
     * integration: add_filter( 'pys_cookiebot_active', '__return_true' ).
     */
    apply_filters( 'pys_cookiebot_active', is_plugin_active( 'cookiebot/cookiebot.php' ) );
  • includes/functions-common.php line 2796
    /**
     * Filters the request signals that make up the visitor id.
     */
    apply_filters( 'pys_pbid_fingerprint_parts', $parts, $server );
  • vendor_prefix/wordpress/mcp-adapter/includes/Core/McpAdapter.php line 107
    /**
     * Filters whether the default MCP server should be created.
     */
    apply_filters( 'pys_pro_mcp_adapter_create_default_server', \true );
  • vendor_prefix/wordpress/mcp-adapter/includes/Servers/DefaultServerFactory.php line 67
    /**
     * Filters the default MCP server configuration.
     */
    apply_filters( 'pys_pro_mcp_adapter_default_server_config', $wordpress_defaults );
  • vendor_prefix/wordpress/mcp-adapter/includes/Transport/HttpTransport.php line 98
    /**
     * Filters the default user capability required for MCP transport access.
     */
    apply_filters( 'pys_pro_mcp_adapter_default_transport_permission_user_capability', 'read', $context );
  • vendor_prefix/wordpress/mcp-adapter/includes/Abilities/DiscoverAbilitiesAbility.php line 91
    /**
     * Filters the capability required to discover available abilities.
     */
    apply_filters( 'pys_pro_mcp_adapter_discover_abilities_capability', 'read' );
  • vendor_prefix/wordpress/mcp-adapter/includes/Cli/StdioServerBridge.php line 87
    /**
     * Filters whether the STDIO transport is enabled.
     */
    apply_filters( 'pys_pro_mcp_adapter_enable_stdio_transport', \true );
  • vendor_prefix/wordpress/mcp-adapter/includes/Abilities/ExecuteAbilityAbility.php line 142
    /**
     * Filters the capability required to execute abilities.
     */
    apply_filters( 'pys_pro_mcp_adapter_execute_ability_capability', 'read' );
  • vendor_prefix/wordpress/mcp-adapter/includes/Abilities/GetAbilityInfoAbility.php line 112
    /**
     * Filters the capability required to get ability information.
     */
    apply_filters( 'pys_pro_mcp_adapter_get_ability_info_capability', 'read' );
  • vendor_prefix/wordpress/mcp-adapter/includes/Core/McpAdapter.php line 86
    /**
     * Fires after the MCP Adapter has been initialized.
     */
    do_action( 'pys_pro_mcp_adapter_init', $this );
  • vendor_prefix/wordpress/mcp-adapter/includes/Handlers/Initialize/InitializeHandler.php line 72
    /**
     * Filters the initialize response before returning to the client.
     */
    apply_filters( 'pys_pro_mcp_adapter_initialize_response', $result, $this->mcp );
  • vendor_prefix/wordpress/mcp-adapter/includes/Core/McpComponentRegistry.php line 94
    /**
     * Filters whether component registration events should be recorded for
     * observability.
     */
    apply_filters( 'pys_pro_mcp_adapter_observability_record_component_registration', \false, $this->mcp_server->get_server_id(), $this->mcp_server );
  • vendor_prefix/wordpress/mcp-adapter/includes/Handlers/Prompts/PromptsHandler.php line 131
    /**
     * Filters prompt arguments before execution, or short-circuits execution
     * entirely.
     */
    apply_filters( 'pys_pro_mcp_adapter_pre_prompt_get', $arguments, $prompt_name, $mcp_prompt, $this->mcp );
  • vendor_prefix/wordpress/mcp-adapter/includes/Handlers/Resources/ResourcesHandler.php line 116
    /**
     * Filters resource parameters before execution, or short-circuits execution
     * entirely.
     */
    apply_filters( 'pys_pro_mcp_adapter_pre_resource_read', $request_params, $uri, $mcp_resource, $this->mcp );
  • vendor_prefix/wordpress/mcp-adapter/includes/Handlers/Tools/ToolsHandler.php line 144
    /**
     * Filters tool arguments before execution, or short-circuits execution
     * entirely.
     */
    apply_filters( 'pys_pro_mcp_adapter_pre_tool_call', $args, $tool_name, $mcp_tool, $this->mcp );
  • vendor_prefix/wordpress/mcp-adapter/includes/Handlers/Prompts/PromptsHandler.php line 151
    /**
     * Filters the prompt execution result before normalization.
     */
    apply_filters( 'pys_pro_mcp_adapter_prompt_get_result', $result, $arguments, $prompt_name, $mcp_prompt, $this->mcp );
  • vendor_prefix/wordpress/mcp-adapter/includes/Domain/Prompts/RegisterAbilityAsMcpPrompt.php line 397
    /**
     * Filters the MCP prompt name derived from an ability.
     */
    apply_filters( 'pys_pro_mcp_adapter_prompt_name', $sanitized_name, $this->ability );
  • vendor_prefix/wordpress/mcp-adapter/includes/Handlers/Prompts/PromptsHandler.php line 78
    /**
     * Filters the list of prompts before returning to the client.
     */
    apply_filters( 'pys_pro_mcp_adapter_prompts_list', $prompts, $this->mcp );
  • vendor_prefix/wordpress/mcp-adapter/includes/Domain/Resources/RegisterAbilityAsMcpResource.php line 350
    /**
     * Filters the MCP resource name derived from an ability.
     */
    apply_filters( 'pys_pro_mcp_adapter_resource_name', $name, $this->ability );
  • vendor_prefix/wordpress/mcp-adapter/includes/Handlers/Resources/ResourcesHandler.php line 136
    /**
     * Filters the resource contents after execution.
     */
    apply_filters( 'pys_pro_mcp_adapter_resource_read_result', $contents, $request_params, $uri, $mcp_resource, $this->mcp );
  • vendor_prefix/wordpress/mcp-adapter/includes/Domain/Resources/RegisterAbilityAsMcpResource.php line 227
    /**
     * Filters the MCP resource URI derived from an ability.
     */
    apply_filters( 'pys_pro_mcp_adapter_resource_uri', $uri, $this->ability );
  • vendor_prefix/wordpress/mcp-adapter/includes/Handlers/Resources/ResourcesHandler.php line 61
    /**
     * Filters the list of resources before returning to the client.
     */
    apply_filters( 'pys_pro_mcp_adapter_resources_list', $resources, $this->mcp );
  • vendor_prefix/wordpress/mcp-adapter/includes/Transport/Infrastructure/SessionManager.php line 173
    /**
     * Filters the minimum interval between session last_activity writes.
     */
    apply_filters( 'pys_pro_mcp_adapter_session_activity_update_interval', self::DEFAULT_ACTIVITY_UPDATE_INTERVAL );
  • vendor_prefix/wordpress/mcp-adapter/includes/Transport/Infrastructure/SessionManager.php line 161
    /**
     * Filters the session inactivity timeout in seconds.
     */
    apply_filters( 'pys_pro_mcp_adapter_session_inactivity_timeout', self::DEFAULT_INACTIVITY_TIMEOUT );
  • vendor_prefix/wordpress/mcp-adapter/includes/Transport/Infrastructure/SessionManager.php line 150
    /**
     * Filters the maximum number of MCP sessions allowed per user.
     */
    apply_filters( 'pys_pro_mcp_adapter_session_max_per_user', self::DEFAULT_MAX_SESSIONS );
  • vendor_prefix/wordpress/mcp-adapter/includes/Handlers/Tools/ToolsHandler.php line 164
    /**
     * Filters the tool execution result before response assembly.
     */
    apply_filters( 'pys_pro_mcp_adapter_tool_call_result', $result, $args, $tool_name, $mcp_tool, $this->mcp );
  • vendor_prefix/wordpress/mcp-adapter/includes/Domain/Tools/RegisterAbilityAsMcpTool.php line 183
    /**
     * Filters the MCP tool name derived from an ability.
     */
    apply_filters( 'pys_pro_mcp_adapter_tool_name', $sanitized_name, $this->ability );
  • vendor_prefix/wordpress/mcp-adapter/includes/Handlers/Tools/ToolsHandler.php line 83
    /**
     * Filters the list of tools before returning to the client.
     */
    apply_filters( 'pys_pro_mcp_adapter_tools_list', $tools, $this->mcp );
  • vendor_prefix/wordpress/mcp-adapter/includes/Plugin.php line 42
    /**
     * Fires after the main plugin class has been initialized.
     */
    do_action( 'pys_pro_wp_mcp_init', self::$instance );
  • includes/class-pys.php line 497
    /**
     * filter pys_record_visit_data Escape hatch for setups where an excluded
     * request type really is an entry point (a feed-only funnel, a 404 URL used as
     * a campaign landing page).
     */
    apply_filters( 'pys_record_visit_data', $record );
  • includes/class-pys.php line 438
    /**
     * filter pys_session_read_only Escape hatch for setups that need the session
     * writable on AJAX.
     */
    apply_filters( 'pys_session_read_only', $read_only );
  • includes/class-pys.php line 460
    /**
     * filter pys_skip_session
     */
    apply_filters( 'pys_skip_session', $skip );
  • includes/class-pys.php line 317 · used in 9 places
    apply_filters( 'pys_form_event_factory', [] );
  • includes/class-consent.php line 71 · used in 6 places
    apply_filters( 'pys_disable_by_gdpr', false );
  • includes/class-plugin-updater.php line 744 · used in 4 places
    apply_filters( 'edd_sl_api_request_verify_ssl', true, $this );
  • includes/class-events-manager.php line 204 · used in 4 places
    apply_filters( 'pys_disable_analytics_by_gdpr', false );
  • includes/class-events-manager.php line 211 · used in 4 places
    apply_filters( 'pys_disable_externalID_by_gdpr', false );
  • includes/class-events-manager.php line 203 · used in 4 places
    apply_filters( 'pys_disable_facebook_by_gdpr', false );
  • includes/class-events-manager.php line 261 · used in 3 places
    apply_filters( 'pys_ad_personalization_mode', true );
  • includes/class-events-manager.php line 259 · used in 3 places
    apply_filters( 'pys_ad_storage_mode', true );
  • includes/class-events-manager.php line 260 · used in 3 places
    apply_filters( 'pys_ad_user_data_mode', true );
  • includes/class-events-manager.php line 258 · used in 3 places
    apply_filters( 'pys_analytics_storage_mode', true );
  • includes/class-events-manager.php line 207 · used in 3 places
    apply_filters( 'pys_disable_bing_by_gdpr', false );
  • includes/class-events-manager.php line 209 · used in 3 places
    apply_filters( 'pys_disable_openai_by_gdpr', false );
  • includes/class-events-manager.php line 206 · used in 3 places
    apply_filters( 'pys_disable_pinterest_by_gdpr', false );
  • includes/class-events-manager.php line 208 · used in 3 places
    apply_filters( 'pys_disable_reddit_by_gdpr', false );
  • modules/facebook/PYSServerEventHelper.php line 615 · used in 3 places
    apply_filters( 'pys_send_meta_id', true );
  • includes/views/html-wrapper-single-page.php line 140 · used in 2 places
    do_action( "pys_admin_{getCurrentAdminPage()}" );
  • includes/class-events-manager.php line 205 · used in 2 places
    apply_filters( 'pys_disable_google_ads_by_gdpr', false );
  • includes/class-events-manager.php line 309 · used in 2 places
    apply_filters( 'pys_event_factory', [] );
  • modules/facebook/facebook.php line 81 · used in 2 places
    apply_filters( 'pys_facebook_ids', [] );
  • pys_ga_ids

    filter
    modules/google_analytics/ga.php line 102 · used in 2 places
    apply_filters( 'pys_ga_ids', [] );
  • pys_gtm_ids

    filter
    modules/google_gtm/gtm.php line 251 · used in 2 places
    apply_filters( 'pys_gtm_ids', [] );
  • includes/class-consent.php line 211 · used in 2 places
    apply_filters( 'pys_meta_ldu_mode', false );
  • modules/openai/openai.php line 79 · used in 2 places
    apply_filters( 'pys_openai_ids', [] );
  • modules/google_analytics/ga.php line 65 · used in 2 places
    apply_filters( 'pys_pixel_disabled', array(), $this->getSlug() );
  • includes/events/interface-events.php line 42 · used in 2 places
    apply_filters( 'pys_validate_pixel_event', true, $pixelEvent, $pixel );
  • includes/functions-woo-discounts.php line 174
    apply_filters( 'advanced_woo_discount_rules_get_cart_item_discount_price', false, $cart_item );
  • includes/functions-woo-discounts.php line 160
    apply_filters( 'advanced_woo_discount_rules_get_product_discount_price_from_custom_price', $price, $product, $qty, 0, 'discounted_price', true, false );
  • includes/class-plugin-updater.php line 268
    do_action( "in_plugin_update_message-{$file}", $plugin, $version_info );
  • includes/views/html-wrapper-main.php line 210
    do_action( "pys_admin_{getCurrentAdminTab()}" );
  • includes/views/html-main-general.php line 507
    do_action( 'pys_admin_pixel_ids' );
  • includes/functions-admin.php line 123
    apply_filters( 'pys_admin_secondary_nav_tabs', $tabs );
  • includes/functions-custom-event.php line 489
    apply_filters( 'pys_currencies_list', $currencies );
  • includes/class-events-manager.php line 395
    apply_filters( "pys_disable_{$slug}_by_gdpr", false );
  • modules/facebook/facebook-server.php line 306
    apply_filters( 'pys_disable_server_event_filter', false );
  • includes/functions-common.php line 1966
    apply_filters( 'pys_dynamic_user_data_keys', array( 'facebook' => array( 'advancedMatching' ), 'tiktok' => array( 'advanced_matching' ), 'pinterest' => array( 'advancedMatching' ), 'reddit' => array( 'advanced_matching' ), 'openai' => array( 'advanced_matching' ), ) );
  • includes/functions-event-signals.php line 216
    apply_filters( 'pys_edd_anonymize_meta_keys', array( 'pys_client_signals', 'pys_fb_cookie', 'pys_tt_cookie', 'pys_pin_cookie', 'pys_oai_cookie' ) );
  • includes/functions-edd.php line 143
    apply_filters( 'pys_edd_require_receipt_access', false );
  • includes/functions-fb-cookies.php line 301
    apply_filters( 'pys_fb_append_param_appendix', false );
  • modules/facebook/facebook-server.php line 334
    apply_filters( 'pys_fb_insecure_tls', false );
  • includes/class-feed-id-check.php line 1419
    apply_filters( 'pys_feed_id_check_video_url', '' );
  • includes/class-pys.php line 1604
    apply_filters( 'pys_gdpr_ajax_enabled', $gdpr_ajax_enabled );
  • includes/logger/class-pys-logger.php line 377
    apply_filters( 'pys_log_max_size', self::LOG_DEFAULT_MAX_SIZE, $this );
  • modules/openai/openai.php line 215
    apply_filters( 'pys_openai_advanced_matching', $params );
  • modules/openai/function-helpers.php line 43
    apply_filters( 'pys_openai_currency_exponent', $exponent, $currency );
  • modules/openai/openai.php line 297
    apply_filters( 'pys_openai_matching_values', $values, $wooOrder, $eddOrder );
  • modules/openai/openai-server.php line 397
    apply_filters( 'pys_openai_server_user_data', $userData, $wooOrder, $eddOrder );
  • includes/class-consent.php line 241
    apply_filters( 'pys_pixel_restricted_mode', (bool) $restricted, $pixel );
  • includes/class-consent.php line 215
    apply_filters( 'pys_reddit_ldu_mode', false );
  • includes/class-pys.php line 278
    do_action( 'pys_register_pixels', $this );
  • includes/class-pys.php line 279
    do_action( 'pys_register_plugins', $this );
  • includes/functions-common.php line 2084
    apply_filters( 'pys_render_visitor_pii_in_html', false );
  • includes/class-rest-api-guard.php line 595
    apply_filters( 'pys_rest_edd_blocked_statuses', array( 'failed', 'abandoned', 'revoked', 'cancelled' ) );
  • includes/class-rest-api-guard.php line 235
    apply_filters( 'pys_rest_enforce_purchase_value', true, $request );
  • includes/class-rest-api-guard.php line 125
    apply_filters( 'pys_rest_purchase_guard_enabled', true );
  • includes/class-rest-api-guard.php line 200
    apply_filters( 'pys_rest_require_order_for_custom_purchase', false, $event_slug, $request );
  • includes/class-rest-api-guard.php line 194
    apply_filters( 'pys_rest_require_order_for_purchase', true, $event_slug, $request );
  • includes/functions-common.php line 163
    apply_filters( 'pys_rest_send_after_response', true );
  • includes/class-rest-api-guard.php line 120
    apply_filters( 'pys_rest_skip_bot_events', PYS()->is_user_agent_bot(), $request );
  • includes/class-rest-api-guard.php line 700
    apply_filters( 'pys_rest_valid_event_slugs', $builtin );
  • includes/class-rest-api-guard.php line 143
    apply_filters( 'pys_rest_validate_event_slug', true, $request );
  • includes/class-rest-api-guard.php line 507
    apply_filters( 'pys_rest_validate_orders', $enabled, $request );
  • includes/class-rest-api-guard.php line 555
    apply_filters( 'pys_rest_woo_blocked_statuses', (array) PYS()->getOption( 'woo_order_purchase_disabled_status' ) );
  • modules/openai/openai-server.php line 127
    do_action( 'pys_send_openai_server_event', $serverEvents );
  • modules/facebook/facebook-server.php line 113
    do_action( 'pys_send_server_event', $serverEvents );
  • includes/functions-common.php line 219
    apply_filters( 'pys_server_connect_timeout', $timeout, $background );
  • includes/functions-common.php line 201
    apply_filters( 'pys_server_request_timeout', $timeout, $background );
  • includes/class-custom-event.php line 1301
    apply_filters( 'pys_superpack_dynamic_params', $param, 'gtm' );
  • includes/functions-system-report.php line 191
    apply_filters( 'pys_system_report', $report, $for_download );
  • includes/class-param-builder-adapter.php line 96
    apply_filters( 'pys_use_capi_param_builder', false );
  • includes/functions-woo-discounts.php line 41
    apply_filters( 'pys_woo_discount_providers', $providers );
  • includes/functions-woo.php line 810
    apply_filters( 'pys_woo_legacy_gateway_compat', false );
  • includes/functions-woo.php line 820
    apply_filters( 'pys_woo_legacy_gateway_compat_window', HOUR_IN_SECONDS );
  • includes/functions-woo.php line 871
    apply_filters( 'pys_woo_request_can_access_order', pysWooCheckOrderAccess( $order_id, $context ), $order_id, $context );
  • includes/class-events-manager.php line 819
    apply_filters( 'woocommerce_ajax_variation_threshold', 30, $product );
  • includes/functions-woo.php line 49
    apply_filters( 'woocommerce_hide_invisible_variations', true, $variation->get_parent_id(), $variation );
  • includes/functions-common.php line 1838
    apply_filters( 'wpml_object_id', $product_id, 'product', false, $tag->getOption($tagLanguageOption) );
  • includes/functions-common.php line 1839
    apply_filters( 'wpml_original_element_id', NULL, $product_id );

Generated from PixelYourSite's GPL-licensed source code. Hooks inside bundled third-party libraries are not listed.

Can't find the right hook?

We can build the customisation for you. Describe what you need: