List of hooks in the WP Activity Log plugin

Updated14 December, 2023

Hooks in the WP Activity Log plugin allow you to hook into the plugin’s functionality to modify its behaviour. This article contains a list of hooks and parameters found in the WP Activity Log plugin.

Note: WP Activity Log also has a list of hooks for custom activity logs extensions.

Index of Hooks:

Activity log data hooks

wsal_auditlog_row_user_data

Function

This filter hook runs before displaying the user data of an event on the activity log view. It can be used to filter the user data of each event being displayed on the activity log view.

Parameters

$row_user_data – User data to display in the activity log row
$event_db_id – Event database ID

Example Code

/**
/**
* Method: This function filters user data before displaying on the activity log view.
*
* @param string $row_user_data - User data to display in the activity log row.
* @param integer $event_db_id - Event database id.
* @return string
*/
function sample_auditlog_row_user_data( $row_user_data, $event_db_id ) {
// Do something here...
return $row_user_data;
}
add_filter( 'wsal_auditlog_row_user_data', 'sample_auditlog_row_user_data' );

Function

This hook allows you to display additional user information in a user’s Log Viewer pop-up. Database calls are done by referencing the user ID. The example code below shows the Facebook URL of the user as available in the wp_usernmeta table

Parameters

$value – the data you want to display
$user-> ID – dynamically allocated user ID depending on hover point

Example Code

/**
add_filter( 'wsal_additional_user_tooltip_content', 'my_additonal_content', 10, 1 );
function my_additonal_content( $user ) {
// $user ID is user's unique ID.
$value = get_user_meta( $user-&amp;amp;amp;gt;ID, 'facebook', true );
return $value;
}

wsal_event_data_before_log

Function

This filter hook runs before saving an event in the activity log database. It can be used to filter the event data of a filter and take action accordingly.

Parameters

$event_id – Event ID
$event_data – Array of event data

Example Code

/**
/**
 * Method: This function filters event data before saving the event to the database.
 *
 * @param array   $event_data - Event data.
 * @param integer $event_id   - Event id.
 * @return integer
 */
function sample_event_data_before_log( $event_data, $event_id ) {
	// Do something here...
	return $event_data;
}
add_filter( 'wsal_event_data_before_log', 'sample_event_data_before_log' );

wsal_event_id_before_log

Function

This filter hook runs before saving an event in the activity log database. It can be used to detect event ids and take the required action.

Parameters

$event_id – Event ID
$event_data – Array of event data

Example Code

/**
/**
 * Method: This function filters event data before saving the event to the database.
 *
 * @param array   $event_data - Event data.
 * @param integer $event_id   - Event id.
 * @return integer
 */
function sample_event_data_before_log( $event_data, $event_id ) {
	// Do something here...
	return $event_data;
}
add_filter( 'wsal_event_data_before_log', 'sample_event_data_before_log' );

wsal_event_metadata_definition

Function

This filter hook runs before displaying the user data of an event in the activity log viewer. It can be used to report the names and values of custom fields and other custom data from any type of post type and user profiles as metadata in event IDs.

Parameters

$metadata – Event data
$code – Event ID

Example Code

/**
 * Adds post ranking metadata item for event 2086.
 *
 * @param array $metadata Event data.
 * @param integer $code Event ID.
 */
function wpws_emdt_change_metadata_definition( $metadata, $code ) {
	if ( 2086 === $code ) {
	    $metadata[ __( 'Post ranking', 'wpws_emdt' ) ] = '%RankingScore%';
        }
return $metadata;
}
add_filter( 'wsal_event_metadata_definition', 'wpws_emdt_change_metadata_definition', 10, 2

wsal_post_meta_updated

Function

This hook runs before the logging of post meta update events, such as event ID 2062 and 2054 (refer to the complete list of WordPress activity log event IDs for more details). This hook can be used to log events of updated post meta from the front-end, since the plugin only keeps a log of post meta updates done via the WordPress admin pages.

Parameters

$meta_id – Unique ID of the meta data.
$object_id – Post ID to which the meta data belongs to.
$old_meta – Array of the meta data containing key & values of old meta data before it is updated.
$meta_key – Key of the meta data being updated.
$meta_value – Value of the meta data being updated.

Example Code

A general example code which shows how to log a meta data updated event in the WP Activity Log plugin.

/**
 * Method: Sample code for logging meta data changes event.
 *
 * @param int    $meta_id    - Meta ID.
 * @param int    $object_id  - Post ID.
 * @param array  $old_meta   - Array of metadata holding keys &amp;amp;amp;amp;amp;amp;amp;amp;amp; values of old meta data before updating the current post.
 * @param string $meta_key   - Meta key.
 * @param mixed  $meta_value - Meta value.
 */
function my_post_meta_updated( $meta_id, $object_id, $old_meta, $meta_key, $meta_value ) {
	// Verify your meta key.
	if ( 'my-key' !== $meta_key ) {
		return;
	}

	// Get post object.
	$post = get_post( $object_id );

	// Get post editor link.
	$post_editor_link = get_edit_post_link( $post-&amp;amp;amp;amp;amp;amp;gt;ID );

	// Check if the meta key value has changed.
	if ( isset( $old_meta[ $meta_id ] ) &amp;amp;amp;amp;amp;amp;amp; $old_meta[ $meta_id ]-&amp;amp;amp;amp;amp;amp;gt; val !== $meta_value ) {
		// Get instance of WSAL.
		$wsal = WpSecurityAuditLog::GetInstance();

		// Log the event.
		$wsal-&amp;amp;amp;gt;alerts-&amp;amp;amp;gt;Trigger(
			2054, array(
				'PostID'         =&amp;amp;amp;gt; $object_id,
				'PostTitle'      =&amp;amp;amp;gt; $post-&amp;amp;amp;gt;post_title,
				'PostStatus'     =&amp;amp;amp;gt; $post-&amp;amp;amp;gt;post_status,
				'PostType'       =&amp;amp;amp;gt; $post-&amp;amp;amp;gt;post_type,
				'PostDate'       =&amp;amp;amp;gt; $post-&amp;amp;amp;gt;post_date,
				'PostUrl'        =&amp;amp;amp;gt; $get_permalink( $post-&amp;amp;amp;gt;ID ),
				'MetaID'         =&amp;amp;amp;gt; $meta_id,
				'MetaKey'        =&amp;amp;amp;gt; $meta_key,
				'MetaValueNew'   =&amp;amp;amp;gt; $meta_value,
				'MetaValueOld'   =&amp;amp;amp;gt; $old_meta[ $meta_id ]-&amp;amp;amp;gt;val,
				'MetaLink'       =&amp;amp;amp;gt; $meta_key,
				'EditorLinkPost' =&amp;amp;amp;gt; $post_editor_link,
				'ReportText'     =&amp;amp;amp;gt; $old_meta[ $meta_id ]-&amp;amp;amp;gt; . '|' . $meta_value,
			)
		);
	}
}
add_action( 'wsal_post_meta_updated', 'my_post_meta_updated', 10, 5 );

wsal_event_data_before_mirror

Function

This filter hook allows you to exclude metadata from being propagated to a configured mirror when mirroring logs to an external service. It’s important to note that both message and severity level remain mandatory and cannot be excluded.

Parameters

$connection_type – The mirror connection to which metadata will be excluded
$processed_metadata – The metadata that will not be mirrored

List of available connection types

AWS Cloud Watch – aws_cloudwatch
Local log file – log_file
Loggly – loggy
Papertrail – papertrail
Slack – slack
Syslog – syslog

List of available WP Activity Log metadata

Example Code

/**
/**
 * Method: This function removes the IP address and user agent metadata before mirroring logs to Slack.
 *
 * @param array $processed_metadata
 * @param integer $connection_type
 * @return array
 */
add_filter( 'wsal_event_data_before_mirror', function ( $processed_metadata, $connection_type 

	if ( 'slack' === $connection_type ) {
        unset( $processed_metadata['ClientIP'] );
        unset( $processed_metadata['UserAgent'] );
   }
   return $processed_metadata;
}, 10, 2 );

Plugin settings hooks

wsal_filter_deactivation_email_delivery

Function

By default the plugin sends an email to the website administrator (configured in the WordPress settings) when the plugin is disabled. You can disable this functionality by using this filter.

Example Code

/**
* Disable the email delivery on activation completely by sending.
*
* This will completely disable the deactivation email system if it returns true.
*
* @var bool
*/
add_filter( 'wsal_filter_prevent_deactivation_email_delivery', '__return_true' );

wsal_filter_deactivation_email_delivery_address

Function

By default the plugin sends an email to the website administrator (configured in the WordPress settings) when the plugin is disabled. You can change the email address to which the notification is sent by using the below filter.

Example Code

/**
* Change the email address that the wsal deactivation email sends to.
*
* Returning a string that is not an email address will effectively
* short-circuit the mail sending and no email will go out.
*
* @var string
*/
add_filter( 'wsal_filter_deactivation_email_delivery_address', function( $address ) {
		return 'newaddress@example.com';	} );

wsal_log_hidden_meta_keys

Function

By default hidden meta keys (custom fields) are ignored by the WP Activity Log plugin. The names of these meta keys start with an underscore and are typically used to store posts’ settings. This filter hook allow users to specify an array of hidden meta keys for which the plugin should keep a log of when they or the values they store change.

Parameter

$meta_keys — Array of hidden post meta keys.

Example Code

/**
 * Add a list of hidden meta keys to be logged by WSAL.
 *
 * @param array $meta_keys - Array of hidden post meta keys.
 * @return array
 */
function wsal_add_hidden_meta_keys( $meta_keys ) {
    $meta_keys[] = '_edit_lock';
    return $meta_keys;
}
add_filter( 'wsal_log_hidden_meta_keys', 'wsal_add_hidden_meta_keys', 10, 1 );

wsal_infinite_scroll_events

Function

This hook can be used to change the number of events that are shown by default in the activity log viewer when using the infinite scroll view mode.

Parameter

return – specify the number of events

Example Code

function wsal_increase_infinite_scroll_events() {
    return 50;
}
add_filter( 'wsal_infinite_scroll_events', 'wsal_increase_infinite_scroll_events' );

Login prompt plugin hooks

wsal_override_session_block_message

Function

This hook filters the message displayed to users when they try to login and their session is blocked because multiple sessions are not allowed.

Parameter

$message — Override session block message.

Example Code

/**
 * Filter override session block message.
 *
 * @param string $message - Override session block message.
 * @return string
 */
function wsal_filter_override_session_message( $message ) {
	$message = __( 'This is override session block message.', 'text-domain' );
	return $message;
}
add_filter( 'wsal_override_session_block_message', 'wsal_filter_override_session_message', 10, 1 );

wsal_override_session_password_field

Function

This hook filters the override session password field displayed to users when their session is blocked and are asked to enter the override password.

Parameter

$password_field — Override password field.

Example Code

/**
* Session override password field.
*
* @param string $password_field - Override password field.
* @return string
*/
function wsal_filter_override_session_password_field( $password_field ) {
$password_field = '&amp;amp;amp;amp;amp;lt;&amp;amp;amp;amp;amp;gt; &amp;amp;amp;amp;amp;amp; &amp;amp;amp;amp;amp;lt;&amp;amp;amp;amp;amp;gt;input type="password"&amp;amp;amp;amp;amp;amp; &amp;amp;amp;amp;amp;lt;/p&amp;amp;amp;amp;amp;gt;';
return $password_field;
}
add_filter( 'wsal_override_session_password_field', 'wsal_filter_override_session_password_field', 10, 1 );

wsal_override_session_password_field_tags

Function

This hook filters the override session password field tags so that they can be displayed using wp_kses function.

Parameter

$allowed_html_tags — Override password field HTML tags.

Example Code

/**
 * Session override password field HTML tags.
 *
 * @param array $allowed_html_tags - Override password field HTML tags.
 * @return array
 */
function wsal_filter_override_session_password_tags( $allowed_html_tags ) {
	$allowed_html_tags = array(
		'p'     =&amp;amp;amp;gt; array(),
		'input' =&amp;amp;amp;gt; array(
			'type' =&amp;amp;amp;gt; array(),
		),
	);
	return $allowed_html_tags;
}
add_filter( 'wsal_override_session_password_field_tags', 'wsal_filter_override_session_password_tags', 10, 1 );

Third party plugins hooks

wsal_disable_user_switching_plugin_tracking

Function

This hook disables the integration and support with the User Switching plugin. Once the integration is disabled, the plugin reports the actual user doing the change and not the switched to user.

/**
 * Register the filtered return to detective login/out tracking on the plugin:
 * `User Switching`.
 *
 * This needs to be hooked in early before the plugin does it's own init. Use
 * `init` hook but add it on priority lower than 5.
 */
add_action( 'init', function() {

        /**
         * Disable the tracking of the `User Switching` plugin.
         *
         * @link: https://wordpress.org/plugins/user-switching/`
         *
         * @var bool
         */
        add_filter( 'wsal_disable_user_switching_plugin_tracking', '__return_true' );

}, 4 );