Thème enfant et snippets · Leçon 8/20 · 12 min

Lire un petit extrait de PHP sans être développeur

Lire un petit extrait de PHP sans être développeur.

Durée indicative : 12 minutes.

Ce qui change par rapport au CSS

Le CSS agit sur la présentation. Le PHP permet notamment d’ajouter des comportements à WordPress.

Une erreur PHP peut empêcher une partie du site de fonctionner, voire bloquer l’administration. Une extension de snippets facilite les essais et la récupération, mais ne garantit pas qu’un code soit sans danger.

Nous allons utiliser un exemple limité : afficher un message fixe dans l’administration, sans modifier les contenus ni les réglages du site.

Capture d’écran du haut de la page « Get a faster, more secure website: update your PHP today » (documentation WordPress).
Page officielle « Get a faster, more secure website : update your PHP today » de la documentation WordPress (page en anglais).

Le snippet de l’atelier

Ne l’activez pas encore. Commencez par le lire :

// Affiche un rappel dans l'administration.
function t1pp_afficher_rappel_atelier() {
    echo '<div class="notice notice-info">';
    echo '<p>Atelier : sauvegarder avant de modifier.</p>';
    echo '</div>';
}

// Demande à WordPress d'afficher ce rappel au bon moment.
add_action( 'admin_notices', 't1pp_afficher_rappel_atelier' );

Le point d’accroche admin_notices permet d’afficher des messages dans les écrans classiques de l’administration. Les classes notice et notice-info donnent au message la présentation standard d’une notification d’information.

Lire le code morceau par morceau

ÉlémentCe qu’il fait ici
//Introduit un commentaire
functionDéclare une fonction
t1pp_afficher_rappel_atelierDonne un nom à notre fonction
{ et }Délimitent les instructions de la fonction
echoProduit le HTML à afficher
'...'Délimite une chaîne de texte
;Termine une instruction
add_action(...)Relie la fonction à un moment prévu par WordPress

Le préfixe t1pp_ aide à distinguer notre fonction des autres fonctions présentes sur le site. Il ne faut pas activer deux extraits qui déclarent exactement la même fonction.

Le lien avec le module 1

À l’intérieur des instructions echo, vous retrouvez du HTML :

<div class="notice notice-info">
  <p>Atelier : sauvegarder avant de modifier.</p>
</div>

Vous connaissez déjà :

  • le conteneur <div> ;
  • le paragraphe <p> ;
  • les classes dans l’attribut class.

Ici, PHP demande simplement à WordPress de produire ce HTML au moment prévu.

Où mettre <?php ?

Dans un vrai fichier PHP, une balise ouvrante <?php indique le début du code PHP.

Dans l’éditeur de snippets PHP utilisé à la leçon suivante, collez seulement le corps de l’extrait présenté, sans ajouter de balise ouvrante ou fermante.

Ne confondez pas les deux contextes.

Ne pas copier le functions.php du parent

Le fichier functions.php d’un thème enfant ne remplace pas celui du parent : les deux sont chargés.

Recopier intégralement celui du parent dans l’enfant peut provoquer des erreurs fatales à cause de fonctions déclarées deux fois. Ajoutez seulement le code nécessaire à votre personnalisation, à l’emplacement choisi.

Dans cet atelier, notre fonction sera enregistrée dans une extension de snippets, pas dans functions.php.

À vous de jouer

Avant de passer à l’activation, expliquez avec vos mots :

  1. Quel message sera affiché ?
  2. Sera-t-il visible sur une page publique ?
  3. Le snippet modifie-t-il un article ou un réglage ?

Réponses attendues :

  1. « Atelier : sauvegarder avant de modifier. »
  2. Non, il utilise un point d’accroche de l’administration.
  3. Non, cet exemple produit uniquement un affichage.

À retenir

Lire un extrait PHP, c’est repérer ce qu’il déclenche, où il agit et ce qu’il affiche.

Toutes les formations

Formations connexes

Nos autres formations

Toutes les formations