Un guide sur WordPress PHP

Vous cherchez à comprendre WordPress PHP ? Dans cet article, nous allons expliquer ce qu'est PHP et comment il fonctionne avec WordPress. Comprendre PHP et comment il s'intègre à WordPress aidera à la maintenance du site, au dépannage des erreurs et au développement de WordPress en général.

Qu'est-ce que PHP ?

PHP, abréviation de Hypertext Preprocessor, est un langage de script utilisé par environ 79 % des internautes . PHP vous permet de faire de nombreuses choses puissantes, telles que l'interaction avec une base de données, l'écriture d'instructions conditionnelles, l'obtention d'informations spécifiques à WordPress, l'extraction de fichiers multimédias et bien plus encore.

WordPress PHP

PHP est ce qui alimente WordPress, car la plupart des fichiers principaux de WordPress sont écrits dans ce langage. Si vous regardez la liste des fichiers d'un site Web WordPress, vous verrez que la plupart des fichiers se terminent par .php, ce qui signifie que le fichier est un fichier PHP. La plupart des fichiers PHP WordPress répertoriés dans la capture d'écran ci-dessous sont nécessaires au fonctionnement d'un site Web WordPress.

Comment fonctionne PHP : Sites Web WordPress

Regardons un exemple réel de la façon dont PHP est utilisé sur un site Web WordPress. Dans cet exemple, nous utiliserons une instruction conditionnelle pour déterminer si un utilisateur est connecté ou non :

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

Même si vous n'avez aucune connaissance de PHP, vous pouvez retenir qu'un utilisateur est connecté ou non connecté. Nous utilisons un conditionnel (if/else) pour vérifier si l'utilisateur est connecté ou non, s'il l'est alors nous affichera un message de bienvenue et s'ils ne le sont pas, nous leur demanderons de se connecter. Bien qu'il ne s'agisse que d'un exemple de base, vous pouvez voir à quel point les conditions peuvent être puissantes.

Vous pouvez voir que nous avons vérifié la fonction "user_is_logged_in". Nous savons qu'il s'agit d'une fonction car elle a les parenthèses "()" après le nom.

Si la fonction renvoie false, lorsque le code est exécuté, il affiche le message :

"Vous n'êtes pas connecté! Veuillez vous connecter.

PHP et WordPress

Juste à partir de l'exemple ci-dessus, vous remarquerez que PHP se trouve partout dans WordPress. WordPress possède des sous-systèmes tels que des boucles qui contrôlent le nombre de publications affichées, ainsi que des crochets qui modifient les fonctionnalités, les API, les thèmes et les plugins.

WordPress PHP : Activer le débogage

WordPress, par défaut, n'affichera aucune erreur/avertissement généré par PHP. C'est une bonne pratique pour les sites en production, mais si vous développez, vous voulez que cela soit activé. Pour activer le débogage, modifiez simplement cette ligne dans le fichier wp-config.php, qui se trouve dans le répertoire racine de WordPress :

define( 'WP_DEBUG', false );

Modifiez simplement la constante WP_DEBUG en true , puis enregistrez le fichier. Toutes les erreurs ou avertissements masqués seront désormais affichés, c'est ce que nous voulons.

La boucle et la requête

La requête est un système qui rassemble les publications à afficher sur la page, et la boucle est ce qui passe par chaque publication et les affiche en conséquence. Sur votre page d'accueil, la requête recherchera les publications les plus récentes et récupérera les 10 publications les plus récentes. Sur une page de catégorie, la requête recherchera les 10 messages les plus récents de la catégorie donnée. Vous pouvez également modifier la requête et l'utiliser pour ce que vous devez faire.

Regardons un exemple :

<?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' ) );
 
?>

Le code commence par vérifier si la fonction « have_posts() » a des données à parcourir. Dans le cas contraire, il définit une variable $ i à 0. Il fonctionne alors une boucle while, qui est une boucle qui fonctionnera tant que la condition est vraie (c. -à- a des données à retour). Il incrémente d'abord la variable $i de 1 "$i++;", puis il exécute une instruction conditionnelle vérifiant si la variable $i est supérieure à 1. Si c'est le cas, il affiche du code HTML pour séparer le message. Après cela, obtenez le message avec la fonction "the_posts()" et affichez le contenu du message avec la fonction "get_template_part()".

Si cette condition n'est pas remplie, il utilise la fonction "is_search" pour déterminer s'il s'agissait ou non d'une recherche. Si c'était le cas, il rend simplement du code HTML et exécute une fonction "get_search_form()" qui demande à l'utilisateur de rechercher à nouveau.

Crochets

WordPress donne aux développeurs la possibilité de modifier les fonctions principales. Cependant, vous ne voulez pas modifier les fichiers de base. C'est la règle n°1 du développement, et c'est tout simplement une mauvaise pratique. Cela peut parfois être difficile selon le projet sur lequel vous travaillez, mais c'est là que les crochets entrent en jeu. WordPress est tout au sujet des crochets, et il a deux crochets principaux qui sont utilisés pour le développement. Ces deux crochets sont des crochets d'action et des crochets de filtre. Les crochets d'action vous permettent d'ajouter du code personnalisé et les crochets de filtre vous permettent de modifier les données avant qu'elles ne soient utilisées.

Personnalisons le wp_footer pour ajouter notre propre code avant la balise body de fermeture du thème. Si vous ouvrez le fichier functions.php du thème, vous pouvez ajouter le code suivant :

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 );

Ce code crée une fonction "itemes_footer_code", qui est utilisée comme fonction de rappel utilisée pour la fonction "add_action()". Cette fonction contient le code que nous aimerions exécuter sur le wp_footer. Pour le premier paramètre de add_action, nous appelons 'wp_footer' qui indique que ce code sera exécuté sur le pied de page. Le deuxième paramètre est la fonction de rappel (la fonction que nous venons de créer) et elle exécutera le code personnalisé. Ceci est un exemple de crochet d'action.

Modifions la longueur personnalisée d'un extrait de message. Par défaut, WordPress affichera 57 caractères mais nous pouvons modifier le nombre de caractères pour qu'il soit plus ou moins :

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

Nous vérifions d'abord si la fonction que nous créons existe déjà en écrivant une condition pour la fonction "function_exists()". Si elle n'existe pas, alors nous créons notre fonction et elle prend $length comme argument. Nous retournons ensuite la valeur de 50. Après cela, nous exécutons la fonction "add_filter()" qui peut contenir 4 paramètres, mais nous n'en utilisons que trois. Ceci est un exemple de crochet de filtre.

Conclusion : WordPress PHP

Comme vous pouvez le voir, le simple fait d'apprendre les bases de WordPress PHP et comment PHP est implémenté dans la base de code WordPress vous permet de mieux comprendre comment votre site fonctionne réellement dans les coulisses. Regardez quelques-uns de nos didacticiels vidéo ici sur PHP : la syntaxe, la boucle dans WordPress et les balises de modèle WordPress.