Um site WordPress pode ter diferentes tipos de páginas, como uma página sobre, página de contato, página de política de privacidade, página do autor ou página inicial.
Às vezes, quando estamos desenvolvendo um tema, um plugin ou implementando alguma outra funcionalidade no WordPress, torna-se importante determinar se a página atual é a página inicial. Neste tutorial, vamos aprender exatamente como fazer isso.
O que é a página inicial e a página inicial do WordPress?
A página inicial é um tipo especial de página no WordPress. Refere-se a uma página no site que contém a lista de todas as postagens do blog que você publicou em ordem cronológica.
Isso não deve ser confundido com o conceito de uma página inicial estática que foi introduzida no WordPress 2.1. O conteúdo de uma página inicial estática não será necessariamente estático. No entanto, não se destina a conter uma lista de todas as postagens do blog, como a página inicial.
As opções apropriadas para definir uma página estática como a página inicial podem ser encontradas visitando Configurações > Leitura da navegação no painel de administração do WordPress.
A terminologia para página inicial e página inicial pode ser um pouco confusa. Geralmente, nos referimos ao URL principal de um site como sua página inicial. Por exemplo, a página inicial do Tuts+ será https://tutsplus.com/. No entanto, esta é considerada a primeira página no WordPress.
A página inicial e a página inicial de um site WordPress podem ser iguais ou diferentes uma da outra, dependendo das configurações.
Usando o is_home() e is_front_page() funções no WordPress
Você pode usar o is_home() função no WordPress para determinar se a página atual é a página inicial do blog ou a página que lista todas as postagens do blog. Ele mostrará todas as postagens do blog do seu site em ordem cronológica.
Usando a captura de tela na seção anterior como referência, o is_home() a função retornará true para o URL site.com/blog/. o Pagina inicial opção nas configurações refere-se à página inicial do blog e não ao URL principal do site.
Você precisa usar o is_front_page() função para determinar se você está atualmente na primeira página ou no URL principal do site, como site.com. Em nosso exemplo, o conteúdo da página inicial ou o URL do site principal será o mesmo da página da loja.
Você pode evitar qualquer confusão em relação a essas duas funções, mantendo os seguintes pontos em mente:
A função is_front_page() sempre vai voltar true quando você está no URL principal do site, como website.com. Não importa se você usa a URL principal para exibir algum conteúdo estático ou uma lista de postagens de blog. A função is_front_page() retornará false em todas as outras páginas.
A função is_home() sempre vai voltar true quando você está em uma página que exibe o índice de postagens do blog. Não importa se é a primeira página do site ou alguma outra página. Ligando is_home() em qualquer outro lugar sempre retornará false.
Usando is_home() e is_front_page() juntos
Você pode precisar usar is_home() e is_front_page() juntos para realizar determinadas tarefas, dependendo de suas configurações.
Digamos que você tenha escolhido as configurações de leitura no painel do WordPress de forma que a página inicial exiba as últimas postagens do blog, conforme mostrado na imagem acima. Neste caso, o valor de is_home() e is_front_page() vai ser true para o URL principal do site como site.com.
Como você pode ver, usando is_front_page() não é diferente de usar is_home() nesta situação. Os dois vão voltar true para o URL principal e false para todos os outros URLs.
Agora, digamos que você tenha definido uma página estática intitulada “Produtos” com o URL site.com/products/ como a página inicial do site e uma página de blog com o URL site.com/blog/ como a página inicial do blog ou a página de índice do blog.
A lista de postagens do blog será mostrada na página site.com/blog/. Nesse caso, apenas o código dentro do primeiro e do último if blocos serão executados.
Nenhum desses if blocos serão executados para quaisquer outras páginas do site.
Digamos que você tenha definido sua própria página personalizada como a página inicial do blog ou a página onde todas as postagens mais recentes serão exibidas. E se você decidir exibir o título da página atual antes da lista de postagens, mas apenas se não estiver na URL principal do site? Nesse caso, você pode usar o seguinte bloco condicional:
'.single_post_title().''; } ?>
Verificando as preferências do usuário programaticamente
Também é possível realizar verificações sobre a preferência do usuário relacionada à configuração de uma página inicial ou página inicial específica. Podemos usar o get_option() função para fazer esta verificação.
Existem três opções cujos valores podemos verificar. Estes são: show_on_front, page_on_fronte page_for_posts.
O valor retornado por uma chamada para get_option('show_on_front') ou seria posts ou page.
Quando esta chamada de função retorna posts, indica que a página inicial foi configurada para mostrar a lista das últimas postagens do blog. Em outras palavras, significa que as chamadas para is_home() e is_front_page() ambos retornarão true.
Quando a chamada para get_option('show_on_front') retorna page, significa que uma página estática foi designada para ser a primeira página do site. Uma chamada para get_option('page_on_front') agora lhe dará o ID dessa página estática. Você também pode ligar para get_option('page_for_posts') para obter o ID da página estática que deve ser usada para exibir as últimas postagens do blog.
Aqui está a saída para essas três chamadas do meu site. Depois de ter o ID das páginas estáticas, você pode ter acesso a mais informações sobre elas.
Pensamentos finais
Neste tutorial, aprendemos sobre duas funções importantes no WordPress chamadas is_home() e is_front_page() que podemos usar para verificar se estamos atualmente na página de postagens do blog ou na página inicial do site. Aprendemos a distinção entre esses dois tipos de páginas e como realizar verificações com essas duas funções pode nos ajudar a executar determinado código em situações muito específicas.
No final, também aprendemos como determinar qual página do site foi definida para ser a página inicial ou a página de postagens do blog.
Miniatura de postagem gerada por OpenAI DALL-E.
