WP hooks navigation: Home/browse • Actions index • Filters index
To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).
The best way to understand what a hook does is to look at where it occurs in the source code.
do_action( "hook_name" )apply_filters( "hook_name", "what_to_filter" ).Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.
This hook occurs 3 times in this file.
| Line | Code | 
|---|---|
| 862 |  * | 
| 863 |  * @param int|WP_Post|null $post An optional post. Global $post used if not provided. | 
| 864 |  * @return bool false if a password is not required or the correct password cookie is present, true otherwise. | 
| 865 |  */ | 
| 866 | function post_password_required( $post = null ) { | 
| 867 |      $post = get_post( $post ); | 
| 868 |  | 
| 869 |      if ( empty( $post->post_password ) ) { | 
| 870 |           /** This filter is documented in wp-includes/post-template.php */ | 
| 871 |           return apply_filters( 'post_password_required', false, $post ); | 
| 872 |      } | 
| 873 |  | 
| 874 |      if ( ! isset( $_COOKIE[ 'wp-postpass_' . COOKIEHASH ] ) ) { | 
| 875 |           /** This filter is documented in wp-includes/post-template.php */ | 
| 876 |           return apply_filters( 'post_password_required', true, $post ); | 
| 877 |      } | 
| 878 |  | 
| 879 |      require_once ABSPATH . WPINC . '/class-phpass.php'; | 
| 880 |      $hasher = new PasswordHash( 8, true ); | 
| 881 |  | 
| 882 |      $hash = wp_unslash( $_COOKIE[ 'wp-postpass_' . COOKIEHASH ] ); | 
| 883 |      if ( 0 !== strpos( $hash, '$P$B' ) ) { | 
| 884 |           $required = true; | 
| 885 |      } else { | 
| Line | Code | 
| 889 |      /** | 
| 890 |       * Filters whether a post requires the user to supply a password. | 
| 891 |       * | 
| 892 |       * @since 4.7.0 | 
| 893 |       * | 
| 894 |       * @param bool    $required Whether the user needs to supply a password. True if password has not been | 
| 895 |       *                          provided or is incorrect, false if password has been supplied or is not required. | 
| 896 |       * @param WP_Post $post     Post object. | 
| 897 |       */ | 
| 898 |      return apply_filters( 'post_password_required', $required, $post ); | 
| 899 | } | 
| 900 |  | 
| 901 | // | 
| 902 | // Page Template Functions for usage in Themes. | 
| 903 | // | 
| 904 |  | 
| 905 | /** | 
| 906 |  * The formatted output of a list of pages. | 
| 907 |  * |