wppaste
WordPress

apply_filters( 'post_link_category', WP_Term $cat, array $cats, WP_Post $post )

Since
3.5.0
Filters the category that gets used in the %category% permalink token.

Compatibility

WordPress
since 3.5.0
  • 6.7.7
  • 6.8.8
  • 6.9.7
  • 7.0.4
  • 7.1.0

Present in every tracked release (6.7.7 to 7.1.0).

Parameters

$catWP_Term
The category to use in the permalink.
$catsarray
Array of all categories (WP_Term objects) associated with the post.
$postWP_Post
The post in question.

Where this hook fires · 1

  • wp-includes/link-template.php:244get_permalink()

Source code

				 * @since 3.5.0				 *				 * @param WP_Term  $cat  The category to use in the permalink.				 * @param array    $cats Array of all categories (WP_Term objects) associated with the post.				 * @param WP_Post  $post The post in question.				 */				$category_object = apply_filters( 'post_link_category', $cats[0], $cats, $post ); 				$category_object = get_term( $category_object, 'category' );				$category        = $category_object->slug;				if ( $category_object->parent ) {					$category = get_category_parents( $category_object->parent, false, '/', true ) . $category;				}

Changelog

Introduced in 3.5.0. Unchanged from 6.7.7 through 7.1.0.

  1. 6.7.7
  2. 6.8.8
  3. 6.9.7
  4. 7.0.4
  5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data
Generated from the wordpress-develop 7.0.4 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
Corrections
Something wrong on this page? Report it and it gets fixed in the next regeneration.