apply_filters( 'post_link', string $permalink, WP_Post $post, bool $leavename )

Filters the permalink for a post.


Description Description

Only applies to posts with post_type of ‘post’.


Top ↑

Parameters Parameters

$permalink

(string) The post's permalink.

$post

(WP_Post) The post in question.

$leavename

(bool) Whether to keep the post name.


Top ↑

More Information More Information

post_link is a filter applied to the permalink URL for a post prior to returning the processed url by the function get_permalink().

This filter only applies to posts with post_type of ‘post’. For that filter which applies to custom post type look post_type_link.


Top ↑

Source Source

File: wp-includes/link-template.php

View on Trac



Top ↑

Changelog Changelog

Changelog
Version Description
1.5.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 2 content
    Contributed by stevenlinx

    Example migrated from Codex:

    Append the query string for posts to permalink URLs (uses add_query_arg):

    function append_query_string( $url, $post, $leavename=false ) {
    	if ( $post->post_type == 'post' ) {
    		$url = add_query_arg( 'foo', 'bar', $url );
    	}
    	return $url;
    }
    add_filter( 'post_link', 'append_query_string', 10, 3 );
    

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