- updated hookdocs;

- reviewed `um_safe_redirect()`;
- updated readme.txt

includes/core/class-logout.php

@@ -79,29 +79,25 @@ if ( ! class_exists( 'um\core\Logout' ) ) {
 						wp_destroy_current_session();
 						wp_logout();
 						session_unset();
-						exit( wp_safe_redirect( home_url() ) );
+						wp_safe_redirect( home_url() );
+						exit;
 					} else {
 						/**
-						 * UM hook
+						 * Filters URL for redirect after logout.
 						 *
-						 * @type filter
-						 * @title um_logout_redirect_url
-						 * @description Change redirect URL after logout
-						 * @input_vars
-						 * [{"var":"$url","type":"string","desc":"Redirect URL"},
-						 * {"var":"$id","type":"int","desc":"User ID"}]
-						 * @change_log
-						 * ["Since: 2.0"]
-						 * @usage
-						 * <?php add_filter( 'um_logout_redirect_url', 'function_name', 10, 2 ); ?>
-						 * @example
-						 * <?php
-						 * add_filter( 'um_logout_redirect_url', 'my_logout_redirect_url', 10, 2 );
-						 * function my_logout_redirect_url( $url, $id ) {
-						 *     // your code here
-						 *     return $url;
+						 * @param {string} $logout_redirect_url URL for redirect after logout.
+						 * @param {int}    $user_id             User ID who logged out.
+						 *
+						 * @return {string} Redirect URL.
+						 *
+						 * @since 2.0
+						 * @hook um_logout_redirect_url
+						 *
+						 * @example <caption>Change URL for redirect after logout.</caption>
+						 * function my_logout_redirect_url( $logout_redirect_url, $user_id ) {
+						 *     return '{your_custom_url}';
 						 * }
-						 * ?>
+						 * add_filter( 'um_logout_redirect_url', 'my_logout_redirect_url', 10, 2 );
 						 */
 						$redirect_url = apply_filters( 'um_logout_redirect_url', um_user( 'logout_redirect_url' ), um_user( 'ID' ) );
 						wp_destroy_current_session();
@@ -111,7 +107,8 @@ if ( ! class_exists( 'um\core\Logout' ) ) {
 					}
 				} else {
 					add_filter( 'wp_safe_redirect_fallback', array( &$this, 'safe_redirect_default' ), 10, 2 );
-					exit( wp_safe_redirect( home_url() ) );
+					wp_safe_redirect( home_url() );
+					exit;
 				}
 			}