rel_canonical()

Outputs rel=canonical for singular queries.

Contents

Description Description

Source Source

File: wp-includes/link-template.php

3729
3730
3731
3732
3733
3734
3735
3736
3737
3738
3739
3740
3741
3742
3743
3744
3745
function rel_canonical() {
    if ( ! is_singular() ) {
        return;
    }
 
    $id = get_queried_object_id();
 
    if ( 0 === $id ) {
        return;
    }
 
    $url = wp_get_canonical_url( $id );
 
    if ( ! empty( $url ) ) {
        echo '<link rel="canonical" href="' . esc_url( $url ) . '" />' . "\n";
    }
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
4.6.0 Adjusted to use wp_get_canonical_url().
2.9.0 Introduced.

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-includes/link-template.php: wp_get_canonical_url()

Returns the canonical URL for a post.
wp-includes/formatting.php: esc_url()

Checks and cleans a URL.
wp-includes/query.php: is_singular()

Determines whether the query is for an existing single post of any post type (post, attachment, page, custom post types).
wp-includes/query.php: get_queried_object_id()

Retrieve ID of the current queried object.

Top ↑

User Contributed Notes User Contributed Notes

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