WP Activity Log icon
Admin & Maintenance

WP Activity Log hooks reference

  • By Melapress
  • v5.7.0 New
  • Updated

WP Activity Log 5.7.0 has 29 actions and 70 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 WP Activity Log fires an action
add_action( 'wsal_auditlog_after_view', function( $events_list ) {
	// Your code runs here.
}, 10, 1 );

// Change a value WP Activity Log is about to use
add_filter( 'wsal_additional_user_tooltip_content', function( $value, $user ) {
	// Change $value here.
	return $value;
}, 10, 2 );

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

  • classes/Helpers/class-user-utils.php line 188 · used in 2 places
    /**
     * WSAL Filter: `wsal_additional_user_tooltip_content'
     */
    apply_filters( 'wsal_additional_user_tooltip_content', '', $user );
  • classes/MainWPAddon/class-mainwp-addon.php line 333 · used in 2 places
    /**
     * Hook: `wsal_auditlog_after_view`
     */
    do_action( 'wsal_auditlog_after_view', $events_list );
  • classes/MainWPAddon/class-mainwp-addon.php line 309 · used in 2 places
    /**
     * Hook: `wsal_auditlog_before_view`
     */
    do_action( 'wsal_auditlog_before_view', $events_list );
  • classes/WPSensors/class-wp-metadata-sensor.php line 404 · used in 2 places
    /**
     * WSAL Filter: `wsal_ignore_user_meta_event`
     */
    apply_filters( 'wsal_ignore_user_meta_event', false, $meta_key, $meta_value, $object_id );
  • classes/MainWPAddon/class-mainwp-addon.php line 319 · used in 2 places
    /**
     * Action: `wsal_search_filters_list`
     */
    do_action( 'wsal_search_filters_list', 'top' );
  • third-party/scoped/classes/wp-async-request.php line 142
    /**
     * Filters the post arguments used during an async request.
     */
    apply_filters( "{$this->identifier}_post_args", $args );
  • third-party/scoped/classes/wp-async-request.php line 99
    /**
     * Filters the post arguments used during an async request.
     */
    apply_filters( "{$this->identifier}_query_args", $args );
  • third-party/scoped/classes/wp-async-request.php line 117
    /**
     * Filters the post arguments used during an async request.
     */
    apply_filters( "{$this->identifier}_query_url", $url );
  • third-party/scoped/classes/wp-background-process.php line 459
    /**
     * Number of seconds to sleep between batches. Defaults to 0 seconds, minimum
     * 0.
     */
    apply_filters( "{$this->identifier}_seconds_between_batches", apply_filters($this->prefix . '_seconds_between_batches', 0) );
  • third-party/scoped/classes/wp-async-request.php line 173
    /**
     * Should wp_die be used?
     */
    apply_filters( "{$this->identifier}_wp_die", \true );
  • third-party/scoped/classes/wp-background-process.php line 459
    /**
     * Number of seconds to sleep between batches. Defaults to 0 seconds, minimum
     * 0.
     */
    apply_filters( "{$this->prefix}_seconds_between_batches", 0 );
  • classes/Helpers/class-logger.php line 50
    /**
     * Enables / Disables the logging for the plugin.
     */
    apply_filters( "{WSAL_PREFIX}logging_enabled", true );
  • classes/MainWPAddon/class-mainwp-addon.php line 483
    /**
     * `mwpal_extension_tabs`
     */
    apply_filters( 'mwpal_extension_tabs', $mwpal_extension_tabs, $extension_url );
  • classes/WPSensors/class-wp-metadata-sensor.php line 123
    /**
     * WSAL Filter: `wsal_before_post_meta_create_event`
     */
    apply_filters( 'wsal_before_post_meta_create_event', true, $meta_key, $meta_value, $post );
  • classes/WPSensors/class-wp-metadata-sensor.php line 327
    /**
     * WSAL Filter: `wsal_before_post_meta_delete_event`
     */
    apply_filters( 'wsal_before_post_meta_delete_event', true, $meta_key, $meta_value, $post, $meta_id );
  • classes/WPSensors/class-wp-metadata-sensor.php line 221
    /**
     * WSAL Filter: `wsal_before_post_meta_update_event`
     */
    apply_filters( 'wsal_before_post_meta_update_event', true, $meta_key, $meta_value, self::$old_meta[ $meta_id ], $post, $meta_id );
  • classes/Controllers/class-connection.php line 284
    /**
     * Filters the timeout used when validating a MySQL connection.
     */
    apply_filters( 'wsal_connection_test_timeout', $connect_timeout );
  • classes/Controllers/class-cron-jobs.php line 608
    /**
     * Gives an option to add hooks which must be enabled.
     */
    apply_filters( 'wsal_cron_hooks', $hooks_array );
  • classes/Helpers/class-settings-helper.php line 1095
    /**
     * Filters the list of alerts disabled by default.
     */
    apply_filters( 'wsal_default_disabled_alerts', $alerts );
  • classes/notification/class-notification-logger.php line 69
    /**
     * Since latest
     */
    apply_filters( 'wsal_enable_notifications', $proceed );
  • classes/Controllers/class-alert-manager.php line 930
    /**
     * WSAL Filter: `wsal_event_data_before_log`.
     */
    apply_filters( 'wsal_event_data_before_log', $event_data, $event_id );
  • classes/Controllers/class-alert-manager.php line 918
    /**
     * WSAL Filter: `wsal_event_id_before_log`.
     */
    apply_filters( 'wsal_event_id_before_log', $event_id, $event_data );
  • classes/Controllers/class-alert-manager.php line 749
    /**
     * WSAL Filter: `wsal_event_metadata_definition`.
     */
    apply_filters( 'wsal_event_metadata_definition', $metadata, $code );
  • classes/Helpers/class-email-helper.php line 81
    /**
     * Get the email address to deliver the deactivation email to.
     */
    apply_filters( 'wsal_filter_deactivation_email_delivery_address', get_bloginfo( 'admin_email' ) );
  • classes/class-wp-security-audit-log.php line 607
    /**
     * Allow short-circuiting of the deactivation email sending by using this
     * filter to return true here instead of default false.
     */
    apply_filters( 'wsal_filter_prevent_deactivation_email_delivery', false );
  • classes/Views/Help.php line 113
    /**
     * Filter: `wsal_help_tabs`
     */
    apply_filters( 'wsal_help_tabs', $wsal_help_tabs );
  • wsal_init

    action
    classes/class-wp-security-audit-log.php line 574
    /**
     * Action: `wsal_init`
     */
    do_action( 'wsal_init', $wsal_class );
  • classes/Controllers/class-sensors-load-manager.php line 175
    /**
     * WSAL Filter: `wsal_load_frontend_sensors`
     */
    apply_filters( 'wsal_load_frontend_sensors', $sensors );
  • classes/Controllers/class-sensors-load-manager.php line 145
    /**
     * WSAL Filter: `wsal_load_login_sensors`
     */
    apply_filters( 'wsal_load_login_sensors', $sensors );
  • classes/WPSensors/class-wp-metadata-sensor.php line 679
    /**
     * List of hidden keys allowed to log.
     */
    apply_filters( 'wsal_log_hidden_meta_keys', array() );
  • classes/Loggers/class-database-logger.php line 87
    /**
     * Fires immediately after an alert is logged.
     */
    do_action( 'wsal_logged_alert', null, $type, $data, $date, $site_id );
  • classes/Helpers/formatters/class-alert-formatter.php line 276
    /**
     * Allows meta formatting via filter if no match was found.
     */
    apply_filters_deprecated( 'wsal_meta_formatter_custom_formatter', array( $value, $expression, ), 'WSAL 4.3.0', 'wsal_format_custom_meta' );
  • classes/WPSensors/class-wp-metadata-sensor.php line 203
    /**
     * WSAL Action Hook.
     */
    do_action( 'wsal_post_meta_updated', $meta_id, $object_id, (object) self::$old_meta, $meta_key, $meta_value );
  • classes/Views/Settings.php line 177
    /**
     * Filter: `wsal_setting_tabs`
     */
    apply_filters( 'wsal_setting_tabs', $wsal_setting_tabs );
  • classes/Helpers/class-view-manager.php line 84
    /**
     * Skipped Views.
     */
    apply_filters( 'wsal_skip_views', $skip_views );
  • classes/Views/class-setup-wizard.php line 252
    /**
     * Filter: `Wizard Default Steps`
     */
    apply_filters( 'wsal_wizard_default_steps', $wizard_steps );
  • classes/AbstractLogger.php line 68 · used in 2 places
    apply_filters( 'wsal_database_timestamp_value', $timestamp, $metadata );
  • classes/Controllers/class-alert-manager.php line 245 · used in 2 places
    apply_filters( 'wsal_disable_user_switching_plugin_tracking', false );
  • classes/Controllers/class-alert-manager.php line 1635 · used in 2 places
    apply_filters( 'wsal_save_settings_disabled_events', $disabled, self::get_alerts(), array(), $enabled );
  • classes/Helpers/settings/class-settings-builder.php line 1564 · used in 2 places
    do_action( 'wsal_settings_save_button' );
  • classes/Controllers/class-alert-manager.php line 1691 · used in 2 places
    apply_filters( 'wsal_togglealerts_obsolete_events', $obsolete_events );
  • third-party/scoped/classes/wp-background-process.php line 201
    do_action( "{$this->identifier}_cancelled" );
  • third-party/scoped/classes/wp-background-process.php line 568
    do_action( "{$this->identifier}_completed" );
  • third-party/scoped/classes/wp-background-process.php line 542
    apply_filters( "{$this->identifier}_default_time_limit", 20 );
  • third-party/scoped/classes/wp-background-process.php line 511
    apply_filters( "{$this->identifier}_memory_exceeded", $return );
  • third-party/scoped/classes/wp-background-process.php line 225
    do_action( "{$this->identifier}_paused" );
  • third-party/scoped/classes/wp-background-process.php line 370
    apply_filters( "{$this->identifier}_queue_lock_time", $lock_duration );
  • third-party/scoped/classes/wp-background-process.php line 242
    do_action( "{$this->identifier}_resumed" );
  • third-party/scoped/classes/wp-background-process.php line 548
    apply_filters( "{$this->identifier}_time_exceeded", $return );
  • classes/Views/class-setup-wizard.php line 348
    do_action( 'admin_print_styles' );
  • third-party/scoped/classes/wp-async-request.php line 135
    apply_filters( 'https_local_ssl_verify', \false );
  • classes/MainWPAddon/class-mainwp-addon.php line 177
    apply_filters( 'mainwp_activated_check', false );
  • classes/MainWPAddon/class-mainwp-addon.php line 218
    apply_filters( 'mainwp_extension_enabled_check', WSAL_BASE_FILE_NAME );
  • classes/MainWPAddon/class-mainwp-addon.php line 554
    apply_filters( 'mainwp_fetchurlauthed', WSAL_BASE_FILE_NAME, self::get_child_key(), $site_id, 'extra_excution', $post_data );
  • classes/MainWPAddon/class-mainwp-settings.php line 45
    apply_filters( 'mainwp_getsites', WSAL_BASE_FILE_NAME, MainWP_Addon::get_child_key(), null );
  • classes/MainWPAddon/class-mainwp-addon.php line 281
    do_action( 'mainwp_pageheader_extensions', __FILE__ );
  • classes/MainWPAddon/class-mainwp-addon.php line 384
    apply_filters( 'mwpal_main_menu_submenu', array( array( __( 'Plugin Settings', 'wp-security-audit-log' ), $extension_url, 'manage_options', ), ) );
  • classes/MainWPAddon/class-mainwp-addon.php line 425
    apply_filters( 'mwpal_page_navigation', array( array( 'title' => __( 'Extension Settings', 'wp-security-audit-log' ), 'href' => self::$mwpal_extension_tabs['settings']['link'], 'active' => 'settings' === self::$current_tab, ), ) );
  • classes/ListAdminEvents/class-list-events.php line 328
    apply_filters( 'wsal_add_site_filter', false );
  • classes/Helpers/settings/class-settings-builder.php line 1653
    do_action( 'wsal_admin_after_head_title', self::$settings['id'] );
  • classes/Helpers/formatters/class-formatter-factory.php line 50
    apply_filters( 'wsal_alert_formatters', array( 'default' => Alert_Formatter_Configuration::get_default_html_configuration(), 'dashboard-widget' => Alert_Formatter_Configuration::set_configuration( array( 'js_in_links_allowed' => false, 'supports_metadata' => false, 'supports_hyperlinks' => false, ) ), ) );
  • classes/Controllers/class-alert-manager.php line 1214
    apply_filters( 'wsal_alter_site_id', $site_id );
  • classes/notification/class-notification-template.php line 1717
    apply_filters( 'wsal_append_dailynotification_email_content', $body, $events );
  • classes/ListAdminEvents/class-list-events.php line 712
    apply_filters( 'wsal_auditlog_row_user_data', $row_user_data, $item['id'] );
  • wsal_cleanup

    action
    classes/Controllers/class-cron-jobs.php line 249
    do_action( 'wsal_cleanup', array() );
  • classes/Controllers/class-cron-jobs.php line 238
    do_action( 'wsal_clear_reports', array() );
  • defaults.php line 36
    do_action( 'wsal_custom_alerts_register', array() );
  • classes/Loggers/class-database-logger.php line 69
    apply_filters( 'wsal_database_site_id_value', $site_id, $type, $data );
  • classes/Controllers/class-alert-manager.php line 1016
    apply_filters( 'wsal_deprecated_event_ids', array( 0000, 0001, 0002, 0003, 0004, 0005, 2004, 2005, 2006, 2007, 2009, 2013, 2015, 2018, 2020, 2022, 2026, 2028, 2059, 2060, 2061, 2064, 2066, 2069, 2075, 2087, 2102, 2103, 2113, 2114, 2115, 2116, 2117, 2118, 5020, 5026, 2107, 2003, 2029, 2030, 2031, 2032, 2033, 2034, 2035, 2036, 2037, 2038, 2039, 2040, 2041, 2056, 2057, 2058, 2063, 2067, 2068, 2070, 2072, 2076, 2088, 2104, 2105, 5021, 5027, ... );
  • classes/Controllers/class-alert-manager.php line 1431
    apply_filters( 'wsal_event_objects', self::$objects_data );
  • classes/Controllers/class-alert-manager.php line 1372
    apply_filters( 'wsal_event_type_data', self::$event_types );
  • classes/Helpers/formatters/class-alert-formatter.php line 301
    apply_filters( 'wsal_format_custom_meta', $result, $expression, $configuration, $occurrence_id );
  • classes/Controllers/class-cron-jobs.php line 155
    do_action( 'wsal_generate_reports', array() );
  • classes/Controllers/class-cron-jobs.php line 166
    do_action( 'wsal_generate_reports_daily', array() );
  • classes/Controllers/class-cron-jobs.php line 191
    do_action( 'wsal_generate_reports_monthly', array() );
  • classes/Controllers/class-cron-jobs.php line 205
    do_action( 'wsal_generate_reports_quarterly', array() );
  • classes/Controllers/class-cron-jobs.php line 177
    do_action( 'wsal_generate_reports_weekly', array() );
  • classes/ListAdminEvents/class-list-events.php line 788
    apply_filters( 'wsal_get_site_details', $info, $item['site_id'], $item );
  • classes/ListAdminEvents/class-list-events.php line 698
    apply_filters( 'wsal_get_user_html', $uhtml, $item );
  • classes/ListAdminEvents/class-list-events.php line 697
    apply_filters( 'wsal_get_user_image', $image, $item );
  • classes/Controllers/class-alert-manager.php line 382
    apply_filters( 'wsal_ignored_custom_post_types', array_unique( array_merge( Settings_Helper::get_excluded_post_types(), self::IGNORED_POST_TYPES ) ) );
  • classes/Views/AuditLog.php line 462
    do_action( 'wsal_inspector_after_meta', $inspected_alert_id );
  • classes/ListAdminEvents/class-list-events.php line 1215
    do_action( 'wsal_list_view_top_navigation' );
  • classes/class-wp-security-audit-log.php line 381
    apply_filters( 'wsal_load_on_frontend', $should_load, $frontend_events );
  • classes/Helpers/class-wp-helper.php line 806
    apply_filters( 'wsal_login_screen_url', $login );
  • classes/Views/AuditLog.php line 191
    apply_filters( 'wsal_main_view_site_id', $view_site_id );
  • classes/Actions/class-plugin-installer.php line 81
    apply_filters( 'wsal_modify_predefined_plugin_slug', $addon );
  • classes/Helpers/class-wp-helper.php line 266
    apply_filters( 'wsal_override_is_multisite', self::$is_multisite );
  • classes/Views/AuditLog.php line 790
    apply_filters( "wsal_pointers_{$screen_id}", array() );
  • wsal_prune

    action
    classes/Entities/class-occurrences-entity.php line 811
    do_action( 'wsal_prune', $count, implode( '; ', $queries ) );
  • classes/Helpers/class-settings-helper.php line 1436
    apply_filters( 'wsal_request_logging_enabled', false );
  • classes/Controllers/class-sensors-load-manager.php line 110
    do_action( 'wsal_sensors_manager_add' );
  • classes/Views/ToggleAlerts.php line 431
    do_action( 'wsal_togglealerts_append_content_to_toggle', $alert['code'] );
  • classes/Views/ToggleAlerts.php line 131
    do_action( 'wsal_togglealerts_process_save_settings', $post_array );
  • classes/Views/ToggleAlerts.php line 200
    apply_filters( 'wsal_togglealerts_sub_category_events', $subcat_alerts );
  • classes/Helpers/formatters/class-alert-formatter.php line 56
    apply_filters( 'wsal_truncate_alert_value', $value, $expression, $configuration['max_meta_value_length'], $configuration['ellipses_sequence'] );
  • wsal_user_can

    filter
    classes/Helpers/class-settings-helper.php line 1906
    apply_filters( 'wsal_user_can', $result, $user, $action );

Generated from WP Activity Log'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: