get_category_by_slug() – Function | Developer.WordPress.org

Retrieves a category object by category slug.

Parameters

$slugstringrequired: The category slug.

Return

object|false Category data object on success, false if not found.

More Information

Same is achieved by:
get_term_by('slug', $slug, 'category');

Source

function get_category_by_slug( $slug ) {
	$category = get_term_by( 'slug', $slug, 'category' );

	if ( $category ) {
		_make_cat_compat( $category );
	}

	return $category;
}

View all references View on Trac View on GitHub

Uses	Description
_make_cat_compat()`wp-includes/category.php`	Updates category structure to old pre-2.3 from new taxonomy structure.
get_term_by()`wp-includes/taxonomy.php`	Gets all term data from database by term field and data.

Changelog

Version	Description
2.3.0	Introduced.

User Contributed Notes

Skip to note 4 content

Ivan Shulev 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 4You must log in to vote on the helpfulness of this note

Returns false if not found

Log in to add feedback
Skip to note 5 content

Ivan Shulev 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 4You must log in to vote on the helpfulness of this note
Example
```
$idObj = get_category_by_slug( 'category-slug' );

if ( $idObj instanceof WP_Term ) {
	$id = $idObj->term_id;
}
```
Log in to add feedback
Skip to note 6 content

Steven Lin 4 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Example migrated from Codex:
```
<?php 
   $idObj = get_category_by_slug('category-slug'); 
   $id = $idObj->term_id;
?>
```
Log in to add feedback

get_category_by_slug( string $slug ): object|false

In this article

Parameters

Return

More Information

Source

Changelog

User Contributed Notes

get_category_by_slug( string $slug ): object|false

In this article

Parameters

Return

More Information

Source

Related

Changelog

User Contributed Notes