apply_filters( 'auth_cookie_expiration', int $length , int $user_id , bool $remember )
Filters the duration of the authentication cookie expiration period.
Parameters
- $length
-
(int) Duration of the expiration period in seconds.
- $user_id
-
(int) User ID.
- $remember
-
(bool) Whether to remember the user login. Default false.
Source
Changelog
| Version | Description |
|---|---|
| 2.8.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
An example of how to extend time in your WordPress session by a year, simply enter this code into your `functions.php` or plugin. Other durations have been added to show different times hat can be set.
add_filter ( 'auth_cookie_expiration', 'wpdev_login_session' ); function wpdev_login_session( $expire ) { // Set login session limit in seconds return YEAR_IN_SECONDS; // return MONTH_IN_SECONDS; // return DAY_IN_SECONDS; // return HOUR_IN_SECONDS; }Top ↑
Feedback
It’s best to consider the $remember parameter and assign a shorter expiry when $remember is false (or leave it default). WP uses the difference between cookie expiry with and without “Remember me” as a heuristic flag in
wp_update_user(). After a password change, it guesses the user wants “Remember me” if the current cookie time left is longer than what this filter returns with $remember = false. Comment based on WP 5.0.2. — By kitchin —Extension of the example, only extending expiration if $remember and low privelege.
add_filter('auth_cookie_expiration', 'auth_cookie_expiration_filter_5587', 10, 3); function auth_cookie_expiration_filter_5587($expiration, $user_id, $remember) { if ($remember && !user_can($user_id, 'edit_others_posts')) { return YEAR_IN_SECONDS; // return MONTH_IN_SECONDS; // return DAY_IN_SECONDS; // return HOUR_IN_SECONDS; } // default return $expiration; }function wp_homework_change_cookie_logout( $expiration){ $user = wp_get_current_user(); $allowed_roles = array('administrator', 'scholar'); if( array_intersect($allowed_roles, $user->roles ) ) { $expiration = 31557600; } return $expiration; } add_filter( 'auth_cookie_expiration','wpse108399_change_cookie_logout', 10, 3 );// forever add_filter('auth_cookie_expiration', function (int $length): int { return PHP_INT_MAX; });