W3cubDocs

/WordPress

wp_ajax_dismiss_wp_pointer()

Ajax handler for dismissing a WordPress pointer.

Source

File: wp-admin/includes/ajax-actions.php 

function wp_ajax_dismiss_wp_pointer() {
	$pointer = $_POST['pointer'];

	if ( sanitize_key( $pointer ) != $pointer ) {
		wp_die( 0 );
	}

	//  check_ajax_referer( 'dismiss-pointer_' . $pointer );

	$dismissed = array_filter( explode( ',', (string) get_user_meta( get_current_user_id(), 'dismissed_wp_pointers', true ) ) );

	if ( in_array( $pointer, $dismissed, true ) ) {
		wp_die( 0 );
	}

	$dismissed[] = $pointer;
	$dismissed   = implode( ',', $dismissed );

	update_user_meta( get_current_user_id(), 'dismissed_wp_pointers', $dismissed );
	wp_die( 1 );
}

Uses

Uses Description
wp-includes/formatting.php: sanitize_key()

Sanitizes a string key.
wp-includes/functions.php: wp_die()

Kills WordPress execution and displays HTML page with an error message.
wp-includes/user.php: get_user_meta()

Retrieve user meta field for a user.
wp-includes/user.php: update_user_meta()

Update user meta field based on user ID.
wp-includes/user.php: get_current_user_id()

Get the current user’s ID

Changelog

Version Description
3.1.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_ajax_dismiss_wp_pointer