diff -r c7c34916027a -r 177826044cd9 wp/wp-includes/class-wp-user-meta-session-tokens.php --- a/wp/wp-includes/class-wp-user-meta-session-tokens.php Mon Oct 14 18:06:33 2019 +0200 +++ b/wp/wp-includes/class-wp-user-meta-session-tokens.php Mon Oct 14 18:28:13 2019 +0200 @@ -11,15 +11,17 @@ * Meta-based user sessions token manager. * * @since 4.0.0 + * + * @see WP_Session_Tokens */ class WP_User_Meta_Session_Tokens extends WP_Session_Tokens { /** - * Get all sessions of a user. + * Retrieves all sessions of the user. * * @since 4.0.0 * - * @return array Sessions of a user. + * @return array Sessions of the user. */ protected function get_sessions() { $sessions = get_user_meta( $this->user_id, 'session_tokens', true ); @@ -47,11 +49,11 @@ } /** - * Retrieve a session by its verifier (token hash). + * Retrieves a session based on its verifier (token hash). * * @since 4.0.0 * - * @param string $verifier Verifier of the session to retrieve. + * @param string $verifier Verifier for the session to retrieve. * @return array|null The session, or null if it does not exist */ protected function get_session( $verifier ) { @@ -65,11 +67,11 @@ } /** - * Update a session by its verifier. + * Updates a session based on its verifier (token hash). * * @since 4.0.0 * - * @param string $verifier Verifier of the session to update. + * @param string $verifier Verifier for the session to update. * @param array $session Optional. Session. Omitting this argument destroys the session. */ protected function update_session( $verifier, $session = null ) { @@ -85,7 +87,7 @@ } /** - * Update a user's sessions in the usermeta table. + * Updates the user's sessions in the usermeta table. * * @since 4.0.0 * @@ -100,7 +102,7 @@ } /** - * Destroy all session tokens for a user, except a single session passed. + * Destroys all sessions for this user, except the single session with the given verifier. * * @since 4.0.0 * @@ -112,7 +114,7 @@ } /** - * Destroy all session tokens for a user. + * Destroys all session tokens for the user. * * @since 4.0.0 */ @@ -121,10 +123,9 @@ } /** - * Destroy all session tokens for all users. + * Destroys all sessions for all users. * * @since 4.0.0 - * @static */ public static function drop_sessions() { delete_metadata( 'user', 0, 'session_tokens', false, true );