Personnaliser le site avec le fichier functions.php

Créer des fonctions simples en PHP

Ajouter une fonction dans WordPress s’effectue de la même manière qu’en PHP. Écrivez les lignes suivantes dans votre fichier functions.php, à la suite des fonctions existantes :

<?php  
function ma_fonction(){ 
   //le code de ma fonction  
   return 'je suis la fonction ma_fonction'; 
} 
?> 

Vous pouvez faire appel à cette fonction dans n’importe quel fichier de votre thème à un ou plusieurs endroits. Écrivez ceci dans un modèle de page du thème, par exemple dans header.php, footer.php ou index.php :

<?php echo ma_fonction(); ?> 

Dans le cas où une fonction du même nom existerait déjà, pensez à vérifier que la fonction existe avant de l’appeler, cela évite l’affichage d’une erreur sur le site. Pour cela, utilisez la fonction PHP :

 function_exists('nom_de_ma_fonction') 

Ce qui donne :

<?php if(function_exists('ma_fonction')){ echo ma_fonction(); } ?> 

<?php  
function mon_image(){ 
   return '<img src="chemindemonimage.jpg" alt="mon...

Créer une fonction fil d’Ariane simple

Un fil d’Ariane est une suite de liens indiquant l’endroit où vous vous trouvez sur un site internet. Il existe des extensions toutes prêtes, mais pour comprendre le fonctionnement de WordPress, et mettre en pratique les notions vues au chapitre WordPress et PHP, vous allez créer votre propre fonction dans le fichier functions.php.

Pour cela, vous avez besoin de la globale $post, des marqueurs conditionnels, des fonctions PHP et des fonctions propres à WordPress. Vous retrouvez les fonctions WordPress utilisées dans cet exemple dans le chapitre WordPress et PHP.

Créez la fonction fil_ariane(), faites appel à la globale $post, avec en sortie de la fonction un marqueur PHP : return, qui retourne une variable : $fil. $fil renverra le code HTML du fil d’Ariane :

<?php 
function fil_ariane(){ 
   global $post; 
 
   return $fil; 
} 
?> 

Affichez le fil d’Ariane sur toutes les pages, excepté sur la page d’accueil. Utilisez le marqueur conditionnel is_front_page().

if (!is_front_page()){} 

Cette ligne de code vérifie que ce n’est pas la page d’accueil.

Puis, ajoutez à la variable $fil :

Ce qui donne la fonction suivante :

<?php 
function fil_ariane(){ 
   global $post; 
       if...

Créer une fonction pour afficher des articles d’une catégorie avec l’objet WP_Query

Dans cette fonction, vous verrez comment faire une requête sur les articles, afin d’afficher les articles appartenant à une catégorie précise. La catégorie doit être créée au préalable, dans la page de l’administration Articles - Catégories.

Page Articles - Catégories - Ajouter une nouvelle catégorie

Pour cet exemple, appelez la catégorie « Actualités » et récupérez l’id (voir le chapitre WordPress et PHP, section Les marqueurs conditionnels).

Dans cet exemple, l’id de la catégorie est 8, mais il est probablement différent pour vous.

Page Articles - Catégories, l’id de la catégorie créée est 8, car la variable tag_ID passée dans l’URL est égale à 8

Attribuez ensuite des articles à cette catégorie, une catégorie sans article ne renvoie aucun résultat. Pour cela, créez des articles avec un titre, du texte, une image à la une, un extrait, puis attribuez-leur la catégorie Actualités.

Page Articles - Ajouter un nouvel article, cochez la case Actualités dans le bloc Catégories pour lier l’article à la catégorie

Pour récupérer les articles, utilisez l’objet WP_Query. Il est possible de récupérer...

Ajouter un lien « Lire la suite » aux résumés

Certains thèmes utilisent la fonction WordPress the_excerpt(). Cette fonction sert à afficher le contenu de la section Extrait que l’on trouve dans l’administration dans la colonne Document à droite de la page Articles.

Section Extrait

Pour afficher un lien Lire la suite qui renvoie sur l’article entier, il faut modifier à la fin de l’extrait, la fonction WordPress de base : the_excerpt().

Si vous reprenez l’exemple précédent, il faudra alors enlever le code HTML du lien Lire la suite dans la fonction posts_actu, sinon deux liens apparaîtront.

Créez la fonction excerpt_new() dans le fichier functions.php et récupérez la valeur que renvoie the_excerpt(), grâce à l’argument $outpout :

function excerpt_new($outpout){ 
   return $outpout ; 
} 

À ce stade la fonction excerpt_new() retourne exactement la même chose que the_excerpt().

Maintenant, récupérez l’URL de l’article, grâce à la fonction WordPress get_permalink(), pour créer un lien HTML qui renvoie sur la page de l’article complet.

function excerpt_new($outpout){ 
   global $post; 
   
   return $outpout.' <a href="'.get_permalink($post->ID).'"> ...

Ajouter des feuilles de style et des scripts

Lors de la création de sites Internet, il est nécessaire d’ajouter des feuilles de style CSS ou des scripts JavaScript.

Avec WordPress, vous pouvez ajouter directement dans le fichier header.php des appels aux fichiers CSS/JavaScript ou dans le fichier footer.php des appels aux fichiers JavaScript, à l’aide de balises HTML classiques.

Grâce à des fonctions WordPress, il est possible d’en ajouter également.

Utiliser ces fonctions permet d’ajouter aux fonctions wp_head() et wp_footer() des fichiers CSS et JavaScript grâce à des hooks. Cette solution est d’ailleurs recommandée.

WordPress dispose aussi d’une bibliothèque de scripts utilisables facilement.

Il est important de bien comprendre ces fonctions, utiles et indispensables lors de la création d’extensions.

<?php wp_register_style( $key, $src, $deps, $ver, $media ); ?> 
 
<?php wp_enqueue_style( $key, $src, $deps, $ver, $media ); ?> 

<?php wp_register_script( $key, $src, $deps, $ver, $footer ); ?> 
 
<?php wp_enqueue_script( $key, $src, $deps, $ver, $footer ); ?> 

Créer des emplacements pour les menus

Vous avez vu au chapitre WordPress et PHP la fonction wp_nav_menu(). Maintenant vous allez voir comment définir des emplacements spécifiques pour les menus, grâce à la fonction WordPress register_nav_menus().

Cette fonction ajoute un onglet supplémentaire Gérer les emplacements, dans le panel d’administration Apparence - Menus.

Certains thèmes intègrent directement cette fonction. Par exemple, le thème Twenty Twenty-One le propose, cela signifie que la fonction register_nav_menus () est présente dans le fichier functions.php de ce thème.

Pour le thème Twenty Twenty-One, nous avons le code suivant ligne 74 :

register_nav_menus( 
    array( 
        'primary' => esc_html__( 'Primary menu', 'twentytwentyone' ), 
        'footer' => esc_html__( 'Secondary menu', 'twentytwentyone' ), 
    ) 
); 

Ce code permet d’avoir les menus suivants dans l’administration :

Gérer les emplacements du thème Twenty Twenty-One

Partie du fichier functions.php du thème Twenty Twenty-One

Voici le détail de la fonction register_nav_menus() :

<?php register_nav_menus( $locations ); ?>...

Créer des sidebars et des zones pour les sidebars

Les sidebars servent à afficher des widgets. La plupart du temps, la sidebar est la colonne latérale d’un site web mais, selon les thèmes, elle peut se trouver en pied de page, dans l’en-tête, sur une page spécifique (comme la page d’accueil)... Les sidebars sont directement liées aux thèmes et peuvent changer d’un thème à l’autre. Vous allez voir comment créer vos propres sidebars, ainsi que l’emplacement leur correspondant. Pour créer des sidebars, vous allez utiliser la fonction WordPress register_sidebar().

Cette fonction permet d’enregistrer et ainsi de créer des sidebars dans l’administration Apparence - Widgets.

Certains thèmes intègrent directement cette fonction. Par exemple, le thème Twenty Twenty-One le propose, cela signifie que la fonction register_sidebar() est présente dans le fichier functions.php de ce thème. Elle est utilisée ligne 357 dans la fonction twenty_twenty_one_ widgets_init().

Dans le thème Twenty Twenty-One, les sidebars Colonne latérale du blog et Pied de page sont créées par cette fonction.

Partie du fichier functions.php du thème Twenty Twenty-One pour créer la sidebar pied de page

Pour créer des sidebars, vous avez besoin de la fonction WordPress :

<?php register_sidebar($args)...

Customiser un thème avec add_theme_support()

La fonction WordPress add_theme_support() permet d’ajouter des fonctionnalités au thème, comme des formats pour les articles, un logo, des en-têtes de page, un background (arrière-plan), etc. mais aussi d’ajouter des fonctionnalités à l’éditeur de bloc Gutenberg. Vous pouvez également vous servir du fichier theme.json pour activer et désactiver cetaines fonctionnalités et d’en personnaliser d’autres.

Cette fonction est utilisée par beaucoup de thèmes, mais certains n’exploitent pas toutes les possibilités qu’offre la fonction.

La fonction add_theme_support() doit être attachée au hook d’action after_setup_theme, qui exécute la fonction lors du chargement du thème.

Si certains éléments ne sont pas présents dans votre thème d’origine, ajoutez cette fonction dans le fichier functions.php, pour activer ces options.

Voici le détail de cette fonction :

<?php add_theme_support( $custom, $arg ); ?> 

Ajouter d’autres types d’articles

Par défaut, WordPress utilise deux types d’articles : les articles que l’on retrouve dans l’onglet Articles et les pages que l’on retrouve dans l’onglet Pages, mais il est tout à fait possible d’ajouter d’autres types d’articles (post_type) comme des produits, des fiches clients ou un portfolio...

Ces types d’articles apparaissent sous forme d’onglets dans le menu d’administration. Ils sont de la même forme que les articles de base et les pages de base, avec les mêmes sous-menus de base pour voir la liste ou pour ajouter des articles. C’est une sorte de clone des parties Articles ou Pages, que vous pouvez paramétrer comme vous voulez.

Pour pouvoir faire cela, utilisez la fonction :

<?php register_post_type( $post_type_name, $args ) ?> 

$args = array( 
   'label' =>'', 
   'labels' =>'', 
   'description...

Ajouter des taxonomies spécifiques

Pour ajouter votre propre taxonomie, utilisez la fonction WordPress :

<?php register_taxonomy( $taxonomy_name, $post_type_name, $args ); ?> 

$args = array( 
   'label' =>'', 
   'labels' =>'', 
   'public ' =>'', 
   'show_ui ' =>'', 
   'show_in_nav_menus' =>'', 
   'show_tagcloud' =>'', 
   'meta_box_cb' =>'',  
   'show_admin_column' =>'', 
   'hierarchical' =>'',  
   'update_count_callback' =>'',  
   'query_var' =>'', 
   'rewrite' =>'', 
   'capabilities'...