post_password_required( int|WP_Post|null $post = null ): bool

Determines whether the post requires password and whether a correct password has been provided.

Parameters

$postint|WP_Post|nulloptional
An optional post. Global $post used if not provided.

Default:null

Return

bool false if a password is not required or the correct password cookie is present, true otherwise.

Source

function post_password_required( $post = null ) {
	$post = get_post( $post );

	if ( empty( $post->post_password ) ) {
		/** This filter is documented in wp-includes/post-template.php */
		return apply_filters( 'post_password_required', false, $post );
	}

	if ( ! isset( $_COOKIE[ 'wp-postpass_' . COOKIEHASH ] ) ) {
		/** This filter is documented in wp-includes/post-template.php */
		return apply_filters( 'post_password_required', true, $post );
	}

	require_once ABSPATH . WPINC . '/class-phpass.php';
	$hasher = new PasswordHash( 8, true );

	$hash = wp_unslash( $_COOKIE[ 'wp-postpass_' . COOKIEHASH ] );
	if ( ! str_starts_with( $hash, '$P$B' ) ) {
		$required = true;
	} else {
		$required = ! $hasher->CheckPassword( $post->post_password, $hash );
	}

	/**
	 * Filters whether a post requires the user to supply a password.
	 *
	 * @since 4.7.0
	 *
	 * @param bool    $required Whether the user needs to supply a password. True if password has not been
	 *                          provided or is incorrect, false if password has been supplied or is not required.
	 * @param WP_Post $post     Post object.
	 */
	return apply_filters( 'post_password_required', $required, $post );
}

Hooks

apply_filters( ‘post_password_required’, bool $required, WP_Post $post )

Filters whether a post requires the user to supply a password.

Changelog

VersionDescription
2.7.0Introduced.

User Contributed Notes

  1. Skip to note 2 content

    I looked long and hard in trying to find a working example of his function, (couldn’t!)
    The code below works, and it works well.

    Note 1: Without getting, (and using the post->ID), then the post_password_required function doesn’t work.
    Note 2: Something else you have to watch is cookies being set once the password has been used once, makes debugging a nightmare, (tip), use an Incognito Window when testing out your code.
    Note 3: I have broken with tradition here, and opened (the-Loop) with wide braces instead of the endwhile: condition, I personally find it easier to follow.

    Hope it helps.

    <?php
    
    $pass_masterPost = get_post();
    if ( post_password_required(  $pass_masterPost->ID ) )
    {
        echo get_the_password_form();
        echo '<p>THIS POST IS PASSWORD PROTECTED: PLEASE ENTER IT!</p>';
    }
    else
    {
        if ( have_posts() )
        { 
            while ( have_posts() ) 
            {        
                the_post();
                the_content();
    			echo '<hr>';
             }    
        }
        else
        {
            echo '<p>Nothing Found!</p>';
        }
    }
    ?>

You must log in before being able to contribute a note or feedback.