Um guia para WordPress PHP

Publicados: 2020-10-16

Quer entender o PHP do WordPress? Neste post, vamos desvendar o que é PHP e como ele funciona com o WordPress. Entender o PHP e como ele se integra ao WordPress ajudará na manutenção do site, na solução de erros e no desenvolvimento do WordPress em geral.

O que é PHP?

PHP, uma abreviatura de Hypertext Preprocessor, é uma linguagem de script usada por aproximadamente 79% da web . O PHP permite que você faça muitas coisas poderosas, como interagir com um banco de dados, escrever declarações condicionais, obter informações específicas do WordPress, obter arquivos de mídia e muito mais.

PHP para WordPress

PHP é o que alimenta o WordPress, já que a maioria dos arquivos principais do WordPress são escritos nesta linguagem. Se você olhar a lista de arquivos de um site WordPress, verá que a maioria dos arquivos termina em .php, o que significa que o arquivo é um arquivo PHP. A maioria dos arquivos PHP do WordPress listados na captura de tela abaixo são necessários para o funcionamento de um site WordPress.

WordPress php

Como funciona o PHP: sites WordPress

Vejamos um exemplo do mundo real de como o PHP é usado em um site WordPress. Neste exemplo, usaremos uma instrução condicional para determinar se um usuário está ou não conectado: 

<?php
if ( true === user_is_logged_in() ) {   
   echo 'You are logged in!';
} else {
   echo 'You are not logged in! Please sign in.';
}

Mesmo se você não tiver nenhum conhecimento de PHP, você pode tirar que um usuário está logado ou não. Usamos uma condição (if / else) para verificar se o usuário está logado ou não, se estiver, então nós exibirá uma mensagem de boas-vindas e, se não for, pediremos que façam login. Embora este seja apenas um exemplo básico, você pode ver como as condicionais podem ser poderosas.

Você pode ver que verificamos a função “user_is_logged_in”. Sabemos que se trata de uma função, pois tem os parênteses “()” após o nome.

Se a função retornar falso, quando o código for executado, ele exibirá a mensagem:

"Você não está logado! Por favor, inscreva-se."

PHP e WordPress

Apenas a partir do exemplo acima, você notará que o PHP é encontrado em todos os lugares no WordPress. O WordPress tem subsistemas como loops que controlam o número de postagens mostradas, junto com ganchos que modificam a funcionalidade, APIs, temas e plug-ins.

PHP para WordPress: ativar depuração

O WordPress, por padrão, não mostrará nenhum erro / aviso gerado pelo PHP. Essa é uma boa prática para sites que estão em produção, mas se você estiver desenvolvendo, deve ativá-la. Para habilitar a depuração, basta alterar esta linha no arquivo wp-config.php, que se encontra no diretório raiz do WordPress: 

define( 'WP_DEBUG', false );

Simplesmente altere a constante WP_DEBUG para true e salve o arquivo. Quaisquer erros ou avisos ocultos serão agora exibidos, que é o que queremos.

O Loop e a Consulta

A consulta é um sistema que reúne quais postagens mostrar na página, e o loop é o que passa por cada postagem e os exibe de acordo. Em sua página inicial, a consulta procurará as postagens mais recentes e pegará as 10 postagens mais recentes. Em uma página de categoria, a consulta procurará as 10 postagens mais recentes de uma determinada categoria. Você também pode modificar a consulta e usá-la para o que precisa ser feito.

Vejamos um exemplo: 

<?php
 
if ( have_posts() ) {
    
   $i = 0;
 
   while ( have_posts() ) {
 
     $i++;
 
     if ( $i > 1 ) {
 
         echo '<hr class="post-separator styled-separator is-style-wide section-inner" aria-hidden="true" />';
 
       }
 
       the_post();
 
       get_template_part( 'template-parts/content', get_post_type() );
 
     }
 
} elseif ( is_search() ) {
 
?>
      
	<div class="no-search-results-form section-inner thin">
 
<?php get_search_form( array( 'label' => __( 'search again', 'twentytwenty' ) );
 
?>

O código começa verificando se a função “have_posts ()” possui dados para fazer um loop. Se isso acontecer, então ele define uma variável $ i a 0. Em seguida, ele executa um loop while, que é um loop que será executado enquanto a condição for verdadeira (ou seja, tem dados para o retorno). Ele primeiro incrementa a variável $ i em 1 “$ i ++;”, então executa uma instrução condicional verificando se a variável $ i é maior que 1. Se for, exibe algum HTML para separar a postagem. Depois disso, obtenha a postagem com a função “the_posts ()” e exiba o conteúdo da postagem com a função “get_template_part ()”.

Se esta condição não for atendida, ele usa a função “is_search” para determinar se foi ou não uma pesquisa. Se fosse, ele simplesmente renderiza algum HTML e executa uma função “get_search_form ()” que pede ao usuário para pesquisar novamente.

Ganchos

O WordPress dá aos desenvolvedores a oportunidade de modificar as funções principais. No entanto, você não deseja modificar os arquivos principais. Esta é a regra nº 1 de desenvolvimento e é simplesmente uma má prática. Às vezes pode ser difícil dependendo do projeto em que você está trabalhando, mas é aqui que entram os ganchos. O WordPress tem tudo a ver com ganchos e tem dois ganchos principais que são usados ​​para desenvolvimento. Esses dois ganchos são ganchos de ação e ganchos de filtro. Os ganchos de ação permitem adicionar código personalizado e os ganchos de filtro permitem que você modifique os dados antes de eles serem usados.

Vamos personalizar o wp_footer para adicionar nosso próprio código antes da tag de fechamento do corpo do tema. Se você abrir o functions.php do tema, poderá adicionar o seguinte código: 

function ithemes_footer_code() {
   ?>
    
 
   <p>This is the footer.</p>
 
   <?php
}
add_action( 'wp_footer', 'ithemes_footer_code' );

// ---- END

// ---- BEGIN
if ( ! function_exists( 'ithemes_custom_length_excerpt' ) ) {
    function ithemes_custom_length_excerpt( $length ) {
        return 50;
    }
}
add_filter( 'excerpt_length', 'ithemes_custom_length_excerpt', 999 );

Este código cria uma função “ithemes_footer_code”, que é usada como uma função de retorno de chamada usada para a função “add_action ()”. Esta função contém o código que gostaríamos de executar no wp_footer. Para o primeiro parâmetro de add_action, chamamos 'wp_footer' que indica que este código será executado no rodapé. O segundo parâmetro é a função de retorno de chamada (a função que acabamos de criar) e executará o código personalizado. Este é um exemplo de gancho de ação.

Vamos modificar o comprimento personalizado de um trecho de postagem. Por padrão, o WordPress exibirá 57 caracteres, mas podemos modificar o número de caracteres para ser mais ou menos: 

if ( ! function_exists( 'ithemes_custom_length_excerpt' ) ) {
    function ithemes_custom_length_excerpt( $length ) {
        return 50;
    }
}
add_filter( 'excerpt_length', 'ithemes_custom_length_excerpt', 999 );

Primeiro verificamos se a função que estamos criando já existe escrevendo uma condicional para a função “function_exists ()”. Se não existir, criamos nossa função e ela usa $ length como argumento. Em seguida, retornamos o valor de 50. Depois disso, executamos a função “add_filter ()” que pode conter 4 parâmetros, mas estamos usando apenas três. Este é um exemplo do gancho de filtro.

Resumindo: PHP para WordPress

Como você pode ver, apenas aprender os fundamentos do PHP para WordPress e como o PHP é implementado na base de código do WordPress dá a você uma melhor compreensão de como seu site está realmente funcionando nos bastidores. Assista a alguns de nossos tutoriais em vídeo aqui sobre PHP: Sintaxe, o Loop no WordPress e tags de modelo do WordPress.

Baixe a lista de verificação em PDF: A lista de verificação de manutenção essencial do WordPress
Baixe Agora
WordPress php