enmi-conf.org: wp/wp-includes/comment-template.php@48c4eec2b7e6 (annotated)

0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1	<?php
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	3	* Comment template functions
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	4	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	5	* These functions are meant to live inside of the WordPress loop.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	6	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	7	* @package WordPress
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	8	* @subpackage Template
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	9	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	10
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	11	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	12	* Retrieves the author of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	13	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	14	* If the comment has an empty comment_author field, then 'Anonymous' person is
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	15	* assumed.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	16	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	17	* @since 1.5.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	18	* @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	19	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	20	* @param int\|WP_Comment $comment_id Optional. WP_Comment or the ID of the comment for which to retrieve the author.
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	21	* Default current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	22	* @return string The comment author
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	23	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	24	function get_comment_author( $comment_id = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	25	$comment = get_comment( $comment_id );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	26
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	27	if ( ! empty( $comment->comment_ID ) ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	28	$comment_id = $comment->comment_ID;
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	29	} elseif ( is_scalar( $comment_id ) ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	30	$comment_id = (string) $comment_id;
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	31	} else {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	32	$comment_id = '';
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	33	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	34
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	35	if ( empty( $comment->comment_author ) ) {
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	36	$user = ! empty( $comment->user_id ) ? get_userdata( $comment->user_id ) : false;
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	37	if ( $user ) {
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	38	$comment_author = $user->display_name;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	39	} else {
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	40	$comment_author = __( 'Anonymous' );
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	41	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	42	} else {
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	43	$comment_author = $comment->comment_author;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	44	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	45
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	46	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	47	* Filters the returned comment author name.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	48	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	49	* @since 1.5.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	50	* @since 4.1.0 The `$comment_id` and `$comment` parameters were added.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	51	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	52	* @param string $comment_author The comment author's username.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	53	* @param string $comment_id The comment ID as a numeric string.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	54	* @param WP_Comment $comment The comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	55	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	56	return apply_filters( 'get_comment_author', $comment_author, $comment_id, $comment );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	57	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	58
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	59	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	60	* Displays the author of the current comment.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	61	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	62	* @since 0.71
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	63	* @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	64	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	65	* @param int\|WP_Comment $comment_id Optional. WP_Comment or the ID of the comment for which to print the author.
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	66	* Default current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	67	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	68	function comment_author( $comment_id = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	69	$comment = get_comment( $comment_id );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	70
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	71	$comment_author = get_comment_author( $comment );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	72
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	73	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	74	* Filters the comment author's name for display.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	75	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	76	* @since 1.2.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	77	* @since 4.1.0 The `$comment_id` parameter was added.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	78	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	79	* @param string $comment_author The comment author's username.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	80	* @param string $comment_id The comment ID as a numeric string.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	81	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	82	echo apply_filters( 'comment_author', $comment_author, $comment->comment_ID );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	83	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	84
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	85	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	86	* Retrieves the email of the author of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	87	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	88	* @since 1.5.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	89	* @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	90	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	91	* @param int\|WP_Comment $comment_id Optional. WP_Comment or the ID of the comment for which to get the author's email.
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	92	* Default current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	93	* @return string The current comment author's email
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	94	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	95	function get_comment_author_email( $comment_id = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	96	$comment = get_comment( $comment_id );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	97
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	98	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	99	* Filters the comment author's returned email address.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	100	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	101	* @since 1.5.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	102	* @since 4.1.0 The `$comment_id` and `$comment` parameters were added.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	103	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	104	* @param string $comment_author_email The comment author's email address.
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	105	* @param string $comment_id The comment ID as a numeric string.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	106	* @param WP_Comment $comment The comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	107	*/
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	108	return apply_filters( 'get_comment_author_email', $comment->comment_author_email, $comment->comment_ID, $comment );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	109	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	110
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	111	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	112	* Displays the email of the author of the current global $comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	113	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	114	* Care should be taken to protect the email address and assure that email
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	115	* harvesters do not capture your commenter's email address. Most assume that
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	116	* their email address will not appear in raw form on the site. Doing so will
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	117	* enable anyone, including those that people don't want to get the email
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	118	* address and use it for their own means good and bad.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	119	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	120	* @since 0.71
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	121	* @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	122	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	123	* @param int\|WP_Comment $comment_id Optional. WP_Comment or the ID of the comment for which to print the author's email.
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	124	* Default current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	125	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	126	function comment_author_email( $comment_id = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	127	$comment = get_comment( $comment_id );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	128
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	129	$comment_author_email = get_comment_author_email( $comment );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	130
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	131	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	132	* Filters the comment author's email for display.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	133	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	134	* @since 1.2.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	135	* @since 4.1.0 The `$comment_id` parameter was added.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	136	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	137	* @param string $comment_author_email The comment author's email address.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	138	* @param string $comment_id The comment ID as a numeric string.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	139	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	140	echo apply_filters( 'author_email', $comment_author_email, $comment->comment_ID );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	141	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	142
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	143	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	144	* Displays the HTML email link to the author of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	145	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	146	* Care should be taken to protect the email address and assure that email
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	147	* harvesters do not capture your commenter's email address. Most assume that
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	148	* their email address will not appear in raw form on the site. Doing so will
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	149	* enable anyone, including those that people don't want to get the email
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	150	* address and use it for their own means good and bad.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	151	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	152	* @since 0.71
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	153	* @since 4.6.0 Added the `$comment` parameter.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	154	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	155	* @param string $link_text Optional. Text to display instead of the comment author's email address.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	156	* Default empty.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	157	* @param string $before Optional. Text or HTML to display before the email link. Default empty.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	158	* @param string $after Optional. Text or HTML to display after the email link. Default empty.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	159	* @param int\|WP_Comment $comment Optional. Comment ID or WP_Comment object. Default is the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	160	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	161	function comment_author_email_link( $link_text = '', $before = '', $after = '', $comment = null ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	162	$link = get_comment_author_email_link( $link_text, $before, $after, $comment );
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	163	if ( $link ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	164	echo $link;
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	165	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	166	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	167
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	168	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	169	* Returns the HTML email link to the author of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	170	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	171	* Care should be taken to protect the email address and assure that email
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	172	* harvesters do not capture your commenter's email address. Most assume that
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	173	* their email address will not appear in raw form on the site. Doing so will
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	174	* enable anyone, including those that people don't want to get the email
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	175	* address and use it for their own means good and bad.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	176	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	177	* @since 2.7.0
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	178	* @since 4.6.0 Added the `$comment` parameter.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	179	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	180	* @param string $link_text Optional. Text to display instead of the comment author's email address.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	181	* Default empty.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	182	* @param string $before Optional. Text or HTML to display before the email link. Default empty.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	183	* @param string $after Optional. Text or HTML to display after the email link. Default empty.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	184	* @param int\|WP_Comment $comment Optional. Comment ID or WP_Comment object. Default is the current comment.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	185	* @return string HTML markup for the comment author email link. By default, the email address is obfuscated
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	186	* via the {@see 'comment_email'} filter with antispambot().
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	187	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	188	function get_comment_author_email_link( $link_text = '', $before = '', $after = '', $comment = null ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	189	$comment = get_comment( $comment );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	190
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	191	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	192	* Filters the comment author's email for display.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	193	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	194	* Care should be taken to protect the email address and assure that email
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	195	* harvesters do not capture your commenter's email address.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	196	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	197	* @since 1.2.0
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	198	* @since 4.1.0 The `$comment` parameter was added.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	199	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	200	* @param string $comment_author_email The comment author's email address.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	201	* @param WP_Comment $comment The comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	202	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	203	$comment_author_email = apply_filters( 'comment_email', $comment->comment_author_email, $comment );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	204
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	205	if ( ( ! empty( $comment_author_email ) ) && ( '@' !== $comment_author_email ) ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	206	$display = ( '' !== $link_text ) ? $link_text : $comment_author_email;
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	207
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	208	$comment_author_email_link = $before . sprintf(
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	209	'<a href="%1$s">%2$s</a>',
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	210	esc_url( 'mailto:' . $comment_author_email ),
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	211	esc_html( $display )
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	212	) . $after;
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	213
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	214	return $comment_author_email_link;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	215	} else {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	216	return '';
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	217	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	218	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	219
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	220	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	221	* Retrieves the HTML link to the URL of the author of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	222	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	223	* Both get_comment_author_url() and get_comment_author() rely on get_comment(),
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	224	* which falls back to the global comment variable if the $comment_id argument is empty.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	225	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	226	* @since 1.5.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	227	* @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	228	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	229	* @param int\|WP_Comment $comment_id Optional. WP_Comment or the ID of the comment for which to get the author's link.
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	230	* Default current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	231	* @return string The comment author name or HTML link for author's URL.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	232	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	233	function get_comment_author_link( $comment_id = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	234	$comment = get_comment( $comment_id );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	235
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	236	$comment_id = ! empty( $comment->comment_ID ) ? $comment->comment_ID : (string) $comment_id;
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	237
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	238	$comment_author_url = get_comment_author_url( $comment );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	239	$comment_author = get_comment_author( $comment );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	240
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	241	if ( empty( $comment_author_url ) \|\| 'http://' === $comment_author_url ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	242	$comment_author_link = $comment_author;
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	243	} else {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	244	$rel_parts = array( 'ugc' );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	245	if ( ! wp_is_internal_link( $comment_author_url ) ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	246	$rel_parts = array_merge(
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	247	$rel_parts,
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	248	array( 'external', 'nofollow' )
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	249	);
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	250	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	251
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	252	/**
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	253	* Filters the rel attributes of the comment author's link.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	254	*
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	255	* @since 6.2.0
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	256	*
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	257	* @param string[] $rel_parts An array of strings representing the rel tags
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	258	* which will be joined into the anchor's rel attribute.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	259	* @param WP_Comment $comment The comment object.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	260	*/
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	261	$rel_parts = apply_filters( 'comment_author_link_rel', $rel_parts, $comment );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	262
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	263	$rel = implode( ' ', $rel_parts );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	264	$rel = esc_attr( $rel );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	265	// Empty space before 'rel' is necessary for later sprintf().
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	266	$rel = ! empty( $rel ) ? sprintf( ' rel="%s"', $rel ) : '';
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	267
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	268	$comment_author_link = sprintf(
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	269	'<a href="%1$s" class="url"%2$s>%3$s</a>',
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	270	$comment_author_url,
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	271	$rel,
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	272	$comment_author
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	273	);
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	274	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	275
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	276	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	277	* Filters the comment author's link for display.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	278	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	279	* @since 1.5.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	280	* @since 4.1.0 The `$comment_author` and `$comment_id` parameters were added.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	281	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	282	* @param string $comment_author_link The HTML-formatted comment author link.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	283	* Empty for an invalid URL.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	284	* @param string $comment_author The comment author's username.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	285	* @param string $comment_id The comment ID as a numeric string.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	286	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	287	return apply_filters( 'get_comment_author_link', $comment_author_link, $comment_author, $comment_id );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	288	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	289
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	290	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	291	* Displays the HTML link to the URL of the author of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	292	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	293	* @since 0.71
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	294	* @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	295	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	296	* @param int\|WP_Comment $comment_id Optional. WP_Comment or the ID of the comment for which to print the author's link.
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	297	* Default current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	298	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	299	function comment_author_link( $comment_id = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	300	echo get_comment_author_link( $comment_id );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	301	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	302
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	303	/**
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	304	* Retrieves the IP address of the author of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	305	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	306	* @since 1.5.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	307	* @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	308	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	309	* @param int\|WP_Comment $comment_id Optional. WP_Comment or the ID of the comment for which to get the author's IP address.
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	310	* Default current comment.
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	311	* @return string Comment author's IP address, or an empty string if it's not available.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	312	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	313	function get_comment_author_IP( $comment_id = 0 ) { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionNameInvalid
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	314	$comment = get_comment( $comment_id );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	315
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	316	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	317	* Filters the comment author's returned IP address.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	318	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	319	* @since 1.5.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	320	* @since 4.1.0 The `$comment_id` and `$comment` parameters were added.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	321	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	322	* @param string $comment_author_ip The comment author's IP address, or an empty string if it's not available.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	323	* @param string $comment_id The comment ID as a numeric string.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	324	* @param WP_Comment $comment The comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	325	*/
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	326	return apply_filters( 'get_comment_author_IP', $comment->comment_author_IP, $comment->comment_ID, $comment ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.NotLowercase
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	327	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	328
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	329	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	330	* Displays the IP address of the author of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	331	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	332	* @since 0.71
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	333	* @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	334	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	335	* @param int\|WP_Comment $comment_id Optional. WP_Comment or the ID of the comment for which to print the author's IP address.
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	336	* Default current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	337	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	338	function comment_author_IP( $comment_id = 0 ) { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionNameInvalid
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	339	echo esc_html( get_comment_author_IP( $comment_id ) );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	340	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	341
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	342	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	343	* Retrieves the URL of the author of the current comment, not linked.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	344	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	345	* @since 1.5.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	346	* @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	347	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	348	* @param int\|WP_Comment $comment_id Optional. WP_Comment or the ID of the comment for which to get the author's URL.
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	349	* Default current comment.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	350	* @return string Comment author URL, if provided, an empty string otherwise.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	351	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	352	function get_comment_author_url( $comment_id = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	353	$comment = get_comment( $comment_id );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	354
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	355	$comment_author_url = '';
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	356	$comment_id = 0;
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	357
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	358	if ( ! empty( $comment ) ) {
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	359	$comment_author_url = ( 'http://' === $comment->comment_author_url ) ? '' : $comment->comment_author_url;
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	360	$comment_author_url = esc_url( $comment_author_url, array( 'http', 'https' ) );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	361
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	362	$comment_id = $comment->comment_ID;
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	363	}
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	364
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	365	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	366	* Filters the comment author's URL.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	367	*
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	368	* @since 1.5.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	369	* @since 4.1.0 The `$comment_id` and `$comment` parameters were added.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	370	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	371	* @param string $comment_author_url The comment author's URL, or an empty string.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	372	* @param string\|int $comment_id The comment ID as a numeric string, or 0 if not found.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	373	* @param WP_Comment\|null $comment The comment object, or null if not found.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	374	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	375	return apply_filters( 'get_comment_author_url', $comment_author_url, $comment_id, $comment );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	376	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	377
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	378	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	379	* Displays the URL of the author of the current comment, not linked.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	380	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	381	* @since 0.71
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	382	* @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	383	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	384	* @param int\|WP_Comment $comment_id Optional. WP_Comment or the ID of the comment for which to print the author's URL.
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	385	* Default current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	386	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	387	function comment_author_url( $comment_id = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	388	$comment = get_comment( $comment_id );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	389
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	390	$comment_author_url = get_comment_author_url( $comment );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	391
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	392	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	393	* Filters the comment author's URL for display.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	394	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	395	* @since 1.2.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	396	* @since 4.1.0 The `$comment_id` parameter was added.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	397	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	398	* @param string $comment_author_url The comment author's URL.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	399	* @param string $comment_id The comment ID as a numeric string.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	400	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	401	echo apply_filters( 'comment_url', $comment_author_url, $comment->comment_ID );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	402	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	403
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	404	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	405	* Retrieves the HTML link of the URL of the author of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	406	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	407	* $link_text parameter is only used if the URL does not exist for the comment
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	408	* author. If the URL does exist then the URL will be used and the $link_text
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	409	* will be ignored.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	410	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	411	* Encapsulate the HTML link between the $before and $after. So it will appear
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	412	* in the order of $before, link, and finally $after.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	413	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	414	* @since 1.5.0
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	415	* @since 4.6.0 Added the `$comment` parameter.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	416	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	417	* @param string $link_text Optional. The text to display instead of the comment
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	418	* author's email address. Default empty.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	419	* @param string $before Optional. The text or HTML to display before the email link.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	420	* Default empty.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	421	* @param string $after Optional. The text or HTML to display after the email link.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	422	* Default empty.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	423	* @param int\|WP_Comment $comment Optional. Comment ID or WP_Comment object.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	424	* Default is the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	425	* @return string The HTML link between the $before and $after parameters.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	426	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	427	function get_comment_author_url_link( $link_text = '', $before = '', $after = '', $comment = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	428	$comment_author_url = get_comment_author_url( $comment );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	429
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	430	$display = ( '' !== $link_text ) ? $link_text : $comment_author_url;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	431	$display = str_replace( 'http://www.', '', $display );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	432	$display = str_replace( 'http://', '', $display );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	433
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	434	if ( str_ends_with( $display, '/' ) ) {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	435	$display = substr( $display, 0, -1 );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	436	}
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	437
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	438	$comment_author_url_link = $before . sprintf(
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	439	'<a href="%1$s" rel="external">%2$s</a>',
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	440	$comment_author_url,
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	441	$display
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	442	) . $after;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	443
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	444	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	445	* Filters the comment author's returned URL link.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	446	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	447	* @since 1.5.0
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	448	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	449	* @param string $comment_author_url_link The HTML-formatted comment author URL link.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	450	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	451	return apply_filters( 'get_comment_author_url_link', $comment_author_url_link );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	452	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	453
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	454	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	455	* Displays the HTML link of the URL of the author of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	456	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	457	* @since 0.71
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	458	* @since 4.6.0 Added the `$comment` parameter.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	459	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	460	* @param string $link_text Optional. Text to display instead of the comment author's
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	461	* email address. Default empty.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	462	* @param string $before Optional. Text or HTML to display before the email link.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	463	* Default empty.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	464	* @param string $after Optional. Text or HTML to display after the email link.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	465	* Default empty.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	466	* @param int\|WP_Comment $comment Optional. Comment ID or WP_Comment object.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	467	* Default is the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	468	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	469	function comment_author_url_link( $link_text = '', $before = '', $after = '', $comment = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	470	echo get_comment_author_url_link( $link_text, $before, $after, $comment );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	471	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	472
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	473	/**
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	474	* Generates semantic classes for each comment element.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	475	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	476	* @since 2.7.0
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	477	* @since 4.4.0 Added the ability for `$comment` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	478	*
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	479	* @param string\|string[] $css_class Optional. One or more classes to add to the class list.
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	480	* Default empty.
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	481	* @param int\|WP_Comment $comment Optional. Comment ID or WP_Comment object. Default current comment.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	482	* @param int\|WP_Post $post Optional. Post ID or WP_Post object. Default current post.
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	483	* @param bool $display Optional. Whether to print or return the output.
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	484	* Default true.
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	485	* @return void\|string Void if `$display` argument is true, comment classes if `$display` is false.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	486	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	487	function comment_class( $css_class = '', $comment = null, $post = null, $display = true ) {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	488	// Separates classes with a single space, collates classes for comment DIV.
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	489	$css_class = 'class="' . implode( ' ', get_comment_class( $css_class, $comment, $post ) ) . '"';
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	490
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	491	if ( $display ) {
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	492	echo $css_class;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	493	} else {
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	494	return $css_class;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	495	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	496	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	497
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	498	/**
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	499	* Returns the classes for the comment div as an array.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	500	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	501	* @since 2.7.0
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	502	* @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	503	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	504	* @global int $comment_alt
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	505	* @global int $comment_depth
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	506	* @global int $comment_thread_alt
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	507	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	508	* @param string\|string[] $css_class Optional. One or more classes to add to the class list.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	509	* Default empty.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	510	* @param int\|WP_Comment $comment_id Optional. Comment ID or WP_Comment object. Default current comment.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	511	* @param int\|WP_Post $post Optional. Post ID or WP_Post object. Default current post.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	512	* @return string[] An array of classes.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	513	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	514	function get_comment_class( $css_class = '', $comment_id = null, $post = null ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	515	global $comment_alt, $comment_depth, $comment_thread_alt;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	516
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	517	$classes = array();
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	518
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	519	$comment = get_comment( $comment_id );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	520	if ( ! $comment ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	521	return $classes;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	522	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	523
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	524	// Get the comment type (comment, trackback).
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	525	$classes[] = ( empty( $comment->comment_type ) ) ? 'comment' : $comment->comment_type;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	526
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	527	// Add classes for comment authors that are registered users.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	528	$user = $comment->user_id ? get_userdata( $comment->user_id ) : false;
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	529	if ( $user ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	530	$classes[] = 'byuser';
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	531	$classes[] = 'comment-author-' . sanitize_html_class( $user->user_nicename, $comment->user_id );
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	532	// For comment authors who are the author of the post.
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	533	$_post = get_post( $post );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	534	if ( $_post ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	535	if ( $comment->user_id === $_post->post_author ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	536	$classes[] = 'bypostauthor';
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	537	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	538	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	539	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	540
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	541	if ( empty( $comment_alt ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	542	$comment_alt = 0;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	543	}
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	544	if ( empty( $comment_depth ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	545	$comment_depth = 1;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	546	}
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	547	if ( empty( $comment_thread_alt ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	548	$comment_thread_alt = 0;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	549	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	550
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	551	if ( $comment_alt % 2 ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	552	$classes[] = 'odd';
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	553	$classes[] = 'alt';
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	554	} else {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	555	$classes[] = 'even';
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	556	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	557
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	558	++$comment_alt;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	559
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	560	// Alt for top-level comments.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	561	if ( 1 == $comment_depth ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	562	if ( $comment_thread_alt % 2 ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	563	$classes[] = 'thread-odd';
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	564	$classes[] = 'thread-alt';
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	565	} else {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	566	$classes[] = 'thread-even';
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	567	}
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	568	++$comment_thread_alt;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	569	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	570
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	571	$classes[] = "depth-$comment_depth";
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	572
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	573	if ( ! empty( $css_class ) ) {
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	574	if ( ! is_array( $css_class ) ) {
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	575	$css_class = preg_split( '#\s+#', $css_class );
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	576	}
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	577	$classes = array_merge( $classes, $css_class );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	578	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	579
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	580	$classes = array_map( 'esc_attr', $classes );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	581
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	582	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	583	* Filters the returned CSS classes for the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	584	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	585	* @since 2.7.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	586	*
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	587	* @param string[] $classes An array of comment classes.
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	588	* @param string[] $css_class An array of additional classes added to the list.
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	589	* @param string $comment_id The comment ID as a numeric string.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	590	* @param WP_Comment $comment The comment object.
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	591	* @param int\|WP_Post $post The post ID or WP_Post object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	592	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	593	return apply_filters( 'comment_class', $classes, $css_class, $comment->comment_ID, $comment, $post );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	594	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	595
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	596	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	597	* Retrieves the comment date of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	598	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	599	* @since 1.5.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	600	* @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	601	*
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	602	* @param string $format Optional. PHP date format. Defaults to the 'date_format' option.
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	603	* @param int\|WP_Comment $comment_id Optional. WP_Comment or ID of the comment for which to get the date.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	604	* Default current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	605	* @return string The comment's date.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	606	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	607	function get_comment_date( $format = '', $comment_id = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	608	$comment = get_comment( $comment_id );
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	609
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	610	$_format = ! empty( $format ) ? $format : get_option( 'date_format' );
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	611
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	612	$comment_date = mysql2date( $_format, $comment->comment_date );
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	613
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	614	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	615	* Filters the returned comment date.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	616	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	617	* @since 1.5.0
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	618	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	619	* @param string\|int $comment_date Formatted date string or Unix timestamp.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	620	* @param string $format PHP date format.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	621	* @param WP_Comment $comment The comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	622	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	623	return apply_filters( 'get_comment_date', $comment_date, $format, $comment );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	624	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	625
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	626	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	627	* Displays the comment date of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	628	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	629	* @since 0.71
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	630	* @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	631	*
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	632	* @param string $format Optional. PHP date format. Defaults to the 'date_format' option.
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	633	* @param int\|WP_Comment $comment_id WP_Comment or ID of the comment for which to print the date.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	634	* Default current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	635	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	636	function comment_date( $format = '', $comment_id = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	637	echo get_comment_date( $format, $comment_id );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	638	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	639
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	640	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	641	* Retrieves the excerpt of the given comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	642	*
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	643	* Returns a maximum of 20 words with an ellipsis appended if necessary.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	644	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	645	* @since 1.5.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	646	* @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	647	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	648	* @param int\|WP_Comment $comment_id Optional. WP_Comment or ID of the comment for which to get the excerpt.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	649	* Default current comment.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	650	* @return string The possibly truncated comment excerpt.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	651	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	652	function get_comment_excerpt( $comment_id = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	653	$comment = get_comment( $comment_id );
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	654
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	655	if ( ! post_password_required( $comment->comment_post_ID ) ) {
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	656	$comment_text = strip_tags( str_replace( array( "\n", "\r" ), ' ', $comment->comment_content ) );
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	657	} else {
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	658	$comment_text = __( 'Password protected' );
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	659	}
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	660
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	661	/* translators: Maximum number of words used in a comment excerpt. */
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	662	$comment_excerpt_length = (int) _x( '20', 'comment_excerpt_length' );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	663
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	664	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	665	* Filters the maximum number of words used in the comment excerpt.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	666	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	667	* @since 4.4.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	668	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	669	* @param int $comment_excerpt_length The amount of words you want to display in the comment excerpt.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	670	*/
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	671	$comment_excerpt_length = apply_filters( 'comment_excerpt_length', $comment_excerpt_length );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	672
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	673	$comment_excerpt = wp_trim_words( $comment_text, $comment_excerpt_length, '…' );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	674
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	675	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	676	* Filters the retrieved comment excerpt.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	677	*
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	678	* @since 1.5.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	679	* @since 4.1.0 The `$comment_id` and `$comment` parameters were added.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	680	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	681	* @param string $comment_excerpt The comment excerpt text.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	682	* @param string $comment_id The comment ID as a numeric string.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	683	* @param WP_Comment $comment The comment object.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	684	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	685	return apply_filters( 'get_comment_excerpt', $comment_excerpt, $comment->comment_ID, $comment );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	686	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	687
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	688	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	689	* Displays the excerpt of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	690	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	691	* @since 1.2.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	692	* @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	693	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	694	* @param int\|WP_Comment $comment_id Optional. WP_Comment or ID of the comment for which to print the excerpt.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	695	* Default current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	696	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	697	function comment_excerpt( $comment_id = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	698	$comment = get_comment( $comment_id );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	699
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	700	$comment_excerpt = get_comment_excerpt( $comment );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	701
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	702	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	703	* Filters the comment excerpt for display.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	704	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	705	* @since 1.2.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	706	* @since 4.1.0 The `$comment_id` parameter was added.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	707	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	708	* @param string $comment_excerpt The comment excerpt text.
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	709	* @param string $comment_id The comment ID as a numeric string.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	710	*/
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	711	echo apply_filters( 'comment_excerpt', $comment_excerpt, $comment->comment_ID );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	712	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	713
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	714	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	715	* Retrieves the comment ID of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	716	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	717	* @since 1.5.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	718	*
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	719	* @return string The comment ID as a numeric string.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	720	*/
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	721	function get_comment_ID() { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionNameInvalid
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	722	$comment = get_comment();
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	723
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	724	$comment_id = ! empty( $comment->comment_ID ) ? $comment->comment_ID : '0';
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	725
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	726	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	727	* Filters the returned comment ID.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	728	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	729	* @since 1.5.0
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	730	* @since 4.1.0 The `$comment` parameter was added.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	731	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	732	* @param string $comment_id The current comment ID as a numeric string.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	733	* @param WP_Comment $comment The comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	734	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	735	return apply_filters( 'get_comment_ID', $comment_id, $comment ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.NotLowercase
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	736	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	737
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	738	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	739	* Displays the comment ID of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	740	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	741	* @since 0.71
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	742	*/
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	743	function comment_ID() { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionNameInvalid
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	744	echo get_comment_ID();
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	745	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	746
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	747	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	748	* Retrieves the link to a given comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	749	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	750	* @since 1.5.0
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	751	* @since 4.4.0 Added the ability for `$comment` to also accept a WP_Comment object. Added `$cpage` argument.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	752	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	753	* @see get_page_of_comment()
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	754	*
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	755	* @global WP_Rewrite $wp_rewrite WordPress rewrite component.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	756	* @global bool $in_comment_loop
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	757	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	758	* @param WP_Comment\|int\|null $comment Optional. Comment to retrieve. Default current comment.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	759	* @param array $args {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	760	* An array of optional arguments to override the defaults.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	761	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	762	* @type string $type Passed to get_page_of_comment().
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	763	* @type int $page Current page of comments, for calculating comment pagination.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	764	* @type int $per_page Per-page value for comment pagination.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	765	* @type int $max_depth Passed to get_page_of_comment().
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	766	* @type int\|string $cpage Value to use for the comment's "comment-page" or "cpage" value.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	767	* If provided, this value overrides any value calculated from `$page`
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	768	* and `$per_page`.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	769	* }
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	770	* @return string The permalink to the given comment.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	771	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	772	function get_comment_link( $comment = null, $args = array() ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	773	global $wp_rewrite, $in_comment_loop;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	774
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	775	$comment = get_comment( $comment );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	776
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	777	// Back-compat.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	778	if ( ! is_array( $args ) ) {
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	779	$args = array( 'page' => $args );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	780	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	781
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	782	$defaults = array(
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	783	'type' => 'all',
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	784	'page' => '',
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	785	'per_page' => '',
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	786	'max_depth' => '',
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	787	'cpage' => null,
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	788	);
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	789
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	790	$args = wp_parse_args( $args, $defaults );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	791
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	792	$comment_link = get_permalink( $comment->comment_post_ID );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	793
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	794	// The 'cpage' param takes precedence.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	795	if ( ! is_null( $args['cpage'] ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	796	$cpage = $args['cpage'];
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	797
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	798	// No 'cpage' is provided, so we calculate one.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	799	} else {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	800	if ( '' === $args['per_page'] && get_option( 'page_comments' ) ) {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	801	$args['per_page'] = get_option( 'comments_per_page' );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	802	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	803
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	804	if ( empty( $args['per_page'] ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	805	$args['per_page'] = 0;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	806	$args['page'] = 0;
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	807	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	808
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	809	$cpage = $args['page'];
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	810
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	811	if ( '' == $cpage ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	812	if ( ! empty( $in_comment_loop ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	813	$cpage = get_query_var( 'cpage' );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	814	} else {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	815	// Requires a database hit, so we only do it when we can't figure out from context.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	816	$cpage = get_page_of_comment( $comment->comment_ID, $args );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	817	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	818	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	819
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	820	/*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	821	* If the default page displays the oldest comments, the permalinks for comments on the default page
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	822	* do not need a 'cpage' query var.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	823	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	824	if ( 'oldest' === get_option( 'default_comments_page' ) && 1 === $cpage ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	825	$cpage = '';
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	826	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	827	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	828
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	829	if ( $cpage && get_option( 'page_comments' ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	830	if ( $wp_rewrite->using_permalinks() ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	831	if ( $cpage ) {
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	832	$comment_link = trailingslashit( $comment_link ) . $wp_rewrite->comments_pagination_base . '-' . $cpage;
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	833	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	834
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	835	$comment_link = user_trailingslashit( $comment_link, 'comment' );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	836	} elseif ( $cpage ) {
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	837	$comment_link = add_query_arg( 'cpage', $cpage, $comment_link );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	838	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	839	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	840
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	841	if ( $wp_rewrite->using_permalinks() ) {
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	842	$comment_link = user_trailingslashit( $comment_link, 'comment' );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	843	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	844
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	845	$comment_link = $comment_link . '#comment-' . $comment->comment_ID;
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	846
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	847	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	848	* Filters the returned single comment permalink.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	849	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	850	* @since 2.8.0
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	851	* @since 4.4.0 Added the `$cpage` parameter.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	852	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	853	* @see get_page_of_comment()
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	854	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	855	* @param string $comment_link The comment permalink with '#comment-$id' appended.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	856	* @param WP_Comment $comment The current comment object.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	857	* @param array $args An array of arguments to override the defaults.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	858	* @param int $cpage The calculated 'cpage' value.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	859	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	860	return apply_filters( 'get_comment_link', $comment_link, $comment, $args, $cpage );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	861	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	862
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	863	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	864	* Retrieves the link to the current post comments.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	865	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	866	* @since 1.5.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	867	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	868	* @param int\|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	869	* @return string The link to the comments.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	870	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	871	function get_comments_link( $post = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	872	$hash = get_comments_number( $post ) ? '#comments' : '#respond';
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	873	$comments_link = get_permalink( $post ) . $hash;
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	874
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	875	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	876	* Filters the returned post comments permalink.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	877	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	878	* @since 3.6.0
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	879	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	880	* @param string $comments_link Post comments permalink with '#comments' appended.
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	881	* @param int\|WP_Post $post Post ID or WP_Post object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	882	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	883	return apply_filters( 'get_comments_link', $comments_link, $post );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	884	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	885
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	886	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	887	* Displays the link to the current post comments.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	888	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	889	* @since 0.71
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	890	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	891	* @param string $deprecated Not Used.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	892	* @param string $deprecated_2 Not Used.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	893	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	894	function comments_link( $deprecated = '', $deprecated_2 = '' ) {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	895	if ( ! empty( $deprecated ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	896	_deprecated_argument( __FUNCTION__, '0.72' );
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	897	}
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	898	if ( ! empty( $deprecated_2 ) ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	899	_deprecated_argument( __FUNCTION__, '1.3.0' );
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	900	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	901	echo esc_url( get_comments_link() );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	902	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	903
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	904	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	905	* Retrieves the amount of comments a post has.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	906	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	907	* @since 1.5.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	908	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	909	* @param int\|WP_Post $post Optional. Post ID or WP_Post object. Default is the global `$post`.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	910	* @return string\|int If the post exists, a numeric string representing the number of comments
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	911	* the post has, otherwise 0.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	912	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	913	function get_comments_number( $post = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	914	$post = get_post( $post );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	915
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	916	$comments_number = $post ? $post->comment_count : 0;
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	917	$post_id = $post ? $post->ID : 0;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	918
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	919	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	920	* Filters the returned comment count for a post.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	921	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	922	* @since 1.5.0
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	923	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	924	* @param string\|int $comments_number A string representing the number of comments a post has, otherwise 0.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	925	* @param int $post_id Post ID.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	926	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	927	return apply_filters( 'get_comments_number', $comments_number, $post_id );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	928	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	929
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	930	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	931	* Displays the language string for the number of comments the current post has.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	932	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	933	* @since 0.71
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	934	* @since 5.4.0 The `$deprecated` parameter was changed to `$post`.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	935	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	936	* @param string\|false $zero Optional. Text for no comments. Default false.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	937	* @param string\|false $one Optional. Text for one comment. Default false.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	938	* @param string\|false $more Optional. Text for more than one comment. Default false.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	939	* @param int\|WP_Post $post Optional. Post ID or WP_Post object. Default is the global `$post`.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	940	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	941	function comments_number( $zero = false, $one = false, $more = false, $post = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	942	echo get_comments_number_text( $zero, $one, $more, $post );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	943	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	944
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	945	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	946	* Displays the language string for the number of comments the current post has.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	947	*
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	948	* @since 4.0.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	949	* @since 5.4.0 Added the `$post` parameter to allow using the function outside of the loop.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	950	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	951	* @param string $zero Optional. Text for no comments. Default false.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	952	* @param string $one Optional. Text for one comment. Default false.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	953	* @param string $more Optional. Text for more than one comment. Default false.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	954	* @param int\|WP_Post $post Optional. Post ID or WP_Post object. Default is the global `$post`.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	955	* @return string Language string for the number of comments a post has.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	956	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	957	function get_comments_number_text( $zero = false, $one = false, $more = false, $post = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	958	$comments_number = get_comments_number( $post );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	959
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	960	if ( $comments_number > 1 ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	961	if ( false === $more ) {
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	962	$comments_number_text = sprintf(
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	963	/* translators: %s: Number of comments. */
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	964	_n( '%s Comment', '%s Comments', $comments_number ),
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	965	number_format_i18n( $comments_number )
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	966	);
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	967	} else {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	968	// % Comments
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	969	/*
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	970	* translators: If comment number in your language requires declension,
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	971	* translate this to 'on'. Do not translate into your own language.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	972	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	973	if ( 'on' === _x( 'off', 'Comment number declension: on or off' ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	974	$text = preg_replace( '#<span class="screen-reader-text">.+?</span>#', '', $more );
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	975	$text = preg_replace( '/&.+?;/', '', $text ); // Remove HTML entities.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	976	$text = trim( strip_tags( $text ), '% ' );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	977
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	978	// Replace '% Comments' with a proper plural form.
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	979	if ( $text && ! preg_match( '/[0-9]+/', $text ) && str_contains( $more, '%' ) ) {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	980	/* translators: %s: Number of comments. */
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	981	$new_text = _n( '%s Comment', '%s Comments', $comments_number );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	982	$new_text = trim( sprintf( $new_text, '' ) );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	983
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	984	$more = str_replace( $text, $new_text, $more );
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	985	if ( ! str_contains( $more, '%' ) ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	986	$more = '% ' . $more;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	987	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	988	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	989	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	990
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	991	$comments_number_text = str_replace( '%', number_format_i18n( $comments_number ), $more );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	992	}
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	993	} elseif ( 0 == $comments_number ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	994	$comments_number_text = ( false === $zero ) ? __( 'No Comments' ) : $zero;
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	995	} else { // Must be one.
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	996	$comments_number_text = ( false === $one ) ? __( '1 Comment' ) : $one;
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	997	}
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	998
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	999	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1000	* Filters the comments count for display.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1001	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1002	* @since 1.5.0
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1003	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1004	* @see _n()
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1005	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1006	* @param string $comments_number_text A translatable string formatted based on whether the count
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1007	* is equal to 0, 1, or 1+.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1008	* @param int $comments_number The number of post comments.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1009	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1010	return apply_filters( 'comments_number', $comments_number_text, $comments_number );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1011	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1012
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1013	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1014	* Retrieves the text of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1015	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1016	* @since 1.5.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1017	* @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1018	* @since 5.4.0 Added 'In reply to %s.' prefix to child comments in comments feed.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1019	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1020	* @see Walker_Comment::comment()
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1021	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1022	* @param int\|WP_Comment $comment_id Optional. WP_Comment or ID of the comment for which to get the text.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1023	* Default current comment.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1024	* @param array $args Optional. An array of arguments. Default empty array.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1025	* @return string The comment content.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1026	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1027	function get_comment_text( $comment_id = 0, $args = array() ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1028	$comment = get_comment( $comment_id );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1029
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1030	$comment_text = $comment->comment_content;
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1031
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1032	if ( is_comment_feed() && $comment->comment_parent ) {
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1033	$parent = get_comment( $comment->comment_parent );
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1034	if ( $parent ) {
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1035	$parent_link = esc_url( get_comment_link( $parent ) );
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1036	$name = get_comment_author( $parent );
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1037
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1038	$comment_text = sprintf(
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1039	/* translators: %s: Comment link. */
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1040	ent2ncr( __( 'In reply to %s.' ) ),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1041	'<a href="' . $parent_link . '">' . $name . '</a>'
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1042	) . "\n\n" . $comment_text;
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1043	}
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1044	}
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1045
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1046	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1047	* Filters the text of a comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1048	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1049	* @since 1.5.0
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1050	*
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1051	* @see Walker_Comment::comment()
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1052	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1053	* @param string $comment_text Text of the comment.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1054	* @param WP_Comment $comment The comment object.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1055	* @param array $args An array of arguments.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1056	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1057	return apply_filters( 'get_comment_text', $comment_text, $comment, $args );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1058	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1059
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1060	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1061	* Displays the text of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1062	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1063	* @since 0.71
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1064	* @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1065	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1066	* @see Walker_Comment::comment()
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1067	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1068	* @param int\|WP_Comment $comment_id Optional. WP_Comment or ID of the comment for which to print the text.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1069	* Default current comment.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1070	* @param array $args Optional. An array of arguments. Default empty array.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1071	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1072	function comment_text( $comment_id = 0, $args = array() ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1073	$comment = get_comment( $comment_id );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1074
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1075	$comment_text = get_comment_text( $comment, $args );
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1076
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1077	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1078	* Filters the text of a comment to be displayed.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1079	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1080	* @since 1.2.0
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1081	*
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1082	* @see Walker_Comment::comment()
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1083	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1084	* @param string $comment_text Text of the comment.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1085	* @param WP_Comment\|null $comment The comment object. Null if not found.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1086	* @param array $args An array of arguments.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1087	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1088	echo apply_filters( 'comment_text', $comment_text, $comment, $args );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1089	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1090
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1091	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1092	* Retrieves the comment time of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1093	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1094	* @since 1.5.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1095	* @since 6.2.0 Added the `$comment_id` parameter.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1096	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1097	* @param string $format Optional. PHP date format. Defaults to the 'time_format' option.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1098	* @param bool $gmt Optional. Whether to use the GMT date. Default false.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1099	* @param bool $translate Optional. Whether to translate the time (for use in feeds).
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1100	* Default true.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1101	* @param int\|WP_Comment $comment_id Optional. WP_Comment or ID of the comment for which to get the time.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1102	* Default current comment.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1103	* @return string The formatted time.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1104	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1105	function get_comment_time( $format = '', $gmt = false, $translate = true, $comment_id = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1106	$comment = get_comment( $comment_id );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1107
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1108	if ( null === $comment ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1109	return '';
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1110	}
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1111
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1112	$comment_date = $gmt ? $comment->comment_date_gmt : $comment->comment_date;
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1113
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1114	$_format = ! empty( $format ) ? $format : get_option( 'time_format' );
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1115
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1116	$comment_time = mysql2date( $_format, $comment_date, $translate );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1117
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1118	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1119	* Filters the returned comment time.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1120	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1121	* @since 1.5.0
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1122	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1123	* @param string\|int $comment_time The comment time, formatted as a date string or Unix timestamp.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1124	* @param string $format PHP date format.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1125	* @param bool $gmt Whether the GMT date is in use.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1126	* @param bool $translate Whether the time is translated.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1127	* @param WP_Comment $comment The comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1128	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1129	return apply_filters( 'get_comment_time', $comment_time, $format, $gmt, $translate, $comment );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1130	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1131
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1132	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1133	* Displays the comment time of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1134	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1135	* @since 0.71
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1136	* @since 6.2.0 Added the `$comment_id` parameter.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1137	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1138	* @param string $format Optional. PHP time format. Defaults to the 'time_format' option.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1139	* @param int\|WP_Comment $comment_id Optional. WP_Comment or ID of the comment for which to print the time.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1140	* Default current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1141	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1142	function comment_time( $format = '', $comment_id = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1143	echo get_comment_time( $format, false, true, $comment_id );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1144	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1145
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1146	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1147	* Retrieves the comment type of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1148	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1149	* @since 1.5.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1150	* @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1151	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1152	* @param int\|WP_Comment $comment_id Optional. WP_Comment or ID of the comment for which to get the type.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1153	* Default current comment.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1154	* @return string The comment type.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1155	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1156	function get_comment_type( $comment_id = 0 ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1157	$comment = get_comment( $comment_id );
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1158
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1159	if ( '' === $comment->comment_type ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1160	$comment->comment_type = 'comment';
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1161	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1162
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1163	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1164	* Filters the returned comment type.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1165	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1166	* @since 1.5.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1167	* @since 4.1.0 The `$comment_id` and `$comment` parameters were added.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1168	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1169	* @param string $comment_type The type of comment, such as 'comment', 'pingback', or 'trackback'.
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1170	* @param string $comment_id The comment ID as a numeric string.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1171	* @param WP_Comment $comment The comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1172	*/
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1173	return apply_filters( 'get_comment_type', $comment->comment_type, $comment->comment_ID, $comment );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1174	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1175
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1176	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1177	* Displays the comment type of the current comment.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1178	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1179	* @since 0.71
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1180	*
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1181	* @param string\|false $commenttxt Optional. String to display for comment type. Default false.
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1182	* @param string\|false $trackbacktxt Optional. String to display for trackback type. Default false.
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1183	* @param string\|false $pingbacktxt Optional. String to display for pingback type. Default false.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1184	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1185	function comment_type( $commenttxt = false, $trackbacktxt = false, $pingbacktxt = false ) {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1186	if ( false === $commenttxt ) {
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1187	$commenttxt = _x( 'Comment', 'noun' );
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1188	}
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1189	if ( false === $trackbacktxt ) {
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1190	$trackbacktxt = __( 'Trackback' );
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1191	}
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1192	if ( false === $pingbacktxt ) {
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1193	$pingbacktxt = __( 'Pingback' );
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1194	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1195	$type = get_comment_type();
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1196	switch ( $type ) {
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1197	case 'trackback':
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1198	echo $trackbacktxt;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1199	break;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1200	case 'pingback':
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1201	echo $pingbacktxt;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1202	break;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1203	default:
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1204	echo $commenttxt;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1205	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1206	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1207
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1208	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1209	* Retrieves the current post's trackback URL.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1210	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1211	* There is a check to see if permalink's have been enabled and if so, will
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1212	* retrieve the pretty path. If permalinks weren't enabled, the ID of the
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1213	* current post is used and appended to the correct page to go to.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1214	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1215	* @since 1.5.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1216	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1217	* @return string The trackback URL after being filtered.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1218	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1219	function get_trackback_url() {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1220	if ( get_option( 'permalink_structure' ) ) {
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1221	$trackback_url = trailingslashit( get_permalink() ) . user_trailingslashit( 'trackback', 'single_trackback' );
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1222	} else {
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1223	$trackback_url = get_option( 'siteurl' ) . '/wp-trackback.php?p=' . get_the_ID();
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1224	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1225
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1226	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1227	* Filters the returned trackback URL.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1228	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1229	* @since 2.2.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1230	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1231	* @param string $trackback_url The trackback URL.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1232	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1233	return apply_filters( 'trackback_url', $trackback_url );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1234	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1235
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1236	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1237	* Displays the current post's trackback URL.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1238	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1239	* @since 0.71
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1240	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1241	* @param bool $deprecated_echo Not used.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1242	* @return void\|string Should only be used to echo the trackback URL, use get_trackback_url()
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1243	* for the result instead.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1244	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1245	function trackback_url( $deprecated_echo = true ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1246	if ( true !== $deprecated_echo ) {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1247	_deprecated_argument(
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1248	__FUNCTION__,
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1249	'2.5.0',
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1250	sprintf(
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1251	/* translators: %s: get_trackback_url() */
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1252	__( 'Use %s instead if you do not want the value echoed.' ),
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1253	'<code>get_trackback_url()</code>'
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1254	)
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1255	);
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1256	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1257
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1258	if ( $deprecated_echo ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1259	echo get_trackback_url();
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1260	} else {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1261	return get_trackback_url();
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1262	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1263	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1264
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1265	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1266	* Generates and displays the RDF for the trackback information of current post.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1267	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1268	* Deprecated in 3.0.0, and restored in 3.0.1.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1269	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1270	* @since 0.71
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1271	*
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1272	* @param int\|string $deprecated Not used (Was $timezone = 0).
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1273	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1274	function trackback_rdf( $deprecated = '' ) {
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1275	if ( ! empty( $deprecated ) ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1276	_deprecated_argument( __FUNCTION__, '2.5.0' );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1277	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1278
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1279	if ( isset( $_SERVER['HTTP_USER_AGENT'] ) && false !== stripos( $_SERVER['HTTP_USER_AGENT'], 'W3C_Validator' ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1280	return;
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1281	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1282
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1283	echo '<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1284	xmlns:dc="http://purl.org/dc/elements/1.1/"
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1285	xmlns:trackback="http://madskills.com/public/xml/rss/module/trackback/">
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1286	<rdf:Description rdf:about="';
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1287	the_permalink();
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1288	echo '"' . "\n";
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1289	echo ' dc:identifier="';
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1290	the_permalink();
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1291	echo '"' . "\n";
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1292	echo ' dc:title="' . str_replace( '--', '--', wptexturize( strip_tags( get_the_title() ) ) ) . '"' . "\n";
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1293	echo ' trackback:ping="' . get_trackback_url() . '"' . " />\n";
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1294	echo '</rdf:RDF>';
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1295	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1296
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1297	/**
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1298	* Determines whether the current post is open for comments.
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1299	*
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1300	* For more information on this and similar theme functions, check out
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1301	* the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1302	* Conditional Tags} article in the Theme Developer Handbook.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1303	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1304	* @since 1.5.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1305	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1306	* @param int\|WP_Post $post Optional. Post ID or WP_Post object. Default current post.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1307	* @return bool True if the comments are open.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1308	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1309	function comments_open( $post = null ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1310	$_post = get_post( $post );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1311
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1312	$post_id = $_post ? $_post->ID : 0;
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1313	$comments_open = ( $_post && ( 'open' === $_post->comment_status ) );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1314
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1315	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1316	* Filters whether the current post is open for comments.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1317	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1318	* @since 2.5.0
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1319	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1320	* @param bool $comments_open Whether the current post is open for comments.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1321	* @param int $post_id The post ID.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1322	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1323	return apply_filters( 'comments_open', $comments_open, $post_id );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1324	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1325
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1326	/**
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1327	* Determines whether the current post is open for pings.
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1328	*
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1329	* For more information on this and similar theme functions, check out
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1330	* the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1331	* Conditional Tags} article in the Theme Developer Handbook.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1332	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1333	* @since 1.5.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1334	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1335	* @param int\|WP_Post $post Optional. Post ID or WP_Post object. Default current post.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1336	* @return bool True if pings are accepted
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1337	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1338	function pings_open( $post = null ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1339	$_post = get_post( $post );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1340
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1341	$post_id = $_post ? $_post->ID : 0;
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1342	$pings_open = ( $_post && ( 'open' === $_post->ping_status ) );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1343
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1344	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1345	* Filters whether the current post is open for pings.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1346	*
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1347	* @since 2.5.0
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1348	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1349	* @param bool $pings_open Whether the current post is open for pings.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1350	* @param int $post_id The post ID.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1351	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1352	return apply_filters( 'pings_open', $pings_open, $post_id );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1353	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1354
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1355	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1356	* Displays form token for unfiltered comments.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1357	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1358	* Will only display nonce token if the current user has permissions for
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1359	* unfiltered html. Won't display the token for other users.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1360	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1361	* The function was backported to 2.0.10 and was added to versions 2.1.3 and
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1362	* above. Does not exist in versions prior to 2.0.10 in the 2.0 branch and in
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1363	* the 2.1 branch, prior to 2.1.3. Technically added in 2.2.0.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1364	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1365	* Backported to 2.0.10.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1366	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1367	* @since 2.1.3
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1368	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1369	function wp_comment_form_unfiltered_html_nonce() {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1370	$post = get_post();
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1371	$post_id = $post ? $post->ID : 0;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1372
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1373	if ( current_user_can( 'unfiltered_html' ) ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1374	wp_nonce_field( 'unfiltered-html-comment_' . $post_id, '_wp_unfiltered_html_comment_disabled', false );
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1375	wp_print_inline_script_tag( "(function(){if(window===window.parent){document.getElementById('_wp_unfiltered_html_comment_disabled').name='_wp_unfiltered_html_comment';}})();" );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1376	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1377	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1378
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1379	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1380	* Loads the comment template specified in $file.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1381	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1382	* Will not display the comments template if not on single post or page, or if
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1383	* the post does not have comments.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1384	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1385	* Uses the WordPress database object to query for the comments. The comments
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1386	* are passed through the {@see 'comments_array'} filter hook with the list of comments
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1387	* and the post ID respectively.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1388	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1389	* The `$file` path is passed through a filter hook called {@see 'comments_template'},
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1390	* which includes the template directory and $file combined. Tries the $filtered path
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1391	* first and if it fails it will require the default comment template from the
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1392	* default theme. If either does not exist, then the WordPress process will be
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1393	* halted. It is advised for that reason, that the default theme is not deleted.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1394	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1395	* Will not try to get the comments if the post has none.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1396	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1397	* @since 1.5.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1398	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1399	* @global WP_Query $wp_query WordPress Query object.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1400	* @global WP_Post $post Global post object.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1401	* @global wpdb $wpdb WordPress database abstraction object.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1402	* @global int $id
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1403	* @global WP_Comment $comment Global comment object.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1404	* @global string $user_login
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1405	* @global string $user_identity
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1406	* @global bool $overridden_cpage
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1407	* @global bool $withcomments
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1408	* @global string $wp_stylesheet_path Path to current theme's stylesheet directory.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1409	* @global string $wp_template_path Path to current theme's template directory.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1410	*
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1411	* @param string $file Optional. The file to load. Default '/comments.php'.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1412	* @param bool $separate_comments Optional. Whether to separate the comments by comment type.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1413	* Default false.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1414	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1415	function comments_template( $file = '/comments.php', $separate_comments = false ) {
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1416	global $wp_query, $withcomments, $post, $wpdb, $id, $comment, $user_login, $user_identity, $overridden_cpage, $wp_stylesheet_path, $wp_template_path;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1417
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1418	if ( ! ( is_single() \|\| is_page() \|\| $withcomments ) \|\| empty( $post ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1419	return;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1420	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1421
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1422	if ( empty( $file ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1423	$file = '/comments.php';
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1424	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1425
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1426	$req = get_option( 'require_name_email' );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1427
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1428	/*
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1429	* Comment author information fetched from the comment cookies.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1430	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1431	$commenter = wp_get_current_commenter();
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1432
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1433	/*
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1434	* The name of the current comment author escaped for use in attributes.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1435	* Escaped by sanitize_comment_cookies().
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1436	*/
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1437	$comment_author = $commenter['comment_author'];
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1438
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1439	/*
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1440	* The email address of the current comment author escaped for use in attributes.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1441	* Escaped by sanitize_comment_cookies().
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1442	*/
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1443	$comment_author_email = $commenter['comment_author_email'];
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1444
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1445	/*
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1446	* The URL of the current comment author escaped for use in attributes.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1447	*/
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1448	$comment_author_url = esc_url( $commenter['comment_author_url'] );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1449
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1450	$comment_args = array(
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1451	'orderby' => 'comment_date_gmt',
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1452	'order' => 'ASC',
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1453	'status' => 'approve',
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1454	'post_id' => $post->ID,
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1455	'no_found_rows' => false,
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1456	);
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1457
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1458	if ( get_option( 'thread_comments' ) ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1459	$comment_args['hierarchical'] = 'threaded';
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1460	} else {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1461	$comment_args['hierarchical'] = false;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1462	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1463
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1464	if ( is_user_logged_in() ) {
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1465	$comment_args['include_unapproved'] = array( get_current_user_id() );
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1466	} else {
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1467	$unapproved_email = wp_get_unapproved_comment_author_email();
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1468
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1469	if ( $unapproved_email ) {
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1470	$comment_args['include_unapproved'] = array( $unapproved_email );
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1471	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1472	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1473
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1474	$per_page = 0;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1475	if ( get_option( 'page_comments' ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1476	$per_page = (int) get_query_var( 'comments_per_page' );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1477	if ( 0 === $per_page ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1478	$per_page = (int) get_option( 'comments_per_page' );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1479	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1480
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1481	$comment_args['number'] = $per_page;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1482	$page = (int) get_query_var( 'cpage' );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1483
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1484	if ( $page ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1485	$comment_args['offset'] = ( $page - 1 ) * $per_page;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1486	} elseif ( 'oldest' === get_option( 'default_comments_page' ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1487	$comment_args['offset'] = 0;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1488	} else {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1489	// If fetching the first page of 'newest', we need a top-level comment count.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1490	$top_level_query = new WP_Comment_Query();
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1491	$top_level_args = array(
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1492	'count' => true,
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1493	'orderby' => false,
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1494	'post_id' => $post->ID,
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1495	'status' => 'approve',
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1496	);
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1497
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1498	if ( $comment_args['hierarchical'] ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1499	$top_level_args['parent'] = 0;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1500	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1501
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1502	if ( isset( $comment_args['include_unapproved'] ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1503	$top_level_args['include_unapproved'] = $comment_args['include_unapproved'];
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1504	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1505
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1506	/**
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1507	* Filters the arguments used in the top level comments query.
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1508	*
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1509	* @since 5.6.0
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1510	*
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1511	* @see WP_Comment_Query::__construct()
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1512	*
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1513	* @param array $top_level_args {
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1514	* The top level query arguments for the comments template.
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1515	*
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1516	* @type bool $count Whether to return a comment count.
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1517	* @type string\|array $orderby The field(s) to order by.
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1518	* @type int $post_id The post ID.
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1519	* @type string\|array $status The comment status to limit results by.
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1520	* }
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1521	*/
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1522	$top_level_args = apply_filters( 'comments_template_top_level_query_args', $top_level_args );
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1523
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1524	$top_level_count = $top_level_query->query( $top_level_args );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1525
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1526	$comment_args['offset'] = ( (int) ceil( $top_level_count / $per_page ) - 1 ) * $per_page;
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1527	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1528	}
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1529
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1530	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1531	* Filters the arguments used to query comments in comments_template().
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1532	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1533	* @since 4.5.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1534	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1535	* @see WP_Comment_Query::__construct()
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1536	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1537	* @param array $comment_args {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1538	* Array of WP_Comment_Query arguments.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1539	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1540	* @type string\|array $orderby Field(s) to order by.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1541	* @type string $order Order of results. Accepts 'ASC' or 'DESC'.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1542	* @type string $status Comment status.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1543	* @type array $include_unapproved Array of IDs or email addresses whose unapproved comments
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1544	* will be included in results.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1545	* @type int $post_id ID of the post.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1546	* @type bool $no_found_rows Whether to refrain from querying for found rows.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1547	* @type bool $update_comment_meta_cache Whether to prime cache for comment meta.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1548	* @type bool\|string $hierarchical Whether to query for comments hierarchically.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1549	* @type int $offset Comment offset.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1550	* @type int $number Number of comments to fetch.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1551	* }
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1552	*/
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1553	$comment_args = apply_filters( 'comments_template_query_args', $comment_args );
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1554
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1555	$comment_query = new WP_Comment_Query( $comment_args );
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1556	$_comments = $comment_query->comments;
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1557
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1558	// Trees must be flattened before they're passed to the walker.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1559	if ( $comment_args['hierarchical'] ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1560	$comments_flat = array();
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1561	foreach ( $_comments as $_comment ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1562	$comments_flat[] = $_comment;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1563	$comment_children = $_comment->get_children(
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1564	array(
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1565	'format' => 'flat',
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1566	'status' => $comment_args['status'],
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1567	'orderby' => $comment_args['orderby'],
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1568	)
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1569	);
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1570
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1571	foreach ( $comment_children as $comment_child ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1572	$comments_flat[] = $comment_child;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1573	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1574	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1575	} else {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1576	$comments_flat = $_comments;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1577	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1578
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1579	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1580	* Filters the comments array.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1581	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1582	* @since 2.1.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1583	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1584	* @param array $comments Array of comments supplied to the comments template.
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1585	* @param int $post_id Post ID.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1586	*/
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1587	$wp_query->comments = apply_filters( 'comments_array', $comments_flat, $post->ID );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1588
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1589	$comments = &$wp_query->comments;
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1590	$wp_query->comment_count = count( $wp_query->comments );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1591	$wp_query->max_num_comment_pages = $comment_query->max_num_pages;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1592
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1593	if ( $separate_comments ) {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1594	$wp_query->comments_by_type = separate_comments( $comments );
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1595	$comments_by_type = &$wp_query->comments_by_type;
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1596	} else {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1597	$wp_query->comments_by_type = array();
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1598	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1599
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1600	$overridden_cpage = false;
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1601
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1602	if ( '' == get_query_var( 'cpage' ) && $wp_query->max_num_comment_pages > 1 ) {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1603	set_query_var( 'cpage', 'newest' === get_option( 'default_comments_page' ) ? get_comment_pages_count() : 1 );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1604	$overridden_cpage = true;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1605	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1606
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1607	if ( ! defined( 'COMMENTS_TEMPLATE' ) ) {
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1608	define( 'COMMENTS_TEMPLATE', true );
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1609	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1610
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1611	$theme_template = trailingslashit( $wp_stylesheet_path ) . $file;
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1612
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1613	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1614	* Filters the path to the theme template file used for the comments template.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1615	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1616	* @since 1.5.1
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1617	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1618	* @param string $theme_template The path to the theme template file.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1619	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1620	$include = apply_filters( 'comments_template', $theme_template );
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1621
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1622	if ( file_exists( $include ) ) {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1623	require $include;
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1624	} elseif ( file_exists( trailingslashit( $wp_template_path ) . $file ) ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1625	require trailingslashit( $wp_template_path ) . $file;
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1626	} else { // Backward compat code will be removed in a future release.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1627	require ABSPATH . WPINC . '/theme-compat/comments.php';
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1628	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1629	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1630
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1631	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1632	* Displays the link to the comments for the current post ID.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1633	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1634	* @since 0.71
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1635	*
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1636	* @param false\|string $zero Optional. String to display when no comments. Default false.
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1637	* @param false\|string $one Optional. String to display when only one comment is available. Default false.
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1638	* @param false\|string $more Optional. String to display when there are more than one comment. Default false.
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1639	* @param string $css_class Optional. CSS class to use for comments. Default empty.
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1640	* @param false\|string $none Optional. String to display when comments have been turned off. Default false.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1641	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1642	function comments_popup_link( $zero = false, $one = false, $more = false, $css_class = '', $none = false ) {
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1643	$post_id = get_the_ID();
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1644	$post_title = get_the_title();
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1645	$comments_number = get_comments_number( $post_id );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1646
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1647	if ( false === $zero ) {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1648	/* translators: %s: Post title. */
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1649	$zero = sprintf( __( 'No Comments<span class="screen-reader-text"> on %s</span>' ), $post_title );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1650	}
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1651
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1652	if ( false === $one ) {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1653	/* translators: %s: Post title. */
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1654	$one = sprintf( __( '1 Comment<span class="screen-reader-text"> on %s</span>' ), $post_title );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1655	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1656
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1657	if ( false === $more ) {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1658	/* translators: 1: Number of comments, 2: Post title. */
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1659	$more = _n(
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1660	'%1$s Comment<span class="screen-reader-text"> on %2$s</span>',
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1661	'%1$s Comments<span class="screen-reader-text"> on %2$s</span>',
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1662	$comments_number
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1663	);
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1664	$more = sprintf( $more, number_format_i18n( $comments_number ), $post_title );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1665	}
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1666
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1667	if ( false === $none ) {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1668	/* translators: %s: Post title. */
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1669	$none = sprintf( __( 'Comments Off<span class="screen-reader-text"> on %s</span>' ), $post_title );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1670	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1671
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1672	if ( 0 == $comments_number && ! comments_open() && ! pings_open() ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1673	printf(
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1674	'<span%1$s>%2$s</span>',
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1675	! empty( $css_class ) ? ' class="' . esc_attr( $css_class ) . '"' : '',
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1676	$none
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1677	);
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1678	return;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1679	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1680
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1681	if ( post_password_required() ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1682	_e( 'Enter your password to view comments.' );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1683	return;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1684	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1685
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1686	if ( 0 == $comments_number ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1687	$respond_link = get_permalink() . '#respond';
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1688	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1689	* Filters the respond link when a post has no comments.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1690	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1691	* @since 4.4.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1692	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1693	* @param string $respond_link The default response link.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1694	* @param int $post_id The post ID.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1695	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1696	$comments_link = apply_filters( 'respond_link', $respond_link, $post_id );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1697	} else {
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1698	$comments_link = get_comments_link();
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1699	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1700
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1701	$link_attributes = '';
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1702
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1703	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1704	* Filters the comments link attributes for display.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1705	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1706	* @since 2.5.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1707	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1708	* @param string $link_attributes The comments link attributes. Default empty.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1709	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1710	$link_attributes = apply_filters( 'comments_popup_link_attributes', $link_attributes );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1711
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1712	printf(
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1713	'<a href="%1$s"%2$s%3$s>%4$s</a>',
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1714	esc_url( $comments_link ),
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1715	! empty( $css_class ) ? ' class="' . $css_class . '" ' : '',
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1716	$link_attributes,
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1717	get_comments_number_text( $zero, $one, $more )
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1718	);
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1719	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1720
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1721	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1722	* Retrieves HTML content for reply to comment link.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1723	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1724	* @since 2.7.0
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1725	* @since 4.4.0 Added the ability for `$comment` to also accept a WP_Comment object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1726	*
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1727	* @param array $args {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1728	* Optional. Override default arguments.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1729	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1730	* @type string $add_below The first part of the selector used to identify the comment to respond below.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1731	* The resulting value is passed as the first parameter to addComment.moveForm(),
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1732	* concatenated as $add_below-$comment->comment_ID. Default 'comment'.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1733	* @type string $respond_id The selector identifying the responding comment. Passed as the third parameter
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1734	* to addComment.moveForm(), and appended to the link URL as a hash value.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1735	* Default 'respond'.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1736	* @type string $reply_text The text of the Reply link. Default 'Reply'.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1737	* @type string $login_text The text of the link to reply if logged out. Default 'Log in to Reply'.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1738	* @type int $max_depth The max depth of the comment tree. Default 0.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1739	* @type int $depth The depth of the new comment. Must be greater than 0 and less than the value
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1740	* of the 'thread_comments_depth' option set in Settings > Discussion. Default 0.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1741	* @type string $before The text or HTML to add before the reply link. Default empty.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1742	* @type string $after The text or HTML to add after the reply link. Default empty.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1743	* }
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1744	* @param int\|WP_Comment $comment Optional. Comment being replied to. Default current comment.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1745	* @param int\|WP_Post $post Optional. Post ID or WP_Post object the comment is going to be displayed on.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1746	* Default current post.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1747	* @return string\|false\|null Link to show comment form, if successful. False, if comments are closed.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1748	*/
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1749	function get_comment_reply_link( $args = array(), $comment = null, $post = null ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1750	$defaults = array(
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1751	'add_below' => 'comment',
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1752	'respond_id' => 'respond',
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1753	'reply_text' => __( 'Reply' ),
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1754	/* translators: Comment reply button text. %s: Comment author name. */
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1755	'reply_to_text' => __( 'Reply to %s' ),
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1756	'login_text' => __( 'Log in to Reply' ),
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1757	'max_depth' => 0,
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1758	'depth' => 0,
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1759	'before' => '',
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1760	'after' => '',
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1761	);
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1762
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1763	$args = wp_parse_args( $args, $defaults );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1764
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1765	if ( 0 == $args['depth'] \|\| $args['max_depth'] <= $args['depth'] ) {
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1766	return;
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1767	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1768
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1769	$comment = get_comment( $comment );
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1770
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1771	if ( empty( $comment ) ) {
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1772	return;
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1773	}
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1774
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1775	if ( empty( $post ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1776	$post = $comment->comment_post_ID;
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1777	}
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1778
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1779	$post = get_post( $post );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1780
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1781	if ( ! comments_open( $post->ID ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1782	return false;
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1783	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1784
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1785	if ( get_option( 'page_comments' ) ) {
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1786	$permalink = str_replace( '#comment-' . $comment->comment_ID, '', get_comment_link( $comment ) );
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1787	} else {
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1788	$permalink = get_permalink( $post->ID );
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1789	}
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1790
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1791	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1792	* Filters the comment reply link arguments.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1793	*
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1794	* @since 4.1.0
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1795	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1796	* @param array $args Comment reply link arguments. See get_comment_reply_link()
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1797	* for more information on accepted arguments.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1798	* @param WP_Comment $comment The object of the comment being replied to.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1799	* @param WP_Post $post The WP_Post object.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1800	*/
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1801	$args = apply_filters( 'comment_reply_link_args', $args, $comment, $post );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1802
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1803	if ( get_option( 'comment_registration' ) && ! is_user_logged_in() ) {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1804	$link = sprintf(
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1805	'<a rel="nofollow" class="comment-reply-login" href="%s">%s</a>',
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1806	esc_url( wp_login_url( get_permalink() ) ),
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1807	$args['login_text']
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1808	);
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1809	} else {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1810	$data_attributes = array(
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1811	'commentid' => $comment->comment_ID,
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1812	'postid' => $post->ID,
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1813	'belowelement' => $args['add_below'] . '-' . $comment->comment_ID,
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1814	'respondelement' => $args['respond_id'],
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	1815	'replyto' => sprintf( $args['reply_to_text'], get_comment_author( $comment ) ),
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1816	);
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1817
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1818	$data_attribute_string = '';
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1819
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1820	foreach ( $data_attributes as $name => $value ) {
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1821	$data_attribute_string .= " data-{$name}=\"" . esc_attr( $value ) . '"';
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1822	}
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1823
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1824	$data_attribute_string = trim( $data_attribute_string );
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1825
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1826	$link = sprintf(
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1827	"<a rel='nofollow' class='comment-reply-link' href='%s' %s aria-label='%s'>%s</a>",
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1828	esc_url(
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1829	add_query_arg(
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1830	array(
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1831	'replytocom' => $comment->comment_ID,
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1832	'unapproved' => false,
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1833	'moderation-hash' => false,
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1834	),
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	1835	$permalink
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1836	)
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1837	) . '#' . $args['respond_id'],
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1838	$data_attribute_string,
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	1839	esc_attr( sprintf( $args['reply_to_text'], get_comment_author( $comment ) ) ),
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1840	$args['reply_text']
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1841	);
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1842	}
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1843
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1844	$comment_reply_link = $args['before'] . $link . $args['after'];
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1845
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1846	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1847	* Filters the comment reply link.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1848	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1849	* @since 2.7.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1850	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1851	* @param string $comment_reply_link The HTML markup for the comment reply link.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1852	* @param array $args An array of arguments overriding the defaults.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1853	* @param WP_Comment $comment The object of the comment being replied.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1854	* @param WP_Post $post The WP_Post object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1855	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1856	return apply_filters( 'comment_reply_link', $comment_reply_link, $args, $comment, $post );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1857	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1858
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1859	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1860	* Displays the HTML content for reply to comment link.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1861	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1862	* @since 2.7.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1863	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1864	* @see get_comment_reply_link()
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1865	*
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1866	* @param array $args Optional. Override default options. Default empty array.
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1867	* @param int\|WP_Comment $comment Optional. Comment being replied to. Default current comment.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1868	* @param int\|WP_Post $post Optional. Post ID or WP_Post object the comment is going to be displayed on.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1869	* Default current post.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1870	*/
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1871	function comment_reply_link( $args = array(), $comment = null, $post = null ) {
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1872	echo get_comment_reply_link( $args, $comment, $post );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1873	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1874
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1875	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1876	* Retrieves HTML content for reply to post link.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1877	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1878	* @since 2.7.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1879	*
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1880	* @param array $args {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1881	* Optional. Override default arguments.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1882	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1883	* @type string $add_below The first part of the selector used to identify the comment to respond below.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1884	* The resulting value is passed as the first parameter to addComment.moveForm(),
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1885	* concatenated as $add_below-$comment->comment_ID. Default is 'post'.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1886	* @type string $respond_id The selector identifying the responding comment. Passed as the third parameter
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1887	* to addComment.moveForm(), and appended to the link URL as a hash value.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1888	* Default 'respond'.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1889	* @type string $reply_text Text of the Reply link. Default is 'Leave a Comment'.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1890	* @type string $login_text Text of the link to reply if logged out. Default is 'Log in to leave a Comment'.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1891	* @type string $before Text or HTML to add before the reply link. Default empty.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1892	* @type string $after Text or HTML to add after the reply link. Default empty.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1893	* }
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1894	* @param int\|WP_Post $post Optional. Post ID or WP_Post object the comment is going to be displayed on.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1895	* Default current post.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1896	* @return string\|false\|null Link to show comment form, if successful. False, if comments are closed.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1897	*/
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1898	function get_post_reply_link( $args = array(), $post = null ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1899	$defaults = array(
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1900	'add_below' => 'post',
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1901	'respond_id' => 'respond',
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1902	'reply_text' => __( 'Leave a Comment' ),
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1903	'login_text' => __( 'Log in to leave a Comment' ),
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1904	'before' => '',
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1905	'after' => '',
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1906	);
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1907
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1908	$args = wp_parse_args( $args, $defaults );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1909
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1910	$post = get_post( $post );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1911
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1912	if ( ! comments_open( $post->ID ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1913	return false;
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1914	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1915
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1916	if ( get_option( 'comment_registration' ) && ! is_user_logged_in() ) {
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1917	$link = sprintf(
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1918	'<a rel="nofollow" class="comment-reply-login" href="%s">%s</a>',
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1919	wp_login_url( get_permalink() ),
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1920	$args['login_text']
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1921	);
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1922	} else {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1923	$onclick = sprintf(
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1924	'return addComment.moveForm( "%1$s-%2$s", "0", "%3$s", "%2$s" )',
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1925	$args['add_below'],
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1926	$post->ID,
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1927	$args['respond_id']
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1928	);
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1929
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1930	$link = sprintf(
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1931	"<a rel='nofollow' class='comment-reply-link' href='%s' onclick='%s'>%s</a>",
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1932	get_permalink( $post->ID ) . '#' . $args['respond_id'],
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1933	$onclick,
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1934	$args['reply_text']
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1935	);
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1936	}
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1937
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1938	$post_reply_link = $args['before'] . $link . $args['after'];
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1939
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1940	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1941	* Filters the formatted post comments link HTML.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1942	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1943	* @since 2.7.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1944	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1945	* @param string $post_reply_link The HTML-formatted post comments link.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1946	* @param int\|WP_Post $post The post ID or WP_Post object.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1947	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1948	return apply_filters( 'post_comments_link', $post_reply_link, $post );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1949	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1950
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1951	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1952	* Displays the HTML content for reply to post link.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1953	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1954	* @since 2.7.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1955	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1956	* @see get_post_reply_link()
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1957	*
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1958	* @param array $args Optional. Override default options. Default empty array.
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1959	* @param int\|WP_Post $post Optional. Post ID or WP_Post object the comment is going to be displayed on.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1960	* Default current post.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1961	*/
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1962	function post_reply_link( $args = array(), $post = null ) {
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1963	echo get_post_reply_link( $args, $post );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1964	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1965
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1966	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	1967	* Retrieves HTML content for cancel comment reply link.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1968	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1969	* @since 2.7.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1970	* @since 6.2.0 Added the `$post` parameter.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1971	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1972	* @param string $link_text Optional. Text to display for cancel reply link. If empty,
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1973	* defaults to 'Click here to cancel reply'. Default empty.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1974	* @param int\|WP_Post\|null $post Optional. The post the comment thread is being
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1975	* displayed for. Defaults to the current global post.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1976	* @return string
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1977	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1978	function get_cancel_comment_reply_link( $link_text = '', $post = null ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1979	if ( empty( $link_text ) ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1980	$link_text = __( 'Click here to cancel reply.' );
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	1981	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1982
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1983	$post = get_post( $post );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1984	$reply_to_id = $post ? _get_comment_reply_id( $post->ID ) : 0;
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1985	$link_style = 0 !== $reply_to_id ? '' : ' style="display:none;"';
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1986	$link_url = esc_url( remove_query_arg( array( 'replytocom', 'unapproved', 'moderation-hash' ) ) ) . '#respond';
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1987
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1988	$cancel_comment_reply_link = sprintf(
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1989	'<a rel="nofollow" id="cancel-comment-reply-link" href="%1$s"%2$s>%3$s</a>',
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1990	$link_url,
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1991	$link_style,
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1992	$link_text
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	1993	);
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1994
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1995	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1996	* Filters the cancel comment reply link HTML.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1997	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1998	* @since 2.7.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1999	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2000	* @param string $cancel_comment_reply_link The HTML-formatted cancel comment reply link.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2001	* @param string $link_url Cancel comment reply link URL.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2002	* @param string $link_text Cancel comment reply link text.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2003	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2004	return apply_filters( 'cancel_comment_reply_link', $cancel_comment_reply_link, $link_url, $link_text );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2005	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2006
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2007	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2008	* Displays HTML content for cancel comment reply link.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2009	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2010	* @since 2.7.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2011	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2012	* @param string $link_text Optional. Text to display for cancel reply link. If empty,
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2013	* defaults to 'Click here to cancel reply'. Default empty.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2014	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2015	function cancel_comment_reply_link( $link_text = '' ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2016	echo get_cancel_comment_reply_link( $link_text );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2017	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2018
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2019	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2020	* Retrieves hidden input HTML for replying to comments.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2021	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2022	* @since 3.0.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2023	* @since 6.2.0 Renamed `$post_id` to `$post` and added WP_Post support.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2024	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2025	* @param int\|WP_Post\|null $post Optional. The post the comment is being displayed for.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2026	* Defaults to the current global post.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2027	* @return string Hidden input HTML for replying to comments.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2028	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2029	function get_comment_id_fields( $post = null ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2030	$post = get_post( $post );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2031	if ( ! $post ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2032	return '';
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2033	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2034
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2035	$post_id = $post->ID;
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2036	$reply_to_id = _get_comment_reply_id( $post_id );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2037
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2038	$comment_id_fields = "<input type='hidden' name='comment_post_ID' value='$post_id' id='comment_post_ID' />\n";
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2039	$comment_id_fields .= "<input type='hidden' name='comment_parent' id='comment_parent' value='$reply_to_id' />\n";
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2040
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2041	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2042	* Filters the returned comment ID fields.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2043	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2044	* @since 3.0.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2045	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2046	* @param string $comment_id_fields The HTML-formatted hidden ID field comment elements.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2047	* @param int $post_id The post ID.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2048	* @param int $reply_to_id The ID of the comment being replied to.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2049	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2050	return apply_filters( 'comment_id_fields', $comment_id_fields, $post_id, $reply_to_id );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2051	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2052
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2053	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2054	* Outputs hidden input HTML for replying to comments.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2055	*
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2056	* Adds two hidden inputs to the comment form to identify the `comment_post_ID`
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2057	* and `comment_parent` values for threaded comments.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2058	*
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2059	* This tag must be within the `<form>` section of the `comments.php` template.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2060	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2061	* @since 2.7.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2062	* @since 6.2.0 Renamed `$post_id` to `$post` and added WP_Post support.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2063	*
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2064	* @see get_comment_id_fields()
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2065	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2066	* @param int\|WP_Post\|null $post Optional. The post the comment is being displayed for.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2067	* Defaults to the current global post.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2068	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2069	function comment_id_fields( $post = null ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2070	echo get_comment_id_fields( $post );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2071	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2072
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2073	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2074	* Displays text based on comment reply status.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2075	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2076	* Only affects users with JavaScript disabled.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2077	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2078	* @internal The $comment global must be present to allow template tags access to the current
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2079	* comment. See https://core.trac.wordpress.org/changeset/36512.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2080	*
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2081	* @since 2.7.0
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2082	* @since 6.2.0 Added the `$post` parameter.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2083	*
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2084	* @global WP_Comment $comment Global comment object.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2085	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2086	* @param string\|false $no_reply_text Optional. Text to display when not replying to a comment.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2087	* Default false.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2088	* @param string\|false $reply_text Optional. Text to display when replying to a comment.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2089	* Default false. Accepts "%s" for the author of the comment
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2090	* being replied to.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2091	* @param bool $link_to_parent Optional. Boolean to control making the author's name a link
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2092	* to their comment. Default true.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2093	* @param int\|WP_Post\|null $post Optional. The post that the comment form is being displayed for.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2094	* Defaults to the current global post.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2095	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2096	function comment_form_title( $no_reply_text = false, $reply_text = false, $link_to_parent = true, $post = null ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2097	global $comment;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2098
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2099	if ( false === $no_reply_text ) {
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2100	$no_reply_text = __( 'Leave a Reply' );
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2101	}
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2102
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2103	if ( false === $reply_text ) {
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2104	/* translators: %s: Author of the comment being replied to. */
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2105	$reply_text = __( 'Leave a Reply to %s' );
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2106	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2107
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2108	$post = get_post( $post );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2109	if ( ! $post ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2110	echo $no_reply_text;
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2111	return;
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2112	}
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2113
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2114	$reply_to_id = _get_comment_reply_id( $post->ID );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2115
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2116	if ( 0 === $reply_to_id ) {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2117	echo $no_reply_text;
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2118	return;
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2119	}
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2120
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2121	// Sets the global so that template tags can be used in the comment form.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2122	$comment = get_comment( $reply_to_id );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2123
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2124	if ( $link_to_parent ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2125	$comment_author = sprintf(
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2126	'<a href="#comment-%1$s">%2$s</a>',
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2127	get_comment_ID(),
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2128	get_comment_author( $reply_to_id )
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2129	);
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2130	} else {
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2131	$comment_author = get_comment_author( $reply_to_id );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2132	}
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2133
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2134	printf( $reply_text, $comment_author );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2135	}
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2136
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2137	/**
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2138	* Gets the comment's reply to ID from the $_GET['replytocom'].
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2139	*
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2140	* @since 6.2.0
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2141	*
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2142	* @access private
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2143	*
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2144	* @param int\|WP_Post $post The post the comment is being displayed for.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2145	* Defaults to the current global post.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2146	* @return int Comment's reply to ID.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2147	*/
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2148	function _get_comment_reply_id( $post = null ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2149	$post = get_post( $post );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2150
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2151	if ( ! $post \|\| ! isset( $_GET['replytocom'] ) \|\| ! is_numeric( $_GET['replytocom'] ) ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2152	return 0;
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2153	}
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2154
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2155	$reply_to_id = (int) $_GET['replytocom'];
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2156
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2157	/*
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2158	* Validate the comment.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2159	* Bail out if it does not exist, is not approved, or its
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2160	* `comment_post_ID` does not match the given post ID.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2161	*/
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2162	$comment = get_comment( $reply_to_id );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2163
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2164	if (
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2165	! $comment instanceof WP_Comment \|\|
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2166	0 === (int) $comment->comment_approved \|\|
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2167	$post->ID !== (int) $comment->comment_post_ID
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2168	) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2169	return 0;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2170	}
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2171
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2172	return $reply_to_id;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2173	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2174
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2175	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2176	* Displays a list of comments.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2177	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2178	* Used in the comments.php template to list comments for a particular post.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2179	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2180	* @since 2.7.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2181	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2182	* @see WP_Query::$comments
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2183	*
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2184	* @global WP_Query $wp_query WordPress Query object.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2185	* @global int $comment_alt
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2186	* @global int $comment_depth
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2187	* @global int $comment_thread_alt
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2188	* @global bool $overridden_cpage
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2189	* @global bool $in_comment_loop
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2190	*
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2191	* @param string\|array $args {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2192	* Optional. Formatting options.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2193	*
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2194	* @type object $walker Instance of a Walker class to list comments. Default null.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2195	* @type int $max_depth The maximum comments depth. Default empty.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2196	* @type string $style The style of list ordering. Accepts 'ul', 'ol', or 'div'.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2197	* 'div' will result in no additional list markup. Default 'ul'.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2198	* @type callable $callback Callback function to use. Default null.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2199	* @type callable $end-callback Callback function to use at the end. Default null.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2200	* @type string $type Type of comments to list. Accepts 'all', 'comment',
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2201	* 'pingback', 'trackback', 'pings'. Default 'all'.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2202	* @type int $page Page ID to list comments for. Default empty.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2203	* @type int $per_page Number of comments to list per page. Default empty.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2204	* @type int $avatar_size Height and width dimensions of the avatar size. Default 32.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2205	* @type bool $reverse_top_level Ordering of the listed comments. If true, will display
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2206	* newest comments first. Default null.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2207	* @type bool $reverse_children Whether to reverse child comments in the list. Default null.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2208	* @type string $format How to format the comments list. Accepts 'html5', 'xhtml'.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2209	* Default 'html5' if the theme supports it.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2210	* @type bool $short_ping Whether to output short pings. Default false.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2211	* @type bool $echo Whether to echo the output or return it. Default true.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2212	* }
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2213	* @param WP_Comment[] $comments Optional. Array of WP_Comment objects. Default null.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2214	* @return void\|string Void if 'echo' argument is true, or no comments to list.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2215	* Otherwise, HTML list of comments.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2216	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2217	function wp_list_comments( $args = array(), $comments = null ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2218	global $wp_query, $comment_alt, $comment_depth, $comment_thread_alt, $overridden_cpage, $in_comment_loop;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2219
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2220	$in_comment_loop = true;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2221
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2222	$comment_alt = 0;
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2223	$comment_thread_alt = 0;
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2224	$comment_depth = 1;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2225
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2226	$defaults = array(
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2227	'walker' => null,
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2228	'max_depth' => '',
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2229	'style' => 'ul',
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2230	'callback' => null,
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2231	'end-callback' => null,
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2232	'type' => 'all',
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2233	'page' => '',
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2234	'per_page' => '',
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2235	'avatar_size' => 32,
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2236	'reverse_top_level' => null,
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2237	'reverse_children' => '',
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2238	'format' => current_theme_supports( 'html5', 'comment-list' ) ? 'html5' : 'xhtml',
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2239	'short_ping' => false,
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2240	'echo' => true,
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2241	);
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2242
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2243	$parsed_args = wp_parse_args( $args, $defaults );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2244
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2245	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2246	* Filters the arguments used in retrieving the comment list.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2247	*
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2248	* @since 4.0.0
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2249	*
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2250	* @see wp_list_comments()
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2251	*
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2252	* @param array $parsed_args An array of arguments for displaying comments.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2253	*/
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2254	$parsed_args = apply_filters( 'wp_list_comments_args', $parsed_args );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2255
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2256	// Figure out what comments we'll be looping through ($_comments).
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2257	if ( null !== $comments ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2258	$comments = (array) $comments;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2259	if ( empty( $comments ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2260	return;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2261	}
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2262	if ( 'all' !== $parsed_args['type'] ) {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2263	$comments_by_type = separate_comments( $comments );
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2264	if ( empty( $comments_by_type[ $parsed_args['type'] ] ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2265	return;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2266	}
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2267	$_comments = $comments_by_type[ $parsed_args['type'] ];
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2268	} else {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2269	$_comments = $comments;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2270	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2271	} else {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2272	/*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2273	* If 'page' or 'per_page' has been passed, and does not match what's in $wp_query,
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2274	* perform a separate comment query and allow Walker_Comment to paginate.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2275	*/
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2276	if ( $parsed_args['page'] \|\| $parsed_args['per_page'] ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2277	$current_cpage = get_query_var( 'cpage' );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2278	if ( ! $current_cpage ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2279	$current_cpage = 'newest' === get_option( 'default_comments_page' ) ? 1 : $wp_query->max_num_comment_pages;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2280	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2281
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2282	$current_per_page = get_query_var( 'comments_per_page' );
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2283	if ( $parsed_args['page'] != $current_cpage \|\| $parsed_args['per_page'] != $current_per_page ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2284	$comment_args = array(
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2285	'post_id' => get_the_ID(),
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2286	'orderby' => 'comment_date_gmt',
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2287	'order' => 'ASC',
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2288	'status' => 'approve',
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2289	);
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2290
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2291	if ( is_user_logged_in() ) {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2292	$comment_args['include_unapproved'] = array( get_current_user_id() );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2293	} else {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2294	$unapproved_email = wp_get_unapproved_comment_author_email();
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2295
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2296	if ( $unapproved_email ) {
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2297	$comment_args['include_unapproved'] = array( $unapproved_email );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2298	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2299	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2300
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2301	$comments = get_comments( $comment_args );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2302
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2303	if ( 'all' !== $parsed_args['type'] ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2304	$comments_by_type = separate_comments( $comments );
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2305	if ( empty( $comments_by_type[ $parsed_args['type'] ] ) ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2306	return;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2307	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2308
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2309	$_comments = $comments_by_type[ $parsed_args['type'] ];
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2310	} else {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2311	$_comments = $comments;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2312	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2313	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2314
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2315	// Otherwise, fall back on the comments from `$wp_query->comments`.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2316	} else {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2317	if ( empty( $wp_query->comments ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2318	return;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2319	}
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2320	if ( 'all' !== $parsed_args['type'] ) {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2321	if ( empty( $wp_query->comments_by_type ) ) {
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2322	$wp_query->comments_by_type = separate_comments( $wp_query->comments );
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2323	}
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2324	if ( empty( $wp_query->comments_by_type[ $parsed_args['type'] ] ) ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2325	return;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2326	}
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2327	$_comments = $wp_query->comments_by_type[ $parsed_args['type'] ];
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2328	} else {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2329	$_comments = $wp_query->comments;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2330	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2331
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2332	if ( $wp_query->max_num_comment_pages ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2333	$default_comments_page = get_option( 'default_comments_page' );
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2334	$cpage = get_query_var( 'cpage' );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2335	if ( 'newest' === $default_comments_page ) {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2336	$parsed_args['cpage'] = $cpage;
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2337
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2338	/*
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2339	* When first page shows oldest comments, post permalink is the same as
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2340	* the comment permalink.
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2341	*/
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2342	} elseif ( 1 == $cpage ) {
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2343	$parsed_args['cpage'] = '';
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2344	} else {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2345	$parsed_args['cpage'] = $cpage;
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2346	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2347
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2348	$parsed_args['page'] = 0;
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2349	$parsed_args['per_page'] = 0;
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2350	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2351	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2352	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2353
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2354	if ( '' === $parsed_args['per_page'] && get_option( 'page_comments' ) ) {
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2355	$parsed_args['per_page'] = get_query_var( 'comments_per_page' );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2356	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2357
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2358	if ( empty( $parsed_args['per_page'] ) ) {
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2359	$parsed_args['per_page'] = 0;
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2360	$parsed_args['page'] = 0;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2361	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2362
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2363	if ( '' === $parsed_args['max_depth'] ) {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2364	if ( get_option( 'thread_comments' ) ) {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2365	$parsed_args['max_depth'] = get_option( 'thread_comments_depth' );
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2366	} else {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2367	$parsed_args['max_depth'] = -1;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2368	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2369	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2370
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2371	if ( '' === $parsed_args['page'] ) {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2372	if ( empty( $overridden_cpage ) ) {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2373	$parsed_args['page'] = get_query_var( 'cpage' );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2374	} else {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2375	$threaded = ( -1 != $parsed_args['max_depth'] );
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2376	$parsed_args['page'] = ( 'newest' === get_option( 'default_comments_page' ) ) ? get_comment_pages_count( $_comments, $parsed_args['per_page'], $threaded ) : 1;
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2377	set_query_var( 'cpage', $parsed_args['page'] );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2378	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2379	}
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2380	// Validation check.
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	2381	$parsed_args['page'] = (int) $parsed_args['page'];
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2382	if ( 0 == $parsed_args['page'] && 0 != $parsed_args['per_page'] ) {
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2383	$parsed_args['page'] = 1;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2384	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2385
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2386	if ( null === $parsed_args['reverse_top_level'] ) {
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2387	$parsed_args['reverse_top_level'] = ( 'desc' === get_option( 'comment_order' ) );
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2388	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2389
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2390	if ( empty( $parsed_args['walker'] ) ) {
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2391	$walker = new Walker_Comment();
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2392	} else {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2393	$walker = $parsed_args['walker'];
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2394	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2395
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2396	$output = $walker->paged_walk( $_comments, $parsed_args['max_depth'], $parsed_args['page'], $parsed_args['per_page'], $parsed_args );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2397
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2398	$in_comment_loop = false;
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2399
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2400	if ( $parsed_args['echo'] ) {
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2401	echo $output;
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2402	} else {
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2403	return $output;
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2404	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2405	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2406
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2407	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2408	* Outputs a complete commenting form for use within a template.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2409	*
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	2410	* Most strings and form fields may be controlled through the `$args` array passed
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2411	* into the function, while you may also choose to use the {@see 'comment_form_default_fields'}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2412	* filter to modify the array of default fields if you'd just like to add a new
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2413	* one or remove a single field. All fields are also individually passed through
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	2414	* a filter of the {@see 'comment_form_field_$name'} where `$name` is the key used
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2415	* in the array of fields.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2416	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2417	* @since 3.0.0
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2418	* @since 4.1.0 Introduced the 'class_submit' argument.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2419	* @since 4.2.0 Introduced the 'submit_button' and 'submit_fields' arguments.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2420	* @since 4.4.0 Introduced the 'class_form', 'title_reply_before', 'title_reply_after',
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2421	* 'cancel_reply_before', and 'cancel_reply_after' arguments.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2422	* @since 4.5.0 The 'author', 'email', and 'url' form fields are limited to 245, 100,
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2423	* and 200 characters, respectively.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2424	* @since 4.6.0 Introduced the 'action' argument.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2425	* @since 4.9.6 Introduced the 'cookies' default comment field.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2426	* @since 5.5.0 Introduced the 'class_container' argument.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2427	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2428	* @param array $args {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2429	* Optional. Default arguments and form fields to override.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2430	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2431	* @type array $fields {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2432	* Default comment fields, filterable by default via the {@see 'comment_form_default_fields'} hook.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2433	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2434	* @type string $author Comment author field HTML.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2435	* @type string $email Comment author email field HTML.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2436	* @type string $url Comment author URL field HTML.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2437	* @type string $cookies Comment cookie opt-in field HTML.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2438	* }
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2439	* @type string $comment_field The comment textarea field HTML.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2440	* @type string $must_log_in HTML element for a 'must be logged in to comment' message.
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2441	* @type string $logged_in_as The HTML for the 'logged in as [user]' message, the Edit profile link,
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2442	* and the Log out link.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2443	* @type string $comment_notes_before HTML element for a message displayed before the comment fields
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2444	* if the user is not logged in.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2445	* Default 'Your email address will not be published.'.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2446	* @type string $comment_notes_after HTML element for a message displayed after the textarea field.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2447	* @type string $action The comment form element action attribute. Default '/wp-comments-post.php'.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2448	* @type string $id_form The comment form element id attribute. Default 'commentform'.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2449	* @type string $id_submit The comment submit element id attribute. Default 'submit'.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2450	* @type string $class_container The comment form container class attribute. Default 'comment-respond'.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2451	* @type string $class_form The comment form element class attribute. Default 'comment-form'.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2452	* @type string $class_submit The comment submit element class attribute. Default 'submit'.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2453	* @type string $name_submit The comment submit element name attribute. Default 'submit'.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2454	* @type string $title_reply The translatable 'reply' button label. Default 'Leave a Reply'.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2455	* @type string $title_reply_to The translatable 'reply-to' button label. Default 'Leave a Reply to %s',
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2456	* where %s is the author of the comment being replied to.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2457	* @type string $title_reply_before HTML displayed before the comment form title.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2458	* Default: '<h3 id="reply-title" class="comment-reply-title">'.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2459	* @type string $title_reply_after HTML displayed after the comment form title.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2460	* Default: '</h3>'.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2461	* @type string $cancel_reply_before HTML displayed before the cancel reply link.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2462	* @type string $cancel_reply_after HTML displayed after the cancel reply link.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2463	* @type string $cancel_reply_link The translatable 'cancel reply' button label. Default 'Cancel reply'.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2464	* @type string $label_submit The translatable 'submit' button label. Default 'Post a comment'.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2465	* @type string $submit_button HTML format for the Submit button.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2466	* Default: '<input name="%1$s" type="submit" id="%2$s" class="%3$s" value="%4$s" />'.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2467	* @type string $submit_field HTML format for the markup surrounding the Submit button and comment hidden
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2468	* fields. Default: '<p class="form-submit">%1$s %2$s</p>', where %1$s is the
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2469	* submit button markup and %2$s is the comment hidden fields.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2470	* @type string $format The comment form format. Default 'xhtml'. Accepts 'xhtml', 'html5'.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2471	* }
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2472	* @param int\|WP_Post $post Optional. Post ID or WP_Post object to generate the form for. Default current post.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2473	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2474	function comment_form( $args = array(), $post = null ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2475	$post = get_post( $post );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2476
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2477	// Exit the function if the post is invalid or comments are closed.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2478	if ( ! $post \|\| ! comments_open( $post ) ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2479	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2480	* Fires after the comment form if comments are closed.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2481	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2482	* For backward compatibility, this action also fires if comment_form()
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2483	* is called with an invalid post object or ID.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2484	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2485	* @since 3.0.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2486	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2487	do_action( 'comment_form_comments_closed' );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2488
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2489	return;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2490	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2491
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2492	$post_id = $post->ID;
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2493	$commenter = wp_get_current_commenter();
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2494	$user = wp_get_current_user();
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2495	$user_identity = $user->exists() ? $user->display_name : '';
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2496
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2497	$args = wp_parse_args( $args );
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2498	if ( ! isset( $args['format'] ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2499	$args['format'] = current_theme_supports( 'html5', 'comment-form' ) ? 'html5' : 'xhtml';
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2500	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2501
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2502	$req = get_option( 'require_name_email' );
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2503	$html5 = 'html5' === $args['format'];
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2504
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2505	// Define attributes in HTML5 or XHTML syntax.
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2506	$required_attribute = ( $html5 ? ' required' : ' required="required"' );
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2507	$checked_attribute = ( $html5 ? ' checked' : ' checked="checked"' );
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2508
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2509	// Identify required fields visually and create a message about the indicator.
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2510	$required_indicator = ' ' . wp_required_field_indicator();
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2511	$required_text = ' ' . wp_required_field_message();
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2512
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2513	$fields = array(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2514	'author' => sprintf(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2515	'<p class="comment-form-author">%s %s</p>',
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2516	sprintf(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2517	'<label for="author">%s%s</label>',
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2518	__( 'Name' ),
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2519	( $req ? $required_indicator : '' )
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2520	),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2521	sprintf(
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2522	'<input id="author" name="author" type="text" value="%s" size="30" maxlength="245" autocomplete="name"%s />',
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2523	esc_attr( $commenter['comment_author'] ),
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2524	( $req ? $required_attribute : '' )
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2525	)
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2526	),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2527	'email' => sprintf(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2528	'<p class="comment-form-email">%s %s</p>',
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2529	sprintf(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2530	'<label for="email">%s%s</label>',
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2531	__( 'Email' ),
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2532	( $req ? $required_indicator : '' )
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2533	),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2534	sprintf(
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2535	'<input id="email" name="email" %s value="%s" size="30" maxlength="100" aria-describedby="email-notes" autocomplete="email"%s />',
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2536	( $html5 ? 'type="email"' : 'type="text"' ),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2537	esc_attr( $commenter['comment_author_email'] ),
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2538	( $req ? $required_attribute : '' )
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2539	)
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2540	),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2541	'url' => sprintf(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2542	'<p class="comment-form-url">%s %s</p>',
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2543	sprintf(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2544	'<label for="url">%s</label>',
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2545	__( 'Website' )
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2546	),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2547	sprintf(
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2548	'<input id="url" name="url" %s value="%s" size="30" maxlength="200" autocomplete="url" />',
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2549	( $html5 ? 'type="url"' : 'type="text"' ),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2550	esc_attr( $commenter['comment_author_url'] )
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2551	)
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2552	),
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2553	);
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2554
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2555	if ( has_action( 'set_comment_cookies', 'wp_set_comment_cookies' ) && get_option( 'show_comments_cookies_opt_in' ) ) {
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2556	$consent = empty( $commenter['comment_author_email'] ) ? '' : $checked_attribute;
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2557
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2558	$fields['cookies'] = sprintf(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2559	'<p class="comment-form-cookies-consent">%s %s</p>',
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2560	sprintf(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2561	'<input id="wp-comment-cookies-consent" name="wp-comment-cookies-consent" type="checkbox" value="yes"%s />',
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2562	$consent
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2563	),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2564	sprintf(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2565	'<label for="wp-comment-cookies-consent">%s</label>',
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2566	__( 'Save my name, email, and website in this browser for the next time I comment.' )
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2567	)
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2568	);
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2569
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2570	// Ensure that the passed fields include cookies consent.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2571	if ( isset( $args['fields'] ) && ! isset( $args['fields']['cookies'] ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2572	$args['fields']['cookies'] = $fields['cookies'];
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2573	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2574	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2575
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2576	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2577	* Filters the default comment form fields.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2578	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2579	* @since 3.0.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2580	*
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2581	* @param string[] $fields Array of the default comment fields.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2582	*/
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2583	$fields = apply_filters( 'comment_form_default_fields', $fields );
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2584
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2585	$defaults = array(
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2586	'fields' => $fields,
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2587	'comment_field' => sprintf(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2588	'<p class="comment-form-comment">%s %s</p>',
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2589	sprintf(
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2590	'<label for="comment">%s%s</label>',
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2591	_x( 'Comment', 'noun' ),
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2592	$required_indicator
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2593	),
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2594	'<textarea id="comment" name="comment" cols="45" rows="8" maxlength="65525"' . $required_attribute . '></textarea>'
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2595	),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2596	'must_log_in' => sprintf(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2597	'<p class="must-log-in">%s</p>',
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2598	sprintf(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2599	/* translators: %s: Login URL. */
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2600	__( 'You must be <a href="%s">logged in</a> to post a comment.' ),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2601	/** This filter is documented in wp-includes/link-template.php */
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2602	wp_login_url( apply_filters( 'the_permalink', get_permalink( $post_id ), $post_id ) )
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2603	)
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2604	),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2605	'logged_in_as' => sprintf(
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2606	'<p class="logged-in-as">%s%s</p>',
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2607	sprintf(
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2608	/* translators: 1: User name, 2: Edit user link, 3: Logout URL. */
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2609	__( 'Logged in as %1$s. <a href="%2$s">Edit your profile</a>. <a href="%3$s">Log out?</a>' ),
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2610	$user_identity,
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2611	get_edit_user_link(),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2612	/** This filter is documented in wp-includes/link-template.php */
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2613	wp_logout_url( apply_filters( 'the_permalink', get_permalink( $post_id ), $post_id ) )
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2614	),
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2615	$required_text
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2616	),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2617	'comment_notes_before' => sprintf(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2618	'<p class="comment-notes">%s%s</p>',
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2619	sprintf(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2620	'<span id="email-notes">%s</span>',
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2621	__( 'Your email address will not be published.' )
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2622	),
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2623	$required_text
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2624	),
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2625	'comment_notes_after' => '',
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2626	'action' => site_url( '/wp-comments-post.php' ),
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2627	'id_form' => 'commentform',
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2628	'id_submit' => 'submit',
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2629	'class_container' => 'comment-respond',
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2630	'class_form' => 'comment-form',
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2631	'class_submit' => 'submit',
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2632	'name_submit' => 'submit',
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2633	'title_reply' => __( 'Leave a Reply' ),
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2634	/* translators: %s: Author of the comment being replied to. */
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2635	'title_reply_to' => __( 'Leave a Reply to %s' ),
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2636	'title_reply_before' => '<h3 id="reply-title" class="comment-reply-title">',
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2637	'title_reply_after' => '</h3>',
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2638	'cancel_reply_before' => ' <small>',
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2639	'cancel_reply_after' => '</small>',
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2640	'cancel_reply_link' => __( 'Cancel reply' ),
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2641	'label_submit' => __( 'Post Comment' ),
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2642	'submit_button' => '<input name="%1$s" type="submit" id="%2$s" class="%3$s" value="%4$s" />',
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2643	'submit_field' => '<p class="form-submit">%1$s %2$s</p>',
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2644	'format' => 'xhtml',
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2645	);
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2646
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2647	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2648	* Filters the comment form default arguments.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2649	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2650	* Use {@see 'comment_form_default_fields'} to filter the comment fields.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2651	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2652	* @since 3.0.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2653	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2654	* @param array $defaults The default comment form arguments.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2655	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2656	$args = wp_parse_args( $args, apply_filters( 'comment_form_defaults', $defaults ) );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2657
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: 16 diff changeset	2658	// Ensure that the filtered arguments contain all required default values.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2659	$args = array_merge( $defaults, $args );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2660
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2661	// Remove `aria-describedby` from the email field if there's no associated description.
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2662	if ( isset( $args['fields']['email'] ) && ! str_contains( $args['comment_notes_before'], 'id="email-notes"' ) ) {
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2663	$args['fields']['email'] = str_replace(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2664	' aria-describedby="email-notes"',
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2665	'',
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2666	$args['fields']['email']
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2667	);
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2668	}
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2669
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2670	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2671	* Fires before the comment form.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2672	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2673	* @since 3.0.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2674	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2675	do_action( 'comment_form_before' );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2676	?>
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2677	<div id="respond" class="<?php echo esc_attr( $args['class_container'] ); ?>">
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2678	<?php
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2679	echo $args['title_reply_before'];
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2680
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2681	comment_form_title( $args['title_reply'], $args['title_reply_to'], true, $post_id );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2682
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2683	if ( get_option( 'thread_comments' ) ) {
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2684	echo $args['cancel_reply_before'];
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2685
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2686	cancel_comment_reply_link( $args['cancel_reply_link'] );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2687
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2688	echo $args['cancel_reply_after'];
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2689	}
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2690
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2691	echo $args['title_reply_after'];
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2692
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2693	if ( get_option( 'comment_registration' ) && ! is_user_logged_in() ) :
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2694
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2695	echo $args['must_log_in'];
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2696	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2697	* Fires after the HTML-formatted 'must log in after' message in the comment form.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2698	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2699	* @since 3.0.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2700	*/
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2701	do_action( 'comment_form_must_log_in_after' );
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2702
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	2703	else :
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2704
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2705	printf(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2706	'<form action="%s" method="post" id="%s" class="%s"%s>',
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2707	esc_url( $args['action'] ),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2708	esc_attr( $args['id_form'] ),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2709	esc_attr( $args['class_form'] ),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2710	( $html5 ? ' novalidate' : '' )
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2711	);
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2712
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2713	/**
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2714	* Fires at the top of the comment form, inside the form tag.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2715	*
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2716	* @since 3.0.0
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2717	*/
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2718	do_action( 'comment_form_top' );
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2719
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2720	if ( is_user_logged_in() ) :
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2721
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2722	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2723	* Filters the 'logged in' message for the comment form for display.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2724	*
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2725	* @since 3.0.0
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2726	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2727	* @param string $args_logged_in The HTML for the 'logged in as [user]' message,
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	2728	* the Edit profile link, and the Log out link.
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2729	* @param array $commenter An array containing the comment author's
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2730	* username, email, and URL.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2731	* @param string $user_identity If the commenter is a registered user,
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2732	* the display name, blank otherwise.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2733	*/
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2734	echo apply_filters( 'comment_form_logged_in', $args['logged_in_as'], $commenter, $user_identity );
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2735
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2736	/**
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2737	* Fires after the is_user_logged_in() check in the comment form.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2738	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2739	* @since 3.0.0
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2740	*
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2741	* @param array $commenter An array containing the comment author's
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2742	* username, email, and URL.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2743	* @param string $user_identity If the commenter is a registered user,
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2744	* the display name, blank otherwise.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2745	*/
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2746	do_action( 'comment_form_logged_in_after', $commenter, $user_identity );
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2747
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2748	else :
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2749
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2750	echo $args['comment_notes_before'];
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2751
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2752	endif;
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2753
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2754	// Prepare an array of all fields, including the textarea.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2755	$comment_fields = array( 'comment' => $args['comment_field'] ) + (array) $args['fields'];
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2756
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2757	/**
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2758	* Filters the comment form fields, including the textarea.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2759	*
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2760	* @since 4.4.0
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2761	*
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2762	* @param array $comment_fields The comment fields.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2763	*/
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2764	$comment_fields = apply_filters( 'comment_form_fields', $comment_fields );
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2765
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2766	// Get an array of field names, excluding the textarea.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2767	$comment_field_keys = array_diff( array_keys( $comment_fields ), array( 'comment' ) );
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2768
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2769	// Get the first and the last field name, excluding the textarea.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2770	$first_field = reset( $comment_field_keys );
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2771	$last_field = end( $comment_field_keys );
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2772
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2773	foreach ( $comment_fields as $name => $field ) {
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2774
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2775	if ( 'comment' === $name ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2776
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2777	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2778	* Filters the content of the comment textarea field for display.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2779	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2780	* @since 3.0.0
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2781	*
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2782	* @param string $args_comment_field The content of the comment textarea field.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2783	*/
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2784	echo apply_filters( 'comment_form_field_comment', $field );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2785
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2786	echo $args['comment_notes_after'];
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2787
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2788	} elseif ( ! is_user_logged_in() ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2789
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2790	if ( $first_field === $name ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2791	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2792	* Fires before the comment fields in the comment form, excluding the textarea.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2793	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2794	* @since 3.0.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2795	*/
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2796	do_action( 'comment_form_before_fields' );
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2797	}
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2798
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2799	/**
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2800	* Filters a comment form field for display.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2801	*
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2802	* The dynamic portion of the hook name, `$name`, refers to the name
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2803	* of the comment form field.
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2804	*
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2805	* Possible hook names include:
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2806	*
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2807	* - `comment_form_field_comment`
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2808	* - `comment_form_field_author`
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2809	* - `comment_form_field_email`
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2810	* - `comment_form_field_url`
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	2811	* - `comment_form_field_cookies`
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2812	*
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2813	* @since 3.0.0
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2814	*
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2815	* @param string $field The HTML-formatted output of the comment form field.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2816	*/
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2817	echo apply_filters( "comment_form_field_{$name}", $field ) . "\n";
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2818
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2819	if ( $last_field === $name ) {
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	2820	/**
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2821	* Fires after the comment fields in the comment form, excluding the textarea.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2822	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2823	* @since 3.0.0
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2824	*/
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2825	do_action( 'comment_form_after_fields' );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2826	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2827	}
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2828	}
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2829
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2830	$submit_button = sprintf(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2831	$args['submit_button'],
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2832	esc_attr( $args['name_submit'] ),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2833	esc_attr( $args['id_submit'] ),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2834	esc_attr( $args['class_submit'] ),
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2835	esc_attr( $args['label_submit'] )
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2836	);
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2837
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2838	/**
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2839	* Filters the submit button for the comment form to display.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2840	*
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2841	* @since 4.2.0
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2842	*
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2843	* @param string $submit_button HTML markup for the submit button.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2844	* @param array $args Arguments passed to comment_form().
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2845	*/
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2846	$submit_button = apply_filters( 'comment_form_submit_button', $submit_button, $args );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2847
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2848	$submit_field = sprintf(
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2849	$args['submit_field'],
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2850	$submit_button,
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2851	get_comment_id_fields( $post_id )
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2852	);
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2853
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2854	/**
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2855	* Filters the submit field for the comment form to display.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2856	*
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2857	* The submit field includes the submit button, hidden fields for the
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2858	* comment form, and any wrapper markup.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2859	*
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2860	* @since 4.2.0
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2861	*
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2862	* @param string $submit_field HTML markup for the submit field.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2863	* @param array $args Arguments passed to comment_form().
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2864	*/
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2865	echo apply_filters( 'comment_form_submit_field', $submit_field, $args );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2866
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2867	/**
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2868	* Fires at the bottom of the comment form, inside the closing form tag.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2869	*
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2870	* @since 1.5.0
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2871	*
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2872	* @param int $post_id The post ID.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2873	*/
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2874	do_action( 'comment_form', $post_id );
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2875
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2876	echo '</form>';
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2877
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2878	endif;
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	2879	?>
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2880	</div><!-- #respond -->
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2881	<?php
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2882
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2883	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2884	* Fires after the comment form.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2885	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2886	* @since 3.0.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2887	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	2888	do_action( 'comment_form_after' );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2889	}

author	ymh <ymh.work@gmail.com>
	Fri, 05 Sep 2025 18:40:08 +0200
changeset 21	48c4eec2b7e6
parent 19	3d72ae0968f4
child 22	8c2e4d02f4ef
permissions	-rw-r--r--