Alert: This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

_wp_dashboard_recent_comments_row( WP_Comment $comment, bool $show_date = true )

Outputs a row for the Recent Comments widget.

Contents

Description Description

Parameters Parameters

$comment

(WP_Comment) (Required) The current comment.

$show_date

(bool) (Optional) Whether to display the date.

Default value: true

Top ↑

Source Source

File: wp-admin/includes/dashboard.php

617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
function _wp_dashboard_recent_comments_row( &$comment, $show_date = true ) {
    $GLOBALS['comment'] = clone $comment;
 
    if ( $comment->comment_post_ID > 0 ) {
 
        $comment_post_title = _draft_or_post_title( $comment->comment_post_ID );
        $comment_post_url   = get_the_permalink( $comment->comment_post_ID );
        $comment_post_link  = "<a href='$comment_post_url'>$comment_post_title</a>";
    } else {
        $comment_post_link = '';
    }
 
    $actions_string = '';
    if ( current_user_can( 'edit_comment', $comment->comment_ID ) ) {
        // Pre-order it: Approve | Reply | Edit | Spam | Trash.
        $actions = array(
            'approve'   => '',
            'unapprove' => '',
            'reply'     => '',
            'edit'      => '',
            'spam'      => '',
            'trash'     => '',
            'delete'    => '',
            'view'      => '',
        );
 
        $del_nonce     = esc_html( '_wpnonce=' . wp_create_nonce( "delete-comment_$comment->comment_ID" ) );
        $approve_nonce = esc_html( '_wpnonce=' . wp_create_nonce( "approve-comment_$comment->comment_ID" ) );
 
        $approve_url   = esc_url( "comment.php?action=approvecomment&p=$comment->comment_post_ID&c=$comment->comment_ID&$approve_nonce" );
        $unapprove_url = esc_url( "comment.php?action=unapprovecomment&p=$comment->comment_post_ID&c=$comment->comment_ID&$approve_nonce" );
        $spam_url      = esc_url( "comment.php?action=spamcomment&p=$comment->comment_post_ID&c=$comment->comment_ID&$del_nonce" );
        $trash_url     = esc_url( "comment.php?action=trashcomment&p=$comment->comment_post_ID&c=$comment->comment_ID&$del_nonce" );
        $delete_url    = esc_url( "comment.php?action=deletecomment&p=$comment->comment_post_ID&c=$comment->comment_ID&$del_nonce" );
 
        $actions['approve']   = "<a href='$approve_url' data-wp-lists='dim:the-comment-list:comment-$comment->comment_ID:unapproved:e7e7d3:e7e7d3:new=approved' class='vim-a' aria-label='" . esc_attr__( 'Approve this comment' ) . "'>" . __( 'Approve' ) . '</a>';
        $actions['unapprove'] = "<a href='$unapprove_url' data-wp-lists='dim:the-comment-list:comment-$comment->comment_ID:unapproved:e7e7d3:e7e7d3:new=unapproved' class='vim-u' aria-label='" . esc_attr__( 'Unapprove this comment' ) . "'>" . __( 'Unapprove' ) . '</a>';
        $actions['edit']      = "<a href='comment.php?action=editcomment&amp;c={$comment->comment_ID}' aria-label='" . esc_attr__( 'Edit this comment' ) . "'>" . __( 'Edit' ) . '</a>';
        $actions['reply']     = '<a onclick="window.commentReply && commentReply.open(\'' . $comment->comment_ID . '\',\'' . $comment->comment_post_ID . '\');return false;" class="vim-r hide-if-no-js" aria-label="' . esc_attr__( 'Reply to this comment' ) . '" href="#">' . __( 'Reply' ) . '</a>';
        $actions['spam']      = "<a href='$spam_url' data-wp-lists='delete:the-comment-list:comment-$comment->comment_ID::spam=1' class='vim-s vim-destructive' aria-label='" . esc_attr__( 'Mark this comment as spam' ) . "'>" . /* translators: mark as spam link */ _x( 'Spam', 'verb' ) . '</a>';
 
        if ( ! EMPTY_TRASH_DAYS ) {
            $actions['delete'] = "<a href='$delete_url' data-wp-lists='delete:the-comment-list:comment-$comment->comment_ID::trash=1' class='delete vim-d vim-destructive' aria-label='" . esc_attr__( 'Delete this comment permanently' ) . "'>" . __( 'Delete Permanently' ) . '</a>';
        } else {
            $actions['trash'] = "<a href='$trash_url' data-wp-lists='delete:the-comment-list:comment-$comment->comment_ID::trash=1' class='delete vim-d vim-destructive' aria-label='" . esc_attr__( 'Move this comment to the Trash' ) . "'>" . _x( 'Trash', 'verb' ) . '</a>';
        }
 
        $actions['view'] = '<a class="comment-link" href="' . esc_url( get_comment_link( $comment ) ) . '" aria-label="' . esc_attr__( 'View this comment' ) . '">' . __( 'View' ) . '</a>';
 
        /**
         * Filters the action links displayed for each comment in the 'Recent Comments'
         * dashboard widget.
         *
         * @since 2.6.0
         *
         * @param string[]   $actions An array of comment actions. Default actions include:
         *                            'Approve', 'Unapprove', 'Edit', 'Reply', 'Spam',
         *                            'Delete', and 'Trash'.
         * @param WP_Comment $comment The comment object.
         */
        $actions = apply_filters( 'comment_row_actions', array_filter( $actions ), $comment );
 
        $i = 0;
        foreach ( $actions as $action => $link ) {
            ++$i;
            ( ( ( 'approve' == $action || 'unapprove' == $action ) && 2 === $i ) || 1 === $i ) ? $sep = '' : $sep = ' | ';
 
            // Reply and quickedit need a hide-if-no-js span
            if ( 'reply' == $action || 'quickedit' == $action ) {
                $action .= ' hide-if-no-js';
            }
 
            if ( 'view' === $action && '1' !== $comment->comment_approved ) {
                $action .= ' hidden';
            }
            $actions_string .= "<span class='$action'>$sep$link</span>";
        }
    }
    ?>
 
        <li id="comment-<?php echo $comment->comment_ID; ?>" <?php comment_class( array( 'comment-item', wp_get_comment_status( $comment ) ), $comment ); ?>>
 
            <?php echo get_avatar( $comment, 50, 'mystery' ); ?>
 
            <?php if ( ! $comment->comment_type || 'comment' == $comment->comment_type ) : ?>
 
            <div class="dashboard-comment-wrap has-row-actions">
            <p class="comment-meta">
                <?php
                // Comments might not have a post they relate to, e.g. programmatically created ones.
                if ( $comment_post_link ) {
                    printf(
                        /* translators: 1: comment author, 2: post link, 3: notification if the comment is pending */
                        __( 'From %1$s on %2$s %3$s' ),
                        '<cite class="comment-author">' . get_comment_author_link( $comment ) . '</cite>',
                        $comment_post_link,
                        '<span class="approve">' . __( '[Pending]' ) . '</span>'
                    );
                } else {
                    printf(
                        /* translators: 1: comment author, 2: notification if the comment is pending */
                        __( 'From %1$s %2$s' ),
                        '<cite class="comment-author">' . get_comment_author_link( $comment ) . '</cite>',
                        '<span class="approve">' . __( '[Pending]' ) . '</span>'
                    );
                }
                ?>
            </p>
 
                <?php
            else :
                switch ( $comment->comment_type ) {
                    case 'pingback':
                        $type = __( 'Pingback' );
                        break;
                    case 'trackback':
                        $type = __( 'Trackback' );
                        break;
                    default:
                        $type = ucwords( $comment->comment_type );
                }
                $type = esc_html( $type );
                ?>
            <div class="dashboard-comment-wrap has-row-actions">
            <p class="comment-meta">
                <?php
                // Pingbacks, Trackbacks or custom comment types might not have a post they relate to, e.g. programmatically created ones.
                if ( $comment_post_link ) {
                    printf(
                        /* translators: 1: type of comment, 2: post link, 3: notification if the comment is pending */
                        _x( '%1$s on %2$s %3$s', 'dashboard' ),
                        "<strong>$type</strong>",
                        $comment_post_link,
                        '<span class="approve">' . __( '[Pending]' ) . '</span>'
                    );
                } else {
                    printf(
                        /* translators: 1: type of comment, 2: notification if the comment is pending */
                        _x( '%1$s %2$s', 'dashboard' ),
                        "<strong>$type</strong>",
                        '<span class="approve">' . __( '[Pending]' ) . '</span>'
                    );
                }
                ?>
            </p>
            <p class="comment-author"><?php comment_author_link( $comment ); ?></p>
 
            <?php endif; // comment_type ?>
            <blockquote><p><?php comment_excerpt( $comment ); ?></p></blockquote>
            <?php if ( $actions_string ) : ?>
            <p class="row-actions"><?php echo $actions_string; ?></p>
            <?php endif; ?>
            </div>
        </li>
    <?php
    $GLOBALS['comment'] = null;
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
2.7.0 Introduced.

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-admin/includes/dashboard.php: comment_row_actions

Filters the action links displayed for each comment in the ‘Recent Comments’ dashboard widget.
wp-admin/includes/template.php: _draft_or_post_title()

Get the post title.
wp-includes/capabilities.php: current_user_can()

Whether the current user has a specific capability.
wp-includes/l10n.php: esc_attr__()

Retrieve the translation of $text and escapes it for safe use in an attribute.
wp-includes/l10n.php: __()

Retrieve the translation of $text.
wp-includes/l10n.php: _x()

Retrieve translated string with gettext context.
wp-includes/formatting.php: esc_html()

Escaping for HTML blocks.
wp-includes/formatting.php: esc_url()

Checks and cleans a URL.
wp-includes/pluggable.php: get_avatar()

Retrieve the avatar <img> tag for a user, email address, MD5 hash, comment, or post.
wp-includes/pluggable.php: wp_create_nonce()

Creates a cryptographic token tied to a specific action, user, user session, and window of time.
wp-includes/link-template.php: get_the_permalink()

Retrieves the full permalink for the current post or post ID.
wp-includes/plugin.php: apply_filters()

Call the functions added to a filter hook.
wp-includes/comment-template.php: get_comment_link()

Retrieve the link to a given comment.
wp-includes/comment-template.php: comment_class()

Generates semantic classes for each comment element.
wp-includes/comment-template.php: comment_excerpt()

Display the excerpt of the current comment.
wp-includes/comment-template.php: get_comment_author_link()

Retrieve the HTML link to the URL of the author of the current comment.
wp-includes/comment-template.php: comment_author_link()

Display the html link to the url of the author of the current comment.
wp-includes/comment.php: wp_get_comment_status()

The status of a comment by ID.
Show 13 more uses Hide more uses

Top ↑

User Contributed Notes User Contributed Notes

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