wp_check_post_lock( int|WP_Post $post_id ): int|false
Determines whether the post is currently being edited by another user.
Parameters
-
$post_idint|WP_Post Required -
ID or object of the post to check for editing.
Return
int|false ID of the user with lock. False if the post does not exist, post is not locked, the user with lock does not exist, or the post is locked by current user.
Source
File: wp-admin/includes/post.php.
View all references
function wp_check_post_lock( $post_id ) {
$post = get_post( $post_id );
if ( ! $post ) {
return false;
}
$lock = get_post_meta( $post->ID, '_edit_lock', true );
if ( ! $lock ) {
return false;
}
$lock = explode( ':', $lock );
$time = $lock[0];
$user = isset( $lock[1] ) ? $lock[1] : get_post_meta( $post->ID, '_edit_last', true );
if ( ! get_userdata( $user ) ) {
return false;
}
/** This filter is documented in wp-admin/includes/ajax-actions.php */
$time_window = apply_filters( 'wp_check_post_lock_window', 150 );
if ( $time && $time > time() - $time_window && get_current_user_id() != $user ) {
return $user;
}
return false;
}
Hooks
-
apply_filters( 'wp_check_post_lock_window',
int $interval ) -
Filters the post lock window duration.
Changelog
| Version | Description |
|---|---|
| 2.5.0 | Introduced. |