A WordPress web site can have totally different sorts of pages like an about web page, contact web page, privateness coverage web page, writer web page, or homepage.
Typically, once we are growing a theme, a plugin or implementing another performance in WordPress, it turns into vital to find out whether or not the present web page is the homepage. On this tutorial, we are going to be taught precisely how to try this.
What’s WordPress Homepage and Entrance Web page?
The homepage is a particular sort of web page in WordPress. It refers to a web page on the web site that accommodates the listing of all weblog posts that you’ve got printed in a chronological order.
This isn’t to be confused with the idea of a static entrance web page which was launched in WordPress 2.1. The content material of a static entrance web page shouldn’t be essentially going to be static. Nevertheless, it’s not meant comprise an inventory of all weblog posts just like the homepage.
The suitable choices for setting a static web page because the entrance web page may be discovered by visiting Settings > Studying from the navigation in WordPress admin dashboard.
The terminology for house web page and a entrance web page could be a bit complicated. Typically, we consult with the principle URL of an internet site as its homepage. For instance, the homepage for Tuts+ shall be https://tutsplus.com/. Nevertheless, that is thought-about the entrance web page in WordPress.
The homepage and the entrance web page a WordPress web site can both be the identical or totally different from one another relying on the settings.
Utilizing the is_home() and is_front_page() features in WordPress
You should use the is_home() operate in WordPress to find out if the present web page is the weblog homepage or the web page which lists all weblog posts. It’ll present all of the weblog posts of your web site in chronological order.
Utilizing the screenshot in earlier part as reference, the is_home() operate will return true for the URL web site.com/weblog/. The Homepage choice within the settings refers back to the weblog homepage and never the principle URL of the web site.
It’s essential to use the is_front_page() operate to find out whether or not you’re presently on the entrance web page or the principle URL on the web site like web site.com. In our instance, the content material for the entrance web page or the principle web site URL shall be identical because the store web page.
You possibly can keep away from any confusion relating to these two features by holding the next factors in thoughts:
The operate is_front_page() will at all times return true when you find yourself on the principle URL of the web site like web site.com. It would not matter for those who use the principle URL to show some static content material or an inventory of weblog posts. The operate is_front_page() will return false on all different pages.
The operate is_home() will at all times return true when you find yourself on a web page that shows the weblog posts index. It would not matter if it’s the entrance web page of the web site or another web page. Calling is_home() wherever else will at all times return false.
Utilizing is_home() and is_front_page() collectively
You may want to make use of is_home() and is_front_page() collectively to perform sure duties relying in your settings.
Shall we say that you’ve got chosen the studying settings in WordPress dashboard such that the homepage shows the most recent weblog posts as proven within the picture above. On this case, the worth of is_home() and is_front_page() shall be true for the principle URL of the web site like web site.com.
<?php
// When checking the principle web site URL with the homepage set to show Newest Posts.
if(is_home()) {
// Executes
}
if(is_front_page()) {
// Executes
}
if(is_home() && is_front_page()) {
// Executes
}
if(is_home() || is_front_page()) {
// Executes
}
?>
As you possibly can see, utilizing is_front_page() is not any totally different than utilizing is_home() on this scenario. Each of them will return true for the principle URL and false for all different URLs.
Now, let’s imagine you will have set a static web page titled “Merchandise” with the URL web site.com/merchandise/ because the entrance web page of the web site and a weblog web page with the URL web site.com/weblog/ because the weblog homepage or the weblog index web page.
<?php
// When checking the principle web site URL with the homepage set to be a static web page
if(is_home()) {
// Does not execute
}
if(is_front_page()) {
// Executes
}
if(is_home() && is_front_page()) {
// Does not Execute
}
if(is_home() || is_front_page()) {
// Executes
}
?>
The listing of weblog posts shall be proven on the web page web site.com/weblog/. On this case, solely the code inside the primary and final if blocks will execute.
<?php
// When checking the URL web site.com/weblog/ with weblog set to be the posts web page.
if(is_home()) {
// Executes
}
if(is_front_page()) {
// Does not execute
}
if(is_home() && is_front_page()) {
// Does not Execute
}
if(is_home() || is_front_page()) {
// Executes
}
?>
None of those if blocks will execute for some other pages of the web site.
Shall we say you will have set your personal customized web page because the weblog homepage or the web page the place all the most recent posts will seem. What for those who resolve to show the title of the present web page earlier than the listing of posts however solely if you’re not on the principle web site URL? In that case, you need to use the next conditional block:
<?php
if(is_home() && !is_front_page()) {
echo '<h1>'.single_post_title().'</h1>';
}
?>
Programmatically Checking Person Preferences
It is usually potential for us to carry out checks about person choice associated to the setting of a selected homepage or entrance web page. We are able to use the get_option() operate to do that verify.
There are three choices whose values we will verify. These are: show_on_front, page_on_front, and page_for_posts.
The worth returned by a name to get_option('show_on_front') would both be posts or web page.
When this operate name returns posts, it signifies that the entrance web page has been set as much as present the listing of newest weblog posts. In different phrases, it implies that the calls to is_home() and is_front_page() will each return true.
When the decision to get_option('show_on_front') returns web page, it implies that a static web page has been assigned to be the entrance web page of the web site. A name to get_option('page_on_front') will now provide the ID of that static web page. It’s also possible to make a name to get_option('page_for_posts') to be able to get the ID of static web page that’s for use for displaying the most recent weblog posts.
Right here is the output for these three calls from my web site. Upon getting the ID of the static pages, you will get entry to extra details about them.
<?php
// web page
echo get_option('show_on_front')
// 342
echo get_option('page_on_front')
// 134
echo get_option('page_for_posts')
?>
Closing Ideas
On this tutorial, we realized about two vital features in WordPress referred to as is_home() and is_front_page() that we will use to verify if we’re presently on the weblog posts web page or the entrance web page of the web site. We realized the excellence between these two forms of pages and the way performing checks with each these features might help us execute sure code in very particular conditions.
On the finish, we additionally realized methods to decide which web page on the web site has been set to be the entrance web page or the weblog posts web page.
Publish thumbnail generated by OpenAI DALL-E.
