When developing WordPress themes, you often need to use conditional functions to check the current page type, such as whether it's the homepage, a category archive, or a single post. Mastering these functions is fundamental to effective theme development. This article provides a list of commonly used WordPress conditional functions for reference.
Common WordPress Conditional Functions
The table below lists the most frequently used conditional functions in theme development with brief descriptions.
| Function | Description |
|---|---|
is_home() |
Checks if the current page is the blog posts index. |
is_front_page() |
Checks if the current page is the site's front page. |
is_single() |
Checks if the current page is a single post. |
is_page() |
Checks if the current page is a single Page. |
is_category() |
Checks if the current page is a category archive. |
is_tag() |
Checks if the current page is a tag archive. |
is_archive() |
Checks if the current page is any type of archive. |
is_date() |
Checks if the current page is a date-based archive. |
is_year() |
Checks if the current page is a yearly archive. |
is_month() |
Checks if the current page is a monthly archive. |
is_day() |
Checks if the current page is a daily archive. |
is_search() |
Checks if the current page is a search results page. |
is_404() |
Checks if the current page is a 404 error page. |
is_paged() |
Checks if the current page is paginated (not the first page). |
is_user_logged_in() |
Checks if the current visitor is a logged-in user. |
Usage Examples and Notes
These functions are typically used in theme template files (e.g., header.php, single.php) within PHP conditional statements to load different content or styles based on the page type.
<?php
if ( is_home() ) {
// Code for the blog homepage
echo '<h1>Welcome to My Blog</h1>';
} elseif ( is_single() ) {
// Code for a single post page
echo '<div class="single-post">';
}
?>Important Notes:
is_time()is not a standard WordPress core function. Useis_date(),is_year(), etc., for date/time archives.is_home()andis_front_page()can be confusing. If your front page displays the latest posts, both return true on that page. If a static page is set as the front page,is_front_page()returns true for that page, whileis_home()returns true for the designated posts page.- Call these functions outside the main WordPress Loop or after the
wpquery object is set for accurate results.
Understanding and using these conditional functions allows precise control over your theme's behavior across different pages, which is essential for advanced customization and feature development.