25 astuces utiles pour le fichier de fonctions WordPress

Le fichier de fonctions, souvent désigné sous le nom de functions.php, est un élément essentiel de tout thème WordPress. Situé à la racine du dossier du thème, ce fichier permet aux développeurs et concepteurs de thèmes d’ajouter des fonctionnalités spécifiques à un thème ou de modifier des comportements existants de WordPress.

Il est important de noter que toute modification apportée à ce fichier doit être effectuée avec prudence. Une erreur dans le code peut rendre un site WordPress inaccessible. Par conséquent, il est toujours recommandé de sauvegarder le fichier original et de tester les modifications dans un environnement de développement avant de les appliquer à un site en production.

25 astuces utiles pour le fichier de fonctions WordPress

Ces astuces constituent des extraits de code que vous pouvez utiliser pour modifier le comportement de WordPress. Vous pouvez les ajouter de manière sécurisée à votre site en utilisant le plugin WPCode.

Commencez par installer le plugin WPCode.

Accédez ensuite à la section « Code snippets › add snippet ».

Sur la page suivante, survolez la section « Add your custom code » et cliquez sur le bouton « Use snippet ».

Sur l’interface suivante, vous pouvez commencer à ajouter vos extraits de code dans le champ « Code preview ». Sélectionnez l’option « PHP Snippet » sur le menu déroulant « Code type » pour tous les extraits que vous devez ajouter dans le fichier de fonctions. N’oubliez pas d’activer le code en utilisant le commutateur.

Voyons maintenant les 25 extraits de code utiles pour votre fichier functions.php.

1. Changer le Gravatar par défaut dans WordPress

Le code ci-dessous vous permet d‘ajouter un Gravatar personnalisé à votre site. Ajoutez simplement ce code dans le fichier de fonctions.

add_filter( 'avatar_defaults', 'ma_nouvelle_image_gravatar' );

function ma_nouvelle_image_gravatar ( $avatar_defaults ) {
    $mon_gravatar = 'URL_DE_VOTRE_IMAGE';
    $avatar_defaults[$mon_gravatar] = 'Nom de votre Gravatar';
    return $avatar_defaults;
}

Dans la section « Commentaires », un Gravatar personnalisé a été ajouté. N’oubliez pas de définir l’URL de l’image pour afficher une image personnalisée.

2. Supprimer le numéro de version de WordPress

Vous pouvez également supprimer le numéro de version habituellement affiché dans le bas de l’espace d’administration en utilisant l’extrait ci-dessous dans le fichier de fonctions.

// Supprimer le numéro de version de WordPress
function remove_wp_version() {
    return '';
}
add_filter('the_generator', 'remove_wp_version');

3. Ajouter des widgets de tableau de bord personnalisés dans WordPress

Pour ajouter des widgets personnalisés au tableau de bord de WordPress, suivez les étapes ci-dessous. Dans cet exemple, nous allons ajouter un widget simple qui affiche un message de bienvenue.

Ouvrez votre fichier functions.php. et ajoutez le code suivant :

// Fonction pour ajouter le contenu du widget personnalisé
function mon_widget_tableau_de_bord_contenu() {
    echo '<p>Bienvenue sur votre tableau de bord personnalisé ! Voici quelques informations utiles pour vous.</p>';
}

// Fonction pour ajouter le widget au tableau de bord
function ajouter_mon_widget_tableau_de_bord() {
    wp_add_dashboard_widget(
        'mon_widget_id',           // ID du widget
        'Mon Widget Personnalisé', // Titre du widget
        'mon_widget_tableau_de_bord_contenu' // Fonction de rappel pour le contenu du widget
    );
}
add_action('wp_dashboard_setup', 'ajouter_mon_widget_tableau_de_bord');

Voici à quoi peut ressembler le résultat.

4. Modifier le pied de page dans le panneau d’administration WordPress

Pour modifier le pied de page dans le panneau d’administration de WordPress, vous pouvez utiliser le filtre admin_footer_text. Voici comment vous pouvez le faire :

// Fonction pour modifier le texte du pied de page dans le panneau d'administration
function personnaliser_texte_pied_de_page_admin() {
    echo 'Merci de créer avec <a href="https://votresite.com">VotreNomDeSociété</a>. Propulsé par <a href="https://wordpress.org">WordPress</a>.';
}
add_filter('admin_footer_text', 'personnaliser_texte_pied_de_page_admin');

Modifiez le texte 'Merci de créer avec <a href="https://votresite.com">VotreNomDeSociété</a>. Propulsé par <a href="https://wordpress.org">WordPress</a>.' selon vos besoins. Par exemple, remplacez votresite.com par l’URL de votre site et VotreNomDeSociété par le nom de votre entreprise ou de votre marque.

Enregistrez le fichier et accédez à votre tableau de bord WordPress. Vous devriez maintenant voir le texte personnalisé dans le pied de page de l’interface d’administration.

5. Ajouter un logo de tableau de bord personnalisé

Pour ajouter un logo personnalisé au tableau de bord de WordPress, vous pouvez utiliser les actions et les filtres appropriés. Ainsi, ajoutez le code suivant :

// Fonction pour ajouter un style personnalisé pour le logo du tableau de bord
function personnaliser_logo_tableau_de_bord() {
    echo '
    <style type="text/css">
        #wpadminbar #wp-admin-bar-wp-logo > .ab-item .ab-icon:before {
            background-image: url(' . get_bloginfo('stylesheet_directory') . '/images/votre-logo.png) !important;
            background-position: 0 0;
            color:rgba(0, 0, 0, 0);
        }
        #wpadminbar #wp-admin-bar-wp-logo.hover > .ab-item .ab-icon {
            background-position: 0 0;
        }
    </style>
    ';
}
add_action('wp_before_admin_bar_render', 'personnaliser_logo_tableau_de_bord');

Assurez-vous d’avoir un logo nommé votre-logo.png dans un dossier images de votre thème actif. Si vous avez un nom de fichier différent ou un chemin différent, remplacez /images/votre-logo.png par le chemin approprié.

6. Date de copyright dynamique dans le pied de page WordPress

Si vous ajoutez simplement un copyright dynamique directement dans le pied de page de votre thème (généralement footer.php), vous n’avez pas besoin de modifier le fichier functions.php.

Cependant, si vous souhaitez rendre cette fonctionnalité plus modulaire ou la réutiliser à différents endroits de votre thème, vous pourriez créer une fonction dans functions.php et ensuite l’appeler depuis footer.php ou tout autre fichier de votre thème.

Dans functions.php, ajoutez :

function afficher_copyright_dynamique() {
    $debut = 2020; // Remplacez par l'année de création de votre site
    $actuel = date('Y');
    if ($debut != $actuel) {
        echo $debut . '-' . $actuel;
    } else {
        echo $actuel;
    }
    echo ' VotreNomDeSociété. Tous droits réservés.';
}

Ensuite, dans footer.php (ou tout autre fichier où vous souhaitez afficher le copyright), ajoutez :

&copy; <?php afficher_copyright_dynamique(); ?>

7. Changer aléatoirement la couleur d’arrière-plan dans WordPress

Pour changer aléatoirement la couleur d’arrière-plan à chaque chargement de page dans WordPress, vous pouvez utiliser une combinaison de PHP et de CSS. Voici comment vous pouvez le faire :

Ouvrez votre fichier functions.php. Ajoutez le code suivant :

function couleur_arriere_plan_aleatoire() {
    // Liste des couleurs que vous souhaitez utiliser
    $couleurs = array('#FF5733', '#33FF57', '#5733FF', '#FF33A1', '#33A1FF', '#A133FF');

    // Sélectionnez une couleur aléatoire parmi les couleurs listées
    $couleur_aleatoire = array_rand($couleurs, 1);

    echo '<style type="text/css">body { background-color: ' . $couleurs[$couleur_aleatoire] . '; }</style>';
}
add_action('wp_head', 'couleur_arriere_plan_aleatoire');

Modifiez la liste $couleurs pour inclure toutes les couleurs que vous souhaitez utiliser. Le code sélectionnera aléatoirement l’une de ces couleurs à chaque chargement de page. Enregistrez le fichier et visualisez votre site. La couleur d’arrière-plan devrait changer aléatoirement à chaque fois que vous rechargez la page.

8. Ajouter des tailles d’image supplémentaires dans WordPress

Pour ajouter des tailles d’image supplémentaires dans WordPress, vous pouvez utiliser la fonction add_image_size().  Ouvrez votre fichier functions.php. Ajoutez le code suivant :

function ajouter_tailles_image_personnalisees() {
    // Ajouter une taille d'image personnalisée
    add_image_size('nom-de-la-taille', 500, 500, true); // 500 pixels de large et de haut, recadrage dur (true)
    
    // Vous pouvez ajouter autant de tailles que vous le souhaitez de la même manière
    // add_image_size('autre-taille', 800, 400, false); // 800 pixels de large, 400 pixels de haut, pas de recadrage dur
}
add_action('after_setup_theme', 'ajouter_tailles_image_personnalisees');

Modifiez 'nom-de-la-taille' par un identifiant unique pour votre taille d’image. Les valeurs 500, 500 sont les dimensions de l’image en pixels. Le dernier paramètre, true, indique si l’image doit être recadrée de manière rigide pour s’adapter exactement à ces dimensions. Si vous mettez false, l’image sera redimensionnée pour s’adapter à ces dimensions tout en conservant ses proportions.

Après avoir ajouté de nouvelles tailles d’image, vous devrez probablement régénérer les miniatures pour les images déjà téléchargées. Pour ce faire, vous pouvez utiliser un plugin comme “Regenerate Thumbnails“.

9. Ajouter de nouveaux menus de navigation à votre thème

Pour ajouter de nouveaux menus de navigation à votre thème WordPress, ouvrez votre fichier functions.php et  ajoutez le code suivant pour enregistrer de nouveaux emplacements de menu.

function enregistrer_mes_menus() {
    register_nav_menus(
        array(
            'menu-header' => __( 'Menu Header' ),
            'menu-footer' => __( 'Menu Footer' ),
            // Ajoutez autant d'emplacements de menu que vous le souhaitez ici
        )
    );
}
add_action( 'init', 'enregistrer_mes_menus' );

Dans cet exemple, nous avons ajouté deux emplacements de menu : “Menu Header” et “Menu Footer“. Vous pouvez ajouter autant d’emplacements que vous le souhaitez en suivant le même format.

Ensuite, pour afficher le menu dans votre thème, ouvrez le fichier où vous souhaitez ajouter le menu, par exemple, header.php pour le menu d’en-tête. Voici le code à utiliser :

<?php wp_nav_menu( array( 'theme_location' => 'menu-header' ) ); ?>

Pour le menu de pied de page, ajoutez le code suivant au fichier footer.php :

<?php wp_nav_menu( array( 'theme_location' => 'menu-footer' ) ); ?>

Enregistrez les fichiers et allez dans la section « Apparence > Menus » dans votre tableau de bord WordPress. Vous devriez maintenant voir les nouveaux emplacements de menu que vous pouvez utiliser pour créer et assigner des menus.

10. Ajouter des champs de profil d’auteur

Pour ajouter des champs de profil d’auteur supplémentaires dans WordPress, vous pouvez utiliser les filtres user_contactmethods et show_user_profile (ainsi que edit_user_profile pour l’administration). Ouvrez votre fichier functions.phpet ajoutez le code suivant pour ajouter de nouveaux champs au profil de l’utilisateur :

// Ajouter de nouveaux champs au profil de l'utilisateur
function ajouter_champs_profil_personnalises( $contactmethods ) {
    $contactmethods['facebook'] = 'Facebook'; // Ajouter un champ Facebook
    $contactmethods['twitter'] = 'Twitter';   // Ajouter un champ Twitter
    $contactmethods['linkedin'] = 'LinkedIn'; // Ajouter un champ LinkedIn

    return $contactmethods;
}
add_filter('user_contactmethods', 'ajouter_champs_profil_personnalises', 10, 1);

// Afficher les champs supplémentaires sur la page de profil de l'utilisateur
function afficher_champs_profil_personnalises( $user ) { ?>
    <h3>Informations supplémentaires</h3>

    <table class="form-table">
        <tr>
            <th><label for="position">Position</label></th>
            <td>
                <input type="text" name="position" id="position" value="<?php echo esc_attr( get_the_author_meta( 'position', $user->ID ) ); ?>" class="regular-text" /><br />
                <span class="description">Veuillez entrer votre position.</span>
            </td>
        </tr>
    </table>
<?php }
add_action( 'show_user_profile', 'afficher_champs_profil_personnalises' );
add_action( 'edit_user_profile', 'afficher_champs_profil_personnalises' );

// Sauvegarder les champs supplémentaires du profil de l'utilisateur
function sauvegarder_champs_profil_personnalises( $user_id ) {
    if ( !current_user_can( 'edit_user', $user_id ) )
        return false;

    update_usermeta( $user_id, 'position', $_POST['position'] );
}
add_action( 'personal_options_update', 'sauvegarder_champs_profil_personnalises' );
add_action( 'edit_user_profile_update', 'sauvegarder_champs_profil_personnalises' );

Dans cet exemple, nous avons ajouté trois nouveaux champs de contact (Facebook, Twitter, LinkedIn) et un champ supplémentaire « Position » sur la page de profil de l’utilisateur.

11. Manipuler le pied de page du flux RSS

Si vous souhaitez manipuler le pied de page du flux RSS de WordPress, vous pouvez le faire en utilisant le filtre the_content_feed. Ajoutez le code suivant au fichier de fonctions :

function personnaliser_pied_de_page_flux_rss( $content ) {
    if( is_feed() ) {
        $message_pied_de_page = '<p>Merci de lire cet article sur [VotreNomDeSite]. Pour plus de contenu, visitez notre site web à l\'adresse [URL de votre site].</p>';
        $content .= $message_pied_de_page;
    }
    return $content;
}
add_filter('the_content_feed', 'personnaliser_pied_de_page_flux_rss');

Remplacez [VotreNomDeSite] par le nom de votre site et [URL de votre site] par l’URL de votre site. Enregistrez le fichier. Désormais, chaque article dans votre flux RSS inclura le message personnalisé que vous avez défini dans le pied de page.

12. Ajouter des images en vedette aux flux RSS

Ce code vérifie si l’article a une image en vedette. Si c’est le cas, il ajoute l’image en vedette au début du contenu de l’article dans le flux RSS.