WordPressを読む　46-3 /blog/wp-includes/comment-template.php 3

2014/11/30 2015/01/14

1 /blog/wp-includes/comment-template.php 3
2 関数　pings_open()
3 関数　wp_comment_form_unfiltered_html_nonce()
4 関数　comments_template()
5 関数　comments_popup_script()
6 関数　comments_popup_link()
7 関数　get_comment_reply_link()
8 関数　comment_reply_link()
9 関数　get_post_reply_link()
10 関数　post_reply_link()
11 関数　get_cancel_comment_reply_link()
12 関数　cancel_comment_reply_link()
13 関数　get_comment_id_fields()

/blog/wp-includes/comment-template.php 3

関数　pings_open()

/**
 * Whether the current post is open for pings.
 *
 * @since 1.5.0
 *
 * @param int|WP_Post $post_id Post ID or WP_Post object. Default current post.
 * @return bool True if pings are accepted
 */
function pings_open( $post_id = null ) {

	$_post = get_post($post_id);

	$open = ( 'open' == $_post->ping_status );

	/**
	 * Filter whether the current post is open for pings.
	 *
	 * @since 2.5.0
	 *
	 * @param bool        $open    Whether the current post is open for pings.
	 * @param int|WP_Post $post_id The post ID or WP_Post object.
	 */
	return apply_filters( 'pings_open', $open, $post_id );
}

/**

* Whether the current post is open for pings.

* @since 1.5.0

* @param int|WP_Post $post_id Post ID or WP_Post object. Default current post.

* @return bool True if pings are accepted

function pings_open( $post_id = null ) {

$_post = get_post($post_id);

$open = ( 'open' == $_post->ping_status );

/**

* Filter whether the current post is open for pings.

* @since 2.5.0

* @param bool $open Whether the current post is open for pings.

* @param int|WP_Post $post_id The post ID or WP_Post object.

return apply_filters( 'pings_open', $open, $post_id );

}

関数　wp_comment_form_unfiltered_html_nonce()

/**
 * Display form token for unfiltered comments.
 *
 * Will only display nonce token if the current user has permissions for
 * unfiltered html. Won't display the token for other users.
 *
 * The function was backported to 2.0.10 and was added to versions 2.1.3 and
 * above. Does not exist in versions prior to 2.0.10 in the 2.0 branch and in
 * the 2.1 branch, prior to 2.1.3. Technically added in 2.2.0.
 *
 * Backported to 2.0.10.
 *
 * @since 2.1.3
 */
function wp_comment_form_unfiltered_html_nonce() {
	$post = get_post();
	$post_id = $post ? $post->ID : 0;

	if ( current_user_can( 'unfiltered_html' ) ) {
		wp_nonce_field( 'unfiltered-html-comment_' . $post_id, '_wp_unfiltered_html_comment_disabled', false );
		echo "<script>(function(){if(window===window.parent){document.getElementById('_wp_unfiltered_html_comment_disabled').name='_wp_unfiltered_html_comment';}})();</script>\n";
	}
}

/**

* Display form token for unfiltered comments.

* Will only display nonce token if the current user has permissions for

* unfiltered html. Won't display the token for other users.

* The function was backported to 2.0.10 and was added to versions 2.1.3 and

* above. Does not exist in versions prior to 2.0.10 in the 2.0 branch and in

* the 2.1 branch, prior to 2.1.3. Technically added in 2.2.0.

* Backported to 2.0.10.

* @since 2.1.3

function wp_comment_form_unfiltered_html_nonce() {

$post = get_post();

$post_id = $post ? $post->ID : 0;

if ( current_user_can( 'unfiltered_html' ) ) {

wp_nonce_field( 'unfiltered-html-comment_' . $post_id, '_wp_unfiltered_html_comment_disabled', false );

echo "<script>(function(){if(window===window.parent){document.getElementById('_wp_unfiltered_html_comment_disabled').name='_wp_unfiltered_html_comment';}})();</script>\n";

}

関数　comments_template()

/**
 * Load the comment template specified in $file.
 *
 * Will not display the comments template if not on single post or page, or if
 * the post does not have comments.
 *
 * Uses the WordPress database object to query for the comments. The comments
 * are passed through the 'comments_array' filter hook with the list of comments
 * and the post ID respectively.
 *
 * The $file path is passed through a filter hook called, 'comments_template'
 * which includes the TEMPLATEPATH and $file combined. Tries the $filtered path
 * first and if it fails it will require the default comment template from the
 * default theme. If either does not exist, then the WordPress process will be
 * halted. It is advised for that reason, that the default theme is not deleted.
 *
 * @todo Document globals
 * @uses $withcomments Will not try to get the comments if the post has none.
 *
 * @since 1.5.0
 *
 * @param string $file              Optional. The file to load. Default '/comments.php'.
 * @param bool   $separate_comments Optional. Whether to separate the comments by comment type.
 *                                  Default false.
 * @return null Returns null if no comments appear.
 */
function comments_template( $file = '/comments.php', $separate_comments = false ) {
	global $wp_query, $withcomments, $post, $wpdb, $id, $comment, $user_login, $user_ID, $user_identity, $overridden_cpage;

	if ( !(is_single() || is_page() || $withcomments) || empty($post) )
		return;

	if ( empty($file) )
		$file = '/comments.php';

	$req = get_option('require_name_email');

	/*
	 * Comment author information fetched from the comment cookies.
	 * Uuses wp_get_current_commenter().
	 */
	$commenter = wp_get_current_commenter();

	/*
	 * The name of the current comment author escaped for use in attributes.
	 * Escaped by sanitize_comment_cookies().
	 */
	$comment_author = $commenter['comment_author'];

	/*
	 * The email address of the current comment author escaped for use in attributes.
	 * Escaped by sanitize_comment_cookies().
	 */
	$comment_author_email = $commenter['comment_author_email'];

	/*
	 * The url of the current comment author escaped for use in attributes.
	 */
	$comment_author_url = esc_url($commenter['comment_author_url']);

	/** @todo Use API instead of SELECTs. */
	if ( $user_ID) {
		$comments = $wpdb->get_results($wpdb->prepare("SELECT * FROM $wpdb->comments WHERE comment_post_ID = %d AND (comment_approved = '1' OR ( user_id = %d AND comment_approved = '0' ) )  ORDER BY comment_date_gmt", $post->ID, $user_ID));
	} else if ( empty($comment_author) ) {
		$comments = get_comments( array('post_id' => $post->ID, 'status' => 'approve', 'order' => 'ASC') );
	} else {
		$comments = $wpdb->get_results($wpdb->prepare("SELECT * FROM $wpdb->comments WHERE comment_post_ID = %d AND ( comment_approved = '1' OR ( comment_author = %s AND comment_author_email = %s AND comment_approved = '0' ) ) ORDER BY comment_date_gmt", $post->ID, wp_specialchars_decode($comment_author,ENT_QUOTES), $comment_author_email));
	}

	/**
	 * Filter the comments array.
	 *
	 * @since 2.1.0
	 *
	 * @param array $comments Array of comments supplied to the comments template.
	 * @param int   $post_ID  Post ID.
	 */
	$wp_query->comments = apply_filters( 'comments_array', $comments, $post->ID );
	$comments = &$wp_query->comments;
	$wp_query->comment_count = count($wp_query->comments);
	update_comment_cache($wp_query->comments);

	if ( $separate_comments ) {
		$wp_query->comments_by_type = separate_comments($comments);
		$comments_by_type = &$wp_query->comments_by_type;
	}

	$overridden_cpage = false;
	if ( '' == get_query_var('cpage') && get_option('page_comments') ) {
		set_query_var( 'cpage', 'newest' == get_option('default_comments_page') ? get_comment_pages_count() : 1 );
		$overridden_cpage = true;
	}

	if ( !defined('COMMENTS_TEMPLATE') )
		define('COMMENTS_TEMPLATE', true);

	$theme_template = STYLESHEETPATH . $file;
	/**
	 * Filter the path to the theme template file used for the comments template.
	 *
	 * @since 1.5.1
	 *
	 * @param string $theme_template The path to the theme template file.
	 */
	$include = apply_filters( 'comments_template', $theme_template );
	if ( file_exists( $include ) )
		require( $include );
	elseif ( file_exists( TEMPLATEPATH . $file ) )
		require( TEMPLATEPATH . $file );
	else // Backward compat code will be removed in a future release
		require( ABSPATH . WPINC . '/theme-compat/comments.php');
}

100

101

102

103

104

105

106

107

108

109

110

111

112

/**

* Load the comment template specified in $file.

* Will not display the comments template if not on single post or page, or if

* the post does not have comments.

* Uses the WordPress database object to query for the comments. The comments

* are passed through the 'comments_array' filter hook with the list of comments

* and the post ID respectively.

* The $file path is passed through a filter hook called, 'comments_template'

* which includes the TEMPLATEPATH and $file combined. Tries the $filtered path

* first and if it fails it will require the default comment template from the

* default theme. If either does not exist, then the WordPress process will be

* halted. It is advised for that reason, that the default theme is not deleted.

* @todo Document globals

* @uses $withcomments Will not try to get the comments if the post has none.

* @since 1.5.0

* @param string $file Optional. The file to load. Default '/comments.php'.

* @param bool $separate_comments Optional. Whether to separate the comments by comment type.

* Default false.

* @return null Returns null if no comments appear.

function comments_template( $file = '/comments.php', $separate_comments = false ) {

global $wp_query, $withcomments, $post, $wpdb, $id, $comment, $user_login, $user_ID, $user_identity, $overridden_cpage;

if ( !(is_single() || is_page() || $withcomments) || empty($post) )

return;

if ( empty($file) )

$file = '/comments.php';

$req = get_option('require_name_email');

* Comment author information fetched from the comment cookies.

* Uuses wp_get_current_commenter().

$commenter = wp_get_current_commenter();

* The name of the current comment author escaped for use in attributes.

* Escaped by sanitize_comment_cookies().

$comment_author = $commenter['comment_author'];

* The email address of the current comment author escaped for use in attributes.

* Escaped by sanitize_comment_cookies().

$comment_author_email = $commenter['comment_author_email'];

* The url of the current comment author escaped for use in attributes.

$comment_author_url = esc_url($commenter['comment_author_url']);

/** @todo Use API instead of SELECTs. */

if ( $user_ID) {

$comments = $wpdb->get_results($wpdb->prepare("SELECT * FROM $wpdb->comments WHERE comment_post_ID = %d AND (comment_approved = '1' OR ( user_id = %d AND comment_approved = '0' ) ) ORDER BY comment_date_gmt", $post->ID, $user_ID));

} else if ( empty($comment_author) ) {

$comments = get_comments( array('post_id' => $post->ID, 'status' => 'approve', 'order' => 'ASC') );

} else {

$comments = $wpdb->get_results($wpdb->prepare("SELECT * FROM $wpdb->comments WHERE comment_post_ID = %d AND ( comment_approved = '1' OR ( comment_author = %s AND comment_author_email = %s AND comment_approved = '0' ) ) ORDER BY comment_date_gmt", $post->ID, wp_specialchars_decode($comment_author,ENT_QUOTES), $comment_author_email));

}

/**

* Filter the comments array.

* @since 2.1.0

* @param array $comments Array of comments supplied to the comments template.

* @param int $post_ID Post ID.

$wp_query->comments = apply_filters( 'comments_array', $comments, $post->ID );

$comments = &$wp_query->comments;

$wp_query->comment_count = count($wp_query->comments);

update_comment_cache($wp_query->comments);

if ( $separate_comments ) {

$wp_query->comments_by_type = separate_comments($comments);

$comments_by_type = &$wp_query->comments_by_type;

}

$overridden_cpage = false;

if ( '' == get_query_var('cpage') && get_option('page_comments') ) {

set_query_var( 'cpage', 'newest' == get_option('default_comments_page') ? get_comment_pages_count() : 1 );

$overridden_cpage = true;

}

if ( !defined('COMMENTS_TEMPLATE') )

define('COMMENTS_TEMPLATE', true);

$theme_template = STYLESHEETPATH . $file;

/**

* Filter the path to the theme template file used for the comments template.

* @since 1.5.1

* @param string $theme_template The path to the theme template file.

$include = apply_filters( 'comments_template', $theme_template );

if ( file_exists( $include ) )

require( $include );

elseif ( file_exists( TEMPLATEPATH . $file ) )

require( TEMPLATEPATH . $file );

else // Backward compat code will be removed in a future release

require( ABSPATH . WPINC . '/theme-compat/comments.php');

}

関数　comments_popup_script()

/**
 * Display the JS popup script to show a comment.
 *
 * If the $file parameter is empty, then the home page is assumed. The defaults
 * for the window are 400px by 400px.
 *
 * For the comment link popup to work, this function has to be called or the
 * normal comment link will be assumed.
 *
 * @global string $wpcommentspopupfile  The URL to use for the popup window.
 * @global int    $wpcommentsjavascript Whether to use JavaScript. Set when function is called.
 *
 * @since 0.71
 *
 * @param int $width  Optional. The width of the popup window. Default 400.
 * @param int $height Optional. The height of the popup window. Default 400.
 * @param string $file Optional. Sets the location of the popup window.
 */
function comments_popup_script( $width = 400, $height = 400, $file = '' ) {
	global $wpcommentspopupfile, $wpcommentsjavascript;

	if (empty ($file)) {
		$wpcommentspopupfile = '';  // Use the index.
	} else {
		$wpcommentspopupfile = $file;
	}

	$wpcommentsjavascript = 1;
	$javascript = "<script type='text/javascript'>\nfunction wpopen (macagna) {\n    window.open(macagna, '_blank', 'width=$width,height=$height,scrollbars=yes,status=yes');\n}\n</script>\n";
	echo $javascript;
}

/**

* Display the JS popup script to show a comment.

* If the $file parameter is empty, then the home page is assumed. The defaults

* for the window are 400px by 400px.

* For the comment link popup to work, this function has to be called or the

* normal comment link will be assumed.

* @global string $wpcommentspopupfile The URL to use for the popup window.

* @global int $wpcommentsjavascript Whether to use JavaScript. Set when function is called.

* @since 0.71

* @param int $width Optional. The width of the popup window. Default 400.

* @param int $height Optional. The height of the popup window. Default 400.

* @param string $file Optional. Sets the location of the popup window.

function comments_popup_script( $width = 400, $height = 400, $file = '' ) {

global $wpcommentspopupfile, $wpcommentsjavascript;

if (empty ($file)) {

$wpcommentspopupfile = ''; // Use the index.

} else {

$wpcommentspopupfile = $file;

}

$wpcommentsjavascript = 1;

$javascript = "<script type='text/javascript'>\nfunction wpopen (macagna) {\n window.open(macagna, '_blank', 'width=$width,height=$height,scrollbars=yes,status=yes');\n}\n</script>\n";

echo $javascript;

}

関数　comments_popup_link()

/**
 * Displays the link to the comments popup window for the current post ID.
 *
 * Is not meant to be displayed on single posts and pages. Should be used
 * on the lists of posts
 *
 * @global string $wpcommentspopupfile  The URL to use for the popup window.
 * @global int    $wpcommentsjavascript Whether to use JavaScript. Set when function is called.
 *
 * @since 0.71
 *
 * @param string $zero      Optional. String to display when no comments. Default false.
 * @param string $one       Optional. String to display when only one comment is available.
 *                          Default false.
 * @param string $more      Optional. String to display when there are more than one comment.
 *                          Default false.
 * @param string $css_class Optional. CSS class to use for comments. Default empty.
 * @param string $none      Optional. String to display when comments have been turned off.
 *                          Default false.
 * @return null Returns null on single posts and pages.
 */
function comments_popup_link( $zero = false, $one = false, $more = false, $css_class = '', $none = false ) {
	global $wpcommentspopupfile, $wpcommentsjavascript;

	$id = get_the_ID();

	if ( false === $zero ) $zero = __( 'No Comments' );
	if ( false === $one ) $one = __( '1 Comment' );
	if ( false === $more ) $more = __( '% Comments' );
	if ( false === $none ) $none = __( 'Comments Off' );

	$number = get_comments_number( $id );

	if ( 0 == $number && !comments_open() && !pings_open() ) {
		echo '<span' . ((!empty($css_class)) ? ' class="' . esc_attr( $css_class ) . '"' : '') . '>' . $none . '</span>';
		return;
	}

	if ( post_password_required() ) {
		echo __('Enter your password to view comments.');
		return;
	}

	echo '<a href="';
	if ( $wpcommentsjavascript ) {
		if ( empty( $wpcommentspopupfile ) )
			$home = home_url();
		else
			$home = get_option('siteurl');
		echo $home . '/' . $wpcommentspopupfile . '?comments_popup=' . $id;
		echo '" onclick="wpopen(this.href); return false"';
	} else { // if comments_popup_script() is not in the template, display simple comment link
		if ( 0 == $number )
			echo get_permalink() . '#respond';
		else
			comments_link();
		echo '"';
	}

	if ( !empty( $css_class ) ) {
		echo ' class="'.$css_class.'" ';
	}
	$title = the_title_attribute( array('echo' => 0 ) );

	$attributes = '';
	/**
	 * Filter the comments popup link attributes for display.
	 *
	 * @since 2.5.0
	 *
	 * @param string $attributes The comments popup link attributes. Default empty.
	 */
	echo apply_filters( 'comments_popup_link_attributes', $attributes );

	echo ' title="' . esc_attr( sprintf( __('Comment on %s'), $title ) ) . '">';
	comments_number( $zero, $one, $more );
	echo '</a>';
}

/**

* Displays the link to the comments popup window for the current post ID.

* Is not meant to be displayed on single posts and pages. Should be used

* on the lists of posts

* @global string $wpcommentspopupfile The URL to use for the popup window.

* @global int $wpcommentsjavascript Whether to use JavaScript. Set when function is called.

* @since 0.71

* @param string $zero Optional. String to display when no comments. Default false.

* @param string $one Optional. String to display when only one comment is available.

* Default false.

* @param string $more Optional. String to display when there are more than one comment.

* Default false.

* @param string $css_class Optional. CSS class to use for comments. Default empty.

* @param string $none Optional. String to display when comments have been turned off.

* Default false.

* @return null Returns null on single posts and pages.

function comments_popup_link( $zero = false, $one = false, $more = false, $css_class = '', $none = false ) {

global $wpcommentspopupfile, $wpcommentsjavascript;

$id = get_the_ID();

if ( false === $zero ) $zero = __( 'No Comments' );

if ( false === $one ) $one = __( '1 Comment' );

if ( false === $more ) $more = __( '% Comments' );

if ( false === $none ) $none = __( 'Comments Off' );

$number = get_comments_number( $id );

if ( 0 == $number && !comments_open() && !pings_open() ) {

echo '<span' . ((!empty($css_class)) ? ' class="' . esc_attr( $css_class ) . '"' : '') . '>' . $none . '</span>';

return;

}

if ( post_password_required() ) {

echo __('Enter your password to view comments.');

return;

}

echo '<a href="';

if ( $wpcommentsjavascript ) {

if ( empty( $wpcommentspopupfile ) )

$home = home_url();

else

$home = get_option('siteurl');

echo $home . '/' . $wpcommentspopupfile . '?comments_popup=' . $id;

echo '" onclick="wpopen(this.href); return false"';

} else { // if comments_popup_script() is not in the template, display simple comment link

if ( 0 == $number )

echo get_permalink() . '#respond';

else

comments_link();

echo '"';

}

if ( !empty( $css_class ) ) {

echo ' class="'.$css_class.'" ';

}

$title = the_title_attribute( array('echo' => 0 ) );

$attributes = '';

/**

* Filter the comments popup link attributes for display.

* @since 2.5.0

* @param string $attributes The comments popup link attributes. Default empty.

echo apply_filters( 'comments_popup_link_attributes', $attributes );

echo ' title="' . esc_attr( sprintf( __('Comment on %s'), $title ) ) . '">';

comments_number( $zero, $one, $more );

echo '</a>';

}

関数　get_comment_reply_link()

/**
 * Retrieve HTML content for reply to comment link.
 *
 * @since 2.7.0
 *
 * @param array $args {
 *     Optional. Override default arguments.
 *
 *     @type string $add_below  The first part of the selector used to identify the comment to respond below.
 *                              The resulting value is passed as the first parameter to addComment.moveForm(),
 *                              concatenated as $add_below-$comment->comment_ID. Default 'comment'.
 *     @type string $respond_id The selector identifying the responding comment. Passed as the third parameter
 *                              to addComment.moveForm(), and appended to the link URL as a hash value.
 *                              Default 'respond'.
 *     @type string $reply_text The text of the Reply link. Default 'Reply'.
 *     @type string $login_text The text of the link to reply if logged out. Default 'Log in to Reply'.
 *     @type int    $depth'     The depth of the new comment. Must be greater than 0 and less than the value
 *                              of the 'thread_comments_depth' option set in Settings > Discussion. Default 0.
 *     @type string $before     The text or HTML to add before the reply link. Default empty.
 *     @type string $after      The text or HTML to add after the reply link. Default empty.
 * }
 * @param int         $comment Comment being replied to. Default current comment.
 * @param int|WP_Post $post    Post ID or WP_Post object the comment is going to be displayed on.
 *                             Default current post.
 * @return mixed Link to show comment form, if successful. False, if comments are closed.
 */
function get_comment_reply_link($args = array(), $comment = null, $post = null) {

	$defaults = array(
		'add_below'  => 'comment',
		'respond_id' => 'respond',
		'reply_text' => __('Reply'),
		'login_text' => __('Log in to Reply'),
		'depth'      => 0,
		'before'     => '',
		'after'      => ''
	);

	$args = wp_parse_args($args, $defaults);

	if ( 0 == $args['depth'] || $args['max_depth'] <= $args['depth'] )
		return;

	extract($args, EXTR_SKIP);

	$comment = get_comment($comment);
	if ( empty($post) )
		$post = $comment->comment_post_ID;
	$post = get_post($post);

	if ( !comments_open($post->ID) )
		return false;

	$link = '';

	if ( get_option('comment_registration') && ! is_user_logged_in() )
		$link = '<a rel="nofollow" class="comment-reply-login" href="' . esc_url( wp_login_url( get_permalink() ) ) . '">' . $login_text . '</a>';
	else
		$link = "<a class='comment-reply-link' href='" . esc_url( add_query_arg( 'replytocom', $comment->comment_ID ) ) . "#" . $respond_id . "' onclick='return addComment.moveForm(\"$add_below-$comment->comment_ID\", \"$comment->comment_ID\", \"$respond_id\", \"$post->ID\")'>$reply_text</a>";

	/**
	 * Filter the comment reply link.
	 *
	 * @since 2.7.0
	 *
	 * @param string  $link    The HTML markup for the comment reply link.
	 * @param array   $args    An array of arguments overriding the defaults.
	 * @param object  $comment The object of the comment being replied.
	 * @param WP_Post $post    The WP_Post object.
	 */
	return apply_filters( 'comment_reply_link', $before . $link . $after, $args, $comment, $post );
}

/**

* Retrieve HTML content for reply to comment link.

* @since 2.7.0

* @param array $args {

* Optional. Override default arguments.

* @type string $add_below The first part of the selector used to identify the comment to respond below.

* The resulting value is passed as the first parameter to addComment.moveForm(),

* concatenated as $add_below-$comment->comment_ID. Default 'comment'.

* @type string $respond_id The selector identifying the responding comment. Passed as the third parameter

* to addComment.moveForm(), and appended to the link URL as a hash value.

* Default 'respond'.

* @type string $reply_text The text of the Reply link. Default 'Reply'.

* @type string $login_text The text of the link to reply if logged out. Default 'Log in to Reply'.

* @type int $depth' The depth of the new comment. Must be greater than 0 and less than the value

* of the 'thread_comments_depth' option set in Settings > Discussion. Default 0.

* @type string $before The text or HTML to add before the reply link. Default empty.

* @type string $after The text or HTML to add after the reply link. Default empty.

* }

* @param int $comment Comment being replied to. Default current comment.

* @param int|WP_Post $post Post ID or WP_Post object the comment is going to be displayed on.

* Default current post.

* @return mixed Link to show comment form, if successful. False, if comments are closed.

function get_comment_reply_link($args = array(), $comment = null, $post = null) {

$defaults = array(

'add_below' => 'comment',

'respond_id' => 'respond',

'reply_text' => __('Reply'),

'login_text' => __('Log in to Reply'),

'depth' => 0,

'before' => '',

'after' => ''

);

$args = wp_parse_args($args, $defaults);

if ( 0 == $args['depth'] || $args['max_depth'] <= $args['depth'] )

return;

extract($args, EXTR_SKIP);

$comment = get_comment($comment);

if ( empty($post) )

$post = $comment->comment_post_ID;

$post = get_post($post);

if ( !comments_open($post->ID) )

return false;

$link = '';

if ( get_option('comment_registration') && ! is_user_logged_in() )

$link = '<a rel="nofollow" class="comment-reply-login" href="' . esc_url( wp_login_url( get_permalink() ) ) . '">' . $login_text . '</a>';

else

$link = "<a class='comment-reply-link' href='" . esc_url( add_query_arg( 'replytocom', $comment->comment_ID ) ) . "#" . $respond_id . "' onclick='return addComment.moveForm(\"$add_below-$comment->comment_ID\", \"$comment->comment_ID\", \"$respond_id\", \"$post->ID\")'>$reply_text</a>";

/**

* Filter the comment reply link.

* @since 2.7.0

* @param string $link The HTML markup for the comment reply link.

* @param array $args An array of arguments overriding the defaults.

* @param object $comment The object of the comment being replied.

* @param WP_Post $post The WP_Post object.

return apply_filters( 'comment_reply_link', $before . $link . $after, $args, $comment, $post );

}

関数　comment_reply_link()

/**
 * Displays the HTML content for reply to comment link.
 *
 * @since 2.7.0
 *
 * @see get_comment_reply_link()
 *
 * @param array       $args    Optional. Override default options.
 * @param int         $comment Comment being replied to. Default current comment.
 * @param int|WP_Post $post    Post ID or WP_Post object the comment is going to be displayed on.
 *                             Default current post.
 * @return mixed Link to show comment form, if successful. False, if comments are closed.
 */
function comment_reply_link($args = array(), $comment = null, $post = null) {
	echo get_comment_reply_link($args, $comment, $post);
}

/**

* Displays the HTML content for reply to comment link.

* @since 2.7.0

* @see get_comment_reply_link()

* @param array $args Optional. Override default options.

* @param int $comment Comment being replied to. Default current comment.

* @param int|WP_Post $post Post ID or WP_Post object the comment is going to be displayed on.

* Default current post.

* @return mixed Link to show comment form, if successful. False, if comments are closed.

function comment_reply_link($args = array(), $comment = null, $post = null) {

echo get_comment_reply_link($args, $comment, $post);

}

関数　get_post_reply_link()

/**
 * Retrieve HTML content for reply to post link.
 *
 * @since 2.7.0
 *
 * @param array $args {
 *     Optional. Override default arguments.
 *
 *     @type string $add_below  The first part of the selector used to identify the comment to respond below.
 *                              The resulting value is passed as the first parameter to addComment.moveForm(),
 *                              concatenated as $add_below-$comment->comment_ID. Default is 'post'.
 *     @type string $respond_id The selector identifying the responding comment. Passed as the third parameter
 *                              to addComment.moveForm(), and appended to the link URL as a hash value.
 *                              Default 'respond'.
 *     @type string $reply_text Text of the Reply link. Default is 'Leave a Comment'.
 *     @type string $login_text Text of the link to reply if logged out. Default is 'Log in to leave a Comment'.
 *     @type string $before     Text or HTML to add before the reply link. Default empty.
 *     @type string $after      Text or HTML to add after the reply link. Default empty.
 * }
 * @param int|WP_Post $post    Optional. Post ID or WP_Post object the comment is going to be displayed on.
 *                             Default current post.
 * @return string|bool|null Link to show comment form, if successful. False, if comments are closed.
 */
function get_post_reply_link($args = array(), $post = null) {
	$defaults = array(
		'add_below'  => 'post',
		'respond_id' => 'respond',
		'reply_text' => __('Leave a Comment'),
		'login_text' => __('Log in to leave a Comment'),
		'before'     => '',
		'after'      => '',
	);

	$args = wp_parse_args($args, $defaults);
	extract($args, EXTR_SKIP);
	$post = get_post($post);

	if ( !comments_open($post->ID) )
		return false;

	if ( get_option('comment_registration') && ! is_user_logged_in() )
		$link = '<a rel="nofollow" href="' . wp_login_url( get_permalink() ) . '">' . $login_text . '</a>';
	else
		$link = "<a rel='nofollow' class='comment-reply-link' href='" . get_permalink($post->ID) . "#$respond_id' onclick='return addComment.moveForm(\"$add_below-$post->ID\", \"0\", \"$respond_id\", \"$post->ID\")'>$reply_text</a>";

	$formatted_link = $before . $link . $after;
	/**
	 * Filter the formatted post comments link HTML.
	 *
	 * @since 2.7.0
	 *
	 * @param string      $formatted The HTML-formatted post comments link.
	 * @param int|WP_Post $post      The post ID or WP_Post object.
	 */
	return apply_filters( 'post_comments_link', $formatted_link, $post );
}

/**

* Retrieve HTML content for reply to post link.

* @since 2.7.0

* @param array $args {

* Optional. Override default arguments.

* @type string $add_below The first part of the selector used to identify the comment to respond below.

* The resulting value is passed as the first parameter to addComment.moveForm(),

* concatenated as $add_below-$comment->comment_ID. Default is 'post'.

* @type string $respond_id The selector identifying the responding comment. Passed as the third parameter

* to addComment.moveForm(), and appended to the link URL as a hash value.

* Default 'respond'.

* @type string $reply_text Text of the Reply link. Default is 'Leave a Comment'.

* @type string $login_text Text of the link to reply if logged out. Default is 'Log in to leave a Comment'.

* @type string $before Text or HTML to add before the reply link. Default empty.

* @type string $after Text or HTML to add after the reply link. Default empty.

* }

* @param int|WP_Post $post Optional. Post ID or WP_Post object the comment is going to be displayed on.

* Default current post.

* @return string|bool|null Link to show comment form, if successful. False, if comments are closed.

function get_post_reply_link($args = array(), $post = null) {

$defaults = array(

'add_below' => 'post',

'respond_id' => 'respond',

'reply_text' => __('Leave a Comment'),

'login_text' => __('Log in to leave a Comment'),

'before' => '',

'after' => '',

);

$args = wp_parse_args($args, $defaults);

extract($args, EXTR_SKIP);

$post = get_post($post);

if ( !comments_open($post->ID) )

return false;

if ( get_option('comment_registration') && ! is_user_logged_in() )

$link = '<a rel="nofollow" href="' . wp_login_url( get_permalink() ) . '">' . $login_text . '</a>';

else

$link = "<a rel='nofollow' class='comment-reply-link' href='" . get_permalink($post->ID) . "#$respond_id' onclick='return addComment.moveForm(\"$add_below-$post->ID\", \"0\", \"$respond_id\", \"$post->ID\")'>$reply_text</a>";

$formatted_link = $before . $link . $after;

/**

* Filter the formatted post comments link HTML.

* @since 2.7.0

* @param string $formatted The HTML-formatted post comments link.

* @param int|WP_Post $post The post ID or WP_Post object.

return apply_filters( 'post_comments_link', $formatted_link, $post );

}

関数　post_reply_link()

/**
 * Displays the HTML content for reply to post link.
 *
 * @since 2.7.0
 *
 * @see get_post_reply_link()
 *
 * @param array       $args Optional. Override default options,
 * @param int|WP_Post $post Post ID or WP_Post object the comment is going to be displayed on.
 *                          Default current post.
 * @return string|bool|null Link to show comment form, if successful. False, if comments are closed.
 */
function post_reply_link($args = array(), $post = null) {
	echo get_post_reply_link($args, $post);
}

/**

* Displays the HTML content for reply to post link.

* @since 2.7.0

* @see get_post_reply_link()

* @param array $args Optional. Override default options,

* @param int|WP_Post $post Post ID or WP_Post object the comment is going to be displayed on.

* Default current post.

* @return string|bool|null Link to show comment form, if successful. False, if comments are closed.

function post_reply_link($args = array(), $post = null) {

echo get_post_reply_link($args, $post);

}

関数　get_cancel_comment_reply_link()

/**
 * Retrieve HTML content for cancel comment reply link.
 *
 * @since 2.7.0
 *
 * @param string $text Optional. Text to display for cancel reply link. Default empty.
 */
function get_cancel_comment_reply_link( $text = '' ) {
	if ( empty($text) )
		$text = __('Click here to cancel reply.');

	$style = isset($_GET['replytocom']) ? '' : ' style="display:none;"';
	$link = esc_html( remove_query_arg('replytocom') ) . '#respond';

	$formatted_link = '<a rel="nofollow" id="cancel-comment-reply-link" href="' . $link . '"' . $style . '>' . $text . '</a>';
	/**
	 * Filter the cancel comment reply link HTML.
	 *
	 * @since 2.7.0
	 *
	 * @param string $formatted_link The HTML-formatted cancel comment reply link.
	 * @param string $link           Cancel comment reply link URL.
	 * @param string $text           Cancel comment reply link text.
	 */
	return apply_filters( 'cancel_comment_reply_link', $formatted_link, $link, $text );
}

/**

* Retrieve HTML content for cancel comment reply link.

* @since 2.7.0

* @param string $text Optional. Text to display for cancel reply link. Default empty.

function get_cancel_comment_reply_link( $text = '' ) {

if ( empty($text) )

$text = __('Click here to cancel reply.');

$style = isset($_GET['replytocom']) ? '' : ' style="display:none;"';

$link = esc_html( remove_query_arg('replytocom') ) . '#respond';

$formatted_link = '<a rel="nofollow" id="cancel-comment-reply-link" href="' . $link . '"' . $style . '>' . $text . '</a>';

/**

* Filter the cancel comment reply link HTML.

* @since 2.7.0

* @param string $formatted_link The HTML-formatted cancel comment reply link.

* @param string $link Cancel comment reply link URL.

* @param string $text Cancel comment reply link text.

return apply_filters( 'cancel_comment_reply_link', $formatted_link, $link, $text );

}

関数　cancel_comment_reply_link()

/**
 * Display HTML content for cancel comment reply link.
 *
 * @since 2.7.0
 *
 * @param string $text Optional. Text to display for cancel reply link. Default empty.
 */
function cancel_comment_reply_link( $text = '' ) {
	echo get_cancel_comment_reply_link($text);
}

/**

* Display HTML content for cancel comment reply link.

* @since 2.7.0

* @param string $text Optional. Text to display for cancel reply link. Default empty.

function cancel_comment_reply_link( $text = '' ) {

echo get_cancel_comment_reply_link($text);

}

関数　get_comment_id_fields()

/**
 * Retrieve hidden input HTML for replying to comments.
 *
 * @since 3.0.0
 *
 * @param int $id Optional. Post ID. Default current post ID.
 * @return string Hidden input HTML for replying to comments
 */
function get_comment_id_fields( $id = 0 ) {
	if ( empty( $id ) )
		$id = get_the_ID();

	$replytoid = isset($_GET['replytocom']) ? (int) $_GET['replytocom'] : 0;
	$result  = "<input type='hidden' name='comment_post_ID' value='$id' id='comment_post_ID' />\n";
	$result .= "<input type='hidden' name='comment_parent' id='comment_parent' value='$replytoid' />\n";

	/**
	 * Filter the returned comment id fields.
	 *
	 * @since 3.0.0
	 *
	 * @param string $result    The HTML-formatted hidden id field comment elements.
	 * @param int    $id        The post ID.
	 * @param int    $replytoid The id of the comment being replied to.
	 */
	return apply_filters( 'comment_id_fields', $result, $id, $replytoid );
}

/**

* Retrieve hidden input HTML for replying to comments.

* @since 3.0.0

* @param int $id Optional. Post ID. Default current post ID.

* @return string Hidden input HTML for replying to comments

function get_comment_id_fields( $id = 0 ) {

if ( empty( $id ) )

$id = get_the_ID();

$replytoid = isset($_GET['replytocom']) ? (int) $_GET['replytocom'] : 0;

$result = "<input type='hidden' name='comment_post_ID' value='$id' id='comment_post_ID' />\n";

$result .= "<input type='hidden' name='comment_parent' id='comment_parent' value='$replytoid' />\n";

/**

* Filter the returned comment id fields.

* @since 3.0.0

* @param string $result The HTML-formatted hidden id field comment elements.

* @param int $id The post ID.

* @param int $replytoid The id of the comment being replied to.

return apply_filters( 'comment_id_fields', $result, $id, $replytoid );

}

- Wordpress

月	火	水	木	金	土	日
« 4月
		1	2	3	4	5
6	7	8	9	10	11	12
13	14	15	16	17	18	19
20	21	22	23	24	25	26
27	28	29	30	31

WordPressを読む 46-3 /blog/wp-includes/comment-template.php 3

/blog/wp-includes/comment-template.php 3

WordPressを読む　46-3 /blog/wp-includes/comment-template.php 3