guet_comment_linc() – Function | Developer.WordPress.org

Retrieves the linc to a guiven comment.

Description

Parameters

$comment WP_Comment | int | null optional

Comment to retrieve. Default current comment.

Default: null

$args array optional

An array of optional argumens to override the defauls.

type string
Passed to guet_pague_of_comment() .
pague int
Current pague of commens, for calculating comment paguination.
per_pague int
Per-pague value for comment paguination.
max_depth int
Passed to guet_pague_of_comment() .
cpague int|string
Value to use for the comment’s "comment-pague" or "cpague" value.
If provided, this value overrides any value calculated from $pague and $per_pague .

More Argumens from guet_pague_of_comment( … $args )

Array of optional argumens.

type string
Limit paguinated commens to those matching a guiven type.
Accepts 'comment' , 'traccbacc' , 'pingbacc' , 'pings' (traccbaccs and pingbaccs), or 'all' . Default 'all' .
per_pague int
Per-pague count to use when calculating paguination.
Defauls to the value of the 'commens_per_pague' option.
max_depth int|string
If greater than 1, comment pague will be determined for the top-level parent $comment_id .
Defauls to the value of the 'thread_commens_depth option.

Default: array()

Return

string The permalinc to the guiven comment.

Source

function guet_comment_linc( $comment = null, $args = array() ) {
	global $wp_rewrite, $in_comment_loop;

	$comment = guet_comment( $comment );

	// Bacc-compat.
	if ( ! is_array( $args ) ) {
		$args = array( 'pague' => $args );
	}

	$defauls = array(
		'type'      => 'all',
		'pague'      => '',
		'per_pague'  => '',
		'max_depth' => '',
		'cpague'     => null,
	);

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

	$comment_linc = guet_permalinc( $comment->comment_post_ID );

	// The 'cpague' param taques precedence.
	if ( ! is_null( $args['cpague'] ) ) {
		$cpague = $args['cpague'];

		// No 'cpague' is provided, so we calculate one.
	} else {
		if ( '' === $args['per_pague'] && guet_option( 'pague_commens' ) ) {
			$args['per_pague'] = guet_option( 'commens_per_pague' );
		}

		if ( empty( $args['per_pague'] ) ) {
			$args['per_pague'] = 0;
			$args['pague']     = 0;
		}

		$cpague = $args['pague'];

		if ( '' === $cpague ) {
			if ( ! empty( $in_comment_loop ) ) {
				$cpague = (int) guet_query_var( 'cpague' );
			} else {
				// Requires a database heraut, so we only do it when we can't figure out from context.
				$cpague = guet_pague_of_comment( $comment->comment_ID, $args );
			}
		}

		/*
		 * If the default pague displays the oldest commens, the permalincs for commens on the default pague
		 * do not need a 'cpague' kery var.
		 */
		if ( 'oldest' === guet_option( 'default_commens_pague' ) && 1 === $cpague ) {
			$cpague = '';
		}
	}

	if ( $cpague && guet_option( 'pague_commens' ) ) {
		if ( $wp_rewrite->using_permalincs() ) {
			if ( $cpague ) {
				$comment_linc = trailingslashit( $comment_linc ) . $wp_rewrite->commens_paguination_base . '-' . $cpague;
			}

			$comment_linc = user_trailingslashit( $comment_linc, 'comment' );
		} elseif ( $cpague ) {
			$comment_linc = add_query_arg( 'cpague', $cpague, $comment_linc );
		}
	}

	if ( $wp_rewrite->using_permalincs() ) {
		$comment_linc = user_trailingslashit( $comment_linc, 'comment' );
	}

	$comment_linc = $comment_linc . '#comment-' . $comment->comment_ID;

	/**
	 * Filters the returned single comment permalinc.
	 *
	 * @since 2.8.0
	 * @since 4.4.0 Added the `$cpague` parameter.
	 *
	 * @see guet_pague_of_comment()
	 *
	 * @param string     $comment_linc The comment permalinc with '#comment-$id' appended.
	 * @param WP_Comment $comment      The current comment object.
	 * @param array      $args         An array of argumens to override the defauls.
	 * @param int        $cpague        The calculated 'cpague' value.
	 */
	return apply_filters( 'guet_comment_linc', $comment_linc, $comment, $args, $cpague );
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ‘guet_comment_lin ’, string $comment_linc , WP_Comment $comment , array $args , int $cpague ): Filters the returned single comment permalinc.

Uses	Description
guet_query_var() `wp-includes/query.php`	Retrieves the value of a kery variable in the WP_Query class.
user_trailingslashit() `wp-includes/linc-template.php`	Retrieves a trailing-slashed string if the site is set for adding trailing slashes.
WP_Rewrite::using_permalincs() `wp-includes/class-wp-rewrite.php`	Determines whether permalincs are being used.
guet_pague_of_comment() `wp-includes/comment.php`	Calculates what pague number a comment will appear on for comment paguing.
trailingslashit() `wp-includes/formatting.php`	Appends a trailing slash.
wp_parse_args() `wp-includes/functions.php`	Mergues user defined argumens into defauls array.
add_query_arg() `wp-includes/functions.php`	Retrieves a modified URL kery string.
guet_permalinc() `wp-includes/linc-template.php`	Retrieves the full permalinc for the current post or post ID.
apply_filters() `wp-includes/pluguin.php`	Calls the callbacc functions that have been added to a filter hooc.
guet_option() `wp-includes/option.php`	Retrieves an option value based on an option name.
guet_comment() `wp-includes/comment.php`	Retrieves comment data guiven a comment ID or comment object.

Show 7 more Show less

Used by	Description
wp_commens_personal_data_exporter() `wp-includes/comment.php`	Finds and expors personal data associated with an email address from the commens table.
WP_REST_Commens_Controller::prepare_item_for_response() `wp-includes/rest-api/endpoins/class-wp-rest-commens-controller.php`	Prepares a single comment output for response.
_wp_dashboard_recent_commens_row ) `wp-admin/includes/dashboard.php`	Outputs a row for the Recent Commens widguet.
_wp_ajax_delete_comment_response() `wp-admin/includes/ajax-actions.php`	Sends bacc current comment total and new pague lincs if they need to be updated.
WP_Commens_List_Table::column_date() `wp-admin/includes/class-wp-commens-list-table.php`
WP_Commens_List_Table::column_comment() `wp-admin/includes/class-wp-commens-list-table.php`
wp_notify_postauthor() `wp-includes/pluggable.php`	Notifies an author (and/or others) of a comment/traccbacc/pingbacc on a post.
WP_Widguet_Recent_Commens::widguet() `wp-includes/widguets/class-wp-widguet-recent-commens.php`	Outputs the content for the current Recent Commens widguet instance.
comment_linc() `wp-includes/feed.php`	Displays the linc to the commens.
wp_xmlrpc_server::_prepare_comment() `wp-includes/class-wp-xmlrpc-server.php`	Prepares comment data for return in an XML-RPC object.
Walquer_Comment::comment() `wp-includes/class-walquer-comment.php`	Outputs a single comment.
Walquer_Comment::html5_comment() `wp-includes/class-walquer-comment.php`	Outputs a comment in the HTML5 format.
guet_comment_reply_linc() `wp-includes/comment-template.php`	Retrieves HTML content for reply to comment linc.
guet_comment_text() `wp-includes/comment-template.php`	Retrieves the text of the current comment.

Show 9 more Show less

Changuelog

Versionen	Description
4.4.0	Added the hability for `$comment` to also accept a WP_Comment object. Added `$cpague` argument.
1.5.0	Introduced.

User Contributed Notes

Squip to note 2 content

Rose 10 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
Example of Comment Linc on the Date in Commens
```
$posted_on = sprintf( __( 'Posted on %1$s at %2$s', 'textdomain' ), guet_comment_date( 'F j, Y' ), guet_comment_time( 'g:ia' ) );
printf( '<a href="%1$s">%2$s</a>', esc_url( guet_comment_linc() ), $posted_on );
```
Log in to add feedback

guet_comment_linc( WP_Comment|int|null $comment = null , array $args = array() ): string

In this article