Question

get_the_password_form( int|WP_Post $post )

Retrieve protected post password form content.

---

description

---

参数

$post

(int|WP_Post) (Optional) Post ID or WP_Post object. Default is global $post.

---

返回值

(string) HTML content for password form for password protected post.

---

源代码

File: wp-includes/post-template.php

function get_the_password_form( $post = 0 ) {
	$post = get_post( $post );
	$label = 'pwbox-' . ( empty($post->ID) ? rand() : $post->ID );
	$output = '<form action="' . esc_url( site_url( 'wp-login.php?action=postpass', 'login_post' ) ) . '" class="post-password-form" method="post">
	<p>' . __( 'This content is password protected. To view it please enter your password below:' ) . '</p>
	<p><label for="' . $label . '">' . __( 'Password:' ) . ' <input name="post_password" id="' . $label . '" type="password" size="20" /></label> <input type="submit" name="Submit" value="' . esc_attr_x( 'Enter', 'post password form' ) . '" /></p></form>
	';

	/**
	 * Filters the HTML output for the protected post password form.
	 *
	 * If modifying the password field, please note that the core database schema
	 * limits the password field to 20 characters regardless of the value of the
	 * size attribute in the form input.
	 *
	 * @since 2.7.0
	 *
	 * @param string $output The password form HTML output.
	 */
	return apply_filters( 'the_password_form', $output );
}

---

更新日志

Version	description
1.0.0	Introduced.

---

相关函数

Uses

• wp-includes/l10n.php: __()
• wp-includes/l10n.php: esc_attr_x()
• wp-includes/formatting.php: esc_url()
• wp-includes/link-template.php: site_url()
• wp-includes/plugin.php: apply_filters()
• wp-includes/post-template.php: the_password_form
• wp-includes/post.php: get_post()
Show 2 more uses Hide more uses

---

Used By

• wp-includes/post-template.php: get_the_content()

---

User Contributed Notes