get_category_by_slug( string $slug ): object|false

Retrieves a category object by category slug.

Contents

Parameters
Return
More Information
Source
Related
- Uses
Changelog
User Contributed Notes

Parameters

$slug string Required: 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

File: wp-includes/category.php. View all references

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

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

	return $category;
}

View on Trac View on GitHub

Uses

Uses
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

Changelog
Version	Description
2.3.0	Introduced.

User Contributed Notes

Skip to note 1 content

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

Contributed by Ivan Shulev — 7 years ago

Returns false if not found

Log in to add feedback
Skip to note 2 content

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

Contributed by Ivan Shulev — 7 years ago
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 3 content

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

Contributed by Steven Lin — 3 years ago
Example migrated from Codex:
```
<?php 
   $idObj = get_category_by_slug('category-slug'); 
   $id = $idObj->term_id;
?>
```
Log in to add feedback

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