On this page
WP_Customize_Manager::set_changeset_lock( int $changeset_post_id, bool $take_over = false )
Marks the changeset post as being currently edited by the current user.
Parameters
$changeset_post_idint Required-
Changeset post ID.
$take_overbool Optional-
Whether to take over the changeset.
Default:
false
Source
File: wp-includes/class-wp-customize-manager.php. View all references
public function set_changeset_lock( $changeset_post_id, $take_over = false ) {
if ( $changeset_post_id ) {
$can_override = ! (bool) get_post_meta( $changeset_post_id, '_edit_lock', true );
if ( $take_over ) {
$can_override = true;
}
if ( $can_override ) {
$lock = sprintf( '%s:%s', time(), get_current_user_id() );
update_post_meta( $changeset_post_id, '_edit_lock', $lock );
} else {
$this->refresh_changeset_lock( $changeset_post_id );
}
}
}
Related
Uses
| Uses | Description |
|---|---|
| WP_Customize_Manager::refresh_changeset_lock() wp-includes/class-wp-customize-manager.php | Refreshes changeset lock with the current time if current user edited the changeset before. |
| update_post_meta() wp-includes/post.php | Updates a post meta field based on the given post ID. |
| get_current_user_id() wp-includes/user.php | Gets the current user’s ID. |
| get_post_meta() wp-includes/post.php | Retrieves a post meta field for the given post ID. |
Used By
| Used By | Description |
|---|---|
| WP_Customize_Manager::handle_override_changeset_lock_request() wp-includes/class-wp-customize-manager.php | Removes changeset lock when take over request is sent via Ajax. |
| WP_Customize_Manager::establish_loaded_changeset() wp-includes/class-wp-customize-manager.php | Establishes the loaded changeset. |
| WP_Customize_Manager::save() wp-includes/class-wp-customize-manager.php | Handles customize_save WP Ajax request to save/update a changeset. |
Changelog
| Version | Description |
|---|---|
| 4.9.0 | Introduced. |
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_customize_manager/set_changeset_lock